DevPilot
DevPilot 是一个研发知识库与智能排障 Agent 平台。它将需求、接口、测试、缺陷文档和代码仓库统一入库，通过带引用的知识问答、代码定位和故障诊断 Agent 输出可追溯结论；需要执行测试或访问高风险工具时，必须先经过人工审批，再进入隔离环境验证。
- Markdown、TXT、PDF、DOCX 与 OpenAPI 文档入库、版本化和增量索引
- 向量检索与关键词检索并行，使用 RRF、Rerank 和引用校验生成回答
- Git 仓库接入与 Tree-sitter 符号解析，支持 Python、Java、TypeScript/JavaScript
- LangGraph 诊断流程：意图路由、计划、证据收集、多假设验证和结构化报告
- MCP 工具注册、风险分级、人工审批、SQL/HTTP 安全限制与测试沙箱
- 离线评测、运行轨迹、Prometheus 指标和 Grafana 可观测面板
| 层级 | 实现 |
|---|---|
| 前端 | React SPA、TypeScript、Vite |
| 后端 | Python 3.12、FastAPI、Pydantic、SQLAlchemy、Alembic |
| Agent | LangGraph、LangChain、OpenAI-compatible Provider 抽象 |
| 检索 | PostgreSQL FTS、pgvector HNSW、RRF、Reranker |
| 异步与存储 | Celery、RabbitMQ、Redis、MinIO |
| 代码理解 | Tree-sitter、Git 增量快照、符号级索引 |
| 部署与观测 | Docker Compose、Nginx、Prometheus、Grafana |
主 Agent 图按 GUARD → ROUTER → QA/DIAGNOSIS → VERIFY → REPORT 运行，诊断结论必须绑定文档 Chunk、代码路径、Commit 和行号。系统对工作空间进行隔离，并对凭据、SQL、HTTP 请求、沙箱网络和工具调用实施分层约束。
LLM、Embedding 与 Reranker 都通过 Provider 接口解耦；没有模型密钥时可以使用 mock 跑通流程，接入真实模型后无需改变业务编排。