86 lines
4.5 KiB
Markdown
86 lines
4.5 KiB
Markdown
# AI Worker 项目管理平台
|
||
|
||
> 以「项目」为中心、以「AI Worker」为执行单元的项目管理平台。
|
||
> 把大模型团队变成一支可指挥、可审计、可控成本的"虚拟团队"。
|
||
|
||
**当前版本：V1**（MVP 闭环 + 多 Agent 编排 / RAG / 预算告警 / 开放 API / 飞书企微集成）
|
||
|
||
---
|
||
|
||
## 功能总览
|
||
|
||
### MVP（已交付 v1.0）
|
||
| 模块 | 能力 |
|
||
|---|---|
|
||
| 📁 项目管理 | 项目 CRUD、目标/验收标准/预算上限、状态流转 |
|
||
| 🧑💻 Worker 管理 | 虚拟员工档案（供应商+模型+角色提示词+温度/Token+成本上限）、连通性测试、自动路由 |
|
||
| 📋 看板 | 6 列看板拖拽、优先级、截止时间、返工计数 |
|
||
| 🚀 执行引擎 | 统一模型网关（doubao/deepseek/openai/qwen/vLLM）、失败重试、超时、成本预检 |
|
||
| ✅ HITL 审核 | 产出进「待审核」，通过/打回（必填原因）→ 返工，AI 不可绕过 |
|
||
| 💰 成本记账 | Token/成本按 项目×Worker×模型 核算、预算硬约束、一次通过率 |
|
||
|
||
### V1（本次交付 v2.0）
|
||
| 模块 | 能力 |
|
||
|---|---|
|
||
| 🔗 **DAG 多任务编排** | 任务依赖（depends_on）、依赖校验拦截、**完成后自动触发下游**、并行执行、一键执行整个工作流、SVG 流程可视化 |
|
||
| 🧠 **AI 辅助规划 WBS** | 输入目标 → LLM 自动生成 4~8 个任务的任务分解（含依赖关系）→ 可编辑预览 → 一键导入项目 |
|
||
| 📚 **RAG 知识库** | 项目级文档（粘贴/上传 txt·md）、自动分块索引、BM25 检索（jieba 分词）、**任务执行时自动注入相关知识**（日志可见命中来源） |
|
||
| 🚨 **预算控制与告警** | 项目预算使用率阈值告警（默认 80%）、成本上限拦截、**告警中心**（未读角标/标记已读）、去重防刷屏 |
|
||
| 🔌 **开放 API** | Bearer Token 认证、Token 管理、外部系统可建任务/派活/查结果/审核（curl 示例内置） |
|
||
| 📨 **通知集成** | 飞书/企微群机器人 Webhook + 邮件 SMTP，订阅事件：待审核/完成/失败/预算告警/Worker 异常/规划完成，渠道连通性测试 |
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
./start.sh # 启动（默认 16071）
|
||
./start.sh stop # 停止
|
||
./start.sh restart # 重启
|
||
```
|
||
|
||
- 管理界面：`http://<IP>:16071/`，默认口令 `admin123`（改 `config.py` 的 `AUTH_PASSWORD`）
|
||
- 首次启动自动灌入演示数据；`python3 seed.py` 重新初始化
|
||
- V1 全链路验证脚本：`python3 dag_verify.py <终点任务ID>`（自动审核放行直到链路完成）
|
||
|
||
## 技术栈
|
||
|
||
- 后端：Python + Flask + SQLite（WAL），依赖仅 flask/requests/jieba
|
||
- 前端：原生 HTML/JS/CSS SPA（无 CDN，离线可用）
|
||
- RAG：本地 BM25（jieba 分词），零依赖；升级路径 = 商用 embedding + pgvector/Qdrant
|
||
- 编排：自研轻量 DAG 引擎（线程级，断点状态落库）；升级路径 = Temporal 持久执行 + LangGraph 多 Agent 推理
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
ai-worker-platform/
|
||
├── app.py # Flask 应用 + REST API（含 V1 路由）
|
||
├── config.py # 供应商/定价/鉴权/告警阈值/邮件 SMTP
|
||
├── db.py # SQLite 数据层 + 自动迁移
|
||
├── engine.py # 执行引擎：DAG 依赖/自动触发/RAG 注入/告警/通知
|
||
├── llm_gateway.py # 统一模型网关
|
||
├── rag.py # 知识库：分块 + BM25 检索
|
||
├── notify.py # 飞书/企微/邮件通知
|
||
├── dag_verify.py # DAG 全链路验证脚本
|
||
├── seed.py # 演示数据
|
||
├── start.sh # 启停脚本
|
||
├── static/ # 前端 SPA
|
||
├── docs/ # 界面截图
|
||
└── data/ # SQLite 库；logs/ 运行日志
|
||
```
|
||
|
||
## 开放 API 摘要
|
||
|
||
所有接口支持 `Authorization: Bearer <TOKEN>`（管理界面「开放 API」页生成）：
|
||
|
||
- `POST /api/projects` 建项目 ｜ `GET /api/projects`
|
||
- `POST /api/tasks` 建任务（body 含 project_id/title/description/depends_on…）
|
||
- `POST /api/tasks/<id>/run` 派活 ｜ `GET /api/tasks/<id>` 查结果
|
||
- `POST /api/tasks/<id>/review` 审核 `{"action":"approve"}` 或 `{"action":"reject","reason":"…"}`
|
||
- `POST /api/projects/<id>/workflow/run` 执行整个工作流
|
||
- `POST /api/projects/<id>/wbs/generate` AI 生成任务分解 ｜ `/wbs/import` 导入
|
||
- `GET /api/reports/cost?group=project|worker|model` 成本报表
|
||
- `GET /api/alerts` 告警 ｜ `GET /api/stats` 统计
|
||
|
||
## 路线图
|
||
|
||
- **V2**：多 Agent 协作模式（主管/评审/辩论）、Temporal 持久执行、自动评估体系（eval）、模板市场、企业版（私有化/SSO/审计）
|