Kronecker/NotesAgentic

Fork 0

Files

T

admin e667dd55dd Record phase two acceptance evidence and synchronize delivery status

2026-09-07 02:55:19 +08:00

18 KiB

Raw Permalink Blame History

第二阶段团队分工表

2026-09-07 全范围收尾状态

本轮覆盖三位成员的第二阶段模块（音频质量专项除外），以实现与验收记录及下方更新后的DoD为当前口径。此前“不含杨侧验收”仅描述当日范围。现有DeepSeek/MiniMax真实链路通过，其他未配置协议保留外部验收项；音频使用Qwen3-ASR/ERes2NetV2技术路径，不声称交付原清单指定模型。

2026-09-06 复核修复补充（不含杨侧验收）

Agent 增加断点续读、有界重连和手动恢复；连接中断不再隐藏仍在运行任务的取消入口。
本地扩展安装库支持重启恢复、包摘要复核和受管理 ZIP 卸载清理。变更后的包需重新安装审查；目录安装保留用户源码。
工作区已挂载编辑器右键及扩展工具栏入口，与已有 palette/详情命令共同使用后端命令校验；执行上下文保留选区快照。
新增真实 Mermaid 6 图型 × 6 主题回归入口，以及参考转写 CER/WER/DER 评分和受限 Provider 连接探针。工具使用与边界见 docs/development/第二阶段补充验收工具.md。
逐字强制对齐、多人重叠分离仍未实现；无标注录音不能完成质量验收，真实厂商专项也不能用一次连接测试替代。以下较早记录中的测试数和延期状态属于历史基线。

2026-09-05 当前完成情况补充（不含杨侧验收）

以下状态补充早期任务清单，历史未勾选项不再单独作为实时完成率依据。杨星萱负责的 Benchmark、检索调优、导出及函数图像不在本次验收范围。

A/B/C/C.1/D 基础工程已落地；E 的离线协议验证已通过，真实目标厂商专项待完成。
Theme：补齐 SemVer 最低版本拒绝、文件/URL/ZIP 共用校验及安装前隔离视觉预览。
Mermaid：真实编辑器及 Markdown 预览接入缩放、重置、大图查看；编辑器预览复制导致的异步标记丢失已修复。
Agent Trace：支持关键词、事件类型、工具及仅错误筛选，保留树的祖先节点和引用定位。
F：本地 Qwen3-ASR、ERes2NetV2、Bekko 已完成 37 分 16 秒录音的 CUDA 转写、片段聚类、笔记及向量检索闭环，约 661 秒生成 441 片段；无参考标注，质量专项保持未完成。
Provider：卡片显示启用状态，支持直接启停与保存失败反馈。
Plugin context_menu/toolbar 按已有本地计划仍是后续增强，当前实际挂载 command_palette 与详情命令；不将声明 Contract 视为已挂载。
逐字强制对齐、多人重叠语音未实现；说话人阈值、准确率、真实厂商专项未验收。Tauri/Rust、生产沙箱仍属于后续阶段。

本轮自动化基线为后端 577 项、前端 280 项及前端生产构建通过。长录音无标注，测试通过不等于质量或所有第二阶段专项全部完成。详细证据见 docs/development/阶段F收尾验收记录.md；本地运行文件不提交。

一、阶段目标

第二阶段延续第一阶段已经形成的模块边界，重点推进多模态输入、MCP 与 Plugin 扩展、更多 Provider、RAG / Agent Benchmark、多格式导出、主题社区格式、Agent Trace 可视化、Mermaid 渲染和函数图像绘制。

第二阶段继续保持第一阶段的模块 ownership：

范涵宇：Agent Core、Extension Core、Model Core、Multimodal、Plugin Command / Settings UI、整体架构与代码审阅。
杨星萱：Knowledge Core、Retrieval Core、Benchmark、文档导出、函数图像绘制。
吉海燕：Frontend、Theme、Agent Trace、Mermaid 渲染。

二、总分工表

成员	主要负责方向	第二阶段任务	配合事项
范涵宇	Agent Core / Extension Core / Model Core / Multimodal / 总体架构	faster-whisper、pyannote.audio、MCP Bridge、Plugin Command / Settings 前后端闭环、更多 Provider、整体集成、代码审阅与统筹	为杨星萱的 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 可视化、Mermaid 渲染支持	与范涵宇联调 AgentEvent；与杨星萱联调函数图像及导出预览

三、范涵宇

3.1 faster-whisper

负责接入 faster-whisper，完成真实音频转写。

目标链路：

Audio
↓
faster-whisper
↓
Timestamped Transcript
↓
Knowledge Core

输出至少包含：

text
start_time
end_time
language

3.2 pyannote.audio

负责说话人分离，并与 faster-whisper 组合。

Audio
↓
pyannote.audio
↓
Speaker Segments
↓
faster-whisper
↓
Timestamped + Speaker Transcript

输出至少包含：

speaker
start_time
end_time
text

3.3 MCP Bridge

负责实现 MCP Bridge，使外部 MCP Server 可以进入现有 Plugin / Tool 体系。

External MCP Server
↓
MCP Bridge
↓
Plugin Runtime
↓
Tool Registry
↓
Agent Runtime

Agent Runtime 继续使用项目内部的：

ToolDefinition
ToolCall
ToolResult

MCP Bridge 负责协议转换。

3.4 Plugin Command Contribution

负责 Plugin Runtime 中 Command Contribution 的解析、注册和执行接口。

Plugin Manifest
↓
Plugin Runtime
↓
Command Registry
↓
Frontend Contract

吉海燕负责 Command Palette 等前端展示。

3.5 Plugin Settings Contribution

负责 Plugin Manifest 中 Settings Schema 的解析和后端配置接口。

首批支持：

string
number
boolean
select
secret reference

范涵宇负责 Manifest Parsing、Settings Schema、Plugin Storage、Secret Reference 和 Runtime Contract。

3.6 更多 Provider

继续完善 Provider Adapter。

第二阶段优先验证：

Normal Chat
Streaming
Tool Calling
Reasoning Event
Cancellation
Usage
Error Mapping

主要协议目标：

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。

比较：

FTS5
Vector Search
Hybrid Retrieval
Hybrid + RRF
Hybrid + RRF + Reranker

核心指标：

Hit@1
Hit@5
Recall@K
MRR
Citation Hit Rate
P50 Latency
P95 Latency

Dataset 至少记录：

query
expected_note_id
expected_block_id
expected_citation
tags

4.2 Agent Benchmark

负责 Agent Benchmark 测试框架、Dataset、指标统计和报告生成。

范涵宇提供：

Agent Run
Agent Event
Tool Call
Tool Result
Trace

主要指标：

Task Success Rate
Tool Selection Accuracy
Tool Argument Accuracy
Invalid Tool Call Rate
Average Steps
Average Latency
Token Usage

示例：

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：

Document AST
↓
DocumentExporter
├── HtmlExporter
├── PdfExporter
└── DocxExporter

统一接口示意：

class DocumentExporter(Protocol):
    async def export(
        self,
        document: Document,
        options: ExportOptions,
    ) -> ExportResult:
        ...

第二阶段完成：

Markdown → HTML
Markdown → PDF
Markdown → DOCX

导出时尽量保持：

标题；
段落；
列表；
表格；
图片；
引用；
代码块；
数学公式；
Mermaid；
函数图像。

Exporter 接口保留未来由 Plugin 增加 EPUB、LaTeX 等格式的扩展空间。

4.4 函数图像绘制与渲染支持

负责函数图像相关的数据解析、表达、绘制和渲染支持。

目标示例：

y = x^2
y = sin(x)
y = 2x + 1

内部建议抽象：

FunctionPlot
├── expressions
├── domain
├── range
├── axis config
└── render config

处理链：

Markdown / Structured Block
↓
Function Expression Parser
↓
Function Plot Model
↓
Renderer
↓
Editor / Preview

需要考虑：

二维函数；
多函数同图；
定义域；
坐标轴；
缩放；
图像刷新；
Markdown 中的持久化格式；
HTML / PDF / DOCX 导出时的静态渲染。

可设计独立 fenced block，例如：

```function-plot
y = x^2
y = sin(x)
```

具体语法在实现阶段冻结。

函数图像的数据结构、解析和渲染逻辑由杨星萱负责；吉海燕配合完成前端容器、布局和交互。

4.5 Retrieval 调优

根据 RAG Benchmark 数据继续调整：

Block Chunking
FTS Query
Vector Top-K
RRF Parameters
Reranker Candidate Count
Score Threshold
Metadata Filter

所有调优保留 Benchmark 前后对比数据。

五、前端展示层（吉海燕；5.4—5.5 由范涵宇负责）

5.1 Theme Import

负责 Theme Package 导入。

建议结构：

my-theme/
├── theme.yaml
├── theme.css
├── preview.png
└── README.md

流程：

Import
↓
Manifest Validation
↓
Preview
↓
Install
↓
Enable
↓
Disable
↓
Uninstall

5.2 Theme Community Format

负责制定和实现社区主题格式。

示例：

id: example-theme
name: Example Theme
version: 1.0.0
author: example
min_app_version: 0.2.0

主题继续基于：

Design Token
CSS Variables
Theme Manifest

第二阶段优先完成本地导入和社区包格式，不要求立即实现联网 Theme Marketplace。

5.3 Agent Trace 可视化

负责将 Agent Runtime 执行过程可视化。

建议结构：

User Request
│
├── Model Call
│
├── rag.search
│   ├── arguments
│   ├── duration
│   └── result
│
├── notes.read
│
├── Model Call
│
└── Completed

Trace Node 可展开查看：

Arguments
Result
Duration
Permission
Usage
Error

需要支持：

Agent Run 状态；
Tool Call 顺序；
Tool 调用耗时；
Tool Result 摘要；
Provider 调用；
Token Usage；
错误状态；
用户取消；
Citation 跳转。

5.4 Plugin Command 前端（范涵宇）

负责 Command Contribution 在前端呈现。

主要挂载：

Command Palette
Context Menu
Toolbar Action

前端使用 Plugin Contribution Contract，不直接解析插件后端 Manifest。

5.5 Plugin Settings 前端（范涵宇）

根据范涵宇提供的 Plugin Settings Schema 动态生成设置表单。

支持：

Input
Number
Switch
Select
Secret Input

Secret 类型通过 Secret API 提交，不写入 Pinia 持久化或普通配置文件。

5.6 Mermaid 渲染支持

负责在 Markdown 编辑器、预览区域和相关展示界面加入 Mermaid 渲染。

目标 Markdown：

```mermaid
flowchart LR
    A[Markdown] --> B[Renderer]
    B --> C[Diagram]
```