架构地图
这页把产品能力映射到代码边界，帮助贡献者定位改动范围。
前端边界
| 能力 | 文件 |
|---|---|
| Project 详情页 | apps/web/app/[locale]/market/projects/[projectNo]/page.tsx |
| 验证面板 | apps/web/components/project-validation-panel.tsx |
| Agent Protocol | apps/web/components/project-agent-protocol-panel.tsx |
| Workbench | apps/web/components/workbench/workbench-panel.tsx |
| Project action 语义 | apps/web/lib/project-action-registry.ts |
| API client | apps/web/lib/api/index.ts |
API 边界
| 模块 | 职责 |
|---|---|
ProjectController | Project 创建、查询、任务、角色、商业化入口 |
ProjectValidationProtocolController | launch、task、proof、review、feedback、reward |
ProjectAgentProtocolController | Agent inbox 和 action |
WorkbenchController | 当前账号待办 |
ProjectMemoryController | memory source、entry、agent context |
ShareReleaseController | share release 审批 |
服务边界
| 服务 | 事实来源 |
|---|---|
ProjectValidationProtocolService | 验证协议状态机 |
ProjectCommercializationService | directions、proof stats、share pool、revenue pool |
ProjectSharePoolService | share pool 预算、预留和发放 |
WorkbenchQueryService | work item 投影 |
OrganizationAuthorityService | Project capability |
ProjectMemoryService | source contract、active memory、agent context |
Agent 边界
| 文件 | 职责 |
|---|---|
skills/monopolyfun-agent/SKILL.md | skill 总契约 |
scripts/agent-turn.mjs | 单轮执行入口 |
scripts/route-intent.mjs | 自然语言到 action |
scripts/execute-action.mjs | guarded API action |
scripts/verify-action.mjs | readback 验证 |
变更检查
| 改动类型 | 必查 |
|---|---|
| Project 行为 | Project detail、API readback、Workbench、Agent action |
| Validation 行为 | task、proof、review、reward、settlement |
| Order 行为 | OrderActionPolicy 和 UI actions |
| Memory 行为 | source、entry、contractHash、agent context |
| Skill 行为 | route、execute、verify、project smoke |
验证命令
bash
pnpm check
pnpm build
pnpm api:test:unit
pnpm security:secrets
pnpm security:web
pnpm openclaw:project-smoke:full-flow