前言¶
DSH 是插件化的运行环境，时间线里已经有不少本地笔记，但如果想把一篇 Markdown 排成公众号文章、再发到 X／知乎／小红书，通常要切到浏览器或专门的排版工具。joeseesun 维护的 qiaomu-publish-dsh 就是针对这个断点做的：它是原版 Qiaomu Publish 的 DeepSeek Harness 版本，直接复用原版的预览、42 个主题、排版控件、封面编辑与发布窗口。下面介绍它的功能、安装与边界。
这是什么¶
一句话定位：一个 DeepSeek Harness 插件，把 Markdown 笔记排成公众号文章、X 文章、知乎草稿和小红书图文。
- 维护者：joeseesun
- 分类：工作流
- 当前版本：v0.1.3，README 声明兼容 DeepSeek Harness
0.2.2-rc.1 - 许可证：MIT；目录页标注 1 stars
- 原始代码来自 qiaomu-publish 的
4fbeae30017e1db4be95b7454620b30eae47ada8，产品 CSS 保持字节一致
它不自己重写排版逻辑，而是把原版的预览、主题、封面和发布窗口接到 DSH 的插件体系上，宿主边界和两处深色可读性修复有单独记录（docs/ADAPTATION.md）。
核心功能¶
一、编辑与排版。原版实时预览、双向滚动、主题搜索与逐篇排版都保留；字号、字体、行距、段距、主色、缩进、代码样式沿用原控件。Markdown 文件、草稿恢复、附件导入、重命名保留主题、外部修改同步均可用；保存时会检查文件版本，避免覆盖其他编辑器的修改。
二、内容与导出。支持表格、提示块、脚注、代码、Wiki/Markdown 图片与笔记嵌入；内置 MathJax 和 Mermaid，公式与图表可随正文导出为图片。可复制公众号富文本、独立 HTML、长图 PNG，标题封面、图片选择、裁剪与字体配色沿用原版。
三、发布。公众号支持多账号、直连／固定 IP 中转／自建 Bridge、新建和更新草稿、上传图片与封面、发布前检查、笔记属性记录。X／知乎／小红书沿用 Qiaomu Clipper v1 的本机交接，六套小红书模板、分页、配色、字体、移除卡片、正文与话题限制均保留。
安装与启用¶
安装前先确认系统满足条件：README 要求 DeepSeek Harness 0.2.2-rc.1、Node.js 24.9 或更新。package.json 的 engines 字段反过来列得更宽：node >=22，dsh 支持 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5 || 0.2.2-rc.1。以哪个为准取决于你要按 README 的最新适配还是 package 声明的完整兼容表，二者不完全一致。
安装分两步：先取包并核对摘要，再交给插件管理加载。
# 从 Releases 下载 tgz 和 SHA256SUMS，并核对摘要
dsh plugin --profile desktop add /absolute/path/qiaomu-publish-dsh-0.1.3.tgz
也可以用 Harness 插件管理直接安装本地 tgz。装完后打开侧栏「乔木排版」。不需要连接任何发布账号就能完成编辑、排版和导出。
笔记目录与原配置迁移¶
默认工作目录在 $DSH_HOME/qiaomu/qiaomu-publish-dsh/notes，未设置 DSH_HOME 时用 ~/.dsh。在这个目录保存 Markdown 和附件，或通过「导入」选择文件。目录内相对图片路径保持不变；单篇 Markdown 上限 2 MB，单个附件上限 32 MB。
插件配置可以指定 notesDir、dataDir 的绝对路径。选择已有笔记目录后，保存和发布记录写入所选笔记，未选择的原 Obsidian 仓库不会被修改。嵌入最多 8 层，同名附件无法唯一确定时会明确报缺图，阻止不完整导出。
「导入」支持原 Publish 或乔木 Agent 的 data.json，保留主题、逐篇样式、账号配置与凭据 ID。需要注意：不同宿主的凭据库不能直接共享，要在原版连接设置里重新填 AppSecret／令牌；原 Obsidian 凭据不会删除。新凭据使用 macOS Keychain、Windows DPAPI 或 Linux Secret Service，配置 JSON 不保存密钥；Linux 需要可用的 secret-tool 和 Secret Service。
发布到平台¶
公众号窗口走官方 API 或用户配置的中转服务，不操作微信客户端或微信内嵌页面。发布按钮只创建／更新草稿，不会直接群发。
X、知乎、小红书需要先装好 Qiaomu Clipper，并在目标浏览器登录平台。交接时 Host 临时监听 127.0.0.1 随机端口，使用一次性取件令牌和会话令牌，完成、取消、超时或卸载后关闭。插件不会在编辑或预览时自动发送内容。
验证范围与限制¶
构建、包契约、原版业务逻辑及宿主边界都有测试。macOS 上已在独立 Harness profile 实测原版预览、公式／图表图片、HTML／长图导出、重命名、外部同步、发布窗口和六套卡片 PNG。
但有几处明确未覆盖：公众号真实账号和外部平台草稿发送没有在迁移验收中执行，传输与交接用的是 fixture 和真实本机 socket 检查，不能替代真实账号验收；Windows/Linux 凭据实现尚未在对应系统实机验证。逐项记录见 ADAPTATION，Harness 0.2.2-rc.1 适配与实测边界见 docs/DSH-0.2.2-RC1.md。
本地开发¶
npm ci
npm run check
npm pack
浏览器卡片验收页用 node scripts/qa-cards.mjs，然后在 build/cards-qa 起本地静态服务器。
适用场景与注意¶
适合已经用 DSH 管理笔记、且需要从 Markdown 直接产出公众号图文和多平台草稿的开发者。想先离线排版导出、暂不接任何账号的场景最省事，因为编辑和导出不需要网络和凭据。
务必注意两点：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证；发布类功能依赖额外的 Qiaomu Clipper 本机服务和平台登录态，跨平台凭据尚未在 Windows/Linux 实机验证。
结尾¶
qiaomu-publish-dsh 的价值在于把原版 Qiaomu Publish 已经打磨过的排版与发布链路搬进 DSH，避免再开一个编辑器。目录页见 https://www.skillhub.cn/plugins/joeseesun/qiaomu-publish-dsh，源码与安装包见 https://github.com/joeseesun/qiaomu-publish-dsh 。
