前言¶
DeepSeek Harness（DSH）的插件生态强调“一切皆插件”。在长期的项目开发或复杂的智能体调试中，对话记录往往散落在聊天窗口中，难以管理和复用。dsh-noteboard 插件提供了一种解决方案：在会话视图中提供一个工作区级的无限画布，将对话内容提取为结构化的 Markdown 便签，并支持通过引用气泡将便签发回给 AI 进行处理。
安装与启用¶
本插件依赖 DSH 环境。在安装前，请确保你的环境满足要求：
- DSH 版本：>=0.2.0-rc.2
- Node.js 版本：>=22.19.0
通过官方插件目录安装：
dsh plugin --profile web add dsh-noteboard
dsh web
npm 安装的是预构建产物，无需在本地执行构建脚本，也不会触发 pnpm 的构建授权确认。
核心功能¶
无限画布与便签管理¶
插件提供无限画布，支持平移、缩放、网格吸附以及多画布布局的切换。便签以 Markdown 文件形式存储，每个文件包含 frontmatter 元数据，支持七种颜色和亮暗双主题。
从对话采集¶
在对话视图中，选中一段文字，会出现采集工具栏。你可以选择将原文直接“存入画布”，或者选择“AI 提炼”生成精简的便签。
来源回链¶
每张便签都会记录其来源会话。点击便签上的“打开对话”按钮，可以直接跳转回原文位置，并高亮显示对应的文字片段。
发回给 AI¶
便签可以拖拽至输入框，以引用气泡的形式发送给 AI。系统会对引用内容进行长度校验，累计超过 32,000 字符的引用气泡会阻止发送。
整理与工具¶
支持通过标签胶囊进行聚焦过滤、搜索标题/正文/标签，以及找回离板便签。插件注册了 12 个模型工具和 5 个内置工作流，用于自动化处理便签数据。
典型用法¶
-
采集与提炼
在对话中框选关键内容，选择“AI 提炼”。插件会根据配置的提炼要求（标题、标签、正文长度）生成便签。 -
批量提取
使用noteboard-extract工作流，可以按条件从会话中筛选内容并保存为便签。 -
引用与跳转
点击便签的“来源”或“打开对话”跳转至原文；处理完毕后，将便签拖回输入框，AI 可以基于这些结构化引用进行后续操作。
AI 工具与工作流¶
插件提供了丰富的 AI 工具集：
12 个模型工具：
- canvas_add_note：创建便签
- noteboard_query：搜索或读取便签全文
- noteboard_create：批量创建便签（最多 200 张）
- noteboard_update：修改便签，支持按颜色分组批量着色
- noteboard_layout：按标签重排、对齐或分布便签
- noteboard_sessions：查找来源会话
- noteboard_read_session：读取会话原文
- noteboard_add / noteboard_remove：便签增删操作
- noteboard_save_as：保存画布布局
- noteboard_history / noteboard_restore：历史记录与恢复
5 个内置工作流：
- noteboard-extract：按条件筛选并提取便签
- noteboard-organize：按主题归类、加标签、重排
- noteboard-compare：比较方案、权衡优缺点
- noteboard-actions：将想法拆解为行动项
- noteboard-synthesize：合并重复便签或综合结论
注意事项与限制¶
- 文件格式：画布文件采用 JSON Canvas 1.0 格式，内容与布局分离，可由文本编辑器管理。
- 单用户：插件假设单用户环境，不支持跨进程文件锁和实时协同。
- 无 UI 边缘/组：目前不提供连接线和成组的 UI，但文件格式已预留位置。
- 操作机制：不监听文件变更，每次 RPC 操作前整体重读。
- 历史记录：默认保留最近 50 条操作记录。
- 配置变更：旧的 prompt 配置不再生效，请使用“额外提炼要求”。
结语¶
dsh-noteboard 将 DSH 的对话流与结构化知识管理结合，通过便签和画布实现了信息的沉淀与复用，适合需要在长期会话中整理思路、追踪决策的开发者。
