dsh-md-notes：DeepSeek Harness 的本地 Markdown 笔记管理插件

dsh-md-notes 是 DeepSeek Harness（DSH）的笔记管理插件（DSH plugin），由 XieZongChen 开发，采用 MIT 许可证。它解决的是 DSH Web 用户无法便捷保存对话内容的问题：在侧边栏新增「MD Notes」入口，并在每条助手回复旁提供「Add to note」操作，让你一键把对话追加到本地纯文本 .md 文件中，之后可在任意编辑器中继续编辑。核心能力包括：侧边栏笔记管理器（列表 + 编辑/预览）、助手消息操作（追加对话到笔记）、纯文件存储（无数据库、无云）、界面语言跟随 DSH 设置（中/英）。

dsh-md-notes 这个 DSH plugin 支持哪些核心特性？

• 侧边栏笔记入口：点击底部（设置上方）的笔记图标，可新建、编辑、预览笔记。
• 助手消息操作：在每条助手回复的复制按钮旁，点击笔记图标，选择目标笔记（或即时新建），即可将用户问题与回答以带时间戳的区块追加到笔记。
• 纯 .md 文件存储：笔记默认保存在 <cwd>/.dsh-notes/ 目录，可直接用任意编辑器打开修改。
• 语言自适应：界面文案跟随 DSH 的语言设置（中文/英文）。

dsh-md-notes 怎么安装？

前提：已安装 dsh CLI，目标 profile 为 web。安装命令如下：

dsh plugin --profile web add github:xiezongchen/dsh-md-notes

安装后需重启 dsh web（bundle 层与客户端包元数据在进程中有缓存）。升级与卸载命令分别为 dsh plugin --profile web update dsh-md-notes 和 dsh plugin --profile web remove dsh-md-notes，同样需要重启生效。

dsh-md-notes 如何配置？

所有配置项均为插件 Config 键，可在 profile 的 cordis.patch.yml 中覆盖（patch 会替换整行 config）：

- id: md-notes
  config:
    root: '/abs/path/to/notes'   # 笔记目录；默认 <cwd>/.dsh-notes
    route: '/plugins/md-notes'   # HTTP API 前缀；默认即可

root 指定笔记存储目录（.md 文件 + meta.json），route 为插件提供的 HTTP API 前缀，同时托管图标（<route>/icon.svg）。该插件无环境变量、无密钥。

dsh-md-notes 兼容哪些 DeepSeek Harness 版本和平台？

插件版本 0.2.0，要求 dsh CLI（含 plugin 子命令）与 web profile。最近验证于 2026-08-16，对应 deepseek-harness 主线（dsh CLI 0.1.0-rc.x 时代）。插件未固定到特定主线提交，如需固定组合可在安装时锁定插件版本。运行时依赖（@deepseek-ai/*、react）声明为可选 peer 依赖，从 dsh 安装中解析。

dsh-md-notes 的权限与数据存储方式？

• 文件系统：仅读写配置 root 目录下的纯 .md 文件（及 meta.json 标题/更新时间 sidecar），不触碰其他内容。
• 网络：仅提供 loopback HTTP API（浏览器 ↔ 本地 dsh 服务器），无外部网络请求。

查看更多 DSH 插件，访问 dsh-plugin.org