微信本地管家

就算你每天在微信上处理上百条消息【工作沟通、群聊、公众号、客户对接】，想要从中整理出一份清晰的工作简报，从来没那么简单。手动复制粘贴不仅耗时，还极易遗漏重要信息。更致命的是隐私风险：当你试图把聊天记录喂给 AI 去总结时，无论是截图还是导出文本，都相当于把客户手机号、公司内部信息或个人隐私发到了云端。

wechat-local-butler 的设计初衷，就是把你电脑上已经登录的微信客户端变成一个可被 AI 安全查询的本地数据库。它不截屏、不复制剪贴板，而是直接从微信底层的加密文件中读取数据，最终帮你跑通一条“提取 → 总结 → 脱敏 → 推送”的自动化流水线。

核心机制与工作原理

这个技能的核心能力体现在三个层面：底层提取、安全脱敏与自动化联动。

• 进程级密钥提取：微信 4.x 的本地聊天数据由 SQLCipher 加密，每一条记录都有独立的密钥。工具通过扫描正在运行的微信进程内存来提取这些密钥（兼容 4.1+ 的只读 Config.Cipher 扫描和 4.0.x 的明文扫描），提取完成后直接在本地解密并读取数据库。整个过程无需微信开放任何 API，完全基于现有客户端的本地数据文件。
• 结构化输出与一键脱敏：提取出的数据默认输出为 JSON 格式，完美契合 Agent 工具的调用逻辑。你可以查询特定时间段内的聊天记录、未读消息增量或群成员列表。为了防止隐私泄露，内置的 --mask 开关会在数据离开本机前自动掩码手机号、身份证号、银行卡号和邮箱（如 138****5678），给明文聊天打上安全补丁。
• 配合 WorkBuddy 跑通自动化闭环：工具只负责取数和脱敏，而真正的“大脑”是你的自动化工作流。将查询结果交给 WorkBuddy 中的 AI，设定如“每日 07:00 提取昨日增量通讯记录，提炼工作进展和待办，并过滤掉娱乐类公众号内容”这样的 Prompt，AI 会自动生成结构化的日报。最终，这份简报可以通过自带的脚本，精准推送到你指定的邮箱、企业微信群机器人或任意 HTTP 端点。

适用边界与风险提示

• 仅限桌面端本人账号：目前完美支持 Windows 和 Linux 桌面版微信，但移动端（iOS/Android/鸿蒙）的沙盒环境无法被直接扫描。请在同一台电脑上使用微信电脑版，本工具仅用于整理你自己的账号数据，严禁触碰他人设备或公共账号。
• 密钥与缓存的本地隔离：为了确保打包发布该技能时不泄露数据，密钥文件 ~/.wechat-cli/all_keys.json 和解密后的明文缓存均被强制存放在 skill 安装目录之外。使用完毕后，建议通过 --clean 参数及时清理临时目录下的明文数据库副本。
• macOS 需额外编译：受限于平台对可执行文件的限制，当前 macOS 环境未内置密钥提取的二进制文件。如果你使用的是 Mac，需要从源码获取 find_all_keys_macos.c 并自行编译。