Skip to content

核心流程

核心流程以 Project 为边界,所有关键动作都要求 API readback 能读到状态变化。

Project 创建

用户目标一句话描述项目方向
POST /projects创建 Project 和初始任务
ProjectCreateResponse返回 projectNo 和资源能力
Project detail进入公司控制台

关键结果:

结果说明
Project项目身份和公开页面
Project Item第一项可执行任务
Share Pool默认虚拟份额池
Agent capabilityAgent 可读的资源能力

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
提交 proofPOST /api/v1/work/items/{itemId}/receipt
验收 proofPOST /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
提交验证 proofPOST /api/v1/projects/{projectNo}/tasks/{taskId}/proof
复核 proofPOST /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

Released under the MIT License.