两个隔离账号、来源身份承诺与只读数据库快照
现在
常用
截至 11 月 4 日 · 项目源码和环境体检

WeChatDirect · 功能说明

同名联系人、双开微信和本机加密数据库不会因为“看起来像”而串到另一个账号;源数据库也不会为了读取而被改写。

当前情况:已有分开主号、副号并核对来源的机制,只配一个账号也能用;读取时微信可以照常写入,文字、图片与语音依赖分别检查,账号不明确时不猜。替我发消息这类动作连“唯一匹配时自动选”也没有,必须明确说主号或副号。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

两个隔离账号、来源身份承诺与只读数据库快照
现在
常用
截至 11 月 4 日 · 项目源码和环境体检

WeChatDirect · 功能说明

同名联系人、双开微信和本机加密数据库不会因为“看起来像”而串到另一个账号;源数据库也不会为了读取而被改写。

当前情况:已有分开主号、副号并核对来源的机制,只配一个账号也能用;读取时微信可以照常写入,文字、图片与语音依赖分别检查,账号不明确时不猜。替我发消息这类动作连“唯一匹配时自动选”也没有,必须明确说主号或副号。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

主号、副号可能有相同昵称和联系人;真实数据库仍在写入,直接解密查询也可能得到不一致页面。若身份和快照不先闭合,后面的消息再完整也可能来自错账号或半写状态。

举个实际例子

主号和副号里都有人叫“小王”,我只说一句“别拿错”。工具会先让我确定账号,再核对这个账号与本地资料确实是一套;身份有一点对不上就停,不会因为头像和昵称很像便把两边聊天拼起来。

最后我会得到什么

得到已核对的微信账号和一份稳定、只读的本机资料副本,后续查询才会使用它。账号或来源对不上时停下,不泄露账号解密信息,也不混主副号。

这项功能怎样使用

用途与实际影响

为什么需要它

主号、副号可能有相同昵称和联系人;真实数据库仍在写入,直接解密查询也可能得到不一致页面。若身份和快照不先闭合,后面的消息再完整也可能来自错账号或半写状态。

举个实际例子

主号和副号里都有人叫“小王”,我只说一句“别拿错”。工具会先让我确定账号,再核对这个账号与本地资料确实是一套;身份有一点对不上就停,不会因为头像和昵称很像便把两边聊天拼起来。

最后我会得到什么

得到已核对的微信账号和一份稳定、只读的本机资料副本,后续查询才会使用它。账号或来源对不上时停下,不泄露账号解密信息,也不混主副号。

结果怎么看
可直接使用

账号和本机来源能唯一对应,临时读取副本完整,才开始读消息。

需要确认

依赖或语音解码器缺失时分别报告;只影响相关功能,不说全部微信读取都坏了。

当前不可用

账号目录不唯一、配置不可读,或本机资料在复制时一直在变(自动重试 3 次仍不稳定)时先停,不能猜一个相似账号。

结果怎么看
可直接使用

账号和本机来源能唯一对应,临时读取副本完整,才开始读消息。

需要确认

依赖或语音解码器缺失时分别报告;只影响相关功能,不说全部微信读取都坏了。

当前不可用

账号目录不唯一、配置不可读,或本机资料在复制时一直在变(自动重试 3 次仍不稳定)时先停,不能猜一个相似账号。

从哪里开始

读取微信前先指明主号或副号与对象,或让 auto 只在唯一匹配时选。

需要准备什么
  • 指定主号、副号,或允许唯一匹配时自动选定
  • 要读的联系人或群
从开始到拿到结果
1系统核对并处理
核对账号来源,把本机加密库复制到临时位置做只读快照和完整性检查;复制时微信照常写入也不影响,文件在复制前后对不上就自动重取,最多 3 次,仍不稳定才停。
2交付与接续
交回与正确账号绑定的上下文;多匹配、解密或快照失败时不借另一账号补空。
从哪里开始

读取微信前先指明主号或副号与对象,或让 auto 只在唯一匹配时选。

需要准备什么
  • 指定主号、副号,或允许唯一匹配时自动选定
  • 要读的联系人或群
从开始到拿到结果
1系统核对并处理
核对账号来源,把本机加密库复制到临时位置做只读快照和完整性检查;复制时微信照常写入也不影响,文件在复制前后对不上就自动重取,最多 3 次,仍不稳定才停。
2交付与接续
交回与正确账号绑定的上下文;多匹配、解密或快照失败时不借另一账号补空。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
环境检查可独立于账号运行;文字/图片与Python3.11语音分别验收。当前源码 v0.2.3(最后提交 2026-11-06)
关键规则与设计选择
1
primary / secondary 是配置身份,不从窗口、头像或昵称推断和修复。
2
配置不保存微信密钥明文,真实路径与承诺值只留本机。
3
源数据库与 WAL 不被写入;所有查询发生在临时快照。
4
Doctor 不打开数据库正文,也不输出路径或密钥。
5
某个依赖缺失只影响对应能力,例如 voiceDecoder unavailable 不等于文字上下文不可用。
6
读取可以用 auto 在唯一匹配时选账号;helper 原生动作必须显式 primary 或 secondary,不从昵称、窗口或 PID 猜;每次动作前再读原生登录身份,退出或切号立即阻止后续动作。细节见收发和实时会话的技术依据。
当前怎样实现
  • 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 账号根。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
环境检查可独立于账号运行;文字/图片与Python3.11语音分别验收。当前源码 v0.2.3(最后提交 2026-11-06)
关键规则与设计选择
1
primary / secondary 是配置身份,不从窗口、头像或昵称推断和修复。
2
配置不保存微信密钥明文,真实路径与承诺值只留本机。
3
源数据库与 WAL 不被写入;所有查询发生在临时快照。
4
Doctor 不打开数据库正文,也不输出路径或密钥。
5
某个依赖缺失只影响对应能力,例如 voiceDecoder unavailable 不等于文字上下文不可用。
6
读取可以用 auto 在唯一匹配时选账号;helper 原生动作必须显式 primary 或 secondary,不从昵称、窗口或 PID 猜;每次动作前再读原生登录身份,退出或切号立即阻止后续动作。细节见收发和实时会话的技术依据。
当前怎样实现
  • 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 日

技术实现与依据(二)
1
解析命令行、环境、本地设置或默认 accounts.json。
2
校验已配置的账号槽位和每个槽位必需的两个身份承诺。
3
使用当前 Windows 用户的 DPAPI 解开本机保护配置。
4
锁定唯一账号目录并生成身份承诺。
5
复制或解密数据库,合并 WAL,比较前后签名;签名不一致时有界重取。
6
quick_check 通过后以 query_only 打开;任务结束清理临时目录。
  • EncryptedPageCodec验证加密页面与WAL校验和,只合并已提交WAL前缀,保留源数据库/WAL只读;不以临时快照成功推断原会话或远端内容完整。
  • 源数据库和 WAL 只以读权限打开,同时允许微信继续读写、删除或改名;结构探测和快照复制前后都比较文件身份、大小和 mtime,各最多 3 次,持续不稳才失败,不混用两代文件;通过 PRAGMA quick_check 后只读 query_only。
执行流程
技术实现与依据(二)
1
解析命令行、环境、本地设置或默认 accounts.json。
2
校验已配置的账号槽位和每个槽位必需的两个身份承诺。
3
使用当前 Windows 用户的 DPAPI 解开本机保护配置。
4
锁定唯一账号目录并生成身份承诺。
5
复制或解密数据库,合并 WAL,比较前后签名;签名不一致时有界重取。
6
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_onlySQLite 连接明确禁止写入,所有查询都针对临时快照。
专业定义

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

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

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

出问题时(一)
解决什么
解决双账号串源、凭据明文、读写源数据库、活动 WAL 导致不一致和把体检冒充真实读取。
边界
  • 真实 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 失败,稍后重试,不写源。
出问题时(一)
解决什么
解决双账号串源、凭据明文、读写源数据库、活动 WAL 导致不一致和把体检冒充真实读取。
边界
  • 真实 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 / DirectWeChatReader页面解密、WAL、临时快照与只读连接。
  • 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 / DirectWeChatReader页面解密、WAL、临时快照与只读连接。
  • 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。