SuperAPI AI 工具集

wechat-local-vault

数据与分析

查看项目

更新于 10-16 00:22

技能介绍

用途:把本机微信数据库转为可查询的本地资产库,支持聊天记录、联系人、群聊、朋友圈、收藏夹和附件索引的密钥提取、全量解密、增量刷新、指定会话导出、关系复盘、客户跟进和内容沉淀。默认只读取本机数据库与本地进程,不点击微信界面;默认只处理官方第一个容器 com.tencent.xinWeChat,不处理双开/第二微信。

主要能力:统一查询入口 scripts/vault_cli.py 提供 status、sessions、unread、new-messages、contacts、members、history、search、stats、export、favorites、moments 等命令,默认 JSON 输出,支持 text/image/voice/video/sticker/location/link/file/call/system 类型过滤。digest-source 可生成群聊摘要素材包,落到 data_root 下的 profiles、profiles-roast、imgs、sources 等目录。

必要用法:查看本地库:python3 {{SKILL_DIR}}/scripts/extract_keys.py --list-dbs;复用已有抓取日志:python3 {{SKILL_DIR}}/scripts/extract_keys.py --match-only --targets all --reuse-log;首次抓 key:python3 {{SKILL_DIR}}/scripts/extract_keys.py --targets all --duration 240;全量解密:python3 {{SKILL_DIR}}/scripts/decrypt_all_dbs.py --mode full;增量刷新:python3 {{SKILL_DIR}}/scripts/decrypt_all_dbs.py --mode incremental;按联系人导出:python3 {{SKILL_DIR}}/scripts/export_chat.py --contact "联系人备注" --mode full 或 --mode incremental;按会话 ID 与时间导出:python3 {{SKILL_DIR}}/scripts/export_chat.py --chat-id "contact_username" --since "2025-01-01"。日常查询优先用 vault_cli.py,不抓 key、不碰微信 UI。

适用场景:首次配置、换设备或微信升级后全量重建;日常更新或只分析近期新增;指定联系人/群聊分析;朋友圈与收藏夹解析;群聊精华、日报、复盘,可配合 digest-source 与 history.json 实现“从上次继续”。

限制:图片内容默认不可见,仅在 imgs/{message_id}.txt 存在时才能引用描述;不在回复或日志输出 key、完整 salt、wxid 或原始库内容,除非用户明确要求;明文库与密钥由本机配置文件管理,建议放私有应用数据目录,不复制到工作区、桌面或网盘;缺 key 时只补相关库,不宜全量抓取;大群或长时间范围应先落文件再分析,避免把大量原始消息直接塞进对话;群聊毒舌版不得做人身攻击或健康、家庭、身份属性推断,也不得用时间戳推断作息或所在地。