前言¶
在 DeepSeek Harness（DSH）里写文档、改 README、维护插件说明时，常见做法是：从工作区文件树找到 .md，复制到外部编辑器，保存后再贴回或切回终端。多一步窗口切换，也容易和 Harness 里的对话、任务上下文脱节。
下面介绍社区插件 dsh-md-editor（维护者 Zhang1025681484）：在官方工作区文件树里点击 Markdown 文件，右侧边栏直接打开可编辑标签页，基于 Monaco，带自动保存，无需单独页面或来回粘贴。
这是什么¶
dsh-md-editor 是 DSH 客户端类插件（社区目录分类：客户端）。一句话定位：为 Harness 右侧边栏提供可编辑的 Markdown 标签页——从工作区文件树打开 .md，在侧边栏内编辑并写回磁盘。
- 仓库：github.com/Zhang1025681484/dsh-md-editor
- 社区目录：skillhub.cn/plugins/Zhang1025681484/dsh-md-editor
- 许可证：MIT（见仓库
LICENSE） - 版本（package.json）：1.0.0
- 引擎要求：DeepSeek Harness >= 0.2.0-rc.2（在
0.2.0-rc.2上开发与验证）
插件以当前 DSH 进程权限运行；安装前建议自行查看源码与许可证。
核心功能¶
以下能力均来自仓库 README，仅作已核实功能的归纳。
就地打开与编辑¶
- 注册独立的 Sidebar 标签类型，匹配
*.md/*.markdown，官方文件树点击后直接在右侧打开可编辑标签，而非只读预览。 - Monaco 编辑器：行号、Markdown 语法高亮、自动换行。若 Monaco 无法加载，会降级为带行号的纯文本
textarea（仍可编辑）。 - Monaco 0.52.2 打包在
vendor/monaco（约 13 MB），可完全离线使用。
保存与重载¶
- 自动保存：停止输入约 1.5 秒后写盘；Ctrl/Cmd+S 立即保存。
- Reload：丢弃本地未保存修改，从磁盘重新读取。
预览交接¶
- Preview 按钮将同一文件交给官方文档标签（kind
text），使用内置渲染（Markdown / 代码 / 纯文本）。若已安装dsh-md-studio，还可配合 Mermaid、KaTeX 等预览能力。
本插件不提供内嵌 Markdown 渲染，定位是编辑器而非阅读器。
安装与启用¶
安装命令以 README 原文为准。将 <your-profile> 换成你的 DSH profile。
# from npm (once published)
dsh plugin --profile <your-profile> add dsh-md-editor
# from GitHub
dsh plugin --profile <your-profile> add github:Zhang1025681484/dsh-md-editor
# from a local directory
dsh plugin --profile <your-profile> add file:/absolute/path/to/dsh-md-editor
Electron 桌面版中，desktop profile 由应用自身管理，CLI 无法向其安装插件——请在 Settings → Plugins → Add plugin 中粘贴本地路径或包名。
完成安装后：
- 完全重启 DSH（宿主侧 JavaScript 模块按进程缓存）。
- 在插件列表中确认插件已启用。
典型用法¶
- 打开右侧边栏 → Files 标签。
- 点击任意
.md文件 → 在 Markdown Editor 标签中打开。 - 编辑；停顿约 1.5 秒，或按 Ctrl/Cmd+S。
- 写入成功后，状态栏显示
已保存（版本 …）。
需要只看渲染效果时，用 Preview 跳转到官方文档标签，或配合 dsh-md-studio 等预览类插件。
适用场景与注意事项¶
适合谁¶
- 在 DSH 工作区内频繁改 Markdown（项目文档、插件 README、任务笔记）的开发者。
- 希望编辑与 Harness 同屏、减少外部编辑器切换的用户。
已知限制（使用前请知晓）¶
- 无冲突保护：保存会无条件覆盖。设计中的
replaceIfVersion守卫当前被禁用（Remote 层返回的version字符串中mtimeNs段在传输中被改写，会导致每次保存被误判为 stale conflict）。若要以磁盘为准，请用 Reload。 - 不渲染 Markdown：编辑用本插件；阅读/预览用 Preview 或
dsh-md-studio。 - 大文件截断：超过约 5 000 行/页 × 40 页（约 200 000 行）会被截断，状态栏会警告；不要保存已被截断的内容。
- 界面文案：当前为硬编码中文，尚未接入客户端 locale 服务。
- 调试日志：插件目录会写入
.client-beacon.log（调试 beacon），可安全删除。
生态说明¶
DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。本插件星标以社区目录展示为准（当前为 0），不代表功能不可用，安装与排错仍以 GitHub README 为准。
结尾¶
dsh-md-editor 把「点文件 → 编辑 → 写回工作区」收进 Harness 右侧边栏，适合把 Markdown 维护留在同一开发环境里完成。安装、限制与架构细节见 GitHub 仓库；社区索引见 SkillHub 目录页。
