
WeChatDirect · 功能说明
消费项目看到的是同一顺序的聊天和真正能查看的附件,不用从文件名、占位文字或一堆无关系文件猜意思。
当前情况:已有交付有序聊天、回复和可读附件的功能;11 月 4 日核对时没有重新打开真实媒体或补取远端附件。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


WeChatDirect · 功能说明
消费项目看到的是同一顺序的聊天和真正能查看的附件,不用从文件名、占位文字或一堆无关系文件猜意思。
当前情况:已有交付有序聊天、回复和可读附件的功能;11 月 4 日核对时没有重新打开真实媒体或补取远端附件。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


用途与实际影响
文件去重不应抹掉表情在对话里出现多次的语境,找到本地路径也不意味着图片可解码。来源、出现位置、实际字节和质量必须分别保留。
我说“把这段讨论和其中的图片交给另一个项目继续看”。它给出有序消息页、原回复和能打开的图片或表情;读不到的附件明说原因,有下一页就沿原查询继续,而不是替我猜图里写了什么。
交回按消息顺序阅读的聊天和实际能打开的图片、语音或文件;每个附件都能回到原消息。图片和表情现在一步就给出该看的那个文件:普通静图是原文件,单帧或每帧都一样的 GIF 是一张静图,真动图是按时间排好、标了帧号和秒数的拼图。AI 要实际打开看;拼图没放全不同的帧,快动作、文字或结尾又看不清时,再从保留的原动画补帧,不拿第一帧当完整意思。打不开或不知来源的项目保留缺口,不拿文件名猜内容。同一条语音如果微信自己已经转好文字,也一起带上,但那只是微信的转写,不算逐字核对过;正在聊的语音走另一条路,见实时聊天怎么读懂语音。新版加密月缓存里的表情,明确要打开时可以在本机解开,前提是选定的号正登录着;平时读聊天不需要这个条件,条件不满足也只留这一个缺口。
消息与附件的实际内容核对后,一起交给需要继续工作的项目。
某条回复或附件缺失时,交回仍可读的部分、缺口和下一页位置,不冒充全历史。
来源或附件身份不能核对时只停这部分,不拼造地址或泄露解密材料。

用途与实际影响
文件去重不应抹掉表情在对话里出现多次的语境,找到本地路径也不意味着图片可解码。来源、出现位置、实际字节和质量必须分别保留。
我说“把这段讨论和其中的图片交给另一个项目继续看”。它给出有序消息页、原回复和能打开的图片或表情;读不到的附件明说原因,有下一页就沿原查询继续,而不是替我猜图里写了什么。
交回按消息顺序阅读的聊天和实际能打开的图片、语音或文件;每个附件都能回到原消息。图片和表情现在一步就给出该看的那个文件:普通静图是原文件,单帧或每帧都一样的 GIF 是一张静图,真动图是按时间排好、标了帧号和秒数的拼图。AI 要实际打开看;拼图没放全不同的帧,快动作、文字或结尾又看不清时,再从保留的原动画补帧,不拿第一帧当完整意思。打不开或不知来源的项目保留缺口,不拿文件名猜内容。同一条语音如果微信自己已经转好文字,也一起带上,但那只是微信的转写,不算逐字核对过;正在聊的语音走另一条路,见实时聊天怎么读懂语音。新版加密月缓存里的表情,明确要打开时可以在本机解开,前提是选定的号正登录着;平时读聊天不需要这个条件,条件不满足也只留这一个缺口。
消息与附件的实际内容核对后,一起交给需要继续工作的项目。
某条回复或附件缺失时,交回仍可读的部分、缺口和下一页位置,不冒充全历史。
来源或附件身份不能核对时只停这部分,不拼造地址或泄露解密材料。

问一句“可以”回复了谁,或某个语音和文件属于哪条消息。
- 选定会话
- 想核对的回复原话或附件线索


问一句“可以”回复了谁,或某个语音和文件属于哪条消息。
- 选定会话
- 想核对的回复原话或附件线索



- wechat_source.py 负责原生引用、分片 Name2Id、消息类型投影和账号绑定 locator(原件定位记录);长 serverId/nativeId 始终以字符串返回。@openim 文字与非文字方向优先取当前分片的本人原生身份。
- wechat_media.py 沿消息原生索引定位与物化;wechat_image.py 校验 DAT 解码和图片,wechat_wxgf.py 验证封装分区、视频流与帧数,不猜完整动画。


- wechat_source.py 负责原生引用、分片 Name2Id、消息类型投影和账号绑定 locator(原件定位记录);长 serverId/nativeId 始终以字符串返回。@openim 文字与非文字方向优先取当前分片的本人原生身份。
- wechat_media.py 沿消息原生索引定位与物化;wechat_image.py 校验 DAT 解码和图片,wechat_wxgf.py 验证封装分区、视频流与帧数,不猜完整动画。
数字截至 2026 年 11 月 6 日

- 表情远端只使用同条消息已有地址,并核对原生 MD5、声明大小和图片解码;失败保留原 gap,不搜索替代图片。
- export-context 使用与 context 相同的范围、锚点和游标,将实际媒体写入新目录,重复字节可复用,每次消息位置不去重。生成的阅读包可以用同一个 verify-export 离线核对清单、声明文件以及账号、消息、媒体和派生关系。
- wechat_render.py 可选生成引用同一媒体的 HTML;AI 默认读取 JSON/Markdown 与媒体文件,不需要浏览器、服务或源数据库 locator(原件定位记录)。

- 表情远端只使用同条消息已有地址,并核对原生 MD5、声明大小和图片解码;失败保留原 gap,不搜索替代图片。
- export-context 使用与 context 相同的范围、锚点和游标,将实际媒体写入新目录,重复字节可复用,每次消息位置不去重。生成的阅读包可以用同一个 verify-export 离线核对清单、声明文件以及账号、消息、媒体和派生关系。
- wechat_render.py 可选生成引用同一媒体的 HTML;AI 默认读取 JSON/Markdown 与媒体文件,不需要浏览器、服务或源数据库 locator(原件定位记录)。

- repair-media只对一个明确账号/contact/output归档补本地媒体或派生WAV,--message-id/--kind进一步收窄,并复用已核对过的 SILK/WAV;不重扫聊天、不请求CDN,不改原增量游标。只有附件后来下载到本机、当前可读才补得上。单语音派生失败单独记录,不抹掉已可用消息与其他附件。


- repair-media只对一个明确账号/contact/output归档补本地媒体或派生WAV,--message-id/--kind进一步收窄,并复用已核对过的 SILK/WAV;不重扫聊天、不请求CDN,不改原增量游标。只有附件后来下载到本机、当前可读才补得上。单语音派生失败单独记录,不抹掉已可用消息与其他附件。



| 名词 | 意思 |
|---|---|
| Materialization(物化) | 从已绑定原生来源取得实际可读文件;找到路径只是候选,不能先宣布打开成功。 |
| Occurrence(出现位置) | 同一张图或表情在不同消息中各有语境,字节可以复用,位置和关系不能被去重抹掉。 |
| WXGF | 微信图像封装;复杂分区或透明度关系未证明时保持缺口,不把首帧冒充完整动图。 |

一条消息的意思常在它引用的文字和附件里。现在可把有序消息、真实可读媒体及缺口交给 AI;HTML 只是可选查看方式。



一条消息的意思常在它引用的文字和附件里。现在可把有序消息、真实可读媒体及缺口交给 AI;HTML 只是可选查看方式。

- 媒体含义必须实际阅读后由消费项目与 AI 判断。
- 不扫描模糊文件名、不搜索或拼造媒体地址。
- 阅读包不携带源数据库 locator(原件定位记录)、私有 URL 或解密参数。
- 输出与同名 .incomplete 必须不存在;已有内容不自动接管或覆盖。单个媒体文件用排他方式发布,写入时目标突然出现也不覆盖;已有的 WAV 派生文件不覆写,失败时只清掉这次新生成的文件。
- 转写、说话人归属和媒体库入库均属于另外明确的任务。
- 原生 MD5、大小或实际格式不匹配: 拒绝该媒体并保留原消息和 gap;不以相邻文件或网络搜索替换。

- 媒体含义必须实际阅读后由消费项目与 AI 判断。
- 不扫描模糊文件名、不搜索或拼造媒体地址。
- 阅读包不携带源数据库 locator(原件定位记录)、私有 URL 或解密参数。
- 输出与同名 .incomplete 必须不存在;已有内容不自动接管或覆盖。单个媒体文件用排他方式发布,写入时目标突然出现也不覆盖;已有的 WAV 派生文件不覆写,失败时只清掉这次新生成的文件。
- 转写、说话人归属和媒体库入库均属于另外明确的任务。
- 原生 MD5、大小或实际格式不匹配: 拒绝该媒体并保留原消息和 gap;不以相邻文件或网络搜索替换。

- WXGF 多分区或透明度关系不能证明: 返回不可解缺口,不静默裁成一帧。
- 只找到缩略图: 按 thumbnail 质量交付,不标成 original。
- 阅读包只有部分内容可读: 返回 partial、每项失败和 continuation;失败回执的 retryable / nextAction 不扩大账号、聊天或写入范围。

- WXGF 多分区或透明度关系不能证明: 返回不可解缺口,不静默裁成一帧。
- 只找到缩略图: 按 thumbnail 质量交付,不标成 original。
- 阅读包只有部分内容可读: 返回 partial、每项失败和 continuation;失败回执的 retryable / nextAction 不扩大账号、聊天或写入范围。

wechat_source.py原生消息、引用、身份、转账与红包投影
wechat_media.py /原生定位、DAT与WXGF物化和字节验证wechat_image.py / wechat_wxgf.py
wechat_render.py /阅读包、可选HTML与范围化CLI(命令行工具)wechat_cli.py
tests/有序交付、分页和分片身份回归test_reading_package.py / test_context_paging.py / test_sender_identity.py
- 9月7日合成套件137项与32个子测试通过,覆盖图片、动画、原生媒体、阅读包、分页、发送方向及归档完整性;之后未重新运行。当前源码另有排他发布与语音派生失败的回归定义(tests/test_archive_reliability.py、test_completion_reliability.py),11 月 4 日核对时没有运行。
- 11 月 4 日核对时没有读取真实微信正文或媒体,没有访问表情 CDN,没有执行个人归档或媒体库入库。
聊天上下文确定最小范围;本模块交付其中真正可读的消息、引用和媒体,阅读包可用 verify-export 单独验真。长期归档及独立保全继续使用各自的状态与验真合同;实时会话里接收语音的补全和技术细节见收发和实时会话的技术依据。

wechat_source.py原生消息、引用、身份、转账与红包投影
wechat_media.py /原生定位、DAT与WXGF物化和字节验证wechat_image.py / wechat_wxgf.py
wechat_render.py /阅读包、可选HTML与范围化CLI(命令行工具)wechat_cli.py
tests/有序交付、分页和分片身份回归test_reading_package.py / test_context_paging.py / test_sender_identity.py
- 9月7日合成套件137项与32个子测试通过,覆盖图片、动画、原生媒体、阅读包、分页、发送方向及归档完整性;之后未重新运行。当前源码另有排他发布与语音派生失败的回归定义(tests/test_archive_reliability.py、test_completion_reliability.py),11 月 4 日核对时没有运行。
- 11 月 4 日核对时没有读取真实微信正文或媒体,没有访问表情 CDN,没有执行个人归档或媒体库入库。
聊天上下文确定最小范围;本模块交付其中真正可读的消息、引用和媒体,阅读包可用 verify-export 单独验真。长期归档及独立保全继续使用各自的状态与验真合同;实时会话里接收语音的补全和技术细节见收发和实时会话的技术依据。
复制 AI 续作说明
项目:按消息顺序交付原回复、可读媒体和可继续阅读的包;仓库:wlyaaaaa/WeChatDirect;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。





