このプロジェクトについて

wx-cliは、macOS上で微信のローカルデータベースを直接読み取り、ユーザーとAIエージェントの両方がチャット履歴、連絡先、グループチャット、メディアメッセージにアクセスできるようにします。データはデフォルトでローカルマシンに留まり、アップロードやクラウドへの依存は不要です。 中核機能は以下の通りです: 1. データベース復号:LLDBフックを介してPBKDF2呼び出しをキャプチャし、生の鍵を抽出します。データベース全体の復号と増分復号をサポートし、すべての微信データベースをカバーします。 2. メッセージ照会と検索:連絡先、グループチャット、時間範囲、メッセージタイプに基づいて履歴メッセージを照会可能。すべての会話にわたるグローバルキーワード検索をサポート。時間範囲を指定して、すべての会話メッセージを一度に読み取ることも可能(タイムライン)で、記憶補完やバッチ処理に適しています。 3. リアルタイム購読:コマンドラインで新しいメッセージを継続的にリッスン、またはSSE(/api/v1/events)を介して、新しいメッセージをエージェントや他のプログラムにリアルタイムでプッシュします。 4. エクスポートとメディア処理:会話をJSONまたはテキストとしてエクスポート可能。画像の復号、音声の抽出(ffmpegが必要)、動画番号動画の復号をサポートします。 5. エージェント連携:npx skills add でインストール可能なエージェントスキルが組み込まれており、Claude Code、Codex、Cursorなどのツールにインストール後、wx-cliの機能を理解し呼び出すことができます。 6. REST APIサービス:常駐サービスが開かれているデータベースを再利用し、sessions、contacts、messages、timeline、search、media、eventsなどのエンドポイントを提供。トークン認証とリモートアクセスをサポート。照会コマンドはサービス実行時に自動的にAPIを再利用します。 7. プライバシー制御:アカウントごとに、指定した連絡先、グループチャット、または特定のタグを持つ連絡先を非表示にできます。照会や購読時にこれらは自動的にフィルタリングされます(全文検索は除く)。 プラットフォーム要件はmacOS(arm64 / Apple Silicon)、微信バージョン4.1.7以上です。鍵抽出にはSIP(System Integrity Protection)を無効にし、DevToolsSecurityと開発者グループ権限を有効にする必要があります。プロジェクトはRustで記述されており、プリコンパイル済みバイナリとソースコードからのコンパイルによるインストールの2種類を提供します。 プロジェクト構造は、中核復号ライブラリ、鍵抽出と保存、CLIエントリ、データベース照会、メディア復号、リアルタイム監視、アカウントコンテキスト解析、プラットフォームパス管理などの独立したクレートで構成されています。