

WeChatDirect · 功能说明
问一句微信事实时,不需要先导出整个账号。要补最近变化,可以先按明确账号与时间列出当前会话候选,再选要读的联系人或群;时间未知和扫描后又变化的会话也会保留,不把漏项说成无变化。要先找自己在大群说过什么,可筛本人及归属未定的发言,继续带着同一筛选翻页;需要别人的回应时再围绕命中补读。最终得到带账号、对象、时间、引用与附件关系的上下文,账号不明确或来源不可读就保留缺口。
当前情况:已有指定账号和对象的聊天读取、变化发现与引用处理;11 月 4 日核对时未读取真实会话,实际缺口由所选窗口返回。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库

WeChatDirect · 功能说明
问一句微信事实时,不需要先导出整个账号。要补最近变化,可以先按明确账号与时间列出当前会话候选,再选要读的联系人或群;时间未知和扫描后又变化的会话也会保留,不把漏项说成无变化。要先找自己在大群说过什么,可筛本人及归属未定的发言,继续带着同一筛选翻页;需要别人的回应时再围绕命中补读。最终得到带账号、对象、时间、引用与附件关系的上下文,账号不明确或来源不可读就保留缺口。
当前情况:已有指定账号和对象的聊天读取、变化发现与引用处理;11 月 4 日核对时未读取真实会话,实际缺口由所选窗口返回。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


用途与实际影响
一条消息的含义可能取决于谁发的、回复哪条、附件是什么,以及当前窗口是不是完整历史。只按关键词抄一句,容易把群成员、本人、系统消息和引用目标混在一起。
我问“项目群里最后是谁同意周五交付?”工具只翻这个群里够回答问题的一段,把说话人、时间和那句回复指向的原消息一起给我;主号、副号里都有同名群时,它先列候选,绝不蒙一个。
交回这次确实读到的一小段聊天:账号、联系人或群、时间范围、说话人、原回复和附件可用性。若只有小窗口或有遗漏,会说明实际范围,不能当整段历史。

用途与实际影响
一条消息的含义可能取决于谁发的、回复哪条、附件是什么,以及当前窗口是不是完整历史。只按关键词抄一句,容易把群成员、本人、系统消息和引用目标混在一起。
我问“项目群里最后是谁同意周五交付?”工具只翻这个群里够回答问题的一段,把说话人、时间和那句回复指向的原消息一起给我;主号、副号里都有同名群时,它先列候选,绝不蒙一个。
交回这次确实读到的一小段聊天:账号、联系人或群、时间范围、说话人、原回复和附件可用性。若只有小窗口或有遗漏,会说明实际范围,不能当整段历史。

账号和对象唯一,窗口可读,影响问题的发送者、引用和媒体关系都已返回。
对象重名、引用目标在窗口外、群成员标签不全或媒体打不开时,保留候选和缺口,并只扩大必要范围。
账号配置、身份承诺、本地消息库、时间索引或输出边界不成立时停止,不换来源补猜。

账号和对象唯一,窗口可读,影响问题的发送者、引用和媒体关系都已返回。
对象重名、引用目标在窗口外、群成员标签不全或媒体打不开时,保留候选和缺口,并只扩大必要范围。
账号配置、身份承诺、本地消息库、时间索引或输出边界不成立时停止,不换来源补猜。

说明账号、联系人或群,以及要问的那段微信事实。
- 微信账号和要看的联系人或群
- 时间、关键词或本人参与线索(如有)


说明账号、联系人或群,以及要问的那段微信事实。
- 微信账号和要看的联系人或群
- 时间、关键词或本人参与线索(如有)



数字截至 2026 年 11 月 6 日


- changes固定discovery.requestedWindow.untilS;按明确primary/secondary/both独立读取当前SessionTable(只查已配置的槽位),保留隐藏会话、时间未知项和observed_after_until候选。completeScope只覆盖当前表,historicalChangeDetection明确不检测已消失会话、旧消息补入/撤回、正文或标签修订。
- --self-only在fetch_messages解码前按当前分片发送者方向筛self/unknown(未验证),selectionScope与coverage.senderScope均为self_messages_and_unresolved_senders。v2游标绑定selfOnly,续查不能改变筛选;v1普通游标继续兼容。引用目标按原生ID补取,不把筛选结果当作全群上下文。
- _resolve_contact 只在已配置的一个或两个槽位中按当前联系人目录解析唯一对象,contact_ambiguous 返回公开安全候选;显式指定了未配置的账号时返回 wechat_account_not_configured,不拿另一个账号代读。
- _context_result 校验扫描与返回上限,按 since / until / lookback / around / contains 形成有界窗口。
- _sender_receipt 保留 self、other、system、unknown(未验证) 与群成员标签;文件传输助手只加标签,不改写原生角色。
- 返回 scannedSenderRoleCounts、returnedSenderRoleCounts、selfObservation、availableHistoryHint 与 gaps。
- Canonical JSON(规范 JSON)计算 manifestSha256。输出超过本次字节预算时先减少消息页数,单条长文本改为分段续读;只有极端元数据仍超预算才返回 context_metadata_too_large_use_export_context,并指向新目录阅读包这条路。


- changes固定discovery.requestedWindow.untilS;按明确primary/secondary/both独立读取当前SessionTable(只查已配置的槽位),保留隐藏会话、时间未知项和observed_after_until候选。completeScope只覆盖当前表,historicalChangeDetection明确不检测已消失会话、旧消息补入/撤回、正文或标签修订。
- --self-only在fetch_messages解码前按当前分片发送者方向筛self/unknown(未验证),selectionScope与coverage.senderScope均为self_messages_and_unresolved_senders。v2游标绑定selfOnly,续查不能改变筛选;v1普通游标继续兼容。引用目标按原生ID补取,不把筛选结果当作全群上下文。
- _resolve_contact 只在已配置的一个或两个槽位中按当前联系人目录解析唯一对象,contact_ambiguous 返回公开安全候选;显式指定了未配置的账号时返回 wechat_account_not_configured,不拿另一个账号代读。
- _context_result 校验扫描与返回上限,按 since / until / lookback / around / contains 形成有界窗口。
- _sender_receipt 保留 self、other、system、unknown(未验证) 与群成员标签;文件传输助手只加标签,不改写原生角色。
- 返回 scannedSenderRoleCounts、returnedSenderRoleCounts、selfObservation、availableHistoryHint 与 gaps。
- Canonical JSON(规范 JSON)计算 manifestSha256。输出超过本次字节预算时先减少消息页数,单条长文本改为分段续读;只有极端元数据仍超预算才返回 context_metadata_too_large_use_export_context,并指向新目录阅读包这条路。

- context --byte-limit限制32–512KiB终端JSON,普通continuation负责其余消息;segmentedFields仅是长字段预览,message-part绑定同一显式账号/对象、偏移和whole-text hash(内容指纹)续读。source_changed要求重新context,不能跨版本拼接;便携export-context仍保存选定全文,终端预算不截断阅读包里的文件。


- context --byte-limit限制32–512KiB终端JSON,普通continuation负责其余消息;segmentedFields仅是长字段预览,message-part绑定同一显式账号/对象、偏移和whole-text hash(内容指纹)续读。source_changed要求重新context,不能跨版本拼接;便携export-context仍保存选定全文,终端预算不截断阅读包里的文件。



| 名词 | 意思 |
|---|---|
| Bounded context(有界上下文) | 账号、对象、时间和返回数量都明确的一小段消息,不代表远端或本地全历史。 |
| Sender role(发送者角色) | self、other、system 或 unknown(未验证);群聊还单独解析成员标签。 |
| availableHistoryHint | 窗口为空时说明当前本机是否仍知道更早、更晚或不可读消息存在。 |
| manifestSha256 | 对本次规范结果计算的整体内容指纹,用于确认回执没有静默变化。 |

先用changes发现当前变化候选,再对明确对象读取有界上下文;可以先筛本人参与,缺少他人回应时再补读。



先用changes发现当前变化候选,再对明确对象读取有界上下文;可以先筛本人参与,缺少他人回应时再补读。

- 最多扫描 500 条、返回 80 条,默认回看 7 天。
- 不自动把窗口扩大到整个联系人、群或账号。
- 当前设备本地可见范围不等于微信远端全历史。
- changes完整不等于历史变化完整;self-only完整不等于全群上下文完整;精确引用回查仍受本机可读范围约束。
- 不把真实联系人、聊天正文或媒体复制到网页。
- 多个账号或对象精确匹配: 返回 contact_ambiguous 候选,等待用户选定,不取第一项。
- 关键词或时间锚点未命中: 返回明确锚点缺口;只在用户需要时调整窗口。

- 最多扫描 500 条、返回 80 条,默认回看 7 天。
- 不自动把窗口扩大到整个联系人、群或账号。
- 当前设备本地可见范围不等于微信远端全历史。
- changes完整不等于历史变化完整;self-only完整不等于全群上下文完整;精确引用回查仍受本机可读范围约束。
- 不把真实联系人、聊天正文或媒体复制到网页。
- 多个账号或对象精确匹配: 返回 contact_ambiguous 候选,等待用户选定,不取第一项。
- 关键词或时间锚点未命中: 返回明确锚点缺口;只在用户需要时调整窗口。

- 回复目标或媒体不在当前可见范围: 保留 quote_target_missing / media_not_openable 等 gaps,不伪造正文。
- 输出太大或消息库缺索引: 两件事分开处理。输出太大时先缩页、长文本分段续读,仍不够就改用 export-context 生成阅读包;缺索引才需要缩小范围或修复源级索引后重试。

- 回复目标或媒体不在当前可见范围: 保留 quote_target_missing / media_not_openable 等 gaps,不伪造正文。
- 输出太大或消息库缺索引: 两件事分开处理。输出太大时先缩页、长文本分段续读,仍不够就改用 export-context 生成阅读包;缺索引才需要缩小范围或修复源级索引后重试。

README.md · context自然语言用途、命令示例与小窗口边界。
wechat_cli.py · _resolve_contact /唯一对象解析、窗口选择、发送者、回复和结果合同。_context_result
wechat_source.py · fetch_messages分片消息读取、内容投影、索引与媒体关系。
tests/对象歧义、窗口角色、引用目标、媒体缺口和空窗口回归。test_wechat_cli.py
- test_exact_contact_ambiguity_never_picks_first 验证多匹配不猜。
- test_context_keeps_native_ids_quote_target_and_media_gap 验证消息、引用和媒体缺口。
- test_empty_context_reports_that_older_local_history_exists 验证空窗口不冒充全历史为空。
- 真实可用性仍需用户点名对象后的 context E2E(端到端验证),本次网页刷新未执行。
这是一次性问题的默认入口;实时聊天里按消息编号取完整上下文走另一个入口,见实时聊天怎么读懂语音;需要长期保存时进入“具名增量归档”,需要打开附件时进入“回复与媒体关系”。

README.md · context自然语言用途、命令示例与小窗口边界。
wechat_cli.py · _resolve_contact /唯一对象解析、窗口选择、发送者、回复和结果合同。_context_result
wechat_source.py · fetch_messages分片消息读取、内容投影、索引与媒体关系。
tests/对象歧义、窗口角色、引用目标、媒体缺口和空窗口回归。test_wechat_cli.py
- test_exact_contact_ambiguity_never_picks_first 验证多匹配不猜。
- test_context_keeps_native_ids_quote_target_and_media_gap 验证消息、引用和媒体缺口。
- test_empty_context_reports_that_older_local_history_exists 验证空窗口不冒充全历史为空。
- 真实可用性仍需用户点名对象后的 context E2E(端到端验证),本次网页刷新未执行。
这是一次性问题的默认入口;实时聊天里按消息编号取完整上下文走另一个入口,见实时聊天怎么读懂语音;需要长期保存时进入“具名增量归档”,需要打开附件时进入“回复与媒体关系”。
复制 AI 续作说明
项目:只读一个明确对象的最小有用聊天上下文;仓库:wlyaaaaa/WeChatDirect;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








