Obsidian Headless 用 dry run 驗收 Publish 筆記
本文目錄
讓 Claude Code 或 Codex 更新 Markdown 後，如果還要將其中幾篇送到 Obsidian Publish，先用 ob publish --dry-run 列出變更，再核對發布清單。代理只需要改筆記時，給它指定目錄就能工作。真正需要呼叫 Obsidian 訂閱服務時，再引入 ob 和登入憑證。
Obsidian Skills 1.1.0 將多個客戶端整合到同一個外掛。稍後的官方提交把 ob-cli 改名為 obsidian-headless。安裝後可檢查外掛內的 skill 名稱，確認拿到新版操作指引。執行命令的是 Obsidian Headless 這個 open beta 用戶端，Node.js 需為 22 以上。同步遠端 vault 要有 Sync 訂閱，上傳公開站點要有 Publish 訂閱。Obsidian Skills 1.1.0 · Obsidian Headless
固定本機路徑與站點
安裝 obsidian-headless 套件並確認 ob --help 可用。先在自己控制的終端機執行 ob login，有啟用雙因素驗證時，依提示輸入代碼。下面是測試環境的指令，將路徑和站點 slug 換成自己的測試值。
vault="$HOME/vaults/publish-sandbox"ob publish-list-sitesob publish-setup --site my-test-site --path "$vault"ob publish --path "$vault" --dry-runpublish-setup 將本機 vault 連到指定站點。先確認站點清單及路徑，再執行設定。在同一台裝置上需要同步這份 vault 時，依官方建議只使用 Desktop Sync 或 Headless Sync 其中一種，先備份再設定。發布驗收可直接用準備好的本機資料夾開始。Headless Publish · Headless Sync
讓測試站點先收到一份預期清單
準備一篇可公開的測試筆記，在 frontmatter 加上 publish: true，另外放一篇無該屬性的私用測試筆記。如果公開筆記有嵌入圖片，也放一張無敏感內容的測試圖。比較 dry run 與預期的路徑，逐項檢查新增、修改或其他意外變更。若畫面沒有列出所需附件，先確認該版本與站點的附件設定，再進入正式發布。
官方預設只包含有 publish: true 的檔案。--all 擴大範圍，--yes 跳過確認。首次驗收保留互動確認，發布後從未登入的視窗打開測試站點，查公開筆記、圖片，以及私用測試筆記的預期網址。之後若要放進 CI，可以把「產生預覽清單」和「核准後發布」做成兩個工作，並以固定路徑與站點核對每次執行目標。若用 GitHub Actions 帶入憑證，可沿用 核准前檢查觸發來源、差異與 secrets 的流程。本文採用官方文件的互動登入作為起點，CI 憑證配置需依實際執行環境另行驗收。
參考資料：