From 9559fda5f9000e21c522893fd3a72ec19ea4119d Mon Sep 17 00:00:00 2001 From: KiriAky 107 Date: Mon, 31 Aug 2026 19:53:44 +0800 Subject: [PATCH] =?UTF-8?q?docx:=E6=B7=BB=E5=8A=A0=E7=AC=AC=E4=BA=8C?= =?UTF-8?q?=E9=98=B6=E6=AE=B5=E5=9B=A2=E9=98=9F=E5=88=86=E5=B7=A5=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 添加详细的第二阶段开发计划文档，包括： - 阶段目标和总体分工安排 - 各成员具体职责和任务分配（范涵宇、杨星萱、吉海燕） - 技术实现方案和架构设计 - 跨模块协作关系和接口定义 - 优先级划分（P0/P1/P2）和验收标准 - 项目演示Demo规划和完成定义 --- docs/第二阶段团队分工表.md | 821 +++++++++++++++++++++++++++++++++++++ 1 file changed, 821 insertions(+) create mode 100644 docs/第二阶段团队分工表.md diff --git a/docs/第二阶段团队分工表.md b/docs/第二阶段团队分工表.md new file mode 100644 index 0000000..6157b55 --- /dev/null +++ b/docs/第二阶段团队分工表.md @@ -0,0 +1,821 @@ +# 第二阶段团队分工表 + +## 一、阶段目标 + +第二阶段延续第一阶段已经形成的模块边界，重点推进多模态输入、MCP 与 Plugin 扩展、更多 Provider、RAG / Agent Benchmark、多格式导出、主题社区格式、Agent Trace 可视化、Mermaid 渲染和函数图像绘制。 + +第二阶段继续保持第一阶段的模块 ownership： + +- 范涵宇：Agent Core、Extension Core、Model Core、Multimodal、整体架构与代码审阅。 +- 杨星萱：Knowledge Core、Retrieval Core、Benchmark、文档导出、函数图像绘制。 +- 吉海燕：Frontend、Theme、Agent Trace、Plugin UI Contribution、Mermaid 渲染。 + +--- + +## 二、总分工表 + +| 成员 | 主要负责方向 | 第二阶段任务 | 配合事项 | +| --- | --- | --- | --- | +| 范涵宇 | Agent Core / Extension Core / Model Core / Multimodal / 总体架构 | faster-whisper、pyannote.audio、MCP Bridge、Plugin Command Contribution 后端、Plugin Settings Contribution 后端、更多 Provider、整体集成、代码审阅与统筹 | 与吉海燕联调 Plugin Command / Settings 前端；为杨星萱的 Agent Benchmark 提供 Agent Trace、Tool Call 等测试接口 | +| 杨星萱 | Knowledge Core / Retrieval Core / Benchmark / Export / 数学内容渲染 | RAG Benchmark、Agent Benchmark 基础设施、Markdown → HTML / PDF / DOCX、函数图像绘制与渲染支持、Retrieval 调优 | 与范涵宇确认 Agent Benchmark 事件和测试数据结构；与吉海燕联调函数图像在编辑器和预览区中的展示 | +| 吉海燕 | Frontend / Theme / Visualization | Theme Import、Theme Manifest、社区主题格式、Agent Trace 可视化、Plugin Command / Settings 前端、Mermaid 渲染支持 | 与范涵宇联调 Plugin Contribution Contract 与 AgentEvent；与杨星萱联调函数图像及导出预览 | + +--- + +## 三、范涵宇 + +### 3.1 faster-whisper + +负责接入 faster-whisper，完成真实音频转写。 + +目标链路： + +```text +Audio +↓ +faster-whisper +↓ +Timestamped Transcript +↓ +Knowledge Core +``` + +输出至少包含： + +```text +text +start_time +end_time +language +``` + +### 3.2 pyannote.audio + +负责说话人分离，并与 faster-whisper 组合。 + +```text +Audio +↓ +pyannote.audio +↓ +Speaker Segments +↓ +faster-whisper +↓ +Timestamped + Speaker Transcript +``` + +输出至少包含： + +```text +speaker +start_time +end_time +text +``` + +### 3.3 MCP Bridge + +负责实现 MCP Bridge，使外部 MCP Server 可以进入现有 Plugin / Tool 体系。 + +```text +External MCP Server +↓ +MCP Bridge +↓ +Plugin Runtime +↓ +Tool Registry +↓ +Agent Runtime +``` + +Agent Runtime 继续使用项目内部的： + +```text +ToolDefinition +ToolCall +ToolResult +``` + +MCP Bridge 负责协议转换。 + +### 3.4 Plugin Command Contribution + +负责 Plugin Runtime 中 Command Contribution 的解析、注册和执行接口。 + +```text +Plugin Manifest +↓ +Plugin Runtime +↓ +Command Registry +↓ +Frontend Contract +``` + +吉海燕负责 Command Palette 等前端展示。 + +### 3.5 Plugin Settings Contribution + +负责 Plugin Manifest 中 Settings Schema 的解析和后端配置接口。 + +首批支持： + +```text +string +number +boolean +select +secret reference +``` + +范涵宇负责 Manifest Parsing、Settings Schema、Plugin Storage、Secret Reference 和 Runtime Contract。 + +### 3.6 更多 Provider + +继续完善 Provider Adapter。 + +第二阶段优先验证： + +```text +Normal Chat +Streaming +Tool Calling +Reasoning Event +Cancellation +Usage +Error Mapping +``` + +主要协议目标： + +```text +OpenAI Responses +OpenAI Chat Completions +OpenAI-Compatible +Anthropic Messages +Ollama +``` + +Provider 数量不作为主要验收指标，优先保证协议适配稳定。 + +### 3.7 审阅与统筹 + +持续负责： + +- 公共 Contract 审阅； +- Agent / Skill / Plugin / Provider 接口审阅； +- 跨模块 PR Review； +- 第二阶段整体架构一致性检查； +- Demo 链路集成； +- 公共错误类型和事件格式统一； +- 第二阶段版本合并与发布前检查。 + +--- + +## 四、杨星萱 + +### 4.1 RAG Benchmark + +建立正式 RAG Benchmark。 + +比较： + +```text +FTS5 +Vector Search +Hybrid Retrieval +Hybrid + RRF +Hybrid + RRF + Reranker +``` + +核心指标： + +```text +Hit@1 +Hit@5 +Recall@K +MRR +Citation Hit Rate +P50 Latency +P95 Latency +``` + +Dataset 至少记录： + +```text +query +expected_note_id +expected_block_id +expected_citation +tags +``` + +### 4.2 Agent Benchmark + +负责 Agent Benchmark 测试框架、Dataset、指标统计和报告生成。 + +范涵宇提供： + +```text +Agent Run +Agent Event +Tool Call +Tool Result +Trace +``` + +主要指标： + +```text +Task Success Rate +Tool Selection Accuracy +Tool Argument Accuracy +Invalid Tool Call Rate +Average Steps +Average Latency +Token Usage +``` + +示例： + +```yaml +id: agent-os-review-001 + +prompt: > + 找出操作系统笔记中关于死锁的内容， + 生成总结并创建三个复习任务。 + +expected_tools: + - rag.search + - notes.read + - tasks.create + +expected_conditions: + citation_required: true + tasks_created: 3 +``` + +### 4.3 多格式文档导出 + +负责建立统一 Export Service： + +```text +Document AST +↓ +DocumentExporter +├── HtmlExporter +├── PdfExporter +└── DocxExporter +``` + +统一接口示意： + +```python +class DocumentExporter(Protocol): + async def export( + self, + document: Document, + options: ExportOptions, + ) -> ExportResult: + ... +``` + +第二阶段完成： + +```text +Markdown → HTML +Markdown → PDF +Markdown → DOCX +``` + +导出时尽量保持： + +- 标题； +- 段落； +- 列表； +- 表格； +- 图片； +- 引用； +- 代码块； +- 数学公式； +- Mermaid； +- 函数图像。 + +Exporter 接口保留未来由 Plugin 增加 EPUB、LaTeX 等格式的扩展空间。 + +### 4.4 函数图像绘制与渲染支持 + +负责函数图像相关的数据解析、表达、绘制和渲染支持。 + +目标示例： + +```text +y = x^2 +y = sin(x) +y = 2x + 1 +``` + +内部建议抽象： + +```text +FunctionPlot +├── expressions +├── domain +├── range +├── axis config +└── render config +``` + +处理链： + +```text +Markdown / Structured Block +↓ +Function Expression Parser +↓ +Function Plot Model +↓ +Renderer +↓ +Editor / Preview +``` + +需要考虑： + +- 二维函数； +- 多函数同图； +- 定义域； +- 坐标轴； +- 缩放； +- 图像刷新； +- Markdown 中的持久化格式； +- HTML / PDF / DOCX 导出时的静态渲染。 + +可设计独立 fenced block，例如： + +````markdown +```function-plot +y = x^2 +y = sin(x) +``` +```` + +具体语法在实现阶段冻结。 + +函数图像的数据结构、解析和渲染逻辑由杨星萱负责；吉海燕配合完成前端容器、布局和交互。 + +### 4.5 Retrieval 调优 + +根据 RAG Benchmark 数据继续调整： + +```text +Block Chunking +FTS Query +Vector Top-K +RRF Parameters +Reranker Candidate Count +Score Threshold +Metadata Filter +``` + +所有调优保留 Benchmark 前后对比数据。 + +--- + +## 五、吉海燕 + +### 5.1 Theme Import + +负责 Theme Package 导入。 + +建议结构： + +```text +my-theme/ +├── theme.yaml +├── theme.css +├── preview.png +└── README.md +``` + +流程： + +```text +Import +↓ +Manifest Validation +↓ +Preview +↓ +Install +↓ +Enable +↓ +Disable +↓ +Uninstall +``` + +### 5.2 Theme Community Format + +负责制定和实现社区主题格式。 + +示例： + +```yaml +id: example-theme +name: Example Theme +version: 1.0.0 +author: example +min_app_version: 0.2.0 +``` + +主题继续基于： + +```text +Design Token +CSS Variables +Theme Manifest +``` + +第二阶段优先完成本地导入和社区包格式，不要求立即实现联网 Theme Marketplace。 + +### 5.3 Agent Trace 可视化 + +负责将 Agent Runtime 执行过程可视化。 + +建议结构： + +```text +User Request +│ +├── Model Call +│ +├── rag.search +│ ├── arguments +│ ├── duration +│ └── result +│ +├── notes.read +│ +├── Model Call +│ +└── Completed +``` + +Trace Node 可展开查看： + +```text +Arguments +Result +Duration +Permission +Usage +Error +``` + +需要支持： + +- Agent Run 状态； +- Tool Call 顺序； +- Tool 调用耗时； +- Tool Result 摘要； +- Provider 调用； +- Token Usage； +- 错误状态； +- 用户取消； +- Citation 跳转。 + +### 5.4 Plugin Command 前端 + +负责 Command Contribution 在前端呈现。 + +主要挂载： + +```text +Command Palette +Context Menu +Toolbar Action +``` + +前端使用 Plugin Contribution Contract，不直接解析插件后端 Manifest。 + +### 5.5 Plugin Settings 前端 + +根据范涵宇提供的 Plugin Settings Schema 动态生成设置表单。 + +支持： + +```text +Input +Number +Switch +Select +Secret Input +``` + +Secret 类型通过 Secret API 提交，不写入 Pinia 持久化或普通配置文件。 + +### 5.6 Mermaid 渲染支持 + +负责在 Markdown 编辑器、预览区域和相关展示界面加入 Mermaid 渲染。 + +目标 Markdown： + +````markdown +```mermaid +flowchart LR + A[Markdown] --> B[Renderer] + B --> C[Diagram] +``` +```` + +处理链： + +```text +Markdown +↓ +Mermaid Code Block +↓ +Mermaid Renderer +↓ +SVG +↓ +Editor / Preview +``` + +需要支持： + +- Flowchart； +- Sequence Diagram； +- Class Diagram； +- State Diagram； +- ER Diagram； +- Gantt 等常用 Mermaid 图； +- Light / Dark Theme； +- 编辑后重新渲染； +- 渲染错误提示； +- SVG 缩放与查看； +- 导出时的静态图处理。 + +Mermaid 渲染需要与 Theme Design Token 联动。 + +与杨星萱负责的 Export Service 联调时，前端或渲染层需要提供 Mermaid → SVG / Image 的稳定输出，使 HTML、PDF 和 DOCX 导出能够保留图表。 + +--- + +## 六、跨成员协作表 + +| 协作事项 | 主负责人 | 配合人员 | +| --- | --- | --- | +| MCP Bridge → Agent Tool | 范涵宇 | 杨星萱 | +| Plugin Command Runtime | 范涵宇 | 吉海燕 | +| Plugin Command UI | 吉海燕 | 范涵宇 | +| Plugin Settings Runtime | 范涵宇 | 吉海燕 | +| Plugin Settings UI | 吉海燕 | 范涵宇 | +| Agent Benchmark Framework | 杨星萱 | 范涵宇 | +| Agent Trace Event Contract | 范涵宇 | 吉海燕、杨星萱 | +| Agent Trace Visualization | 吉海燕 | 范涵宇 | +| RAG Benchmark | 杨星萱 | 范涵宇 | +| Markdown Export | 杨星萱 | 吉海燕 | +| Mermaid Editor Rendering | 吉海燕 | 杨星萱 | +| Mermaid Export Rendering | 杨星萱 | 吉海燕 | +| Function Plot Core / Rendering | 杨星萱 | 吉海燕 | +| Function Plot Frontend Integration | 吉海燕 | 杨星萱 | +| Theme Community Format | 吉海燕 | 范涵宇 | +| Provider Streaming UI | 范涵宇 | 吉海燕 | +| Multimodal → Knowledge Core | 范涵宇 | 杨星萱 | +| 第二阶段整体 Demo | 范涵宇 | 吉海燕、杨星萱 | +| 核心代码 Review | 范涵宇 | 对应模块负责人 | + +--- + +## 七、第二阶段优先级 + +### P0 + +#### 范涵宇 + +```text +MCP Bridge +faster-whisper +pyannote.audio +``` + +#### 杨星萱 + +```text +RAG Benchmark +Agent Benchmark Infrastructure +Markdown → HTML +函数图像基础渲染 +``` + +#### 吉海燕 + +```text +Agent Trace Visualization +Theme Manifest / Theme Import +Mermaid Rendering +``` + +### P1 + +#### 范涵宇 + +```text +Plugin Command Contribution +Plugin Settings Contribution +Provider Adapter 完善 +``` + +#### 杨星萱 + +```text +Markdown → PDF +Markdown → DOCX +Retrieval 调优 +函数图像导出适配 +``` + +#### 吉海燕 + +```text +Theme Community Format +Plugin Command UI +Plugin Settings UI +Mermaid Theme Adaptation +``` + +### P2 + +#### 范涵宇 + +```text +更多 Provider +MCP 兼容性增强 +Multimodal Pipeline 优化 +``` + +#### 杨星萱 + +```text +复杂格式导出 +Benchmark 报告自动生成 +函数图像高级配置 +``` + +#### 吉海燕 + +```text +Theme 浏览与管理体验 +Agent Trace 高级筛选 +Mermaid 高级交互 +``` + +--- + +## 八、第二阶段共同验收 Demo + +建议使用“课堂学习全过程”作为第二阶段总 Demo： + +```text +导入课堂录音 +↓ +pyannote.audio +↓ +说话人分离 +↓ +faster-whisper +↓ +带时间戳 Transcript +↓ +生成 Markdown +↓ +Knowledge Core 建立索引 +↓ +用户询问课程内容 +↓ +Agent 调用 RAG +↓ +返回 Citation +↓ +Agent Trace 可视化 +``` + +随后展示： + +```text +选择 Skill +↓ +调用 Agent +↓ +通过 MCP Bridge 使用外部 Tool +↓ +生成整理后的 Markdown +``` + +Markdown 中展示： + +```text +普通文本 +数学公式 +Mermaid 图 +函数图像 +``` + +最后： + +```text +Markdown +├── Export HTML +├── Export PDF +└── Export DOCX +``` + +并切换一个导入的 Community Theme。 + +--- + +## 九、Definition of Done + +### 范涵宇 + +- [ ] faster-whisper 能完成真实音频转写； +- [ ] pyannote.audio 能生成说话人分段； +- [ ] 两者能组合生成带时间戳和 Speaker 的 Transcript； +- [ ] MCP Server 能通过 MCP Bridge 注册 Tool； +- [ ] Agent 能调用 MCP Tool； +- [ ] Plugin Command Contribution 后端可注册； +- [ ] Plugin Settings Contribution 后端可解析； +- [ ] Provider Adapter 的 Streaming / Tool Calling / Error Mapping 稳定； +- [ ] 完成跨模块接口审阅和第二阶段集成。 + +### 杨星萱 + +- [ ] RAG Benchmark Dataset 可以稳定运行； +- [ ] 能输出 Hit@K、Recall@K、MRR、Latency 等指标； +- [ ] Agent Benchmark Framework 可以执行标准 Case； +- [ ] Markdown 可以导出 HTML； +- [ ] Markdown 可以导出 PDF； +- [ ] Markdown 可以导出 DOCX； +- [ ] Mermaid 在导出链路中可以保留为静态图； +- [ ] 函数图像能够由结构化表达生成； +- [ ] 函数图像能够进入预览和导出链路； +- [ ] Retrieval 调优结果有 Benchmark 数据支撑。 + +### 吉海燕 + +- [ ] Theme Package 可以导入； +- [ ] Theme Manifest 可以校验； +- [ ] Theme 可以启用、停用和卸载； +- [ ] Agent Trace 可以展示完整 Tool Call 顺序； +- [ ] Trace Node 可以查看参数、结果、耗时和错误； +- [ ] Plugin Command 可以显示在前端； +- [ ] Plugin Settings 可以动态生成设置项； +- [ ] Markdown Mermaid Code Block 可以渲染； +- [ ] Mermaid 支持主题切换； +- [ ] Mermaid 渲染错误可以明确展示； +- [ ] Mermaid 图能够提供给 Export Service。 + +--- + +## 十、分工摘要 + +```text +范涵宇 +├── faster-whisper +├── pyannote.audio +├── MCP Bridge +├── Plugin Command Runtime +├── Plugin Settings Runtime +├── Provider Adapter +├── Code Review +└── Integration / Coordination + +杨星萱 +├── RAG Benchmark +├── Agent Benchmark Infrastructure +├── Retrieval Optimization +├── Export Service +│ ├── Markdown → HTML +│ ├── Markdown → PDF +│ └── Markdown → DOCX +└── Function Plot + ├── Expression / Data Model + ├── Rendering + └── Export Integration + +吉海燕 +├── Theme Import +├── Theme Community Format +├── Agent Trace Visualization +├── Plugin Command UI +├── Plugin Settings UI +└── Mermaid + ├── Markdown Rendering + ├── Theme Adaptation + └── Export Rendering Interface +```