前言¶
給 DSH 加一個插件時，常見需求是把手裏的 Markdown 筆記按原習慣發到自己的博客：沿用原來的分類、草稿，本地圖片和音視頻直接進博客對象存儲。DeepSeek Harness 的理念是「一切皆插件」，社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，本文介紹的插件就掛在這個目錄裏。
下面介紹的 joeseesun/qiaomu-blog-publisher-dsh 是原版喬木博客發佈器的 DeepSeek Harness 版本，維護者爲 joeseesun，在社區目錄中歸入「工作流」，當前 1 個星標。它保留原版的發佈彈窗、分類與設置頁，適合已經在使用 Qiaomu Blog、想在 Harness 裏繼續發佈的人。
這是什麼¶
一句話定位：把 Markdown 筆記發佈到自己的 Qiaomu Blog 的 DSH 插件，直接使用原 Obsidian 插件的發佈彈窗、分類與設置頁。倉庫版本 0.1.3，針對 DeepSeek Harness 0.2.2-rc.1 做兼容更新，許可證 MIT。
它解決的問題是：不用複製筆記到別的目錄、不必手工轉存媒體、不丟失原插件的分類和草稿流程，在 Harness 側欄裏完成發佈。
核心功能¶
- 標題自動從 frontmatter、一級標題、文件名依次提取，可在原發布窗口修改。
- 獲取博客分類，選擇草稿或直接發佈；顯示上傳進度、成功數量、失敗原因和重試入口。
- 標準 Markdown 圖片與 Wiki 嵌入，自動上傳本地圖片、音頻、視頻到博客 R2，轉存第三方圖片並改寫鏈接。
- Markdown 工作目錄、文件導入、草稿恢復、保存衝突保護與外部修改同步。
- 原版連接設置、API Token 測試；Token 存入系統安全憑據庫。
安裝與啓用¶
先看環境要求。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.5 || 0.2.2-rc.1。
安裝沒有走命名拼接的快捷命令，而是從 Releases 下載 tgz 和 SHA256SUMS，校驗後安裝：
dsh plugin --profile desktop add /absolute/path/qiaomu-blog-publisher-dsh-0.1.3.tgz
路徑需替換爲實際下載位置。Releases 地址：https://github.com/joeseesun/qiaomu-blog-publisher-dsh/releases。
啓用後打開側欄的「喬木博客發佈」，導入 Markdown，在設置裏填寫自己的博客地址和 API Token，點擊「發佈到博客」。默認創建草稿；選擇「直接發佈」會公開文章。
典型用法¶
1、導入。支持 Markdown、媒體和原博客插件的 data.json。媒體放在 attachments，Markdown 中保持相應路徑；完整目錄可以直接配置爲 notesDir。
2、配置目錄。默認筆記目錄爲：
$DSH_HOME/qiaomu/qiaomu-blog-publisher-dsh/notes
未設置 DSH_HOME 時爲 ~/.dsh。插件配置項 notesDir 指向明確選擇的筆記目錄，dataDir 指定插件狀態目錄，均使用絕對路徑。單篇 Markdown 上限 2 MB，附件上限 32 MB，不跟隨工作目錄內軟鏈接。
3、遷移舊配置。導入舊配置會把 Token 遷入 macOS Keychain、Windows DPAPI 或 Linux Secret Service；新的狀態 JSON 不保存 Token，原配置不會刪除。Linux 需要 secret-tool 和 Secret Service。
4、發佈。默認草稿，需要公開時在發佈窗口選擇「直接發佈」。媒體上傳失敗時沿用原版行爲：文章可以創建，插件會報告失敗數量，之後需要檢查文章中的媒體鏈接。
適用場景與注意¶
適合已經在用 Qiaomu Blog、且博客支持原 Qiaomu Blog API 的用戶。如果只是偶爾發文章，手工拖拽可能比搭插件更直接。
需要留意的幾點：
- 倉庫自述測試只發送給本機 fixture，沒有提交到真實博客或 R2；Windows / Linux 憑據沒有對應系統實機驗收，具體邊界見倉庫的遷移記錄與兼容驗證記錄。
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼和許可證（MIT）。原版凍結來源爲
5d41358f707320c2f56016bf62327eb60d8668b8，打包依賴見倉庫 THIRD_PARTY_NOTICES。 - 倉庫發佈的是校驗後的 tgz，不直接提供
dsh plugin add github:owner/repo形式的安裝命令，不要用名稱自行拼接。
結尾¶
這套插件的價值在於把原發布流程原樣搬進 Harness，分類、草稿、媒體轉存和憑據安全沿用原版行爲，適合長期以 Markdown 爲工作稿、以 Qiaomu Blog 爲發佈站點的場景。
目錄頁：https://www.skillhub.cn/plugins/joeseesun/qiaomu-blog-publisher-dsh
倉庫：https://github.com/joeseesun/qiaomu-blog-publisher-dsh
需要我先覈對某個功能細節，或調整哪部分篇幅？
