dsh-fishpai

dsh plugin --profile web add dsh-fishpai

<div align="center">

<img src="https://raw.githubusercontent.com/OMSociety/dsh-fishpai/main/docs/logo.png" alt="鱼排 FishPai" width="190">

<h1>鱼排编辑器 FishPai</h1>

<p>公众号排版工作台，长在 DeepSeek Harness 的右侧栏里。</p>

<p>人在侧栏改字、加批注与占位；模型用<strong>块级 diff</strong> 看懂你改了什么、想要什么；成品仍由你复制粘贴进公众号编辑器。</p>

<p>

<a href="https://www.npmjs.com/package/dsh-fishpai"><img src="https://img.shields.io/npm/v/dsh-fishpai?color=4f6ef7&label=version" alt="Version"></a>

<a href="https://github.com/deepseek-ai/dsh"><img src="https://img.shields.io/badge/DSH-%3E%3D0.2.0--rc.2_%3C0.3.0--0-4f6ef7" alt="DSH"></a>

<a href="LICENSE"><img src="https://img.shields.io/github/license/OMSociety/dsh-fishpai?color=4f6ef7" alt="License"></a>

<a href="https://github.com/OMSociety/dsh-fishpai/stargazers"><img src="https://img.shields.io/github/stars/OMSociety/dsh-fishpai?color=4f6ef7" alt="Stars"></a>

<a href="https://github.com/OMSociety/dsh-fishpai/issues"><img src="https://img.shields.io/github/issues/OMSociety/dsh-fishpai?color=4f6ef7" alt="Issues"></a>

</p>

<a href="#这是什么">这是什么</a> • <a href="#核心特性">核心特性</a> • <a href="#效果">效果</a> • <a href="#安装方式">安装方式</a> • <a href="#模型工具">模型工具</a> • <a href="#面板快捷键">面板快捷键</a> • <a href="#开发">开发</a> • <a href="#许可证与作者">许可证与作者</a>

</div>

这是什么

鱼排编辑器把 Markdown 排成内联样式 HTML：整段粘进微信公众号编辑器就得到成品排版。

它同时是一个人在回路里的改稿台——面板与模型看的是同一篇文档，谁改了什么一目了然。

渲染内核与主题来自 MoPai 墨排 / mopai-markdown（MIT），

本仓库把同一套管线重构为 DSH 插件。署名与许可链条见 [NOTICE.md](NOTICE.md)。

核心特性

特性 · 说明

Markdown 快捷键 · 选中后 Ctrl/⌘+B 加粗、+I 斜体、+K 链接、+Alt+1/2/3 标题、+Shift+8/7 列表；列表里回车自动续写

图片直接粘进来 · 截图 Ctrl/⌘+V 粘入（也可以拖进来）→ 存到文档同级的 assets/，正文自动插入引用，预览立刻可见

实时预览 + 手机宽度 · 打字 300ms 后预览跟着变；栏位够宽左右并排，窄了自动单栏；可切 375px 看公众号真实观感

批注与占位 · 光标所在段落加批注（模型下次 fishpai_read 就能看到）；正文里写 <!-- 鱼排: 这里补个过渡 --> 也一样；点批注「定位」直接选中它引用的那段

块级 diff 与局部改稿 · 模型只改该改的块，你的其它改动原样保留；写入必须带 base_revision，不符先拒并回带"自你上次写入以来的改动"

冲突不丢字 · 模型与你同时改时给出「用我的覆盖 / 看 AI 的版本」，采用 AI 版会先把你的草稿存进历史

主题与主题色 · 11 套主题，按"是否适合公众号"分组；主题色只对「默认公众号」生效（用不上的取色行会自动隐藏），有风险的主题直接提示原因；另有工作目录级的「自定义主题」（模型可在内置主题上只改几个槽位）

复制与导出 · 复制为 text/html + text/plain 双格式；本地图片内嵌 base64，粘过去不用手动重传；也能导出成自包含 .html

五个模型工具 · fishpai_open / read / write / render / theme，配一份教模型怎么用的技能

效果

<table>

<tr>

<td width="64%" align="center"><img src="https://raw.githubusercontent.com/OMSociety/dsh-fishpai/main/docs/panel-fishpai.png" alt="鱼排编辑器面板：左侧源码、右侧实时预览" width="540"></td>

<td width="36%" align="center"><a href="https://raw.githubusercontent.com/OMSociety/dsh-fishpai/main/docs/wechat-fishpai.jpg"><img src="https://raw.githubusercontent.com/OMSociety/dsh-fishpai/main/docs/wechat-fishpai.jpg" alt="复制后粘进公众号编辑器的实际效果" width="235"></a></td>

</tr>

<tr>

<td align="center">面板截图：左边写 Markdown，右边实时预览；主题、字体、字号、脚注开关都在顶部一行</td>

<td align="center">粘贴进公众号后并发布后的实机截图</td>

</tr>

</table>

同一份 HTML 用「导出 HTML」存成文件、在浏览器里打开，看到的就是面板右侧那个样子。

安装方式

从 npm 安装

# 先停掉正在运行的 DSH（运行中的服务会锁住依赖，装完再起）
dsh plugin --profile <profile> add "dsh-fishpai"

装好后刷新一下浏览器页面，「鱼排编辑器」从右侧栏的引导页打开——只重启宿主不够，客户端产物是页面加载时取的；入口与布局按会话记忆，新会话第一次要点一次（模型调 fishpai_open 时也会自动打开）。

本插件零运行时依赖，不受 minimumReleaseAge 影响。

装完怎么用

1. 让模型 fishpai_open 打开一篇 Markdown → 右侧栏应自动弹出鱼排并显示正文与预览

2. 在面板里打字 → 预览跟着变；选中文字按 Ctrl/⌘+B → 变成 加粗，Ctrl+Z 能撤销

3. 截图后 Ctrl/⌘+V → 正文出现 ![](assets/…)，预览里能看到图，文档同级多出 assets/ 目录

4. 光标放在某段上点「＋批注」写一句要求，再到正文里写一行 <!-- 鱼排: 这里补个过渡 -->

5. 让模型 fishpai_read → 它应当说出你改了哪一块、批注要求什么、占位在哪一行

6. 让模型 fishpai_write（mode: "patch"）→ 只有那块变了，你其它改动原样保留

7. 点「复制到公众号」→ 粘进公众号编辑器，版式正确（标题 / 列表 / 引用 / 表格 / 信息卡片）

模型工具

工具 · 作用 · 关键参数

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、theme_spec（临时自定义主题，不落盘）、publish（false = 预览原样形态）、embed_images

fishpai_theme · 工作目录级的「自定义主题」（一套，set / show / clear）：模型在某套内置主题上只覆盖想改的槽位，面板主题列表里就是那一个占位 · action、theme_spec

模型的标准动作顺序是 open → 等你改 → read → write → 你点复制；技能 fishpai

（随插件注册）里写明了这套纪律与排版口径，模型会在需要时自己读。

面板快捷键

快捷键 · 作用 · 快捷键 · 作用

Ctrl/⌘ + B · 加粗 · Ctrl/⌘ + Alt + 1/2/3 · 一级 / 二级 / 三级标题

Ctrl/⌘ + I · 斜体 · Ctrl/⌘ + Alt + 0 · 正文（去掉标题）

Ctrl/⌘ + E · 行内代码 · Ctrl/⌘ + Shift + . · 引用

Ctrl/⌘ + K · 链接 · Ctrl/⌘ + Shift + 8 / + 7 · 无序 / 有序列表

Ctrl/⌘ + Shift + X · 删除线 · Tab / Shift + Tab · 缩进 / 反缩进

Ctrl/⌘ + S · 保存 · Ctrl/⌘ + Shift + C · 复制到公众号

Ctrl/⌘ + V · 粘贴图片（或拖进来） · Ctrl/⌘ + Enter · 添加批注（在批注框里）

编辑器右上角的「快捷键」按钮里就是这份表（Mac 显示 ⌘、Windows 显示 Ctrl）。

数据放在哪

位置 · 内容 · 说明

你指定的 .md · 文档正文 · 普通 Markdown，任何编辑器都能改；鱼排不往正文里塞标记

.fishpai/docs/ · 没指定路径时新建的文档 · fishpai_open 省略 path 就落在这里，按标题命名

<文档同级>/assets/ · 粘贴进来的图片 · 相对路径引用（assets/xxx.png），文档搬走图也跟着走

.fishpai/state/ · 主题、revision、baseline、批注 · 按文档路径哈希命名；删掉会丢批注、历史与「模型上次写入的基线」（正文不动，但模型暂时看不出你改了什么）

.fishpai/history/ · 历史快照（最多 50 份） · 面板「历史」抽屉里可一键回滚

.fishpai/theme.json · 「自定义主题」（工作目录级，只有一套） · fishpai_theme set 写、clear 删；改坏了静默退回「默认公众号」

.fishpai/.gitignore · 忽略 state/、history/、theme.json · 插件自建，只追加缺失的行（你写的改动一字不动）；正文与图片是否入库由你自己决定，主题想跟仓库走就用 git add -f

开发

npm install        # 只有 devDependencies（esbuild / typescript / @types/react / @types/react-dom / @deepseek-ai/cordis）
npm test           # 全量回归：golden + 站点对照 + 块/diff/批注/补丁 + 宿主红线 + 微信兼容层 + 主题规格 + 主题图标内联核对 + bundle + 快捷键 + 挂载 + 客户端 store 时序 + 接口层（api）
npm run typecheck  # 客户端 TSX 类型检查
npm run build      # 重新打包 lib/client.js（改完客户端必须跑，并提交产物）
npm run check:build  # 确认 lib

…(truncated)