在 DeepSeek Harness (DSH) 的生态里，插件是解决具体场景问题的标准方式。如果你在调试一个需要特定排版（如微信公众号）的 Agent，手动排版效率低，直接让模型输出 HTML 又容易丢失样式。omsociety/dsh-fishpai 插件把排版工作台长在了 DSH 的右侧栏，把“人在回路”改稿和“模型看懂改动”这两个动作整合在一起。
这是什么¶
鱼排编辑器 是一个插件，核心价值是把 Markdown 渲染成内联样式的 HTML，可以直接复制到微信公众号编辑器使用。它同时是一个“人在回路”的改稿台：面板与模型共享同一份文档，模型通过块级 diff 看懂你改了哪里，保留你的批注和占位符。渲染内核与主题来自 MoPai 墨排 / mopai-markdown（MIT）。
安装与启用¶
从 npm 安装。
# 先停掉正在运行的 DSH（运行中的服务会锁住依赖，装完再起）
dsh plugin --profile <profile> add "dsh-fishpai"
安装完成后，刷新浏览器页面。插件零运行时依赖，不受 minimumReleaseAge 影响。
核心特性¶
- Markdown 快捷键：支持加粗 (
Ctrl/⌘+B)、斜体、链接、标题、列表等快捷操作。 - 图片直接粘贴：支持
Ctrl/⌘+V粘贴截图或拖拽图片，自动存入同级assets/目录。 - 实时预览：打字 300ms 后预览同步更新，支持 375px 手机宽度切换。
- 批注与占位：支持光标批注和 HTML 注释，方便模型理解你的修改意图。
- 块级 diff 与局部改稿：模型仅修改指定块，保留你的其他改动。
- 冲突处理：模型与用户同时修改时，提供合并选项，不丢字。
- 主题与主题色：内置 11 套主题，支持自定义主题色。
- 复制与导出：支持复制为
text/html+text/plain双格式，图片 Base64 内嵌。
模型工具¶
插件提供了五个模型工具，用于文档的打开、读取、写入、渲染和主题管理。
| 工具 | 作用 | 关键参数 |
|---|---|---|
fishpai_open |
打开 / 新建文档，并在右侧栏弹出面板 | path（可省扩展名，自动补 .md）、markdown（新建时写正文）、theme |
fishpai_read |
改稿前必做：读块级 diff、批注、占位、图片提醒与块 id | doc_key、include |
fishpai_write |
改稿。必须带 base_revision；优先按块改 |
doc_key、base_revision、mode（patch / replace）、patches[{block_id 或 block_index, op, markdown}] |
fishpai_render |
导出可粘贴 / 归档的自包含 HTML（本地图片内嵌 base64） | out_path（可省扩展名）、theme、embed_images |
fishpai_theme |
工作目录级的“自定义主题” | action、theme_spec |
典型用法¶
模型的标准动作顺序是 open → 等你改 → read → write → 你点复制。
- 打开文档：让模型调用
fishpai_open打开一篇 Markdown，右侧栏应自动弹出鱼排面板。 - 人工改稿：在面板里打字、加粗、粘贴图片（
Ctrl/⌘+V）或添加批注。 - 模型读取：调用
fishpai_read，模型应能识别你改了哪一块、批注要求什么。 - 模型写入：调用
fishpai_write(mode: patch)，模型只改该改的块，你的其他改动原样保留。 - 复制成品：在面板按
Ctrl/⌘+Shift+C复制 HTML，手动粘贴进公众号编辑器即可。
数据存放¶
- 正文：你指定的
.md文件。 - 图片：粘贴的图片存放在
<文档同级>/assets/目录。 - 状态与历史：
.fishpai/state/存储批注、版本号；.fishpai/history/存储历史快照（最多 50 份）。 - 自定义主题：
.fishpai/theme.json。
适用场景与注意¶
本插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。署名与许可链条见仓库中的 NOTICE.md。适合需要精细控制排版且希望模型能理解人工干预的场景。
GitHub 仓库：omsociety/dsh-fishpai