ops120/wechat-local-viewer

解決する課題

このプロジェクトは、エクスポートされた WeChat のチャット履歴を閲覧・検索するためのローカルでプライベートなインターフェースを提供します。公式アプリ内では管理や検索が難しい大量のチャットデータ（最大数十万件のメッセージ）を扱う問題を解決します。

仕組み

ユーザーは、復号化した WeChat データベースファイル（連絡先、セッション、メッセージ）を指定のディレクトリに配置します。このツールは、Python ベースの ETL（抽出・変換・ロード）プロセスを使用して、FTS5（全文検索）インデックスを持つローカル SQLite データベースにデータを取り込みます。FastAPI バックエンドがこのデータを Vue.js フロントエンドに提供し、チャット記録の高速検索、フィルタリング、エクスポートを可能にします。また、OpenAI 互換の LLM API と統合し、ローカルのチャットデータに基づく要約や Q&A 機能を提供します。

対象ユーザー

自分のデータ復号化を処理できる技術力を持ち、完全にオフラインでプライベートな環境で個人のチャット履歴の高度な分析、検索、AI 支援による要約を行いたいユーザー向けに設計されています。

ハイライト

• ローカルファーストアーキテクチャ：すべてのデータ処理と保存はユーザーのマシン上で行われ、外部依存やデータ流出はありません。
• 高性能検索：SQLite FTS5 を利用し、大規模なメッセージデータセットに対してほぼ瞬時の全文検索を実現します。
• LLM 統合：DeepSeek や Ollama などの OpenAI 互換サービスからのストリーミング応答をサポートし、チャット履歴の要約や質問応答を行います。
• データの移植性：連絡先とセッションデータを CSV または JSON 形式でエクスポートできます。
• ゼロ設定セットアップ：Windows でワンクリック起動するための簡単なバッチスクリプトが含まれています。