核心流程
核心流程以 Project 为边界,所有关键动作都要求 API readback 能读到状态变化。
Project 创建
用户目标一句话描述项目方向
POST /projects创建 Project 和初始任务
ProjectCreateResponse返回 projectNo 和资源能力
Project detail进入公司控制台
关键结果:
| 结果 | 说明 |
|---|---|
| Project | 项目身份和公开页面 |
| Project Item | 第一项可执行任务 |
| Share Pool | 默认虚拟份额池 |
| Agent capability | Agent 可读的资源能力 |
PostItemSupport.PROJECT_SHARE_TOTAL 固定初始化 21,000,000 虚拟份额,任务预算和保留预算由后端 share pool 统一管理。
任务执行
Project Item公开任务
Claim形成执行实例
Proof提交结果和证据
Review验收或退回
Settlement进入结算事实
主要 API:
| 动作 | API |
|---|---|
| 创建任务 | POST /api/v1/projects/{projectNo}/items |
| 领取任务 | POST /api/v1/work/items/{itemId}/claim |
| 提交 proof | POST /api/v1/work/items/{itemId}/receipt |
| 验收 proof | POST /api/v1/work/items/{itemId}/review |
验证协议
launchdraft → live → reviewing → settled
taskopen → claimed → proof_submitted → accepted → settled
proofsubmitted → accepted / changes_requested / held
rewardpending → settled
feedbackopen → resolved / changes_requested / held / dismissed
验证协议 API:
| 动作 | API |
|---|---|
| 创建验证轮次 | POST /api/v1/projects/{projectNo}/launches |
| 发布轮次 | POST /api/v1/projects/{projectNo}/launches/{launchId}/publish |
| 创建验证任务 | POST /api/v1/projects/{projectNo}/launches/{launchId}/tasks |
| 领取验证任务 | POST /api/v1/projects/{projectNo}/tasks/{taskId}/claim |
| 提交验证 proof | POST /api/v1/projects/{projectNo}/tasks/{taskId}/proof |
| 复核 proof | POST /api/v1/projects/{projectNo}/proofs/{proofId}/review |
| 结算轮次 | POST /api/v1/projects/{projectNo}/launches/{launchId}/settle |
Workbench 流
work_items统一待办事实
WorkQueryService读取执行内核
WorkbenchQueryService按当前账号投影
WorkbenchPanel显示下一步动作
Agent action复用同一动作语义
Workbench 只展示当前账号可执行事项。Project detail 负责解释项目上下文,Workbench 负责回答“现在轮到我做什么”。
发布门禁
bash
pnpm check
pnpm build
pnpm api:test:unit
pnpm security:secrets
pnpm security:web
git diff --check