dsh-fishpai 1.0.2

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 ye4wzp (MoPai 墨排 / mopai-markdown — the rendering core this project derives from)
+Copyright (c) 2026 OMSociety (FishPai 鱼排 — the DeepSeek Harness plugin)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,46 @@
+# 起源与第三方许可（NOTICE）
+
+鱼排（FishPai，仓库 `OMSociety/dsh-fishpai`）是 [MoPai 墨排 / mopai-markdown](https://github.com/ye4wzp/mopai-markdown)
+的 **fork**，在保持上游 MIT 许可与版权声明的前提下，重构为 DeepSeek Harness（DSH）插件。
+
+## 1. 上游
+
+| 项 | 内容 |
+|---|---|
+| 上游仓库 | https://github.com/ye4wzp/mopai-markdown |
+| 上游作者 | [@ye4wzp](https://github.com/ye4wzp) |
+| 许可 | MIT |
+| 本仓库 fork 自 | `main`（fork 时的上游 HEAD） |
+| 上游原样保留位置 | `legacy-site/`（去掉 `screenshots/`，其余原样：`index.html`、`css/`、`js/`、`docs/`、`DESIGN.md`、`README*.md`、`tests/` 等） |
+
+鱼排直接复用了上游两项核心资产，均为 MIT：
+
+1. **主题定义** —— 上游 `js/themes.js` 复制为本仓库 `plugin/vendor/themes.js`（换行符归一为 LF；
+   另外**有意删除了两套主题**：「金融时报（ft）」与「Medium」——前者靠整页异色底立身、公众号文章不要
+   整页底色，后者与「纽约时报」只剩字号与字体栈的差别）。上游那 13 套的原版文件仍在 `legacy-site/js/`，
+   需要逐字节比对时看那边。
+2. **渲染管线设计** —— 「先渲染 HTML，再给每个标签内联主题样式」「复制到公众号时把代码块内
+   span 的计算样式内联」「h4–h6 套 h3 样式」「外链转文末参考资料」等行为与验收标准。
+
+## 2. 打包进本仓库的运行时依赖
+
+| 文件 | 版本 | 许可 | 版权 |
+|---|---|---|---|
+| `plugin/vendor/markdown-it.min.js` | markdown-it 14.1.0 | MIT | © markdown-it contributors |
+| `plugin/vendor/highlight.min.js` | highlight.js 11.9.0 (git f47103d4f1) | BSD-3-Clause | © 2006-2023 highlight.js contributors |
+| `plugin/vendor/themes.js` | 上游同步（移除两套主题，见上） | MIT | © 2026 [@ye4wzp](https://github.com/ye4wzp) |
+| `plugin/vendor/hljs-map.json` | — | MIT（本仓库整理） | 从真实浏览器导出的 highlight.js token 计算样式表 |
+
+`markdown-it` 与 `highlight.js` 的运行时代码随本插件一起分发，故在此保留其声明。
+BSD-3-Clause 要求保留版权声明与免责声明；两处声明均完整保留在对应 `.min.js` 文件的首部注释中。
+
+## 3. 刻意**未**引入的东西
+
+| 项目 | 原因 |
+|---|---|
+| `wechatsync/Wechatsync` 及其派生的 `article-syncjs` | 上游为 GPL-3.0，派生物**没有**许可证文件（默认保留全部权利）。鱼排不做多平台分发。 |
+| `DOMPurify` | 许可为 `(MPL-2.0 OR Apache-2.0)`，MPL 是文件级 copyleft。鱼排的渲染在宿主侧完成，预览走沙箱 iframe，不需要它。 |
+
+## 4. 本仓库新增部分的许可
+
+新增代码同样以 MIT 发布，版权归 [@OMSociety](https://github.com/OMSociety)。完整条款见 `LICENSE`。

package/README.md

@@ -0,0 +1,169 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/OMSociety/dsh-fishpai/main/logo.png" alt="鱼排 FishPai" width="190">
+  <h1>鱼排 FishPai</h1>
+  <p>公众号排版工作台，长在 DeepSeek Harness 的右侧栏里。</p>
+  <p>人在侧栏改字、加批注与占位；模型用<strong>块级 diff</strong> 看懂你改了什么、想要什么；成品仍由你复制粘贴进公众号编辑器。</p>
+
+  <p>
+    <a href="https://github.com/OMSociety/dsh-fishpai/releases"><img src="https://img.shields.io/github/v/tag/OMSociety/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.1.5--rc.2-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](https://github.com/ye4wzp/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」存成文件、在浏览器里打开，看到的就是面板右侧那个样子。
+
+## 快速开始
+
+**方式一：从 GitHub 装（推荐）**
+
+```powershell
+# 1) 先停掉 dsh web（运行中的服务会锁住依赖，装完再起）
+dsh plugin --profile web add "github:OMSociety/dsh-fishpai#v1.0.2"
+# 2) 重新启动 dsh web
+```
+
+**方式二：clone 到本地再装**
+
+```powershell
+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` → 正文出现 `![](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` |
+
+## 开发
+
+```powershell
+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，不进依赖）：
+
+```powershell
+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 <导出的 article.html> --json    # isValid: true 即通过
+```
+
+## 支持与致谢
+
+- 如果这个插件对你有帮助，欢迎点亮 Star，有问题和建议请提交 [Issue](https://github.com/OMSociety/dsh-fishpai/issues) 或 [Pull Request](https://github.com/OMSociety/dsh-fishpai/pulls)。
+- 想改主题或加一套自己的：主题定义集中在 `plugin/vendor/themes.js`，加完跑 `npm run test:golden:regen` 重生成 golden
+
+- [MoPai 墨排 / mopai-markdown](https://github.com/ye4wzp/mopai-markdown)（MIT）：渲染管线、主题、以及"复制到公众号"的整套行为都来自这里
+- [markdown-it](https://github.com/markdown-it/markdown-it)（MIT）与 [highlight.js](https://github.com/highlightjs/highlight.js)（BSD-3-Clause）：随包内嵌的 vendor 资产
+- [DeepSeek Harness](https://github.com/deepseek-ai/dsh)：插件、右侧栏与技能的宿主
+
+## 许可证与作者
+
+[MIT](LICENSE)。上游 `mopai-markdown` © 2026 [@ye4wzp](https://github.com/ye4wzp)；本仓库新增部分 © 2026 [@OMSociety](https://github.com/OMSociety)。

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# DSH bundle layer: mount the host plugin that registers the fishpai tools,
+# the /fishpai/api routes, and the bundled `fishpai` skill.
+#
+# `name` is the module specifier DSH imports (the vendor/loader resolves
+# `options.name`), so it must be the published package name, not the repo name.
+# The same package also declares its browser half through `dsh.client` +
+# `exports["./client"]`, which the client module loader serves as one bundle.
+- insert:
+    - id: fishpai
+      name: dsh-fishpai