AIパーソナル・ラーニング
と実践的なガイダンス
サイバーナイフ用ドローイングミラー

Chatlog: WeChatのチャットログを抽出・照会するオープンソースツール

はじめに

Chatlogは、WeChatのローカルデータベースからチャットログを抽出してクエリすることに特化したオープンソースツールです。WeChatバージョン3.xと4.0をサポートし、WindowsとmacOSの両システムをカバーする。ユーザーは、コマンドライン、ターミナルインターフェース、またはHTTP API操作から、チャットログ、連絡先、グループチャット、最近の会話を見ることができます。 エムシーピー チャットデータを素早く分析するためにAIアシスタント(例えばChatWise)と統合することができるSSEプロトコル。プロジェクトはApache-2.0ライセンスに基づいており、コードはオープンで安全かつ信頼性が高く、WeChatデータの整理や分析を必要とするユーザーに適している。

チャットログ:オープンソースツールのWeChatチャットログの抽出とクエリ-1


 

機能一覧

  • WeChatのローカルデータベースからチャットログ、連絡先、グループチャット、最近の会話を抽出。
  • WeChatバージョン3.xと4.0をサポートし、複数のデータ形式と互換性があります。
  • 直感的な操作のためのターミナル・インターフェイス(TUI)とコマンドライン・ツールを提供。
  • チャットログ、連絡先、グループチャット、その他の情報のクエリをサポートするHTTP APIを内蔵。
  • MCP SSEプロトコルをサポートし、互換性のあるAIアシスタントとのシームレスな接続を実現。
  • ユーザーがローカルデータに安全にアクセスできるように、データ復号化機能を提供する。
  • オープンソースコードで、ユーザーはセキュリティチェックや機能のカスタマイズが可能。

 

ヘルプの使用

チャットログの目的は、ユーザーが簡単にWeChatチャットログを抽出し、照会できるようにすることです。下記は、ユーザーがすぐに使い始められるよう、詳細なインストールと使用ガイドです。

設置プロセス

Chatlogは技術的な操作を必要としますので、基本的な知識をお持ちの方に適しています。以下はインストール手順です:

  1. 環境を整える
    以下のソフトウェアがコンピュータにインストールされていることを確認してください:

    • 行くインストール方法については、Goのウェブサイトをご覧ください。
    • エックスコード(macOSユーザー):App Storeからダウンロードしてキーを抽出する。
    • WeChatクライアント: インストールされ、ログインしていることを確認し、チャットログをあなたのコンピュータに移行する必要があることを確認します。
  2. ソースからのインストール
    ターミナルを開き、以下のコマンドを実行してChatlogをインストールします:

    go install github.com/sjzar/chatlog@latest
    

    インストール後、Chatlogはコマンドラインから直接実行できます。

  3. コンパイル済みバージョンのダウンロード
    ソースからコンパイルしたくない場合は、GitHub Releasesにアクセスし、お使いのシステム(WindowsやmacOSなど)用にコンパイル済みのバージョンをダウンロードしてください。ダウンロードしたら、解凍して使ってください。
  4. macOSユーザーはSIPをオフにする
    macOSシステムの場合、セキュリティ上の制約から、以下のように、キーを抽出する際にSIPを一時的に無効にする必要がある:

    • リカバリーモードに入る:
      • インテル・マック電源オフ後に長押し Command + R キーを押し、Apple ロゴが表示されるまでコンピュータの電源を入れます。
      • アップル・シリコン・マックコンピュータの電源を切った後、ブートオプションが表示されるまで電源ボタンを押し続けます。
    • ターミナルを開き、こう入力する:
      csrutil disable
      
    • システムを再起動する:
      sudo reboot
      
    • キーを抽出した後、SIPを再有効化することをお勧めします。 csrutil enable (そして再起動する)。
  5. WeChatチャット記録の移行
    携帯電話のWeChatで操作:

    • 私」-「設定」-「一般」-「チャット履歴の移行とバックアップ」-「移行」-「PCに移行」を開きます。
    • 指示に従って、チャット記録をコンピュータのWeChatクライアントに転送してください。この操作は携帯電話のデータには影響しません。

主な機能

チャットログはWeChatのチャットデータを管理するための複数の方法を提供します:

  • データの抽出と解読
    Chatlogを実行すると、WeChatデータベースへのパスを求めるプロンプトが表示されます。 ~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/ (Windowsの場合はWeChatのインストール・ディレクトリ)。パスを入力した後、以下のコマンドを実行してデータを復号化する:

    ./chatlog decrypt
    

    復号化されたデータは、照会や表示に使用できる。

  • ターミナルインターフェース(TUI)の操作
    ターミナルインターフェースを起動する:

    ./chatlog
    

    操作方法:

    • 矢印キーを使ってメニューを移動する。
    • プレス Enter オプションを選択してください。
    • プレス Esc 前のレベルに戻る。
    • プレス Ctrl+C 退場手続き。
      端末のインターフェイスには、チャットログや連絡先などの情報が表示され、素早く見るのに適している。
  • コマンドラインクエリ
    マイクロソフトのデータキーを入手する:

    ./chatlog key
    

    特定のデータを照会する(チャットログなど)

    ./chatlog decrypt
    

    コマンドラインはバッチ操作やスクリプト処理に適している。

  • HTTP API の使用法
    HTTPサービスを開始する(デフォルトのポート5030):

    ./chatlog
    

    ブラウザからのアクセス http://127.0.0.1:5030 データを表示したり、APIを使用してクエリを実行します:

    • チャットログ::
      GET /api/v1/chatlog?time=2023-01-01&talker=wxid_xxx&limit=100&offset=0&format=json
      

      パラメータの説明

      • time例:時間範囲 2023-01-01 もしかしたら 2023-01-01~2023-12-31.
      • talkerチャットID、WeChat ID、ニックネーム、グループチャットIDをサポートします。
      • limitレコード数を返します。
      • offsetページングオフセット。
      • format出力フォーマットjsonそしてcsv (またはテキスト)。
    • 連絡先リスト::
      GET /api/v1/contact
      
    • グループチャット一覧::
      GET /api/v1/chatroom
      
    • 最近のセッション::
      GET /api/v1/session
      
  • ブラウザビュー
    HTTPサービスを開始した後、ブラウザーを開き、以下のサイトにアクセスする。 http://127.0.0.1:5030.このページは、チャット記録、連絡先、その他のコンテンツを表示し、時間やオブジェクトによるソートをサポートし、直感的に操作できます。

注目の機能操作

チャットログのユニークさは、そのオープンソース設計とAI統合にあります:

  • MCP SSEプロトコルの統合
    ChatlogはAIアシスタント(ChatWise、Claudeなど)と接続するためのMCP SSEプロトコルをサポートしています。セットアップの手順

    • チャットログのHTTPサービスを開始します。
    • AIアシスタントの設定に新しいツールを追加する:
      • タイプsse.
      • URL:http://127.0.0.1:5030/sse.
      • 自動実行ツール」にチェックを入れる。
    • 設定後、AIアシスタントは直接チャット記録を照会できる。例えば、ChatWiseで "Find chats with Xiaoming yesterday "と入力すると、アシスタントは対応するレコードを返します。
    • AIツールがMCP SSEをサポートしていない場合は、次のようにします。 mcp-プロキシ リクエストを転送する。例えば クロード デスクトップで編集 config.json::
      {
      "mcpServers": {
      "mcp-proxy": {
      "command": "/path/to/mcp-proxy",
      "args": ["http://localhost:5030/sse"],
      "env": {}
      }
      }
      }
      
  • オープンソースとカスタマイズ
    ChatlogはApache-2.0ライセンスに基づいており、セキュリティチェックや機能変更ができるようにコードが公開されています。例えば

    • 新しいエクスポート形式(CSVなど)を追加します:
      • コンパイラ src/export.go輸出ロジックを追加する。
      • うごきだす go build リコンパイルする。
    • クエリー速度を最適化する:
      • 修正 src/query.goデータベースのインデックスを調整する。
        オープンソース設計のため、ユーザーは必要に応じて機能を拡張することができる。

補足機能(公式説明では言及されているが、オリジナルのプレゼンテーションでは欠落している)

  • マルチシステム対応
    ChatlogはWindowsとmacOSの両方に対応しており、クロスプラットフォームでのアクセスを保証するためにプロセスは一貫しています。
  • プランニング機能(TODO)
    公式ノートによると、Chatlogは将来的にサポートされるとのこと:

    • マルチメディアデータ(画像、音声など)の抽出。
    • チャットデータをフルテキストインデックス化し、検索を高速化。
    • メッセージ頻度、キーワードなどの分析結果を表示するデータ統計ダッシュボード。
      これらの機能はまだ稼動していないが、プロジェクトの継続的改善の方向性を示している。

ほら

  • データ機密保護: チャットログはローカルデータのみを処理し、ウェブにはアップロードしません。ユーザーはGitHub経由でコードをチェックし、安全性を確認することができます。
  • SIPオペレーションmacOSユーザーは、キーを抽出するときだけSIPを無効にし、終わったら再び有効にする必要がある。
  • WeChatバージョンWeChatクライアントのバージョンが3.xまたは4.0であることを確認してください。
  • バックアップデータマイクロソフトのデータベースファイルを定期的にバックアップすることをお勧めします。

以上の手順で、ユーザーは簡単にチャットログをインストールし、チャットログを抽出したり、APIやAIアシスタントを使ってデータを分析したりすることができる。

 

アプリケーションシナリオ

  1. チャットを整理する
    友達とのWeChatメッセージやグループチャットを保存したい場合、Chatlogは記録を抽出・整理し、アーカイブやエクスポートを簡単に行うことができます。
  2. グループチャット管理
    グループチャットがメッセージで溢れかえっているとき、Chatlogは特定のメンバーの発言やキーワードを素早く検索することができ、グループ管理者に適しています。
  3. データ分析
    開発者は、チャットの頻度やキーワードの統計を必要としており、チャットログのHTTP APIは、調査やレポートに適した構造化データを提供します。
  4. AIコラボレーション
    チャットログのMCP SSEサポートにより、AIが直接データを読み取り、分析することができます。

 

品質保証

  1. チャットログはどのようなシステムに対応していますか?
    WindowsとmacOSをサポートし、WeChatバージョン3.xと4.0と互換性があります。
  2. データ・セキュリティはどのように確保するのですか?
    チャットログはオープンソースのツールで、データはローカルでのみ処理され、コードは一般に公開され、ウェブにアップロードされることはありません。
  3. macOS なぜSIPをオフにする必要があるのですか?
    WeChatのセキュリティ・メカニズムはキーの抽出を制限しており、SIPを無効にするのは一時的な操作で、完了後に再び有効にすることができる。
  4. APIはどのようなデータクエリをサポートしていますか?
    JSONおよびCSV形式でのチャットログ、連絡先、グループチャット、最近のセッションクエリをサポート。
  5. AIアシスタントとの連携は?
    チャットログのSSEサービスを起動し、AIアシスタントのツールURLを次のように設定します。 http://127.0.0.1:5030/sse 準備はできている。
無断転載を禁じます:チーフAIシェアリングサークル " Chatlog: WeChatのチャットログを抽出・照会するオープンソースツール
ja日本語