只读一个明确对象的最小有用聊天上下文
现在
常用
截至 11 月 6 日 · 项目源码和环境体检

WeChatDirect · 功能说明

问一句微信事实时,不需要先导出整个账号。要补最近变化,可以先按明确账号与时间列出当前会话候选,再选要读的联系人或群;时间未知和扫描后又变化的会话也会保留,不把漏项说成无变化。要先找自己在大群说过什么,可筛本人及归属未定的发言,继续带着同一筛选翻页;需要别人的回应时再围绕命中补读。最终得到带账号、对象、时间、引用与附件关系的上下文,账号不明确或来源不可读就保留缺口。

当前情况:已有指定账号和对象的聊天读取、变化发现与引用处理;11 月 4 日核对时未读取真实会话,实际缺口由所选窗口返回。

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

项目源码

公开仓库

只读一个明确对象的最小有用聊天上下文
现在
常用
截至 11 月 6 日 · 项目源码和环境体检

WeChatDirect · 功能说明

问一句微信事实时,不需要先导出整个账号。要补最近变化,可以先按明确账号与时间列出当前会话候选,再选要读的联系人或群;时间未知和扫描后又变化的会话也会保留,不把漏项说成无变化。要先找自己在大群说过什么,可筛本人及归属未定的发言,继续带着同一筛选翻页;需要别人的回应时再围绕命中补读。最终得到带账号、对象、时间、引用与附件关系的上下文,账号不明确或来源不可读就保留缺口。

当前情况:已有指定账号和对象的聊天读取、变化发现与引用处理;11 月 4 日核对时未读取真实会话,实际缺口由所选窗口返回。

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

项目源码

公开仓库

这项功能怎样使用

用途与实际影响

为什么需要它

一条消息的含义可能取决于谁发的、回复哪条、附件是什么,以及当前窗口是不是完整历史。只按关键词抄一句,容易把群成员、本人、系统消息和引用目标混在一起。

举个实际例子

我问“项目群里最后是谁同意周五交付?”工具只翻这个群里够回答问题的一段,把说话人、时间和那句回复指向的原消息一起给我;主号、副号里都有同名群时,它先列候选,绝不蒙一个。

最后我会得到什么

交回这次确实读到的一小段聊天:账号、联系人或群、时间范围、说话人、原回复和附件可用性。若只有小窗口或有遗漏,会说明实际范围,不能当整段历史。

这项功能怎样使用

用途与实际影响

为什么需要它

一条消息的含义可能取决于谁发的、回复哪条、附件是什么,以及当前窗口是不是完整历史。只按关键词抄一句,容易把群成员、本人、系统消息和引用目标混在一起。

举个实际例子

我问“项目群里最后是谁同意周五交付?”工具只翻这个群里够回答问题的一段,把说话人、时间和那句回复指向的原消息一起给我;主号、副号里都有同名群时,它先列候选,绝不蒙一个。

最后我会得到什么

交回这次确实读到的一小段聊天:账号、联系人或群、时间范围、说话人、原回复和附件可用性。若只有小窗口或有遗漏,会说明实际范围,不能当整段历史。

结果怎么看
可直接使用

账号和对象唯一,窗口可读,影响问题的发送者、引用和媒体关系都已返回。

需要确认

对象重名、引用目标在窗口外、群成员标签不全或媒体打不开时,保留候选和缺口,并只扩大必要范围。

当前不可用

账号配置、身份承诺、本地消息库、时间索引或输出边界不成立时停止,不换来源补猜。

结果怎么看
可直接使用

账号和对象唯一,窗口可读,影响问题的发送者、引用和媒体关系都已返回。

需要确认

对象重名、引用目标在窗口外、群成员标签不全或媒体打不开时,保留候选和缺口,并只扩大必要范围。

当前不可用

账号配置、身份承诺、本地消息库、时间索引或输出边界不成立时停止,不换来源补猜。

从哪里开始

说明账号、联系人或群,以及要问的那段微信事实。

需要准备什么
  • 微信账号和要看的联系人或群
  • 时间、关键词或本人参与线索(如有)
从开始到拿到结果
1系统核对并处理
先从会话变化或本人参与定位小范围,再读足够前后文和原回复,不导出整个账号。
2交付与接续
交回说话人、时间、回复及媒体缺口;对象不唯一或范围不足时停下补线索,不猜是谁。
从哪里开始

说明账号、联系人或群,以及要问的那段微信事实。

需要准备什么
  • 微信账号和要看的联系人或群
  • 时间、关键词或本人参与线索(如有)
从开始到拿到结果
1系统核对并处理
先从会话变化或本人参与定位小范围,再读足够前后文和原回复,不导出整个账号。
2交付与接续
交回说话人、时间、回复及媒体缺口;对象不唯一或范围不足时停下补线索,不猜是谁。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
9月9日来源投影、上下文与候选发现45项及6子测试通过(之后未重新运行);当前源码 v0.2.3(最后提交 2026-11-06)共定义 434 个测试函数(2026-11-04 重数,之后的提交没有重数),没有运行;2026-11-04 无正文环境体检成功;真实具名会话未读取
关键规则与设计选择
1
coverage.hasMore 与 continuation 决定是否还需续查;游标固定账号、聊天、时间范围和搜索条件,每次调用仍是独立本地快照,不宣称历史跨页永不变化。
2
not_found_in_page 不等于请求窗口未命中;末页 not_found_in_remaining_window 只说明剩余范围,存在正文解码缺口时不能说从未说过。
3
coverage.returnedAllScanned 明确展示是否包含所有扫描消息;关键词附近的小窗口不是完整历史,continuation.purpose 分开继续找命中与普通翻页。
4
聊天默认从最小窗口开始,不先创建全量档案。每条消息另带 time(固定 +08:00 的北京时间,没有原生时间时为 null),原 Unix 秒 createTime 保留;time 只供展示,不参与消息或清单哈希,不写入 sync-contact 档案,已计入输出字节上限(f4c0113、a337446,11 月 5 日)。
5
auto 只有唯一匹配时才选择账号;多匹配必须由用户决定。
6
返回窗口的 self=0 只表示这段没有观察到本人消息,不代表全历史没有。
7
空窗口仍说明当前会话是否存在更早或更新的本地可见消息。
8
私聊与群聊引用目标均可按原生server id精确回查;源中缺失或无法读取时仍保留缺口,不保证全部回复都能补回。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
9月9日来源投影、上下文与候选发现45项及6子测试通过(之后未重新运行);当前源码 v0.2.3(最后提交 2026-11-06)共定义 434 个测试函数(2026-11-04 重数,之后的提交没有重数),没有运行;2026-11-04 无正文环境体检成功;真实具名会话未读取
关键规则与设计选择
1
coverage.hasMore 与 continuation 决定是否还需续查;游标固定账号、聊天、时间范围和搜索条件,每次调用仍是独立本地快照,不宣称历史跨页永不变化。
2
not_found_in_page 不等于请求窗口未命中;末页 not_found_in_remaining_window 只说明剩余范围,存在正文解码缺口时不能说从未说过。
3
coverage.returnedAllScanned 明确展示是否包含所有扫描消息;关键词附近的小窗口不是完整历史,continuation.purpose 分开继续找命中与普通翻页。
4
聊天默认从最小窗口开始,不先创建全量档案。每条消息另带 time(固定 +08:00 的北京时间,没有原生时间时为 null),原 Unix 秒 createTime 保留;time 只供展示,不参与消息或清单哈希,不写入 sync-contact 档案,已计入输出字节上限(f4c0113、a337446,11 月 5 日)。
5
auto 只有唯一匹配时才选择账号;多匹配必须由用户决定。
6
返回窗口的 self=0 只表示这段没有观察到本人消息,不代表全历史没有。
7
空窗口仍说明当前会话是否存在更早或更新的本地可见消息。
8
私聊与群聊引用目标均可按原生server id精确回查;源中缺失或无法读取时仍保留缺口,不保证全部回复都能补回。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
9
只有会改变答案的媒体才需要进一步打开或转写。
当前怎样实现
  • 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,并指向新目录阅读包这条路。
技术实现与依据(二)
9
只有会改变答案的媒体才需要进一步打开或转写。
当前怎样实现
  • 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,并指向新目录阅读包这条路。
技术实现与依据(三)
1
读取已配置账号槽位的公开安全配置结构。
2
解析唯一联系人或群,失败时返回未命中或候选。
3
按请求时间与上限读取一个本地快照;--around 优先取最靠近锚点的消息,再按时间排序,续查上界固定但每页快照独立。
4
围绕关键词或时间锚点选择最多 80 条。
5
补全发送者、回复目标和媒体缺口。
6
写出带实际范围与哈希的 JSON,不修改任何源数据。
  • context --byte-limit限制32–512KiB终端JSON,普通continuation负责其余消息;segmentedFields仅是长字段预览,message-part绑定同一显式账号/对象、偏移和whole-text hash(内容指纹)续读。source_changed要求重新context,不能跨版本拼接;便携export-context仍保存选定全文,终端预算不截断阅读包里的文件。
执行流程
技术实现与依据(三)
1
读取已配置账号槽位的公开安全配置结构。
2
解析唯一联系人或群,失败时返回未命中或候选。
3
按请求时间与上限读取一个本地快照;--around 优先取最靠近锚点的消息,再按时间排序,续查上界固定但每页快照独立。
4
围绕关键词或时间锚点选择最多 80 条。
5
补全发送者、回复目标和媒体缺口。
6
写出带实际范围与哈希的 JSON,不修改任何源数据。
  • 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发现当前变化候选,再对明确对象读取有界上下文;可以先筛本人参与,缺少他人回应时再补读。

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

先用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。