dsh-notes: DeepSeek Harness Notes Workspace Plugin

前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在智能体开发或对话过程中，我们需要一块独立的区域来记录笔记，且要求与中央对话区域互不干扰。dsh-notes 插件在 DSH 界面右侧栏提供了一个独立的“笔记”工作区，旨在解决左侧栏/右栏重复、笔记树失真以及 Agent 与笔记割裂的问题。

它是什么¶

dsh-notes 是 DeepSeek Harness 的笔记工作区插件。

定位: 右侧栏独立笔记区域 + CodeMirror 6 实时预览编辑器。
维护者: DynaMyhome
许可证: MIT
核心价值: 笔记即普通 Markdown 文件，按工作区组织，拥有类似 Typora/Obsidian 的编辑手感。

安装与启用¶

插件需要构建产物并安装到当前 profile。请使用 plugin_manager 工具，不要手动编辑 profile 配置文件。

# 1) 构建客户端产物
cd "<你克隆 dsh-notes 的目录>"
npm run setup && npm run build

# 2) 装进当前 profile
#    action: install_bundle, target: <本目录绝对路径>

安装完成后，右侧栏会出现「笔记」入口。

核心功能¶

1. 右侧栏独立笔记区域¶

右侧栏被划分为两部分：左侧是可收起的笔记树，右侧是 Markdown 编辑器。这是与左侧“会话/工作区”和中央“DSH 对话”的明确区分。
- 笔记树: 显示当前工作区的笔记索引。
- 编辑器: 基于 CodeMirror 6，支持预览/源码切换。

2. 编辑器能力¶

预览模式: 标记默认隐藏，文字直接编辑。标题分级、列表、引用、双链、真表格都在原位渲染，光标进入才展开源码。
公式支持: 行内公式 $...$ 和行间公式 $$...$$，使用 MathML 渲染，零字体依赖。
真表格: 表格单元格支持就地编辑，不撑列、不挪位。
代码卡片: 代码块渲染为圆角卡片，带语言名、语法着色和复制按钮。
自动保存: 默认 800ms 自动保存，切换模式或关闭标签页前会自动提交未保存内容。

3. 笔记树与组织¶

按工作区: 一个工作区对应一棵树。笔记本质是普通 .md 文件，需在 frontmatter 中包含 dsh-note-id。
纳入管理: 工作区内的未标记文件会自动归入「未归类」，可在此面板进行批量纳入或忽略操作。
分类右键: 支持重命名和删除分类。删除分类仅改变树归属，不触碰磁盘文件。

4. Agent 原生集成¶

插件为 Agent 增加了一个 knowledge 工具。Agent 可以通过此工具管理笔记（登记、注销、归类、重扫），内容操作继续沿用既有文件工具。

5. 大纲与快速打开¶

大纲: 切换到“大纲”视图可查看标题树，支持拖拽重排。
快速打开: 在编辑器区域按下 Ctrl/Cmd+P（或 Ctrl/Cmd+K）可快速打开笔记。

6. 回收站¶

右键删除笔记会将其移入工作区内的 .dsh-notes/.trash/ 目录。只有点击“彻底删除”才会真正 unlink 磁盘文件。

典型用法¶

创建笔记¶

在笔记树或分类右键菜单中选择“新建”。笔记本质是普通 Markdown 文件，建议添加 dsh-note-id: "uuid" 前言。

Agent 操作¶

在 Agent 对话中，使用新增的 knowledge 工具。例如：
- knowledge register <note-id>: 将笔记登记为知识。
- knowledge unfiled: 查看未归类列表。

文件管理¶

删除: 右键点击分类或笔记 -> Delete -> 移入回收站。
恢复: 在树工具栏点击 🗑 图标进入回收站，选择恢复或彻底删除。

数据存放与配置¶

存储位置¶

插件数据（分类树、忽略规则、回收站）默认跟随工作区，存储在 <工作区>/.dsh-notes/ 目录下。
- 索引文件: index.json，包含树结构、归属关系等。
- 回收站: .trash/，存放被删除的文件。

关键配置项¶

键	默认值	含义
`notesDir`	`notes`	笔记根目录（相对于工作区根）
`storeScope`	`workspace`	数据存放范围：`workspace` 跟随工作区，`home` 放 `$DSH_HOME/knowledge`
`autosaveMs`	800	自动保存静默时长，0 表示关闭
`watch`	true	文件监视，用于检测改名/删除

切换行为¶

不重载: 切走右侧栏的标签或收起整栏，组件不卸载，切回来时内容保留，不会重新拉取。
换机器: 只需拷贝工作区目录，.dsh-notes 里的索引和回收站会自动跟随。

注意事项¶

图标来源: 插件的图标与标题元数据不来自插件代码，而是由 DSH 启动时通过 dsh-app-boot 读取 package.json 中的配置。
权限: 插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。
彻底删除: 只有在回收站中点击“彻底删除”才会真正从磁盘移除文件。