docx:添加第二阶段团队分工表

添加详细的第二阶段开发计划文档，包括： - 阶段目标和总体分工安排 - 各成员具体职责和任务分配（范涵宇、杨星萱、吉海燕） - 技术实现方案和架构设计 - 跨模块协作关系和接口定义 - 优先级划分（P0/P1/P2）和验收标准 - 项目演示Demo规划和完成定义
2026-08-31 19:53:44 +08:00
parent fb1da4d00a
commit 9559fda5f9
1 changed files with 821 additions and 0 deletions
@@ -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
 ```