Architecture

架构说明

组件

• FastAPI 后端：提供仓库、任务、配置、统计和 webhook API，并托管前端构建产物。
• React/Vite 前端：展示任务队列、Issue、流水线、设置、通知与统计信息。
• SQLite 数据库：保存仓库、任务、日志、会话、通知与运行配置。
• 调度器与对账器：同仓库串行、跨仓库并行；webhook 实时入队，对账定时补漏。
• 执行器插件：支持 Claude、Hermes 与 DSH；会在预检、失败分类和备用引擎策略下运行。
• GitLab 客户端：封装项目、Issue、评论、标签、流水线和 webhook 的 API 访问。

数据流

GitLab Issue / Webhook
        ↓
任务入队与优先级调度 → 执行前预检 → AI 执行器
        ↓                                  ↓
任务状态、日志、用量 ← 测试 / Git 主分支提交 / GitLab CI
        ↓
结果评论 + bot-done（人工决定是否关闭 Issue）

所有凭据由环境变量注入，运行数据与代码目录分离。详细开发约定见开发与测试。