geekjourneyx/obsidian-md2wechat

MD2WeChat Publisher – これは何ですか

MD2WeChat Publisher は、Obsidian デスクトッププラグインで、Obsidian で markdown 記事を書いた後、AI 機能付きエージェント（例：Claude、Codex、WorkBuddy）に WeChat 向けにフォーマットを依頼し、結果を横並びでプレビューし、その後外部の md2wechat CLI を使って WeChat 公式アカウントの下書きを作成できるようにします。

重い処理（markdown → WeChat HTML 変換、画像アップロード、下書き作成）は、別途インストールされた md2wechat CLI ツール（npm でグローバルにインストール）が担当します。プラグイン自体は、Obsidian 内の UI と、エージェントおよび md2wechat スキルとのやり取りを行うグルーコードのみを提供します。

---

コア機能

機能	動作方法
書きながらプレビュー	ノートの横に「公众号排版」パネルを開きます。エージェントがフォーマットを終了すると、プレビューには実際に WeChat に送信されるレイアウトが正確に表示されます。
エージェント非依存	プラグインは独自の AI サービスを提供しません。標準の obsidian-md2wechat スキルをサポートする任意のローカルエージェント（Claude Code、Codex、WorkBuddy、ZCode など）が使用可能です。
公開前に確認	対象の公式アカウント、サムネイル画像、タイトル、著者、要約を指定します。Create Draft をクリックしてから、プラグインが md2wechat を呼び出して実際に WeChat 上で下書きを作成します。
バージョン管理付き下書き	どの記事、アカウント、バージョンが既に送信されたかを記録するため、過去の下書きを確認でき、重複送信を回避できます。
ライブリフレッシュ	ソースの markdown を編集後、Refresh Layout をクリックすると、同じテーマ/フォント設定でエージェントを再実行し、下書きを作成せずにプレビューを更新できます。

---

インストール手順（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. エージェントの接続
   • Obsidian の公式コマンドライン機能を有効化。
   • プラグインパッケージから skills/obsidian-md2wechat ディレクトリをエージェントのスキルフォルダにコピー。
   • エージェントが md2wechat スキルを実行できることを確認（内部で CLI を呼び出します）。

---

一般的なワークフロー

1. 公開したい markdown ノートを開く。
2. 公众号排版 サイドパネルを開く。
3. エージェントに話しかける（または入力）：「排版 Obsidian 当前文章，完成后展示给我。」 — エージェントが md2wechat スキルを実行し、markdown を変換、画像をアップロード、プレビューを返却。
4. パネルの More メニューからテーマやフォントサイズを調整；必要に応じてフォーマット済み HTML をコピー。
5. 満足したら Create Draft をクリックし、WeChat アカウントとサムネイル画像を選択、メタデータを確認。その後、プラグインが md2wechat を呼び出して WeChat バックエンドに下書きを作成。
6. パネルには下書きの記録（アカウント、タイムスタンプ、バージョン）が表示されます。後からリフレッシュや再フォーマットが可能で、重複は発生しません。

---

互換性と制限

• 対応 OS – macOS でテスト済み；Windows/Linux は未検証。
• Obsidian バージョン – デスクトップ 1.12.7+ 必須；モバイルクライアントは非対応。
• エージェント要件 – ローカルコマンド実行と obsidian-md2wechat スキルをサポートする必要あり。プラグインは特定のエージェントをバンドルしない。
• プラグイン内に API キーなし – すべての認証情報は md2wechat CLI の設定で管理される。

---

開発と貢献

• npm ci でビルド、npm run check で lint、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 エージェント、WeChat 公式アカウントの公開パイプラインをつなぐブリッジです。markdown で書く、ローカルエージェントにフォーマットを依頼、Obsidian 内でプレビュー、手動確認後に WeChat 下書きとして送信——プラグイン内に API キーを露出させることなく実現します。