按消息顺序交付原回复、可读媒体和可继续阅读的包
现在
常用
截至 11 月 6 日 · 项目源码

WeChatDirect · 功能说明

消费项目看到的是同一顺序的聊天和真正能查看的附件,不用从文件名、占位文字或一堆无关系文件猜意思。

当前情况:已有交付有序聊天、回复和可读附件的功能;11 月 4 日核对时没有重新打开真实媒体或补取远端附件。

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

项目源码

公开仓库

按消息顺序交付原回复、可读媒体和可继续阅读的包
现在
常用
截至 11 月 6 日 · 项目源码

WeChatDirect · 功能说明

消费项目看到的是同一顺序的聊天和真正能查看的附件,不用从文件名、占位文字或一堆无关系文件猜意思。

当前情况:已有交付有序聊天、回复和可读附件的功能;11 月 4 日核对时没有重新打开真实媒体或补取远端附件。

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

项目源码

公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

文件去重不应抹掉表情在对话里出现多次的语境,找到本地路径也不意味着图片可解码。来源、出现位置、实际字节和质量必须分别保留。

举个实际例子

我说“把这段讨论和其中的图片交给另一个项目继续看”。它给出有序消息页、原回复和能打开的图片或表情;读不到的附件明说原因,有下一页就沿原查询继续,而不是替我猜图里写了什么。

最后我会得到什么

交回按消息顺序阅读的聊天和实际能打开的图片、语音或文件;每个附件都能回到原消息。图片和表情现在一步就给出该看的那个文件:普通静图是原文件,单帧或每帧都一样的 GIF 是一张静图,真动图是按时间排好、标了帧号和秒数的拼图。AI 要实际打开看;拼图没放全不同的帧,快动作、文字或结尾又看不清时,再从保留的原动画补帧,不拿第一帧当完整意思。打不开或不知来源的项目保留缺口,不拿文件名猜内容。同一条语音如果微信自己已经转好文字,也一起带上,但那只是微信的转写,不算逐字核对过;正在聊的语音走另一条路,见实时聊天怎么读懂语音。新版加密月缓存里的表情,明确要打开时可以在本机解开,前提是选定的号正登录着;平时读聊天不需要这个条件,条件不满足也只留这一个缺口。

结果怎么看
可直接使用

消息与附件的实际内容核对后,一起交给需要继续工作的项目。

需要确认

某条回复或附件缺失时,交回仍可读的部分、缺口和下一页位置,不冒充全历史。

当前不可用

来源或附件身份不能核对时只停这部分,不拼造地址或泄露解密材料。

这项功能怎样使用

用途与实际影响

为什么需要它

文件去重不应抹掉表情在对话里出现多次的语境,找到本地路径也不意味着图片可解码。来源、出现位置、实际字节和质量必须分别保留。

举个实际例子

我说“把这段讨论和其中的图片交给另一个项目继续看”。它给出有序消息页、原回复和能打开的图片或表情;读不到的附件明说原因,有下一页就沿原查询继续,而不是替我猜图里写了什么。

最后我会得到什么

交回按消息顺序阅读的聊天和实际能打开的图片、语音或文件;每个附件都能回到原消息。图片和表情现在一步就给出该看的那个文件:普通静图是原文件,单帧或每帧都一样的 GIF 是一张静图,真动图是按时间排好、标了帧号和秒数的拼图。AI 要实际打开看;拼图没放全不同的帧,快动作、文字或结尾又看不清时,再从保留的原动画补帧,不拿第一帧当完整意思。打不开或不知来源的项目保留缺口,不拿文件名猜内容。同一条语音如果微信自己已经转好文字,也一起带上,但那只是微信的转写,不算逐字核对过;正在聊的语音走另一条路,见实时聊天怎么读懂语音。新版加密月缓存里的表情,明确要打开时可以在本机解开,前提是选定的号正登录着;平时读聊天不需要这个条件,条件不满足也只留这一个缺口。

结果怎么看
可直接使用

消息与附件的实际内容核对后,一起交给需要继续工作的项目。

需要确认

某条回复或附件缺失时,交回仍可读的部分、缺口和下一页位置,不冒充全历史。

当前不可用

来源或附件身份不能核对时只停这部分,不拼造地址或泄露解密材料。

从哪里开始

问一句“可以”回复了谁,或某个语音和文件属于哪条消息。

需要准备什么
  • 选定会话
  • 想核对的回复原话或附件线索
从开始到拿到结果
1系统核对并处理
按真实消息顺序连接引用目标、发送者与附件;打不开的媒体保留位置和失败说明,不从邻近文件猜。
2交付与接续
交回可继续阅读的小窗口或档案包;回复目标不明时保留未知。
从哪里开始

问一句“可以”回复了谁,或某个语音和文件属于哪条消息。

需要准备什么
  • 选定会话
  • 想核对的回复原话或附件线索
从开始到拿到结果
1系统核对并处理
按真实消息顺序连接引用目标、发送者与附件;打不开的媒体保留位置和失败说明,不从邻近文件猜。
2交付与接续
交回可继续阅读的小窗口或档案包;回复目标不明时保留未知。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
当前源码 v0.2.3(最后提交 2026-11-06)已核对,共定义 434 个测试函数(2026-11-04 重数,之后的提交没有重数),没有运行;137项/32子测试保留9月7日证据(之后未重新运行)。11 月 4 日核对时没有打开真实微信媒体、访问 CDN 或重做归档
关键规则与设计选择
1
context 只查本机;显式 export-context / media-open 才可物化同条表情自带的原生 CDN,--local-only 可禁止。sync-contact 与 preserve 不自动向远端补表情。
2
图片按消息 MD5 与 hardlink.db 精确定位;V1/V2 DAT 使用身份一致的既有保护配置在进程内解码,密钥不进入包、终端或 Git。
3
表情保留 PNG/GIF 等真实格式和每次出现。图片和表情 materialize 时同时给出 view.path(f35e3e5,11 月 6 日):静图是原文件,单帧或全相同帧 GIF 是 still.png,真动图是 frames.png,最多 25 个不同帧且含首尾,complete=false 表示还有帧没展示;view=null/viewError 是查看派生没成功,原文件仍可能已交付。media-open --output 的扩展名按真实内容修正,最终路径以回执 output 为准。媒体已物化、已生成查看图与 AI 已实际看懂是三件事;安装入口的 media-open --help 只读回查过,没有调用真实媒体。WXGF 依赖现有 ffmpeg/ffprobe,只在分区与帧数可证明时转成 PNG 或保持动作的 GIF。
4
VoiceInfo 保留 SILK,按需派生 WAV;对非语音消息要 --voice-wav 会在取任何媒体之前就拒绝。解码超时、解释器不可用或生成的 WAV 不合格时,只把这一条记为缺口,原 SILK 和其余消息照常可用,不判整包失败。通话事件仍只是状态。视频和文件仅在原生 MD5 索引找到实际本机文件时交付。
5
openable=null、materializable=true 表示找到候选但尚未证明可读;实际成功才能升级。requiresNetwork 说明是否需要原生远端物化。
6
转账正文按原生结算子类型投影,红包单独识别;程序解释消息格式,不代替支付平台的现实结算核对。
7
同条语音已完成的微信转写缓存投影成 contentSource=wechat_native_cache,保留音频,verbatimVerified=false;待转或没有缓存不算文字(11 月 3 日 847e6bb)。
8
显式 media-open、导出或保全可解开本机加密月缓存表情,保留动画并核对同消息 MD5 和长度;只读校验当前微信核心指纹及前后账号身份,密钥只在内存,不注入 DLL、不启动原生服务或会话。这条路要已安装的 helper 和选定账号正登录;普通 context 只报告可物化,不读微信进程(11 月 3 日 1086f22)。
当前怎样实现
  • wechat_source.py 负责原生引用、分片 Name2Id、消息类型投影和账号绑定 locator(原件定位记录);长 serverId/nativeId 始终以字符串返回。@openim 文字与非文字方向优先取当前分片的本人原生身份。
  • wechat_media.py 沿消息原生索引定位与物化;wechat_image.py 校验 DAT 解码和图片,wechat_wxgf.py 验证封装分区、视频流与帧数,不猜完整动画。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
当前源码 v0.2.3(最后提交 2026-11-06)已核对,共定义 434 个测试函数(2026-11-04 重数,之后的提交没有重数),没有运行;137项/32子测试保留9月7日证据(之后未重新运行)。11 月 4 日核对时没有打开真实微信媒体、访问 CDN 或重做归档
关键规则与设计选择
1
context 只查本机;显式 export-context / media-open 才可物化同条表情自带的原生 CDN,--local-only 可禁止。sync-contact 与 preserve 不自动向远端补表情。
2
图片按消息 MD5 与 hardlink.db 精确定位;V1/V2 DAT 使用身份一致的既有保护配置在进程内解码,密钥不进入包、终端或 Git。
3
表情保留 PNG/GIF 等真实格式和每次出现。图片和表情 materialize 时同时给出 view.path(f35e3e5,11 月 6 日):静图是原文件,单帧或全相同帧 GIF 是 still.png,真动图是 frames.png,最多 25 个不同帧且含首尾,complete=false 表示还有帧没展示;view=null/viewError 是查看派生没成功,原文件仍可能已交付。media-open --output 的扩展名按真实内容修正,最终路径以回执 output 为准。媒体已物化、已生成查看图与 AI 已实际看懂是三件事;安装入口的 media-open --help 只读回查过,没有调用真实媒体。WXGF 依赖现有 ffmpeg/ffprobe,只在分区与帧数可证明时转成 PNG 或保持动作的 GIF。
4
VoiceInfo 保留 SILK,按需派生 WAV;对非语音消息要 --voice-wav 会在取任何媒体之前就拒绝。解码超时、解释器不可用或生成的 WAV 不合格时,只把这一条记为缺口,原 SILK 和其余消息照常可用,不判整包失败。通话事件仍只是状态。视频和文件仅在原生 MD5 索引找到实际本机文件时交付。
5
openable=null、materializable=true 表示找到候选但尚未证明可读;实际成功才能升级。requiresNetwork 说明是否需要原生远端物化。
6
转账正文按原生结算子类型投影,红包单独识别;程序解释消息格式,不代替支付平台的现实结算核对。
7
同条语音已完成的微信转写缓存投影成 contentSource=wechat_native_cache,保留音频,verbatimVerified=false;待转或没有缓存不算文字(11 月 3 日 847e6bb)。
8
显式 media-open、导出或保全可解开本机加密月缓存表情,保留动画并核对同消息 MD5 和长度;只读校验当前微信核心指纹及前后账号身份,密钥只在内存,不注入 DLL、不启动原生服务或会话。这条路要已安装的 helper 和选定账号正登录;普通 context 只报告可物化,不读微信进程(11 月 3 日 1086f22)。
当前怎样实现
  • 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(原件定位记录)。
技术实现与依据(三)
1
固定账号、对象和查询窗口
2
按原生消息顺序读取正文与引用
3
验证每条媒体的原生来源
4
按请求进行本地或原生表情物化
5
核对实际格式、字节与质量
6
生成新阅读包并保留逐项缺口
7
有后续内容时沿原游标继续
  • repair-media只对一个明确账号/contact/output归档补本地媒体或派生WAV,--message-id/--kind进一步收窄,并复用已核对过的 SILK/WAV;不重扫聊天、不请求CDN,不改原增量游标。只有附件后来下载到本机、当前可读才补得上。单语音派生失败单独记录,不抹掉已可用消息与其他附件。
执行流程
技术实现与依据(三)
1
固定账号、对象和查询窗口
2
按原生消息顺序读取正文与引用
3
验证每条媒体的原生来源
4
按请求进行本地或原生表情物化
5
核对实际格式、字节与质量
6
生成新阅读包并保留逐项缺口
7
有后续内容时沿原游标继续
  • repair-media只对一个明确账号/contact/output归档补本地媒体或派生WAV,--message-id/--kind进一步收窄,并复用已核对过的 SILK/WAV;不重扫聊天、不请求CDN,不改原增量游标。只有附件后来下载到本机、当前可读才补得上。单语音派生失败单独记录,不抹掉已可用消息与其他附件。
执行流程
名词和入口
本模块用到的名词
名词意思
Materialization(物化)从已绑定原生来源取得实际可读文件;找到路径只是候选,不能先宣布打开成功。
Occurrence(出现位置)同一张图或表情在不同消息中各有语境,字节可以复用,位置和关系不能被去重抹掉。
WXGF微信图像封装;复杂分区或透明度关系未证明时保持缺口,不把首帧冒充完整动图。
专业定义

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

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

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

出问题时(一)
解决什么
解决引用失联、媒体占位冒充已读、动图丢动作、发送方向错误和跨项目交付只剩 HTML 的问题。
边界
  • 媒体含义必须实际阅读后由消费项目与 AI 判断。
  • 不扫描模糊文件名、不搜索或拼造媒体地址。
  • 阅读包不携带源数据库 locator(原件定位记录)、私有 URL 或解密参数。
  • 输出与同名 .incomplete 必须不存在;已有内容不自动接管或覆盖。单个媒体文件用排他方式发布,写入时目标突然出现也不覆盖;已有的 WAV 派生文件不覆写,失败时只清掉这次新生成的文件。
  • 转写、说话人归属和媒体库入库均属于另外明确的任务。
失败与恢复
  • 原生 MD5、大小或实际格式不匹配: 拒绝该媒体并保留原消息和 gap;不以相邻文件或网络搜索替换。
出问题时(一)
解决什么
解决引用失联、媒体占位冒充已读、动图丢动作、发送方向错误和跨项目交付只剩 HTML 的问题。
边界
  • 媒体含义必须实际阅读后由消费项目与 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 / wechat_image.py / wechat_wxgf.py原生定位、DAT与WXGF物化和字节验证
  • wechat_render.py / wechat_cli.py阅读包、可选HTML与范围化CLI(命令行工具)
  • 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 / wechat_image.py / wechat_wxgf.py原生定位、DAT与WXGF物化和字节验证
  • wechat_render.py / wechat_cli.py阅读包、可选HTML与范围化CLI(命令行工具)
  • 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。