はじめに
Chatlogは、WeChatのローカルデータベースからチャットログを抽出してクエリすることに特化したオープンソースツールです。WeChatバージョン3.xと4.0をサポートし、WindowsとmacOSの両システムをカバーする。ユーザーは、コマンドライン、ターミナルインターフェース、またはHTTP API操作から、チャットログ、連絡先、グループチャット、最近の会話を見ることができます。 エムシーピー チャットデータを素早く分析するためにAIアシスタント(例えばChatWise)と統合することができるSSEプロトコル。プロジェクトはApache-2.0ライセンスに基づいており、コードはオープンで安全かつ信頼性が高く、WeChatデータの整理や分析を必要とするユーザーに適している。
機能一覧
- WeChatのローカルデータベースからチャットログ、連絡先、グループチャット、最近の会話を抽出。
- WeChatバージョン3.xと4.0をサポートし、複数のデータ形式と互換性があります。
- 直感的な操作のためのターミナル・インターフェイス(TUI)とコマンドライン・ツールを提供。
- チャットログ、連絡先、グループチャット、その他の情報のクエリをサポートするHTTP APIを内蔵。
- MCP SSEプロトコルをサポートし、互換性のあるAIアシスタントとのシームレスな接続を実現。
- ユーザーがローカルデータに安全にアクセスできるように、データ復号化機能を提供する。
- オープンソースコードで、ユーザーはセキュリティチェックや機能のカスタマイズが可能。
ヘルプの使用
チャットログの目的は、ユーザーが簡単にWeChatチャットログを抽出し、照会できるようにすることです。下記は、ユーザーがすぐに使い始められるよう、詳細なインストールと使用ガイドです。
設置プロセス
Chatlogは技術的な操作を必要としますので、基本的な知識をお持ちの方に適しています。以下はインストール手順です:
- 環境を整える
以下のソフトウェアがコンピュータにインストールされていることを確認してください:- 行くインストール方法については、Goのウェブサイトをご覧ください。
- エックスコード(macOSユーザー):App Storeからダウンロードしてキーを抽出する。
- WeChatクライアント: インストールされ、ログインしていることを確認し、チャットログをあなたのコンピュータに移行する必要があることを確認します。
- ソースからのインストール
ターミナルを開き、以下のコマンドを実行してChatlogをインストールします:go install github.com/sjzar/chatlog@latest
インストール後、Chatlogはコマンドラインから直接実行できます。
- コンパイル済みバージョンのダウンロード
ソースからコンパイルしたくない場合は、GitHub Releasesにアクセスし、お使いのシステム(WindowsやmacOSなど)用にコンパイル済みのバージョンをダウンロードしてください。ダウンロードしたら、解凍して使ってください。 - macOSユーザーはSIPをオフにする
macOSシステムの場合、セキュリティ上の制約から、以下のように、キーを抽出する際にSIPを一時的に無効にする必要がある:- リカバリーモードに入る:
- インテル・マック電源オフ後に長押し
Command + R
キーを押し、Apple ロゴが表示されるまでコンピュータの電源を入れます。 - アップル・シリコン・マックコンピュータの電源を切った後、ブートオプションが表示されるまで電源ボタンを押し続けます。
- インテル・マック電源オフ後に長押し
- ターミナルを開き、こう入力する:
csrutil disable
- システムを再起動する:
sudo reboot
- キーを抽出した後、SIPを再有効化することをお勧めします。
csrutil enable
(そして再起動する)。
- リカバリーモードに入る:
- 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
データベースのインデックスを調整する。
オープンソース設計のため、ユーザーは必要に応じて機能を拡張することができる。
- 修正
- 新しいエクスポート形式(CSVなど)を追加します:
補足機能(公式説明では言及されているが、オリジナルのプレゼンテーションでは欠落している)
- マルチシステム対応
ChatlogはWindowsとmacOSの両方に対応しており、クロスプラットフォームでのアクセスを保証するためにプロセスは一貫しています。 - プランニング機能(TODO)
公式ノートによると、Chatlogは将来的にサポートされるとのこと:- マルチメディアデータ(画像、音声など)の抽出。
- チャットデータをフルテキストインデックス化し、検索を高速化。
- メッセージ頻度、キーワードなどの分析結果を表示するデータ統計ダッシュボード。
これらの機能はまだ稼動していないが、プロジェクトの継続的改善の方向性を示している。
ほら
- データ機密保護: チャットログはローカルデータのみを処理し、ウェブにはアップロードしません。ユーザーはGitHub経由でコードをチェックし、安全性を確認することができます。
- SIPオペレーションmacOSユーザーは、キーを抽出するときだけSIPを無効にし、終わったら再び有効にする必要がある。
- WeChatバージョンWeChatクライアントのバージョンが3.xまたは4.0であることを確認してください。
- バックアップデータマイクロソフトのデータベースファイルを定期的にバックアップすることをお勧めします。
以上の手順で、ユーザーは簡単にチャットログをインストールし、チャットログを抽出したり、APIやAIアシスタントを使ってデータを分析したりすることができる。
アプリケーションシナリオ
- チャットを整理する
友達とのWeChatメッセージやグループチャットを保存したい場合、Chatlogは記録を抽出・整理し、アーカイブやエクスポートを簡単に行うことができます。 - グループチャット管理
グループチャットがメッセージで溢れかえっているとき、Chatlogは特定のメンバーの発言やキーワードを素早く検索することができ、グループ管理者に適しています。 - データ分析
開発者は、チャットの頻度やキーワードの統計を必要としており、チャットログのHTTP APIは、調査やレポートに適した構造化データを提供します。 - AIコラボレーション
チャットログのMCP SSEサポートにより、AIが直接データを読み取り、分析することができます。
品質保証
- チャットログはどのようなシステムに対応していますか?
WindowsとmacOSをサポートし、WeChatバージョン3.xと4.0と互換性があります。 - データ・セキュリティはどのように確保するのですか?
チャットログはオープンソースのツールで、データはローカルでのみ処理され、コードは一般に公開され、ウェブにアップロードされることはありません。 - macOS なぜSIPをオフにする必要があるのですか?
WeChatのセキュリティ・メカニズムはキーの抽出を制限しており、SIPを無効にするのは一時的な操作で、完了後に再び有効にすることができる。 - APIはどのようなデータクエリをサポートしていますか?
JSONおよびCSV形式でのチャットログ、連絡先、グループチャット、最近のセッションクエリをサポート。 - AIアシスタントとの連携は?
チャットログのSSEサービスを起動し、AIアシスタントのツールURLを次のように設定します。http://127.0.0.1:5030/sse
準備はできている。