bojieli/greenbubbles

解决的问题

GreenBubbles 让用户无需手动导出数据，即可在 macOS 上访问并搜索自己的 WeChat 聊天记录。它特别允许 AI 代理程序（如 Claude Code 或 Codex）实时读取这些记录，以便根据用户的对话建立结构化笔记、私人维基或生活摘要。

运作原理

此工具作为 Mac CLI 及选配应用程序运作，可读取存储在本地的 WeChat 原始加密数据库。它需要一次性设置以从运行中的 WeChat 应用程序获取账号加密密钥（需管理员权限）。一旦取得密钥，GreenBubbles 即可直接查询实时数据库，并以 JSON Lines 格式返回结果供人类或 AI 代理程序使用。它还提供“技能”（Markdown 指令文件），引导编程代理程序如何使用此 CLI 来获取并整理聊天数据。

目标用户

希望以程序化方式访问 WeChat 记录以进行个人知识管理，或增强 AI 代理程序个人背景信息的极客型 macOS 用户（Apple silicon, macOS 14+）。

特色亮点

• 实时访问： 直接读取实时数据库，无需手动导出或维护重复副本。
• 代理程序整合： 为热门编程代理程序提供预定义技能，将对话转化为带有引用的 Markdown 笔记。
• 本地优先隐私： 所有读取、搜索与存储皆在 Mac 本地进行；除非用户明确使用云端 AI 服务，否则数据不会离开设备。
• 加密备份： 支持创建受 24 字词恢复短语保护的聊天记录加密快照。
• 全方位 CLI： 包含列出聊天、搜索消息、排序活跃对话以及遮蔽个人详细信息的工具。