鱼排 FishPai

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

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

这是什么 • 核心特性 • 效果 • 快速开始 • 模型工具 • 面板快捷键 • 开发 • 许可证

🐟 这是什么

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

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

渲染内核与主题来自 MoPai 墨排 / mopai-markdown（MIT）， 本仓库把同一套管线重构为 DSH 插件。署名与许可链条见 NOTICE.md。

✨ 核心特性

📷 效果

面板截图：左边写 Markdown，右边实时预览；主题、字体、字号、脚注开关都在顶部一行	粘贴进公众号后并发布后的实机截图

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

🚀 快速开始

方式一：从 GitHub 装（推荐）

# 1) 先停掉 dsh web（运行中的服务会锁住依赖，装完再起）
dsh plugin --profile web add "github:OMSociety/dsh-fishpai#v1.0.0"
# 2) 重新启动 dsh web

上面的 #v1.0.0 钉在已发布的版本上；想跟进最新就把尾巴换成 #main（最新的排版规则与兼容层都在这里）。

方式二：clone 到本地再装

git clone https://github.com/OMSociety/dsh-fishpai D:\WorkSpace\dsh-fishpai
dsh plugin --profile web add "github:OMSociety/dsh-fishpai"

装好后刷新一下浏览器页面，右侧栏就会多出「鱼排编辑器」入口（官方右侧栏的 + 菜单 / 引导页里也能找到）——只重启宿主不够，客户端产物是页面加载时取的。 本插件零运行时依赖，不受 minimumReleaseAge 影响；客户端产物 lib/client.js 已入库，不需要本地构建。

装完怎么用

1. 让模型 fishpai_open 打开一篇 Markdown → 右侧栏应自动弹出鱼排并显示正文与预览
2. 在面板里打字 → 预览跟着变；选中文字按 Ctrl/⌘+B → 变成 **加粗**，Ctrl+Z 能撤销
3. 截图后 Ctrl/⌘+V → 正文出现 ![](https://github.com/OMSociety/dsh-fishpai/blob/HEAD/assets/…)，预览里能看到图，文档同级多出 assets/ 目录
4. 光标放在某段上点「＋批注」写一句要求，再到正文里写一行 <!-- 鱼排: 这里补个过渡 -->
5. 让模型 fishpai_read → 它应当说出你改了哪一块、批注要求什么、占位在哪一行
6. 让模型 fishpai_write（mode: "patch"）→ 只有那块变了，你其它改动原样保留
7. 点「复制到公众号」→ 粘进公众号编辑器，版式正确（标题 / 列表 / 引用 / 表格 / 信息卡片）

🧩 模型工具

模型的标准动作顺序是 open → 等你改 → read → write → 你点复制；技能 fishpai （随插件注册）里写明了这套纪律与排版口径，模型会在需要时自己读。

📋 面板快捷键

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

📄 数据放在哪

🛠 开发

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

目录与「改东西去哪」：

plugin/index.mjs        宿主入口：注册工具 + /fishpai/api 路由 + fishpai 技能
plugin/core/            渲染内核（ESM，零依赖）：runtime / markdown / render / diff / notes / patch / theme-info / theme-spec
plugin/host/            宿主侧：工具契约、HTTP 路由、文档存储、图片、自定义主题
plugin/vendor/          上游 themes.js + markdown-it 14.1.0 + highlight.js 11.9.0 + hljs-map.json
client/                 客户端源码（TSX → esbuild 打成 lib/client.js）
lib/client.js           客户端 bundle（入库；dsh plugin add 不做构建）
skills/fishpai/         鱼排技能：教模型怎么选主题、怎么按块改稿
legacy-site/            上游 SPA 原样留存，便于复核渲染一致性
test/                   golden、站点对照、块/diff/批注/补丁、宿主红线、微信兼容层、主题规格、bundle 形态、快捷键、真实 Cordis 挂载、客户端 store 时序

用微信官方校验器复验（需要本机 Chrome，不进依赖）：

git clone --depth 1 https://github.com/wechatjs/verify-article-structure-spec "$env:TEMP\was"
cd "$env:TEMP\was\cli"; $env:PUPPETEER_SKIP_DOWNLOAD='true'; npm install
$env:PUPPETEER_EXECUTABLE_PATH='C:\Program Files\Google\Chrome\Application\chrome.exe'
npx tsx src/index.ts <https://github.com/OMSociety/dsh-fishpai/blob/HEAD/导出的 article.html> --json    # isValid: true 即通过

⭐ 支持

• 如果这个插件对你有帮助，欢迎点亮 Star ⭐，有问题和建议请提交 Issue 或 Pull Request。
• 想改主题或加一套自己的：主题定义集中在 plugin/vendor/themes.js，加完跑 npm run test:golden:regen 重生成 golden

🙏 致谢

• MoPai 墨排 / mopai-markdown（MIT）：渲染管线、主题、以及"复制到公众号"的整套行为都来自这里
• markdown-it（MIT）与 highlight.js（BSD-3-Clause）：随包内嵌的 vendor 资产
• DeepSeek Harness：插件、右侧栏与技能的宿主

📜 许可证

MIT。上游 mopai-markdown © 2026 ye4wzp；本仓库新增部分 © 2026 OMSociety。