前言¶

在 DeepSeek Harness（DSH）里和模型对话，有价值的内容往往散落在多轮消息里：一段排查思路、一份接口约定、一次实验结论。事后想整理成笔记，常见做法是复制到外部编辑器，或依赖带数据库的笔记服务。前者打断工作流，后者又引入额外依赖。

下面介绍 dsh-md-notes，一个面向 DSH Web 用户的第三方笔记插件。它把笔记存成本地 .md 文件，提供全屏管理器与编辑器，支持从对话一键摘录，也可通过 @ 把笔记内容注入模型上下文；可选 Git 同步做备份与多端协作。维护者为 XieZongChen，在 SkillHub 社区目录中归类为「记忆」。

这是什么¶

dsh-md-notes 是 DSH 的第三方 bundle 插件，当前版本 0.8.0（MIT 许可证）。它在 DSH Web 侧栏提供笔记入口，在每个工作区的 .dsh-notes/ 目录下以纯 Markdown 文件保存内容，不依赖数据库或云端存储。

适用对象：希望在 DSH 内完成「对话 → 笔记 → 再引用」闭环、并偏好文件化、可 Git 管理的开发者。

核心功能¶

笔记管理与编辑¶

侧栏底部（Settings 上方）有笔记入口，点击进入全屏笔记管理器。按工作区分组展示笔记列表，支持折叠分组；可新建、编辑、预览 Markdown、保存与删除（页内确认）。笔记文件位于各工作区目录下的 .dsh-notes/，可用任意编辑器直接打开。

从对话摘录¶

助手回复旁（复制按钮旁）有笔记图标。点击后选择已有笔记或当场新建，即可将本轮对话（用户问题 + 最终回答）追加到笔记，以「会话标题 – 时间戳」为分节标题。文本直接从对话抓取，无需等待；推理过程不纳入摘录。分节标签随 DSH 语言本地化（中/英）。

在聊天中引用笔记（@）¶

在输入框输入 @ 可跨工作区选取笔记；发送时宿主将笔记内容注入模型上下文，模型可直接引用，无需额外要求读文件。

Git 同步（可选）¶

通过配置开启 Git 模式：

• shared：所有工作区共用一个远程仓库，按工作区分子目录；
• own：每个工作区单独配置 URL、分支与子路径。

Push 为镜像同步（含删除）；Update 为拉取并在三方冲突时确认；打开笔记时可自动 pull。管理器内显示 Git 同步卡片（「已同步」/「N 条未推送」及远端有新提交提示）。克隆目录位于 $DSH_HOME/md-notes-repos/。

其他能力¶

• 写入互斥：同一条笔记在多会话间写入时加锁，侧栏、选择器与管理器保持同步直至写完。
• 设置面板：DSH Settings → MD Notes，可配置模式、仓库 URL/分支/子路径、自动 pull、提交作者等。
• 主题与 i18n：跟随 DSH 亮/暗主题与中英文界面；npm 有新版本时显示黄色「有更新」标签。

路线图（见仓库 docs/TODO.md）包括：可视化 Git 冲突处理、笔记搜索/目录/wiki 链接、编辑器脏状态提醒与快捷键等。

安装与启用¶

前提：已安装 dsh CLI，目标 profile 为 web。

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-md-notes

安装或升级后需重启 dsh web——bundle 层与客户端包元数据会缓存在进程中，不重启变更不会生效。

升级：

dsh plugin --profile web update dsh-md-notes

卸载：

dsh plugin --profile web remove dsh-md-notes

卸载不删除已有笔记文件。插件以当前 dsh 进程权限运行，安装前建议查阅 GitHub 仓库 源码与 MIT 许可证。

兼容性（据 README）：插件 0.8.0 已在 deepseek-harness 主线 0.1.1-rc.2 上验证；运行时依赖从 dsh 安装解析，未固定到特定主线 commit。

典型用法¶

1. 按上文命令安装插件，重启 dsh web。
2. 新建笔记：侧栏点笔记入口 → 在工作区行点 +（生成「Untitled note \<日期>」标题）→ 编辑 → Save。
3. 摘录对话：在任意助手回复下点笔记图标 → 选目标笔记或新建 → Write to note。
4. 引用笔记：聊天输入框输入 @ 选笔记，发送后内容进入模型上下文。

可选：在 profile 的 cordis.patch.yml 中覆盖插件配置，例如：

- id: md-notes
  config:
    route: '/plugins/md-notes'   # HTTP API 前缀，默认即可
    gitMode: 'off'               # 'off' | 'shared' | 'own'
    gitAutoPull: true            # 打开笔记前是否 pull

插件无环境变量与密钥类配置；网络仅本机 loopback API，无外部请求与遥测。

适用场景与注意¶

适合：在 DSH Web 内做对话沉淀、按工作区组织技术笔记、用 Git 备份或跨机同步 Markdown 的开发者。

注意：

• 仅支持 web profile，需重启后生效。
• 笔记绑定工作区；需先在侧栏创建工作区，并保证 .dsh-notes 目录可写。
• Git 同步为可选；默认 gitMode: 'off' 时笔记仅存本地。
• 安装后若界面无变化，先重启 dsh web；图标异常可硬刷新页面。
• 插件由社区维护，SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。

小结¶

dsh-md-notes 把 DSH 对话与本地 Markdown 笔记连在一起：管理编辑在插件内完成，摘录与 @ 引用减少切换成本，Git 同步则便于备份与协作。当前 GitHub 约 13 stars，可在社区目录与仓库获取安装说明与更新。

• 社区目录：https://www.skillhub.cn/plugins/XieZongChen/dsh-md-notes
• GitHub：https://github.com/XieZongChen/dsh-md-notes