WeChatBridgeとは
WeChatBridge（中国語名「微信流」）は、ネイティブ対応で軽量、完全ローカル動作のmacOSツールです。macOS版WeChat 4.1.13以降が提供する「結合転送」機能を利用し、チャット履歴から生成されたTXT、画像、動画のアーカイブを、システム共有拡張機能経由でAI Agent、ローカルナレッジベース、クリップボード、その他指定したアプリに送信します。
WeChatのデータベースを読み取ったり、復号、インジェクション、WeChatプロセスの変更を行ったりすることはありません。チャット内容はWeChatが明示的にエクスポートしたファイルのみを利用し、アーカイブ、シーン設定、転送履歴はすべてローカルに保存されます。
主な機能
9つのネイティブ転送先
共有拡張機能をインストールして有効にすると、WeChatの「ほかのアプリに転送」メニューから、WeChatBridgeのメインウインドウを事前に開かずに次の送信先を直接選択できます。
- Codexに送信：ChatGPT/Codexを起動し、チャットアーカイブを貼り付けます。
- Claudeに送信：Claudeを起動し、チャットアーカイブを貼り付けます。
- Doubaoに送信：Doubaoを起動し、チャットアーカイブを貼り付けます。
- Qianwen Officeに送信：Qianwen Officeを起動し、チャットアーカイブを貼り付けます。
- WorkBuddyに送信：WorkBuddyを起動し、チャットアーカイブを貼り付けます。
- WeSightに送信：WeSightを起動し、チャットアーカイブを貼り付けます。
- Obsidianに保存：Markdownノートを作成し、元の添付ファイルを保存します。
- クリップボードにコピー：ファイルを保持し、ユーザーが手動で貼り付けます。
- カスタム送信：ユーザーが管理するmacOSアプリのリストに転送します。
シーン、スキル、ローカル履歴
WeChatBridgeでは、異なるグループチャットやタスクごとにシーンプロンプトを保存し、使用するAgentを指定できます。スキルセンターでは、互換性のあるAgentのSKILL.mdを管理できます。メインアプリにはローカルのバッチ履歴も保存され、状態の確認、再送信、内容のコピー、ファイルの場所の表示、履歴の削除が可能です。
失敗時のフォールバック
送信先アプリがインストールされていない場合や、システム権限が不足している場合でも、WeChatBridgeはファイルをクリップボードに保持するため、後続の操作を手動で完了できます。
インストール前の準備
WeChatBridgeを使用する前に、環境が次の要件を満たしていることを確認してください。
- macOS 14 Sonoma以降。
- 自動貼り付けを使用する場合は、システム設定でアクセシビリティ権限を付与します。
- WeChatのタイトルバーに表示されるチャット名を認識する場合は、画面収録権限を付与します。
- ソースからビルドする場合は、Xcode 16またはSwift 6に対応したCommand Line Toolsが必要です。
画面収録権限は、WeChatのタイトルバーに表示されるチャット名の認識にのみ使用します。画像はメモリ上でのみ処理されます。アクセシビリティ権限は、送信先アプリの起動と貼り付けの実行にのみ使用します。
方法1：リリース版をインストールする
WeChatBridge GitHub Releasesを開き、最新のDMGをダウンロードします。READMEには、Developer ID署名とApple公証を取得済みのインストーラが公開されていると記載されています。
DMGを開き、「微信流」を「アプリケーション」フォルダにドラッグします。インストーラはApple SiliconとIntel Macの両方に対応しています。
微信流を起動し、「設定 → 入口」を開きます。
Claude、Codex、Obsidian、クリップボードへのコピーなど、必要な共有入口を有効にします。
入口がシステム共有メニューに表示されない場合は、「システム設定 → 一般 → ログイン項目と機能拡張 → 共有」を開き、対応する拡張機能が有効になっていることを確認します。
方法2：ソースからビルドする
開発者は、リポジトリをクローンし、テストを実行してリリースビルドを生成できます。
git clone https://github.com/freestylefly/WeChatBridge.git
cd WeChatBridge
swift test
CONFIG=release Scripts/make-app.shビルドが完了すると、アプリはdist/微信流.appに生成されます。次のスクリプトを使うと、開発版を現在のユーザーの「アプリケーション」フォルダにインストールし、共有拡張機能を登録できます。
Scripts/install-dev-build.shインストール後、「微信流 → 設定 → 入口」を開き、必要な共有入口を有効にします。
ローカルビルドでは、キーチェーンにあるApple DevelopmentまたはDeveloper ID証明書が優先的に使用されます。利用可能な証明書がない場合はアドホック署名が使用されるため、macOSでアクセシビリティ権限の再付与が必要になる場合があります。
基本操作：WeChatのチャットをAI Agentに送信する
macOS版WeChatで対象のチャットを開きます。
処理するチャット履歴を複数選択し、「結合転送」を選びます。
「ほかのアプリに転送」を開き、「Claudeに送信」「Codexに送信」など、有効にしたAI入口を選択します。
WeChatBridgeがWeChatの生成したZIPアーカイブを受け取ります。アーカイブにはTXT、画像、動画が含まれる場合があります。
WeChatBridgeが送信先アプリを起動し、選択したシーンの指示を追加して、チャットアーカイブを自動的に貼り付けます。
たとえば、仕事用グループの議論を処理する場合は、まず「会議整理」シーンを作成し、次のようなタスク指示を保存できます。
このチャットアーカイブを基に、次の内容を整理してください。
1. 確定した決定事項
2. 未完了のタスクと担当者
3. 未解決の問題
4. 関連するリンクと添付ファイル転送時にこのシーンを選択すれば、互換性のあるAgentに一定の構成で内容を処理させることができます。シーンプロンプトはユーザー自身が管理し、実際の処理結果は使用する送信先アプリとモデルによって異なります。
基本操作：Obsidianにアーカイブする
WeChatBridgeで「Obsidianに保存」入口が有効になっていることを確認します。
WeChatで履歴を複数選択し、「結合転送」を実行します。
共有メニューから「Obsidianに保存」を選択します。
WeChatBridgeがMarkdownノートを生成し、元のZIPと関連する添付ファイルを保存します。
内容はチャット名ごとに整理されるため、ローカルナレッジベースで検索して、さらに整理できます。
この方法は、プロジェクトの議論、学習資料、グループチャット内の重要な情報を蓄積しながら、WeChatがエクスポートした元のアーカイブも保持したい場合に適しています。
クリップボードとカスタム送信先を使用する
クリップボードにコピー
すぐに別のアプリを開きたくない場合は、「クリップボードにコピー」を選択できます。WeChatBridgeがファイルを保持するため、後から送信先アプリに手動で切り替えて貼り付けられます。権限が不足している場合や、送信先アプリがインストールされていない場合にも便利なフォールバックです。
カスタムアプリに送信
内蔵の入口に加えて、独自のmacOSアプリリストを管理できます。ターミナル系アプリでは、ファイルパスのみを受け取るよう設定できるため、チャットアーカイブを既存のスクリプトやコマンドラインワークフローに渡せます。送信先は、このMacにインストールされているアプリに合わせて設定してください。
応用テクニック
タスクごとにシーンを作成する
すべてのチャットに同じプロンプトを使用しないでください。会議の要約、要件分析、顧客フィードバック、リンク抽出、学習ノートなどのシーンを個別に作成し、それぞれに適したAgentを指定できます。これにより、繰り返し入力する手間を減らし、結果の構成を統一できます。
必要な入口だけ有効にする
9つの共有入口は個別にオン・オフを切り替えられます。普段使用する送信先だけを残すと、WeChatの共有メニューをより簡潔にできます。WeChatBridgeは、まだインストールされていない送信先アプリにも印を付けるため、設定を確認しやすくなっています。
Agentのスキルを管理する
スキルセンターでは、互換性のあるAgentのSKILL.mdを管理できます。グループチャット内のリンク、動画、特定形式の資料を処理するワークフローが必要な場合は、プロジェクトに内蔵されたスキルや独自に管理するスキル設定を利用できます。ただし、対象のAgentが対応する形式をサポートしていることを事前に確認してください。
ローカル履歴で再試行する
転送後は、メインアプリでバッチの状態を確認できます。送信が中断された場合でも、履歴から再送信、内容のコピー、アーカイブファイルの場所の表示ができるため、WeChatで同じメッセージを再度選択する必要はありません。
履歴を定期的に整理する
画像、動画、元のZIPは継続的にディスク容量を消費する可能性があります。重要な内容がナレッジベースに保存されたことを確認したら、ローカル履歴から不要になったバッチを削除できます。
開発と検証のコマンド
ソースを変更した後は、リポジトリに用意されたスクリプトを使って、テスト、リソース検証、開発プレビューを実行できます。
# テストを実行
swift test
# 中国語と英語のリソースを検証
swift Scripts/check-localizations.swift
# 署名、Bundle ID、App Group、リリース設定を確認
Scripts/check-release-config.sh
# 開発版をビルド、インストールして起動
Scripts/dev-preview.shプロジェクトはSwift Package ManagerでソースとSparkle依存関係を管理しています。Scripts/make-app.shは、メインプログラムと9つのShare Extensionを組み合わせ、完全なmacOSアプリを構成します。なお、プロジェクトにはGitHub Releasesの自動更新機能に必要な設定用の枠組みがありますが、現在のソース設定では自動チェックは有効になっていません。
プライバシーとセキュリティの範囲
- WeChatが明示的にエクスポートしたチャットファイルのみを処理します。
- WeChatのデータベースを読み取らず、復号、インジェクション、プロセスの変更も行いません。
- チャットアーカイブ、シーン、履歴はすべてローカルに保存されます。
- Share ExtensionはmacOSのサンドボックス内で動作し、ネットワーク権限を持ちません。
- 画面収録はチャット名の認識にのみ使用し、画像はメモリ上でのみ処理されます。
- アクセシビリティ権限はアプリの起動と貼り付けの実行にのみ使用します。
まとめ
WeChatBridgeは、WeChatのネイティブな結合転送、AI Agent、ローカルナレッジベースを、シンプルなmacOSワークフローとしてつなぎます。一般ユーザーはDMGをインストールして共有入口を有効にするだけで利用でき、開発者はソースからビルドして拡張することもできます。シーンプロンプト、スキル管理、カスタム送信先、Obsidianへのアーカイブを活用することで、WeChatのデータベースを読み取らずに、チャット情報をより効率的に処理・蓄積できます。