在 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
