前言¶
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 。
