# Yichen Wechat Local Vault

微信本地数字资产库：支持 macOS 与已实测 Windows 环境的本地全量解析，包括全库采集、认证解密、聊天记录读取/搜索/导出，以及朋友圈和收藏正文解析。Mac...

- Repository: https://github.com/mcncarl/yichen-skills (5140 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mcncarl/yichen-skills --skill yichen-wechat-local-vault -g -a claude-code -y`
Codex: `npx skills add mcncarl/yichen-skills --skill yichen-wechat-local-vault -g -a codex -y`
Cursor: `npx skills add mcncarl/yichen-skills --skill yichen-wechat-local-vault -g -a cursor -y`
Gemini CLI: `npx skills add mcncarl/yichen-skills --skill yichen-wechat-local-vault -g -a gemini-cli -y`

## Description

微信本地数字资产库：支持 macOS 与已实测 Windows 环境的本地全量解析，包括全库采集、认证解密、聊天记录读取/搜索/导出，以及朋友圈和收藏正文解析。Mac 另支持增量刷新和漏看/待回复检查，默认微信1，微信2须明确指定。Windows 本机采集走 windows，离线聊天查询走 snapshot，朋友圈/收藏复用包内纯函数工作流；不触发 Mac 配置或流程。依赖最新聊天时必须先刷新相应来源，不能拿旧记录代替目标。Windows 版本及功能边界见本机采集参考。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 微信本地解析 Vault

这个 skill 提供同一个本地入口，分别处理 Mac vault、Windows 本机聊天采集和显式离线明文快照。Mac 模式处理官方微信容器 `com.tencent.xinWeChat` 内已确认的账号数据，默认微信1，微信2须由用户明确指定；这里的账号编号不等于双开容器编号，不自动处理双开/第二独立微信容器。遵守用户的界面操作限制；Windows 登录和测试消息由用户手动完成。`snapshot` 模式完全不访问微信进程、密钥、Mac 配置或运行中客户端。

本版本吸收了两类外部工具的优点：

- WeChat CLI 风格：统一命令入口、JSON 默认输出、最近会话、历史记录、全局搜索、联系人详情、群成员、统计、导出、收藏夹、未读和增量新消息。
- 宝玉群聊摘要工作流：按群归档、从上次摘要继续、摘要素材包、群友画像目录、历史索引、图片说明扩展点，以及“大批量先落文件再分析”的安全习惯。

## 隐私边界

- 不在回复或日志里输出 key、完整 salt、wxid、原始聊天库内容，除非用户明确要求展示。
- 密钥、配置、明文库、manifest、增量状态和导出目录都由本机配置文件管理；skill 文档不要写入任何个人机器的真实绝对路径、wxid、联系人或聊天内容。
- 建议把密钥和明文库放在本机私有应用数据目录，把可读报告放在用户自选的导出目录；路径以占位符或配置字段说明即可。
- 不要把明文数据库复制到项目工作区、桌面、网盘目录或聊天回复里；工作区只放用户明确要求的导出报告。
- 查询和导出的消息正文统一经过 `scripts/message_display.py`：入群/撤回通知转为可读事件，链接、文件和合并转发只提取可读字段；未知、破损或带实体声明的 XML 返回占位提示，不回退输出原文。正文里的显式凭据字段默认隐藏。
- Mac CLI 默认在 JSON、`--format text` 和导出中隐藏账号标识（username、微信号），名字缺失时回退成的标识也一并隐藏，显示为“[内部标识已隐藏]”；用于本机精确匹配的内部读取函数仍保留标识。确需从 CLI 导出这些字段时，在子命令前加 `--include-identifiers`，并直接保存到本机私密 JSON，不把输出打印到日志或回复。只有用户明确要求展示时才显示标识；该参数不会放开原始 XML 或附件凭据。
- 这些保护不代表正文已匿名化：昵称、自我介绍、用户主动发送的联系方式等仍可能包含个人资料。不要靠“字符串以 `<` 开头”筛除 XML，群号前缀、转义内容和嵌套转发都可能绕过该判断。

## 先确定数据来源

The rest: https://github.com/mcncarl/yichen-skills/blob/HEAD/yichen-wechat-local-vault/SKILL.md