
WeChatDirect · 功能说明
可以把当前电脑已经看见的朋友圈内容有界交给当前工作,同时不会把主号、副号或远端完整性混在一起。
当前情况:已有按明确账号读取本机朋友圈缓存的功能;11 月 4 日核对时未读真实正文,本机无缓存不代表对方没有发布。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


WeChatDirect · 功能说明
可以把当前电脑已经看见的朋友圈内容有界交给当前工作,同时不会把主号、副号或远端完整性混在一起。
当前情况:已有按明确账号读取本机朋友圈缓存的功能;11 月 4 日核对时未读真实正文,本机无缓存不代表对方没有发布。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码
公开仓库


用途与实际影响
朋友圈不是普通聊天目录:账号自己的身份可能不在会话列表,当前缓存里的发布者也可能没有聊天会话。若只查 session 或默认 auto,容易漏人、串号并把缓存未命中误写成没有内容。
我说“看看副号里小王最近发的朋友圈”。工具只看副号在这台电脑上已经缓存的内容;能找到人但没有正文时,它会提示我回到副号手动打开小王主页后再试,不把“本机没缓存”说成“他什么都没发”。
得到这个明确账号在当前电脑已缓存的朋友圈内容、实际可见时间和缺口。没有本机缓存时会提示在同一账号手动打开目标后再试,不说对方没有发布。
账号和发布者能唯一对应、电脑里确实有相关缓存时,交回实际可见部分。
发布者重名、媒体未缓存或本机缓存变化时保留候选和缺口。
本机尚无这名发布者的缓存时说明如何手动取得,不自动打开主页或联网补历史。

用途与实际影响
朋友圈不是普通聊天目录:账号自己的身份可能不在会话列表,当前缓存里的发布者也可能没有聊天会话。若只查 session 或默认 auto,容易漏人、串号并把缓存未命中误写成没有内容。
我说“看看副号里小王最近发的朋友圈”。工具只看副号在这台电脑上已经缓存的内容;能找到人但没有正文时,它会提示我回到副号手动打开小王主页后再试,不把“本机没缓存”说成“他什么都没发”。
得到这个明确账号在当前电脑已缓存的朋友圈内容、实际可见时间和缺口。没有本机缓存时会提示在同一账号手动打开目标后再试,不说对方没有发布。
账号和发布者能唯一对应、电脑里确实有相关缓存时,交回实际可见部分。
发布者重名、媒体未缓存或本机缓存变化时保留候选和缺口。
本机尚无这名发布者的缓存时说明如何手动取得,不自动打开主页或联网补历史。

明确账号和联系人,请查看电脑当前已经缓存的朋友圈。
- primary 或 secondary 账号
- 联系人和所需范围


明确账号和联系人,请查看电脑当前已经缓存的朋友圈。
- primary 或 secondary 账号
- 联系人和所需范围



- _resolve_moments_subject 强制显式账号,并组合 source-proven self、完整联系人目录和当前缓存发布者。
- list_moments 对指定人会扫描完整当前缓存后再应用 limit,避免目标在后部时被错误截断。
- moments 返回 target_cached / target_not_in_current_local_cache / account_cache_read。


- _resolve_moments_subject 强制显式账号,并组合 source-proven self、完整联系人目录和当前缓存发布者。
- list_moments 对指定人会扫描完整当前缓存后再应用 limit,避免目标在后部时被错误截断。
- moments 返回 target_cached / target_not_in_current_local_cache / account_cache_read。
数字截至 2026 年 11 月 6 日

- sync-moments 用当前集合与旧 JSONL 比较 new / updated / removed,有变化才输出完整替换快照;文件占用和中断与联系人档案使用同一套明确错误和恢复入口。默认输出目录把本人、全缓存和指定联系人分开,联系人目录名按规范化后的请求哈希生成,避免名字转换后撞名。
- 来源指纹只覆盖 sns.db 与 contact.db 元数据;无变化时在原目录核对后只更新回执,不复制、不重新发布整包。


- sync-moments 用当前集合与旧 JSONL 比较 new / updated / removed,有变化才输出完整替换快照;文件占用和中断与联系人档案使用同一套明确错误和恢复入口。默认输出目录把本人、全缓存和指定联系人分开,联系人目录名按规范化后的请求哈希生成,避免名字转换后撞名。
- 来源指纹只覆盖 sns.db 与 contact.db 元数据;无变化时在原目录核对后只更新回执,不复制、不重新发布整包。



| 名词 | 意思 |
|---|---|
| Explicit account(显式账号) | 朋友圈不接受 auto;每份结果必须明确属于主号或副号。 |
| targetCacheStatus | 目标已缓存、目标不在当前缓存,或正在读取账号整体缓存。 |
| Current cache replacement(当前缓存替换) | 刷新后档案准确代表当前可见集合;被缓存淘汰的旧条目不继续冒充可见。 |
| Source-proven self | 从配置绑定的账号原生身份推导本人朋友圈作者,不从显示名称猜。 |

moments 与 sync-moments 只读取明确账号当前设备可见的 sns 缓存;缓存未命中不是空主页,刷新也不保留已淘汰条目。



moments 与 sync-moments 只读取明确账号当前设备可见的 sns 缓存;缓存未命中不是空主页,刷新也不保留已淘汰条目。

- 只读取当前设备缓存,不访问远端朋友圈主页或补历史。
- 不自动切号、点击、点赞、评论或输入。
- 可选收发接口在当前微信版本上读不了朋友圈;这里走数据库缓存,不受影响。
- 联系人/群会话不是完整朋友圈作者目录。
- 真实朋友圈正文、发布者和媒体不进入网站。
- 没有明确账号或用了 auto: 命令返回 moments_explicit_account_required;自然语言请求由 AI 分别对主号、副号各发一次明确请求。指定的号没有配置时返回 wechat_account_not_configured,不借另一个号。
- 同名发布者: 返回 contact_ambiguous 候选,不按第一项选择。
- 目标不在当前缓存: 提示在同一账号手动打开该目标朋友圈后重试,不宣称为空。
- 刷新期间缓存变化: 返回 source_changed_during_sync_retry,不提交新的 state。

- 只读取当前设备缓存,不访问远端朋友圈主页或补历史。
- 不自动切号、点击、点赞、评论或输入。
- 可选收发接口在当前微信版本上读不了朋友圈;这里走数据库缓存,不受影响。
- 联系人/群会话不是完整朋友圈作者目录。
- 真实朋友圈正文、发布者和媒体不进入网站。
- 没有明确账号或用了 auto: 命令返回 moments_explicit_account_required;自然语言请求由 AI 分别对主号、副号各发一次明确请求。指定的号没有配置时返回 wechat_account_not_configured,不借另一个号。
- 同名发布者: 返回 contact_ambiguous 候选,不按第一项选择。
- 目标不在当前缓存: 提示在同一账号手动打开该目标朋友圈后重试,不宣称为空。
- 刷新期间缓存变化: 返回 source_changed_during_sync_retry,不提交新的 state。

README.md · moments /当前缓存、显式账号与手动补缓存边界。sync-moments
wechat_cli.py · _resolve_moments_subjectself、联系人和缓存发布者的唯一解析。
wechat_cli.py · command_sync_moments当前集合替换、增删改和导出清单。
tests/身份、缓存未命中、跨账号和淘汰回归。test_wechat_cli.py · moments
- test_moments_self_uses_source_account_identity 验证本人身份来自来源账号。
- test_moments_self_cache_miss_requests_same_account_profile_open 验证缓存未命中下一步。
- test_moments_rejects_implicit_cross_account_selection 验证不跨账号猜。
- test_moments_sync_replaces_items_evicted_from_current_cache 验证快照替换。
朋友圈与聊天共享账号身份和媒体读取,但拥有独立的缓存范围、对象解析与同步状态,不能用聊天档案替代。

README.md · moments /当前缓存、显式账号与手动补缓存边界。sync-moments
wechat_cli.py · _resolve_moments_subjectself、联系人和缓存发布者的唯一解析。
wechat_cli.py · command_sync_moments当前集合替换、增删改和导出清单。
tests/身份、缓存未命中、跨账号和淘汰回归。test_wechat_cli.py · moments
- test_moments_self_uses_source_account_identity 验证本人身份来自来源账号。
- test_moments_self_cache_miss_requests_same_account_profile_open 验证缓存未命中下一步。
- test_moments_rejects_implicit_cross_account_selection 验证不跨账号猜。
- test_moments_sync_replaces_items_evicted_from_current_cache 验证快照替换。
朋友圈与聊天共享账号身份和媒体读取,但拥有独立的缓存范围、对象解析与同步状态,不能用聊天档案替代。
复制 AI 续作说明
项目:明确账号下的当前本机朋友圈缓存;仓库:wlyaaaaa/WeChatDirect;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。





