WeChat Local Reader Codex Skill

这是一个面向 Codex 的本地微信只读读取 skill，用于在 Windows 上通过本机 wechat-cli 读取、检索和总结指定微信小号的本地消息与媒体缓存。

本仓库是公开可迁移版本：已移除本机专属 wxid、真实账号昵称、编译缓存和密钥文件，只保留 skill 说明、脚本和迁移规则。

主要功能

• 读取最近会话、未读会话、联系人和指定聊天历史。
• 搜索本地微信消息，适合查找通知、任务、截止时间、报名、材料、反馈等关键词。
• 解析文字、图片、语音、文件、普通链接和转发聊天记录。
• 解码本地 WeChat v4 .dat 图片缓存，并在需要时视觉检查图片内容。
• 从本地数据库中读取语音消息并转码，支持可选语音转写。
• 解析微信公众号文章、普通链接卡片和转发聊天记录中的内嵌链接。
• 识别转发聊天记录中的嵌入图片、嵌入文件和远程文档线索。
• 支持 Codex App 小时级只读任务扫描自动化，并支持多设备共享状态协调。
• 对运行日志、任务输出、链接、XML、wxid、数据库密钥、图片密钥等敏感内容默认脱敏。
• 内置 Windows PowerShell 5.1 中文编码保护规则，避免中文路径和中文聊天内容被写成乱码。

仓库结构

.
├── README.md
└── wechat-local-reader/
    ├── SKILL.md
    ├── agents/
    ├── references/
    └── scripts/

其中 wechat-local-reader/ 是可安装到 Codex 的 skill 目录。

安装方式

克隆仓库后，将 wechat-local-reader 文件夹复制到 Codex skills 目录：

git clone https://github.com/dangerous090566/wechat-local-reader-codex-skill.git
Copy-Item -Recurse -Force .\wechat-local-reader "$env:USERPROFILE\.codex\skills\wechat-local-reader"

安装后重启 Codex，使 skill 重新被发现。

本机环境要求

本 skill 不是独立微信客户端，也不会登录微信账号。它依赖目标 Windows 电脑上已经存在的本机微信数据和 wechat-cli 初始化结果。

使用前需要准备：

• Windows 微信已登录目标小号。
• 本机已安装并初始化 huohuoer/wechat-cli 或兼容的本地读取工具。
• 已为目标小号生成本机 config.json 和必要的本地数据库解密信息。
• all_keys.json、image_key.bin、数据库文件和解码媒体只保存在本机，不提交到仓库。

推荐设置这些环境变量，使公开版脚本不依赖硬编码路径：

[Environment]::SetEnvironmentVariable("WECHAT_READER_ROOT", "$env:USERPROFILE\Documents\Codex\wechat-reader", "User")
[Environment]::SetEnvironmentVariable("WECHAT_SMALL_CONFIG", "$env:USERPROFILE\Documents\Codex\wechat-reader\wechat-small-account\config.json", "User")
[Environment]::SetEnvironmentVariable("WECHAT_ALLOWED_DB_DIR", "你的微信小号 db_storage 绝对路径", "User")
[Environment]::SetEnvironmentVariable("WECHAT_CLI_SOURCE_ROOT", "$env:USERPROFILE\Documents\Codex\wechat-reader\wechat-cli-eval\wechat-cli-main", "User")
[Environment]::SetEnvironmentVariable("WECHAT_SELF_DISPLAY_NAME", "你的微信显示名", "User")

设置后重启 Codex 或重新打开 PowerShell。

使用边界

• 默认只读取一个已授权的小号，不自动扫描其它微信账号。
• 默认只读，不发送消息、不自动回复、不加好友、不入群、不控制微信 UI。
• 不帮助规避平台检测、绕过封禁或转移账号风险。
• 不承诺零账号风险。本地数据库读取在技术上可行，但仍属于敏感的平台合规边界。
• 默认总结和脱敏，不输出 wxid、数据库密钥、图片密钥、all_keys.json、长跟踪 URL、原始 XML 或无关聊天全文。
• 读取本地文件附件前，必须确认路径位于允许的小号数据根目录下。
• 删除本机文件、清理日志、迁移敏感文件等破坏性或敏感操作，必须由用户在当前轮明确授权。

自动化说明

skill 中包含用于小时级微信任务扫描的脚本和参考文档。自动化设计为：

• 先运行低 token 快速门禁。
• 只有发现真实新增入口时才进入完整扫描。
• 使用共享 Nutstore 目录记录运行日志、任务结果和多设备状态。
• 多设备之间用 lease 和 run lock 避免重复扫描。
• 普通日志保持中文、简洁、脱敏。

自动化前请先阅读：

• wechat-local-reader/references/migration.md
• wechat-local-reader/references/multi_device_coordination.md
• wechat-local-reader/references/hourly_task_scanner_automation.md

不包含的内容

公开仓库不包含：

• 微信数据库文件。
• all_keys.json。
• image_key.bin。
• 真实微信账号 wxid。
• 真实聊天记录、媒体缓存或任务输出。
• 本机 Codex 运行日志。
• GitHub Token、API Key 或其它凭据。

许可证

本仓库当前未声明开源许可证。公开仓库表示代码和说明可被访问，但不自动授予再分发或商用许可；如需正式开源，可后续补充 MIT、Apache-2.0 等许可证。