
WeChatDirect · 功能说明
重要聊天可以留下独立可读、可核对的材料;保全包、阅读包和持续更新的档案,都能在不重新访问微信源的情况下确认没有文件被换掉或漏写。
当前情况:已有明确窗口保全和独立验真。同一个验真命令能核对四种材料:联系人归档、朋友圈快照、阅读包和保全包,这项支持 9 月 18 日就已实现。11 月 4 日核对时没有新建包或重跑验真;验真通过也不证明微信未取得的远端历史已保存。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


WeChatDirect · 功能说明
重要聊天可以留下独立可读、可核对的材料;保全包、阅读包和持续更新的档案,都能在不重新访问微信源的情况下确认没有文件被换掉或漏写。
当前情况:已有明确窗口保全和独立验真。同一个验真命令能核对四种材料:联系人归档、朋友圈快照、阅读包和保全包,这项支持 9 月 18 日就已实现。11 月 4 日核对时没有新建包或重跑验真;验真通过也不证明微信未取得的远端历史已保存。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:公开仓库


用途与实际影响
只复制屏幕截图或一堆媒体会丢失账号、对象、时间、回复与原消息关系;只有文件存在也不能证明清单、状态和媒体仍是一套。
我明确要求“把昨晚这段聊天、回复关系和当前能打开的语音做成保全包”。完成后会得到消息、清单和媒体目录;打不开的图片、视频或文件仍留着关系和缺口。整套文件和清单写完后才一次性出现,不会把写到一半的目录交给我。
得到一份包含所选聊天、回复关系和当前能打开附件的材料包,另有清单说明缺什么。以后随时可以单独核对这份包是否还完整;验真只看包里现有的文件和关系,不会把缺的附件变出来。
包里每个文件都能和清单对上,验真才算通过;附件不全的包也能验真,结果会和缺口分开写。
某张图或语音打不开时仍保留消息和缺口,不把附件空白说成整段聊天不存在。
目标已有内容或文件身份、数量不符时不覆盖,也不宣布保全成功。

用途与实际影响
只复制屏幕截图或一堆媒体会丢失账号、对象、时间、回复与原消息关系;只有文件存在也不能证明清单、状态和媒体仍是一套。
我明确要求“把昨晚这段聊天、回复关系和当前能打开的语音做成保全包”。完成后会得到消息、清单和媒体目录;打不开的图片、视频或文件仍留着关系和缺口。整套文件和清单写完后才一次性出现,不会把写到一半的目录交给我。
得到一份包含所选聊天、回复关系和当前能打开附件的材料包,另有清单说明缺什么。以后随时可以单独核对这份包是否还完整;验真只看包里现有的文件和关系,不会把缺的附件变出来。
包里每个文件都能和清单对上,验真才算通过;附件不全的包也能验真,结果会和缺口分开写。
某张图或语音打不开时仍保留消息和缺口,不把附件空白说成整段聊天不存在。
目标已有内容或文件身份、数量不符时不覆盖,也不宣布保全成功。

要求给一段重要聊天做可核对的独立保全或验真。
- 明确账号、对象与需要保全的时间窗口
- 是新保全、验真已有包还是补缺失媒体


要求给一段重要聊天做可核对的独立保全或验真。
- 明确账号、对象与需要保全的时间窗口
- 是新保全、验真已有包还是补缺失媒体



- preserve 先调用 context 得到账号、对象、窗口、消息、引用和 gaps。
- 保全包在具名 .incomplete 候选目录写完所选消息、可用媒体、每项 hash/size 和 manifest(清单)后,一次 rename 发布成正式目录;它没有增量 state,也不在发布前自动跑整包 verify-export。两次改名与事务恢复只属于替换已有归档。packageCreated=true和exit0不等于全部所选内容可用,status=partial、delivery与hasMore必须独立读取。


- preserve 先调用 context 得到账号、对象、窗口、消息、引用和 gaps。
- 保全包在具名 .incomplete 候选目录写完所选消息、可用媒体、每项 hash/size 和 manifest(清单)后,一次 rename 发布成正式目录;它没有增量 state,也不在发布前自动跑整包 verify-export。两次改名与事务恢复只属于替换已有归档。packageCreated=true和exit0不等于全部所选内容可用,status=partial、delivery与hasMore必须独立读取。
数字截至 2026 年 11 月 6 日

- 媒体记录 messageNativeId、mediaId、kind、locatorSha256、bytes、sha256 与 derivedPaths。
- verify-export 接受 wechat-direct-contact-export.v1、moments-export.v1、阅读包和保全包四种 v1 格式。联系人与朋友圈核对 state 与记录;阅读包与保全包有 manifest 时核对宣告文件、hash/size、账号与对象绑定、消息/引用/媒体关系和语音派生来源(scope=declared_files_and_relations)。只有没有 manifest、但有 conversation.json 的旧阅读包才按 legacy 较窄范围检查;manifest 存在但损坏时直接失败,不退回旧格式。
- 验真限制所有相对路径留在导出根,拒绝反斜杠、冒号、..、绝对路径和符号链接逃逸。


- 媒体记录 messageNativeId、mediaId、kind、locatorSha256、bytes、sha256 与 derivedPaths。
- verify-export 接受 wechat-direct-contact-export.v1、moments-export.v1、阅读包和保全包四种 v1 格式。联系人与朋友圈核对 state 与记录;阅读包与保全包有 manifest 时核对宣告文件、hash/size、账号与对象绑定、消息/引用/媒体关系和语音派生来源(scope=declared_files_and_relations)。只有没有 manifest、但有 conversation.json 的旧阅读包才按 legacy 较窄范围检查;manifest 存在但损坏时直接失败,不退回旧格式。
- 验真限制所有相对路径留在导出根,拒绝反斜杠、冒号、..、绝对路径和符号链接逃逸。





| 名词 | 意思 |
|---|---|
| Self-contained bundle(自包含保全包) | 离开源数据库后仍能理解账号、对象、时间、消息、回复、媒体与缺口。 |
| .incomplete | 尚未完成的候选目录。新保全写完后整体改名为正式目录;替换已有归档时才涉及两次改名,已知中断按事务恢复,未知旧目录不自动删除。 |
| Path containment(路径约束) | 清单里的每个文件都必须解析在导出根内,不能借相对路径或链接逃出。 |
| Independent verification(独立验真) | 不打开微信源,只依赖导出本身重算身份绑定、文件和关系;它只证明包内现有内容没被改,不证明聊天历史齐全。 |

preserve 只在用户明确要求时生成自包含窗口;verify-export 不读源数据库,独立重算联系人归档、朋友圈快照、阅读包和保全包四种 v1 格式的身份、文件、数量、哈希和媒体关系。



preserve 只在用户明确要求时生成自包含窗口;verify-export 不读源数据库,独立重算联系人归档、朋友圈快照、阅读包和保全包四种 v1 格式的身份、文件、数量、哈希和媒体关系。

- 保全目标必须由用户明确点名且尚不存在。
- 保全包按自己的格式验真,不当成持续增量档案;没有清单的旧阅读包只做较窄检查。验真不读源、不修包、不补缺口。
- 媒体不可用时保留 gap,不从其他目录补同名文件。
- 保全成品含真实私人内容,只留本机,不进入网站或 PUBLIC(公开) Git。
- 目标或 .incomplete 已存在: 拒绝覆盖并保留原目录,先由用户判断旧目录用途。
- 保全过程中出现普通错误: 清理这次新建的 .incomplete,原目标仍不存在;进程被强制结束时无法保证完成清理,要人工查看留下的候选目录。
- 导出路径越界或符号链接逃逸: verify-export 返回路径错误,不读取外部文件。
- 哈希、大小、数量、账号或派生关系不一致,或清单损坏: 返回 failed 和完整 errors,不局部判 PASS。

- 保全目标必须由用户明确点名且尚不存在。
- 保全包按自己的格式验真,不当成持续增量档案;没有清单的旧阅读包只做较窄检查。验真不读源、不修包、不补缺口。
- 媒体不可用时保留 gap,不从其他目录补同名文件。
- 保全成品含真实私人内容,只留本机,不进入网站或 PUBLIC(公开) Git。
- 目标或 .incomplete 已存在: 拒绝覆盖并保留原目录,先由用户判断旧目录用途。
- 保全过程中出现普通错误: 清理这次新建的 .incomplete,原目标仍不存在;进程被强制结束时无法保证完成清理,要人工查看留下的候选目录。
- 导出路径越界或符号链接逃逸: verify-export 返回路径错误,不读取外部文件。
- 哈希、大小、数量、账号或派生关系不一致,或清单损坏: 返回 failed 和完整 errors,不局部判 PASS。

wechat_cli.py · command_preserve有界自包含保全和目录发布。
wechat_cli.py · command_verify_export联系人、朋友圈、阅读包和保全包四种格式的独立验真合同。
tests/消息、媒体、语音派生和 manifest(清单) 回归。test_wechat_cli.py · preservation
tests/路径、身份、哈希、数量和派生关系回归。test_public_commands.py · verify-export
- test_explicit_preservation_bundle_is_self_contained 验证保全自包含。
- test_verify_export_accepts_contact_and_moments_without_writes 验证两类持续导出;tests/test_product_completion.py 另定义阅读包、保全包和旧版阅读包的验真范围回归。
- test_verify_export_rejects_fixed_file_symlink_escape 验证路径逃逸失败。
- test_verify_export_rejects_cross_account_state 与媒体关系测试验证绑定。以上测试只清点定义,没有运行。
保全消费“聊天上下文”和“回复与媒体”;verify-export 验证“具名增量归档”“朋友圈缓存”的正式输出,也验证阅读包和保全包,但不替代源端读取、重核与媒体修复。

wechat_cli.py · command_preserve有界自包含保全和目录发布。
wechat_cli.py · command_verify_export联系人、朋友圈、阅读包和保全包四种格式的独立验真合同。
tests/消息、媒体、语音派生和 manifest(清单) 回归。test_wechat_cli.py · preservation
tests/路径、身份、哈希、数量和派生关系回归。test_public_commands.py · verify-export
- test_explicit_preservation_bundle_is_self_contained 验证保全自包含。
- test_verify_export_accepts_contact_and_moments_without_writes 验证两类持续导出;tests/test_product_completion.py 另定义阅读包、保全包和旧版阅读包的验真范围回归。
- test_verify_export_rejects_fixed_file_symlink_escape 验证路径逃逸失败。
- test_verify_export_rejects_cross_account_state 与媒体关系测试验证绑定。以上测试只清点定义,没有运行。
保全消费“聊天上下文”和“回复与媒体”;verify-export 验证“具名增量归档”“朋友圈缓存”的正式输出,也验证阅读包和保全包,但不替代源端读取、重核与媒体修复。
复制 AI 续作说明
项目:明确窗口保全、完整导出和独立验真;仓库:wlyaaaaa/WeChatDirect;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。





