前言¶
在 DeepSeek Harness（DSH）里，智能体经常把说明、方案、长文写成工作区里的 .md 文件；右侧栏默认是 Markdown 预览，能看不能改时，改一个字往往要切编辑器或让智能体再跑一轮。若你还想对某段写「这里要补例子」「这句不对」，批注和正文分散在不同工具里，来回对照成本更高。
dsh-quirekit-md-editor 把右侧预览换成可编辑界面：打开的就是当前文件，改完写回同一路径；批注可以挂在段落旁，再一次性交给智能体处理。下面按定位、能力、安装与用法说明这个工作流类插件。
这是什么¶
- 名称：
dsh-quirekit-md-editor（npm 包名与安装标识一致） - 维护者：quirekit
- 分类：工作流（社区目录 SkillHub 插件页）
- 一句话：Edit Markdown where the agent writes it, and hand your comments back to the agent.——在智能体写入 Markdown 的位置编辑，并把你的评论交还给智能体。
- 编辑器本体：QuireKit MD Editor，与插件一并构建；底层是优化过的 CodeMirror 与 Lezer。
- 许可证：MIT（
package.json当前版本 0.1.2）
与「只换预览皮肤」类插件不同，README 强调它面向「智能体已经写完文档之后」：你阅读、修改，并用评论说明还要智能体改什么。
核心功能¶
编辑与文件保真¶
- 三种模式（每个标签页会记住上次选择）：Visual 隐藏标记、Markup 在当前段落显示标记、Source 显示全部源码；仍是同一份纯文本，不是从文档树反推再生成文件。
- 就地渲染：数学公式、Mermaid、PlantUML、表格、脚注、frontmatter；可插入白板、流程图、思维导图，数据写在 Markdown 里。
- 保存：输入时自动保存，或
Cmd/Ctrl+S。 - 粘贴图片：保存到文档旁的
assets/，用相对路径引用。 - 主题：跟随 DSH 的语言与明暗主题。
- 批注文件分离：评论存在独立文件中，正文除你改动的部分外保持字节级一致（README 称可用
npm run benchmark:fidelity在三种模式下校验）。
与智能体协作¶
- 选中发送：把选中文本连同文件路径与行号送到 Composer，再由你决定是否发送。
- 评论驱动：对段落加评论，可单条或一次性发送所有未关闭评论；智能体处理后会通过
resolve_document_comment将对应评论标为已解决，未处理的保持打开。 - 外部变更：智能体改文件后，若你本地无未保存内容，编辑器会同步；若有未保存内容，会询问保留哪一版，不会静默覆盖。
- Skill：自带
quirekit-markdown，便于智能体写 callout、折叠块、Mermaid、PlantUML 与数学公式。 - 截图：本地截图可按相对或绝对路径显示（仅读取图片文件）。
工具栏菜单可随时切回官方 Markdown 预览；评论侧栏可隐藏或显示。
性能（README 公布数据）¶
在约 100 万字符长文档中，中位单次按键到编辑器接受新文档约 2.4 ms（Visual），p95 约 3.0 ms；编辑器运行在独立 iframe 中，与 DSH 页面样式隔离。实测环境为 Apple M3 Max、Chromium 149，文档中称长文按键延迟随篇幅增长较平缓。
安装与启用¶
环境要求（与 package.json 的 engines.dsh 一致）：DeepSeek Harness >=0.2.2-rc.1 且 <0.3.0，Web 或桌面端均可。
Web 端安装命令（须使用资料原文，勿自行拼接 GitHub 路径）：
dsh plugin --profile web add dsh-quirekit-md-editor
安装后重启 dsh web，在 Files 标签中打开任意 Markdown 文件即可进入可编辑预览。
桌面端：打开 Plugins 页面 → Add plugin → 输入 dsh-quirekit-md-editor → 启用。
从源码安装（需自行构建，路径改为本机绝对路径）：
npm install
npm run build
dsh plugin --profile web add file:/absolute/path/to/dsh-md-editor
注意：插件以当前 DSH 进程的权限运行；安装前建议查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全策略。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
插件设置¶
在 DSH 的 Plugins 页面可配置：
- 默认编辑模式
- 是否显示模式切换
- 格式工具栏：固定、浮动或隐藏
设置保存在当前浏览器中。
典型用法¶
- 让智能体在工作区生成或更新某一
.md文件。 - 在 Files 中打开该文件，右侧使用 QuireKit 编辑器阅读；需要时切换 Visual / Markup / Source。
- 直接改正文，或在对照段落旁添加评论。
- 将选中内容发送到 Composer，或将一条/全部开放评论发给智能体。
- 智能体修改文件并 resolve 已处理的评论后，确认编辑器同步结果；若你仍有未保存编辑，按提示选择保留版本。
README 中的演示视频展示了选区发送、评论交接与 resolve、以及在同一 Markdown 下三种模式与评论的表现（部分片段有加速标注）。
适用场景与局限¶
更适合：智能体产出长 README、设计说明、技术方案后，由人在 DSH 内微调措辞、补图表，并用评论列出仍须智能体执行的修改；重视「改一个字就是一个字符 diff」、不希望预览编辑破坏原有 Markdown 写法（setext 标题、各类列表符号、原始 HTML 等）的场景。
需留意：
- DSH 版本须落在
0.2.x的 rc.1 及以上、0.3.0 以下，升级主版本前需确认插件是否仍兼容。 - 评论与正文分文件存储，协作时要清楚哪一侧是「给智能体的工单」。
- 性能数据来自作者 benchmark，与你本机硬件、文档结构（是否结构密集）会有差异。
结尾¶
dsh-quirekit-md-editor 把 DSH 右侧从只读预览变成与智能体共用的 Markdown 工作面：正文仍是你仓库里的纯文本，评论则成为可往返于编辑器和智能体之间的协作通道。若要查看简介与分类，可打开 SkillHub 目录页；安装命令、设置项与性能说明以 GitHub README 为准。
