组件详解
各系统组件的详细说明。
API 服务器
API 服务器是管理所有数据和编排开发流水线的中心枢纽。
核心服务
| 服务 | 职责 |
|---|---|
PollingOrchestrator | 任务调度、分发、协调 |
AgentGateway | Agent 协议抽象和路由 |
WorkflowPolicyManager | WORKFLOW.md 生命周期管理 |
BuildTestRunner | 构建/Lint/测试执行（本地或 Docker） |
GateScoreCalculator | 7 维质量评分 |
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 模式 / App Server | L3（完整） |
| Codex | App Server | L3（完整） |
| GitHub Copilot | CLI JSON 流 | L3（完整） |
| Gemini CLI | CLI | L1 |
| OpenCode | CLI | L2 |
| Kimi Code | CLI | L2 |
| MiMo Code | run --format json | L2（仅显式选择） |
| Qwen Code | stream-json | L2（仅显式选择） |
| CodeBuddy | stream-json | L2（仅显式选择） |
| Qoder CLI | stream-json | L2（仅显式选择） |
| TraeCode CLI | exec --json | L2（仅显式选择；真实账号 live gate 待完成） |
| ZCode | app-server 双向 NDJSON Protocol | L2 Experimental（仅显式选择；批准构建和 live gate 待完成） |
| DeepSeek Harness | --profile headless --patch <overlay> --json，提示经 stdin | L2 开发者预览（显式个人 Runtime；精确 0.2.0-rc.2 + 构件验收） |
共有 13 个集成。Claude Code、Codex、GitHub Copilot、Gemini CLI、OpenCode 和 Kimi Code 为 6 个标准自动候选；MiMo Code、Qwen Code、CodeBuddy、Qoder CLI、TraeCode CLI、ZCode 与 DeepSeek Harness 为 7 个显式选择，自动路由/default fallback 排除七者。TraeCode CLI/ZCode 保留各自门禁，Harness 要求下述固定构件和个人 Runtime 验收。
任务生命周期（守护进程侧）
DeepSeek Harness（deepseek）是第 7 个显式集成。共享严格 runner 使用受管 home、外部认证只读引用、workspace-write/never preset、外层写入 sandbox、配置绑定的原生恢复与取消意图监督。提交式 JSONL 不是 token 流；共享池、自动路由与默认 fallback 均排除它，图片/fork/只读 review/并行能力关闭。参见 Harness 安装。
- 轮询服务器获取分配的任务
- 准备工作空间（clone/worktree）
- 以丰富提示词执行 Agent
- 收集 git diff 统计
- 自动提交并推送变更
- 报告完成及指标
前端
React 19 单页应用，使用 Ant Design。
页面
| 页面 | 用途 |
|---|---|
| 项目 | 项目管理 |
| 需求 | 需求 CRUD + AI 分析 |
| 看板 | 5 列看板 |
| 执行 | 流水线可视化 |
| 门禁 | 质量门禁评审 |
| 工作流 | WORKFLOW.md 编辑器 |
| 预算 | 使用量跟踪 |
| 运行时 | 守护进程监控 |
| 设置 | 配置管理 |