
WeChatDirect · 功能说明
同名联系人、双开微信和本机加密数据库不会因为“看起来像”而串到另一个账号;源数据库也不会为了读取而被改写。
当前情况:已有分开主号、副号并核对来源的机制,只配一个账号也能用;读取时微信可以照常写入,文字、图片与语音依赖分别检查,账号不明确时不猜。替我发消息这类动作连“唯一匹配时自动选”也没有,必须明确说主号或副号。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


WeChatDirect · 功能说明
同名联系人、双开微信和本机加密数据库不会因为“看起来像”而串到另一个账号;源数据库也不会为了读取而被改写。
当前情况:已有分开主号、副号并核对来源的机制,只配一个账号也能用;读取时微信可以照常写入,文字、图片与语音依赖分别检查,账号不明确时不猜。替我发消息这类动作连“唯一匹配时自动选”也没有,必须明确说主号或副号。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


用途与实际影响
主号、副号可能有相同昵称和联系人;真实数据库仍在写入,直接解密查询也可能得到不一致页面。若身份和快照不先闭合,后面的消息再完整也可能来自错账号或半写状态。
主号和副号里都有人叫“小王”,我只说一句“别拿错”。工具会先让我确定账号,再核对这个账号与本地资料确实是一套;身份有一点对不上就停,不会因为头像和昵称很像便把两边聊天拼起来。
得到已核对的微信账号和一份稳定、只读的本机资料副本,后续查询才会使用它。账号或来源对不上时停下,不泄露账号解密信息,也不混主副号。

用途与实际影响
主号、副号可能有相同昵称和联系人;真实数据库仍在写入,直接解密查询也可能得到不一致页面。若身份和快照不先闭合,后面的消息再完整也可能来自错账号或半写状态。
主号和副号里都有人叫“小王”,我只说一句“别拿错”。工具会先让我确定账号,再核对这个账号与本地资料确实是一套;身份有一点对不上就停,不会因为头像和昵称很像便把两边聊天拼起来。
得到已核对的微信账号和一份稳定、只读的本机资料副本,后续查询才会使用它。账号或来源对不上时停下,不泄露账号解密信息,也不混主副号。

账号和本机来源能唯一对应,临时读取副本完整,才开始读消息。
依赖或语音解码器缺失时分别报告;只影响相关功能,不说全部微信读取都坏了。
账号目录不唯一、配置不可读,或本机资料在复制时一直在变(自动重试 3 次仍不稳定)时先停,不能猜一个相似账号。

账号和本机来源能唯一对应,临时读取副本完整,才开始读消息。
依赖或语音解码器缺失时分别报告;只影响相关功能,不说全部微信读取都坏了。
账号目录不唯一、配置不可读,或本机资料在复制时一直在变(自动重试 3 次仍不稳定)时先停,不能猜一个相似账号。

读取微信前先指明主号或副号与对象,或让 auto 只在唯一匹配时选。
- 指定主号、副号,或允许唯一匹配时自动选定
- 要读的联系人或群


读取微信前先指明主号或副号与对象,或让 auto 只在唯一匹配时选。
- 指定主号、副号,或允许唯一匹配时自动选定
- 要读的联系人或群



- accounts.json 只允许 primary / secondary 两个槽位名,但至少配置一个即可,不要求必须双号;本机当前配置了 2 个。每个已配置槽位提供 config_path、local_state_path 和两个来源身份承诺;identity-commitments 可从本人有权读取的这两份已有保护载体计算出这两个承诺,只输出承诺,不输出账号原生 ID 或密钥。这两份载体由哪个程序、哪个版本生成,目前未核实。
- Windows DPAPI 解开 Local State 中的本机 AES key,再解开 dbPath、decryptKey 与 myWxid。
- load_direct_source_identity 只接受一个与原生身份匹配的 db_storage 账号根。


- accounts.json 只允许 primary / secondary 两个槽位名,但至少配置一个即可,不要求必须双号;本机当前配置了 2 个。每个已配置槽位提供 config_path、local_state_path 和两个来源身份承诺;identity-commitments 可从本人有权读取的这两份已有保护载体计算出这两个承诺,只输出承诺,不输出账号原生 ID 或密钥。这两份载体由哪个程序、哪个版本生成,目前未核实。
- Windows DPAPI 解开 Local State 中的本机 AES key,再解开 dbPath、decryptKey 与 myWxid。
- load_direct_source_identity 只接受一个与原生身份匹配的 db_storage 账号根。
数字截至 2026 年 11 月 6 日

- EncryptedPageCodec验证加密页面与WAL校验和,只合并已提交WAL前缀,保留源数据库/WAL只读;不以临时快照成功推断原会话或远端内容完整。
- 源数据库和 WAL 只以读权限打开,同时允许微信继续读写、删除或改名;结构探测和快照复制前后都比较文件身份、大小和 mtime,各最多 3 次,持续不稳才失败,不混用两代文件;通过 PRAGMA quick_check 后只读 query_only。


- EncryptedPageCodec验证加密页面与WAL校验和,只合并已提交WAL前缀,保留源数据库/WAL只读;不以临时快照成功推断原会话或远端内容完整。
- 源数据库和 WAL 只以读权限打开,同时允许微信继续读写、删除或改名;结构探测和快照复制前后都比较文件身份、大小和 mtime,各最多 3 次,持续不稳才失败,不混用两代文件;通过 PRAGMA quick_check 后只读 query_only。



| 名词 | 意思 |
|---|---|
| DPAPI(Windows 数据保护接口) | 让配置载荷只能由当前 Windows 用户在本机解开,不把密钥明文写入项目。 |
| Account identity commitment(账号身份承诺) | 原生微信身份的 SHA-256;验证同一来源而不公开真实 wxid。 |
| WAL(数据库预写日志) | SQLite 尚未合并进主文件的已提交页面;快照需要一并处理才能保持一致。 |
| query_only | SQLite 连接明确禁止写入,所有查询都针对临时快照。 |

primary / secondary 是两个严格隔离的配置槽位,可以只配一个;每次读取先核对来源身份承诺,再在临时目录准备通过完整性检查的只读快照。



primary / secondary 是两个严格隔离的配置槽位,可以只配一个;每次读取先核对来源身份承诺,再在临时目录准备通过完整性检查的只读快照。

- 真实 config、Local State、数据库路径、wxid、解密 key 和承诺值不进入网页或 Git。
- 只有当前 Windows 用户有权访问的本人设备数据属于来源。
- Doctor 证明文件和依赖入口存在,不证明数据库身份或聊天读取成功。
- 主 CLI(命令行工具) 只支持 Windows 和 Python 3.14+。
- 配置或 Local State 不可解密: DirectCredentialError,读取前停止,不输出值。
- 账号目录零个或多个匹配: local source account directory is ambiguous,不猜目录。
- 页面、HMAC、WAL 或 quick_check 失败: SnapshotCopyError / EncryptedPageError,不查询部分快照。
- 源在三次快照期间持续变化: bounded snapshot retries 失败,稍后重试,不写源。

- 真实 config、Local State、数据库路径、wxid、解密 key 和承诺值不进入网页或 Git。
- 只有当前 Windows 用户有权访问的本人设备数据属于来源。
- Doctor 证明文件和依赖入口存在,不证明数据库身份或聊天读取成功。
- 主 CLI(命令行工具) 只支持 Windows 和 Python 3.14+。
- 配置或 Local State 不可解密: DirectCredentialError,读取前停止,不输出值。
- 账号目录零个或多个匹配: local source account directory is ambiguous,不猜目录。
- 页面、HMAC、WAL 或 quick_check 失败: SnapshotCopyError / EncryptedPageError,不查询部分快照。
- 源在三次快照期间持续变化: bounded snapshot retries 失败,稍后重试,不写源。

- 微信窗口退回扫码页、提示重新登录: 之前出现过这个问题,10 月 7 日我确认已经恢复。当时同时做了两项调整:读取方式的兼容修复,以及让一个屏幕叠加工具不再挂接微信主程序。两项一起做、没有分开试,所以真正原因还不确定,也不能保证以后不会再掉登录;那项工具设置由电脑配置项目维护。

- 微信窗口退回扫码页、提示重新登录: 之前出现过这个问题,10 月 7 日我确认已经恢复。当时同时做了两项调整:读取方式的兼容修复,以及让一个屏幕叠加工具不再挂接微信主程序。两项一起做、没有分开试,所以真正原因还不确定,也不能保证以后不会再掉登录;那项工具设置由电脑配置项目维护。

accounts.example.json隔离槽位和身份承诺的公开结构(可只配一个槽位)。
wechat_source.py · load_direct_source_identityDPAPI、配置解密和唯一账号根。
wechat_source.py · EncryptedPageCodec /页面解密、WAL、临时快照与只读连接。DirectWeChatReader
wechat_cli.py · command_doctor /无正文环境体检、局部可用状态,以及从已有载体计算身份承诺。identity-commitments
- 2026-10-11 16:33 普通 Doctor 返回 success、configuredAccounts=2、所需文件 2/2、依赖与 voiceDecoder available;16:32 的仅环境检查各项能力也可用(它不检查账号,所以那里的账号数 0 不代表没有账号)。两次都没有测试实际读取,sourceAccess=not_tested。2026-11-04 09:09–09:14 再跑 doctor --environment-only:success,文字、图片、WXGF、语音转 WAV 和离线验真都可用,配置 not_checked、sourceAccess not_tested;同样不证明真实读库。
- test_reader_rejects_wrong_source_identity_commitment_before_reads 验证身份不匹配在正文前失败。
- test_account_config_requires_both_identity_commitments 验证每个槽位两个承诺必需。
- test_doctor_is_body_free_and_requires_windows 验证 Doctor 不打开正文且限制平台。
所有聊天、朋友圈、媒体和归档模块都以这里的账号身份与稳定快照为前提;它只建立可信来源,不拥有聊天语义。

accounts.example.json隔离槽位和身份承诺的公开结构(可只配一个槽位)。
wechat_source.py · load_direct_source_identityDPAPI、配置解密和唯一账号根。
wechat_source.py · EncryptedPageCodec /页面解密、WAL、临时快照与只读连接。DirectWeChatReader
wechat_cli.py · command_doctor /无正文环境体检、局部可用状态,以及从已有载体计算身份承诺。identity-commitments
- 2026-10-11 16:33 普通 Doctor 返回 success、configuredAccounts=2、所需文件 2/2、依赖与 voiceDecoder available;16:32 的仅环境检查各项能力也可用(它不检查账号,所以那里的账号数 0 不代表没有账号)。两次都没有测试实际读取,sourceAccess=not_tested。2026-11-04 09:09–09:14 再跑 doctor --environment-only:success,文字、图片、WXGF、语音转 WAV 和离线验真都可用,配置 not_checked、sourceAccess not_tested;同样不证明真实读库。
- test_reader_rejects_wrong_source_identity_commitment_before_reads 验证身份不匹配在正文前失败。
- test_account_config_requires_both_identity_commitments 验证每个槽位两个承诺必需。
- test_doctor_is_body_free_and_requires_windows 验证 Doctor 不打开正文且限制平台。
所有聊天、朋友圈、媒体和归档模块都以这里的账号身份与稳定快照为前提;它只建立可信来源,不拥有聊天语义。
复制 AI 续作说明
项目:两个隔离账号、来源身份承诺与只读数据库快照;仓库:wlyaaaaa/WeChatDirect;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








