Summary

This project offers a WeChat chat history analyzer designed to run locally within Claude Code, eliminating the need for API keys and ensuring data privacy. It generates a comprehensive HTML report that includes dual-user chat behavior visualizations and an AI-driven personality comparison, providing users with insights into their communication patterns. The tool is targeted at macOS users seeking a private, automated analysis of their chat logs.

How It Works

The analyzer processes WeChat chat data locally using Claude Code's execution environment. A one-time manual setup is required, involving disabling macOS's System Integrity Protection (SIP) and executing a specific key extraction script via the Terminal.app with debugger privileges. After this initial configuration, the tool automatically analyzes chat logs, generates various visualizations such as hourly message distribution, word clouds, and Big Five personality radar charts, and compiles these into a detailed, shareable HTML report. The AI personality comparison is performed internally by Claude Code.

Quick Start & Requirements

• Primary Install/Run: Clone the repository and execute the /analyze-wechat command within Claude Code.
• Prerequisites:
  • Operating System: macOS 12 or later.
  • WeChat Version: Mac client 4.x.
  • Python: 3.10 or later.
  • Claude Code: Installed.
• Manual Pre-steps (One-time):
  1. Disable System Integrity Protection (SIP) on macOS (refer to 安装指南.md for detailed steps).
  2. Manually run a key extraction script in Terminal.app using lldb (the tool provides the command).
• Setup Time: Initial setup requires manual intervention; subsequent analyses are automated.
• Links: 安装指南.md (referenced for SIP and key extraction instructions).

Highlighted Details

• Generates a single, polished HTML report containing chat visualizations and AI personality analysis.
• All data processing and AI analysis are performed locally, ensuring user privacy and eliminating reliance on external APIs.
• Features dual-user chat behavior visualization, including comparative word clouds and message frequency charts.
• Provides an AI-driven personality comparison report, visualized using a Big Five radar chart.

Maintenance & Community

No specific information regarding contributors, sponsorships, community channels (e.g., Discord, Slack), or roadmaps is provided in the README content.

Licensing & Compatibility

The license type and any compatibility notes relevant to commercial use or linking with closed-source projects are not specified in the provided README content.

Limitations & Caveats

This tool is exclusively compatible with macOS 12+ and WeChat client version 4.x. The mandatory one-time setup, which includes disabling SIP and running a debugger script, presents a significant barrier to entry for less technical users. Reliance on specific, potentially older, versions of macOS and WeChat may impact the tool's long-term viability and supportability.