CyberUnion HuntDog 是本机微信数据连接器，用于在用户明确授权的范围内发现微信数据库、读取已有密钥、检查解密覆盖度，并让本机 Agent 查询群聊、联系人和消息。
当前发布：0.4.0-r2
当前平台：Apple 芯片 Mac（macOS arm64）
把本仓库链接交给目标 Mac 上的 Codex：
然后告诉 Codex：
阅读仓库里的
INSTALL_HUNTDOG_WITH_CODEX.md，全程由你自动安装和验收 HuntDog，不要让我打开终端或复制命令。未经我确认，不要运行init或init --force。
Codex 会自动完成下载、SHA256 校验、解压、安装、核心启动测试和只读验收。用户只可能需要配合 macOS 的系统权限弹窗、管理员密码弹窗，以及重启并重新登录微信。
验收报告会分别返回：
INSTALL_OK：核心是否正确安装并能启动。DATABASE_DISCOVERY：是否发现本机微信数据库。KEYS：是否存在可用密钥。DECRYPTION_CONTEXT：是否能建立解密上下文。QUERY：是否通过消息查询。DATA_STATE：FULL_READY、PARTIAL_READY、NEEDS_INITIALIZATION或DATA_UNAVAILABLE。
INSTALL_OK=YES 但 DATA_STATE=NEEDS_INITIALIZATION 不代表安装失败。首次初始化会扫描本机微信进程内存；macOS 拒绝访问时，当前实现可能重新签名 WeChat.app，因此必须由用户明确确认。
- 只处理当前用户有权访问并明确授权分析的微信数据。
- 原始聊天、密钥、配置和私有诊断默认留在本机。
PARTIAL_READY时不得声称全量、精确总数或不存在某类反馈。- 不要把
~/.huntdog/reports/private/上传到 GitHub 或发送给他人。
INSTALL_HUNTDOG_WITH_CODEX.md：Codex 自动安装协议。HuntDog-CyberUnion-macos-arm64-0.4.0-r2.zip：当前安装包。HuntDog-CyberUnion-macos-arm64-0.4.0-r2.sha256：发布校验值。HUNTDOG_INSTALLER_R2.md：r2 根因、修复和验证记录。huntdog-installer-r2-source/：白名单构建脚本、安装脚本和测试。