组件详解
各系统组件的详细说明。
API 服务器
API 服务器是管理所有数据和编排开发流水线的中心枢纽。
核心服务
| 服务 | 职责 |
|---|---|
PollingOrchestrator | 任务调度、分发、协调 |
AgentGateway | Agent 协议抽象和路由 |
WorkflowPolicyManager | WORKFLOW.md 生命周期管理 |
BuildTestRunner | 构建/Lint/测试执行（本地或 Docker） |
GateScoreCalculator | 6 维质量评分 |
GitManager | 分支、提交、PR 管理 |
RuntimeRegistry | 守护进程注册和选择 |
PlanGenerator | AI 驱动的计划生成 |
EventBus | Redis Streams 事件发布 |
API 路由
| 前缀 | 资源 |
|---|---|
/api/v1/auth | 认证（登录、注册） |
/api/v1/workspaces | 工作空间 CRUD + 成员 |
/api/v1/projects | 项目 CRUD |
/api/v1/requirements | 需求 CRUD + AI 分析 |
/api/v1/plans | 计划生成 + 审批 |
/api/v1/executions | 执行生命周期 |
/api/v1/gates | 质量门禁评审 |
/api/v1/runtimes | 守护进程注册 + 任务分发 |
/api/v1/budget | 预算查询 |
/api/v1/workflows | 工作流策略管理 |
运行时守护进程
守护进程是运行在开发者机器上的独立 Python 进程。
子组件
| 组件 | 职责 |
|---|---|
AgentDiscovery | 扫描 PATH 发现 AI Agent CLI |
WorkspaceManager | 每个任务创建 git worktree |
ProcessManager | 管理 Agent 子进程生命周期 |
HeartbeatService | 定期健康报告 |
TaskPoller | 轮询服务器获取分配的任务 |
ProgressReporter | 报告进度和完成状态 |
Agent 支持
| Agent | 调用模式 | 兼容性 |
|---|---|---|
| Claude Code | print 模式（stdin→stdout） | L3（完整） |
| Codex | exec 模式（JSON） | L3（完整） |
| OpenCode | run 模式（JSON） | L2 |
| Gemini | -p 提示模式 | L1 |
| Hermes | CLI | L1 |
任务生命周期（守护进程侧）
- 轮询服务器获取分配的任务
- 准备工作空间（clone/worktree）
- 以丰富提示词执行 Agent
- 收集 git diff 统计
- 自动提交并推送变更
- 报告完成及指标
前端
React 19 单页应用，使用 Ant Design。
页面
| 页面 | 用途 |
|---|---|
| 项目 | 项目管理 |
| 需求 | 需求 CRUD + AI 分析 |
| 看板 | 5 列看板 |
| 执行 | 流水线可视化 |
| 门禁 | 质量门禁评审 |
| 工作流 | WORKFLOW.md 编辑器 |
| 预算 | 使用量跟踪 |
| 运行时 | 守护进程监控 |
| 设置 | 配置管理 |