geekjourneyx/obsidian-md2wechat

MD2WeChat Publisher – 是什麼

MD2WeChat Publisher 是一個 Obsidian 桌面端插件，允許你在 Obsidian 中撰寫 markdown 文章，呼叫一個 支援 AI 的 Agent（例如 Claude、Codex、WorkBuddy）將其格式化為 WeChat 適配樣式，側邊預覽效果，並透過外部 md2wechat CLI 工具將格式化後的內容作為 WeChat 公眾號草稿發布。

核心任務——markdown 轉 WeChat HTML、圖片上傳、草稿建立——由獨立的 md2wechat CLI 工具（透過 npm 全域安裝）完成。插件本身僅提供 Obsidian 內的 UI 和與 Agent 及 md2wechat 技能通訊的膠水程式碼。

---

核心功能

功能	工作方式
邊寫邊預覽	在筆記旁邊開啟「公眾號排版」面板。Agent 完成格式化後，預覽將顯示將傳送至 WeChat 的精確佈局。
Agent 無關	插件不內建 AI 服務。任何支援標準 obsidian-md2wechat 技能的本地 Agent（如 Claude Code、Codex、WorkBuddy、ZCode 等）均可使用。
發布前確認	你可選擇目標公眾號、封面圖、標題、作者和摘要。只有點選 建立草稿 後，插件才會呼叫 md2wechat 在 WeChat 上實際建立草稿。
版本感知草稿	插件會記錄已傳送的文章、帳號和版本，以便檢視歷史草稿並避免重複提交。
即時刷新	編輯來源 markdown 後，點選 刷新佈局 會以相同主題/字型設定重新執行 Agent，更新預覽但不建立新草稿。

---

安裝流程（詳見 README）

1. 安裝 md2wechat CLI

   npm install -g @geekjourneyx/md2wechat
   md2wechat version --json
   md2wechat config init --json   # 運行向導
   md2wechat config validate --json
   

   CLI 必須至少為版本 3.5.0。
2. 新增 Obsidian 插件
   • 從最新 GitHub 發布版下載 zip（非原始碼歸檔）。
   • 解壓後將 md2wechat-publisher 資料夾放入 <vault>/.obsidian/plugins/。
   • 重啟 Obsidian，在 設定 → 第三方插件 中啟用 MD2WeChat Publisher。
3. 連接 Agent
   • 啟用 Obsidian 官方命令列功能。
   • 將插件包中的 skills/obsidian-md2wechat 目錄複製到 Agent 的技能資料夾中。
   • 確保 Agent 可執行 md2wechat 技能（其內部會呼叫 CLI）。

---

典型工作流程

1. 打開你想要發布的 markdown 筆記。
2. 打開 公眾號排版 邊側面板。
3. 向 Agent 說話（或輸入）：「排版 Obsidian 當前文章，完成後展示給我。」 — Agent 執行 md2wechat 技能，轉換 markdown，上傳圖片，並返回預覽。
4. 透過面板的 更多 菜單調整主題或字型大小；如需可複製格式化後的 HTML。
5. 滿意後點選 建立草稿，選擇 WeChat 帳號和封面圖，確認元資料，插件呼叫 md2wechat 在 WeChat 後端建立草稿。
6. 面板現在顯示草稿記錄（帳號、時間戳、版本）。後續可刷新或重新格式化文章，而不會建立重複草稿。

---

相容性與限制

• 支援的系統 – 已在 macOS 上測試；Windows/Linux 尚未驗證。
• Obsidian 版本 – 需要桌面版 1.12.7+；行動端客戶端不支援。
• Agent 要求 – 必須支援本地命令執行和 obsidian-md2wechat 技能。插件不捆綁任何特定 Agent。
• 插件中無 API 金鑰 – 所有憑證均由 md2wechat CLI 設定管理。

---

開發與貢獻

• 使用 npm ci 建構，npm run check 檢查，npm run package 打包（需本地有 md2wechat CLI）。
• 發布自動化：推送標籤（如 v2.0.0）會觸發 GitHub Actions，產生 zip 並上傳至發佈頁。
• 貢獻遵循專案 AGPL-3.0-Only 許可證，並遵守 dev.md、RELEASE.md 和 AGENTS.md 中的指南。

---

TL;DR

MD2WeChat Publisher 是連接 Obsidian、AI Agent 與 WeChat 公眾號發佈流程的橋樑。用 markdown 寫作，讓本地 Agent 格式化，Obsidian 內預覽，經手動確認後推送到 WeChat 草稿——整個過程無需在插件中暴露 API 金鑰。