# 接入卡住后的处理流程

## 先确认在哪里运行

需要能够访问本人电脑文件并执行本地命令的Agent或终端。仅有网页聊天或远端云环境，不能直接打开电脑里的微信数据库。安装Skill只增加操作说明，不会替网页模型建立本机连接；不要为此将微信目录或key上传到云端。

## 已用其他工具跑通

先区分“应用界面能打开”和“真实聊天已可读取”。后者优先复用已有成果，Codex只在本人机器检查：

1. 已有授权材料：核对导出工具、文件格式及本人账号目录；使用`diagnose --source`临时验证，不把key贴到对话中。
2. 已有明文数据库：在本人明确指定的目录运行`access-plan --database-root ...`。保留原表结构且识别通过时可继续`setup`，无需额外key；结构不兼容时记录表名/缺失列，不重新获取。
3. 只有HTML、CSV或JSON导出：不是可以直接传给数据库Reader的文件。先核对字段与时间范围，再走Hub的导入接口；不能伪装成实时全量读取。

不自动扫描其他工具的私有配置，不运行聊天附件中的脚本，不把已解密数据库提交到Issue。

## Mac失败或换最新版仍失败

不承诺所有最新版兼容，不默认降级、关闭SIP或重复重启微信。先运行`diagnose --support-summary`，结合具体系统、微信完整构建、状态码及上一次失败阶段定位。多开/修改版与官方版应分别记录；不能只看版本号就断言原因。

存在恢复锁时，先核对官方微信是否已恢复、获取进程是否结束。使用者事后明确确认后，才按`finish-recovery`指引处理。恢复锁不是key失效的证明，也不能自动删掉来重试。

## Windows导入失败

使用原生Python和实际Windows路径，核对解释器架构、SQLCipher驱动、材料编码与ACL。连接和临时验证目录使用Windows ACL，而不是只看chmod模式位。已有目录权限不符合要求时明确失败，不自动扩大访问权限。

`diagnose --support-summary`是专用脱敏输出，仅包含白名单字段，不包含路径、姓名、聊天、密钥、自由文本错误或原始日志。它不会联网、启动获取或覆盖配置。诊断成功返回码不等于接入成功，要看`data.state`。

维护者提供Windows CI虚构数据库测试，覆盖真实ACL、中文路径及UTF-16材料的SQLCipher读取；CI通过仍不证明真实微信进程获取兼容。没有已验证材料时，首次获取依旧需要独立审计和知情授权。

## 给本地Codex的提示词

> 更新微信CLI与微信个人情报库的公开代码和Skill，保留我的Profile、历史数据和访问材料。先用diagnose --support-summary定位接入问题，不自动获取新key。其他工具已有可用材料或已解密库时，只在本机验证复用；没有本地执行能力时明确告知。最终给出doctor、已知消息抽检结果和覆盖缺口，不把安装成功当成接入成功，不打印或上传密钥。