初始化项目基础结构

添加了完整的前后端开发环境配置,包括:
- 创建 .gitignore 文件忽略本地生成目录和环境文件
- 添加详细的 README.md 开发指南文档
- 配置 backend 目录结构和 FastAPI 应用基础框架
- 实现应用配置管理、健康检查和状态接口
- 设置 uv 依赖管理和虚拟环境配置
- 完成 CORS 中间件配置支持前端开发联调
This commit is contained in:
2026-08-27 11:19:36 +08:00
commit 08e4aeea0c
29 changed files with 3539 additions and 0 deletions
+55
View File
@@ -0,0 +1,55 @@
# 第一阶段分工表
## 总分工表
| 成员 | 主要职责 | 第一阶段负责模块 | 具体工作内容 | 主要交付物 |
| ------ | -------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 吉海燕 | 前端设计与交互实现 | Desktop Frontend / UI | 负责 Vue 3 + TypeScript 前端界面设计与实现;完成 Workspace、Markdown Editor、AI Chat、Search、Agent Trace、Skill/Plugin 管理、Theme Manager、Settings 等页面;维护 Design Token 与主题系统;负责前端状态管理与接口联调 | 前端页面、组件库、交互逻辑、主题系统、前端 Store、API Client、前端演示界面 |
| 范涵宇 | 主要程序开发、整体架构与代码审阅 | Agent Core / Extension Core / Model Core / 后端基础框架 | 负责 Python AI Core 与 FastAPI 后端壳子搭建;负责 Agent Runtime、Tool Registry、Permission、Trace;负责 Skill Runtime、Plugin Runtime、Plugin Host/MCP Bridge 等扩展体系;负责 Provider Adapter、多模型协议统一与 API Key 调用链;负责核心接口设计、模块集成、工程规范与代码 Review | FastAPI Core、Agent Runtime、Tool Registry、Skill Runtime、Plugin Runtime、Provider Adapter、公共接口、代码审阅与集成版本 |
| 杨星萱 | 本地知识库与检索系统开发 | Knowledge Core / Retrieval Core | 负责 Markdown Vault、Note/Block 数据模型、Markdown 解析与增量索引;负责 SQLite 元数据、FTS5 全文检索、sqlite-vec 向量检索;负责 Embedding、Hybrid Retrieval、RRF、Reranker、Metadata Filter、Citation 与笔记定位;负责 RAG 检索 Benchmark | Knowledge Core、Note Block、SQLite/FTS5、VectorStore、Embedding、Hybrid RAG、Reranker、Citation、检索测试数据 |
## 细则:
| 协作事项 | 主负责人 | 配合人员 |
| ------------------------------ | -------- | -------------- |
| 前后端 API Contract | 范涵宇 | 吉海燕 |
| Markdown 编辑与 Note Core 联动 | 杨星萱 | 吉海燕 |
| Search / Citation 前端展示 | 杨星萱 | 吉海燕 |
| Agent 调用 RAG | 范涵宇 | 杨星萱 |
| Agent 调用笔记 Tool | 范涵宇 | 杨星萱 |
| Skill 调用 Plugin Tool | 范涵宇 | 吉海燕 |
| Provider Streaming 前端显示 | 范涵宇 | 吉海燕 |
| Agent Trace 前端显示 | 范涵宇 | 吉海燕 |
| RAG Benchmark | 杨星萱 | 范涵宇 |
| Agent Benchmark | 范涵宇 | 杨星萱 |
| 整体 Demo 联调 | 范涵宇 | 吉海燕、杨星萱 |
| UI/UX 最终统一 | 吉海燕 | 全员 |
| PR / 核心代码 Review | 范涵宇 | 对应模块负责人 |
## 验收:
尽量通过VibeCoding在开学前把demo跑出来
### 分别交付:
吉海燕:能够完整操作 Workspace、编辑 Markdown、搜索、AI Chat,并展示 Citation 和 Agent Trace。
范涵宇:Agent 能调用 Tool、Skill 能加载、Plugin 能注册 Tool、至少两个 Provider 可以切换运行。
杨星萱:Markdown 能完成 Block 化索引,FTS5 + Vector + RRF + Reranker 能完成检索,并返回可定位 Citation。
### 总体验收:
```markdown
→ 自动建立本地知识索引
→ 用户向 Agent 提问
→ Agent 调用 RAG
→ Retrieval Core 找到 Note Block
→ Provider 生成回答
→ 前端显示 Citation
→ 点击 Citation
→ 跳转并高亮原笔记
```