Kronecker/NotesAgentic

Fork 0

Files

T

admin 6a08ad898e feat(extension): 实现插件命令与设置贡献

2026-09-02 12:52:40 +08:00

15 KiB

Raw Blame History

第二阶段团队分工表

一、阶段目标

第二阶段延续第一阶段已经形成的模块边界，重点推进多模态输入、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，完成真实音频转写。

目标链路：

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.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]
```