Project Copilot

面向项目团队的 AI 知识库与风险管理助手。第二阶段已补齐私有项目隔离、混合检索、AI 质量观测和项目健康分析。

阶段文档：

• 第一阶段项目结构整理
• 第二阶段实现总结

已实现

• 项目、任务、风险 REST CRUD
• PDF、Word、Markdown、TXT 文档解析与重叠切分
• 本地确定性向量嵌入与余弦检索
• 带文档来源引用的 RAG 问答
• 项目所有者隔离与统一子资源访问校验
• 向量相似度和关键词覆盖率混合检索
• AI 问答历史、耗时、运行模式和召回分统计
• 基于任务与风险的项目健康评分和行动建议
• OpenAI-compatible 模型接入，未配置模型时自动降级
• SSE 流式问答接口
• H2 零依赖启动、PostgreSQL 可选配置
• 单页演示工作台、Actuator、Flyway 和集成测试

启动

需要 Java 21 或更高版本以及 Maven 3.9+。

mvn spring-boot:run

打开 http://localhost:8080。应用首次启动会创建一个演示项目、任务和风险。

接入大模型

支持所有 OpenAI-compatible /chat/completions 接口：

export AI_BASE_URL=https://api.deepseek.com
export AI_API_KEY=your-key
export AI_MODEL=deepseek-chat
mvn spring-boot:run

未配置上述变量时，系统仍可运行，并使用知识库检索结果生成本地摘要回答。

PostgreSQL

docker compose up -d
mvn spring-boot:run -Dspring-boot.run.profiles=postgres

当前阶段在应用层保存本地向量，以确保离线体验。后续可将 LocalEmbeddingService 替换为外部 Embedding 模型，并将检索迁移至 PGVector。

主要 API

GET/POST           /api/projects
GET/PUT/DELETE     /api/projects/{id}
GET/POST           /api/projects/{id}/tasks
GET/POST           /api/projects/{id}/risks
GET/POST           /api/projects/{id}/knowledge/documents
GET                /api/projects/{id}/knowledge/search?query=...
POST               /api/projects/{id}/chat
POST               /api/projects/{id}/chat/stream
GET                /api/projects/{id}/chat/history
GET                /api/projects/{id}/chat/stats
GET                /api/projects/{id}/health

验证

mvn test