微信聊天读取我问 AI 一件微信里的事,AI 就用它直接读这台电脑上微信的本地数据库:只读我点名的那个人或群、够回答问题的那一小段,把谁说的、回的是哪句、附件属于哪条一起交回来。要长期保存,就给那个人或群建一份档案,以后只补新的。微信的数据库它只读不写(解密后的副本放在它自己的缓存里),也不上网补历史,所以能读到的就是这台电脑上存着的那些;唯一的例外是我明确要附件时,可以按消息里记着的地址取回表情。
我明确要求时,AI 还能通过一个可选的原生接口替我发微信:文字、图片、文件、动图表情和语音;也能在这次任务里收指定对象的新消息和语音,同意新收到的好友申请。它只在这次任务期间连着,不自动回复,见让 AI 替我收发微信和实时聊天怎么读懂语音。
比如我说“微信有新消息,把近况更新一下”:AI 先列出两个号最近有新消息的聊天,一个个读完(人多的群只读我自己的发言),把能看出我最近在做什么的整理成摘要交给个人理解库;推送、客服这类没内容的,直接标成读过。

10 月 11 日清点当时那 4 份档案:里面存着 12 张 PNG 图片,没有语音文件;认不出是谁发的消息 0 条;当时最近一次更新档案是 9 月 10 日。现在是 5 份,这些细项没有重新清点。现在的版本仍是 0.2.3,代码核对到北京时间 11 月 6 日 00:39 最后一次提交:10 月 28 日起可以用我平时的称呼找人和群、名字只写一部分也能找到,解密后的明文快照改为长期留在本机缓存、只按变化重解,10 月 29 日又补认了位置分享和新版动画表情(10 月 30 日只读核对源码,这些新用法还没在真实使用里验过)。11 月 1–3 日加了上面的原生收发和实时聊天:单聊语音收发和精确读回验证过,群语音没验,15 秒完整上下文还要真实链路验收。11 月 5–6 日又加了几样:给真人分条发消息时,发前和每条之间都看对方有没有新消息,有就停;发完可以在同一条连接上等回复;微信退出登录后只读地等我登回来,再接着读;打开图片、表情一步拿到该看的文件;给人或群建的档案不再跟着改名走。这些只核对了代码和安装入口(11 月 6 日 05:15),没有连微信、没有真的收发,不算真实聊天验收;两个号现在登没登录、这版微信核心对不对得上未核实。

微信聊天读取10 月 11 日清点当时那 4 份档案:里面存着 12 张 PNG 图片,没有语音文件;认不出是谁发的消息 0 条;当时最近一次更新档案是 9 月 10 日。现在是 5 份,这些细项没有重新清点。现在的版本仍是 0.2.3,代码核对到北京时间 11 月 6 日 00:39 最后一次提交:10 月 28 日起可以用我平时的称呼找人和群、名字只写一部分也能找到,解密后的明文快照改为长期留在本机缓存、只按变化重解,10 月 29 日又补认了位置分享和新版动画表情(10 月 30 日只读核对源码,这些新用法还没在真实使用里验过)。11 月 1–3 日加了上面的原生收发和实时聊天:单聊语音收发和精确读回验证过,群语音没验,15 秒完整上下文还要真实链路验收。11 月 5–6 日又加了几样:给真人分条发消息时,发前和每条之间都看对方有没有新消息,有就停;发完可以在同一条连接上等回复;微信退出登录后只读地等我登回来,再接着读;打开图片、表情一步拿到该看的文件;给人或群建的档案不再跟着改名走。这些只核对了代码和安装入口(11 月 6 日 05:15),没有连微信、没有真的收发,不算真实聊天验收;两个号现在登没登录、这版微信核心对不对得上未核实。
我问 AI 一件微信里的事,AI 就用它直接读这台电脑上微信的本地数据库:只读我点名的那个人或群、够回答问题的那一小段,把谁说的、回的是哪句、附件属于哪条一起交回来。要长期保存,就给那个人或群建一份档案,以后只补新的。微信的数据库它只读不写(解密后的副本放在它自己的缓存里),也不上网补历史,所以能读到的就是这台电脑上存着的那些;唯一的例外是我明确要附件时,可以按消息里记着的地址取回表情。
我明确要求时,AI 还能通过一个可选的原生接口替我发微信:文字、图片、文件、动图表情和语音;也能在这次任务里收指定对象的新消息和语音,同意新收到的好友申请。它只在这次任务期间连着,不自动回复,见让 AI 替我收发微信和实时聊天怎么读懂语音。
比如我说“微信有新消息,把近况更新一下”:AI 先列出两个号最近有新消息的聊天,一个个读完(人多的群只读我自己的发言),把能看出我最近在做什么的整理成摘要交给个人理解库;推送、客服这类没内容的,直接标成读过。


怎么用它没有全局常驻程序:平时只在我问到微信时由 AI 调用一次,答完就结束;要连续收发或接实时语音时,AI 在这次任务里开一个连接,任务结束就关。自动运行的只有每晚一次的环境体检,不碰账号和聊天。
- 1问一段聊天里的事
说哪个人或群、哪天或什么关键词,AI 先认准是主号还是副号里的哪一个,只读够回答的一小段:每次最多翻 500 条、交回 80 条,带上时间和谁说的。我平时叫的称呼在微信备注、昵称和群名里都找不到时,AI 先跟我确认是哪个私聊或群,再记进本机的称呼表,以后直接用这个称呼;一个称呼可以同时对应一个人的私聊和几个群,没说找群时,恰好只有一个私聊就默认私聊,要找群就说明,几个群仍列出来让我选。名字只记得一部分也能找:依次按称呼表、完整名称、忽略空格和标点后的同名、至少两个字的部分名称、群成员称呼去对,前一层有命中就停;对不上时最多给 5 个相似的名字让我挑,不替我选。
- 2那句话回的是哪句
引用回复和它回的原消息放在一起交回;原消息在这一段之外,就标出来再往前补读。9 月 27 日那次读回的 1853 条里,有 82 条是被引用的原消息。
- 3听语音、看图片和文件
点名那条消息,只打开那条消息自己的附件。语音转成 WAV 交给中文语音转写(已保存的语音走它的云优先转写,免费期内会传到阿里云),图片和表情一步拿到该看的文件:静图就是原文件,真动图给一张按时间排好帧的拼图,原动画也留着;AI 要真的打开看,拼图没看清就回原动画补帧,不拿第一帧当全部意思。正在聊的语音走另一条路,见实时聊天怎么读懂语音。比如一张图电脑上已经删了,就标成打不开,不拿别的图顶上。
- 4给一个人或群建档
第一次存下这台电脑上能看到的全部聊天,以后同一句话只补新的。现在有 5 份(11 月 6 日数)。对方改了微信名、我换了称呼,都还是同一份档案;旧目录里同一个人的完整档案也接着用,不另建。
- 5看朋友圈
读这台电脑上缓存着的朋友圈。缓存里没有这个人,就请我在同一个号里点开他的主页再试,不说“他没发过”。到现在还没用过。
- 6把一段聊天完整存底
我明确要求时,把那段聊天连同附件、时间、消息编号和每个文件的内容指纹存成一个文件夹,以后能核对一个字没变。到现在还没用过。
| 日期 | 做什么 | 读了多少 |
|---|---|---|
| 9 月 8 日 | 个人项目终审,理解库全面核对 | 675 段、7502 条 |
| 9 月 12 日 | 理解库更新(两批) | 44 段、513 条 |
| 9 月 15 日 | 认知审计 | 14 段、510 条 |
| 9 月 18 日 | 理解库更新 | 58 段、183 条 |
| 9 月 26 日 | 群聊认知审计:只读我自己的发言 | 10 个群、我今年的 61070 条 |
| 9 月 27 日 | 近况更新 | 47 个聊天、1853 条 |
| 10 月 6 日 | 理解库更新 | 49 段、980 条 |
跟 AI 怎么说、例子和边界,见技能页。
怎么用它没有全局常驻程序:平时只在我问到微信时由 AI 调用一次,答完就结束;要连续收发或接实时语音时,AI 在这次任务里开一个连接,任务结束就关。自动运行的只有每晚一次的环境体检,不碰账号和聊天。
- 1问一段聊天里的事
说哪个人或群、哪天或什么关键词,AI 先认准是主号还是副号里的哪一个,只读够回答的一小段:每次最多翻 500 条、交回 80 条,带上时间和谁说的。我平时叫的称呼在微信备注、昵称和群名里都找不到时,AI 先跟我确认是哪个私聊或群,再记进本机的称呼表,以后直接用这个称呼;一个称呼可以同时对应一个人的私聊和几个群,没说找群时,恰好只有一个私聊就默认私聊,要找群就说明,几个群仍列出来让我选。名字只记得一部分也能找:依次按称呼表、完整名称、忽略空格和标点后的同名、至少两个字的部分名称、群成员称呼去对,前一层有命中就停;对不上时最多给 5 个相似的名字让我挑,不替我选。
- 2那句话回的是哪句
引用回复和它回的原消息放在一起交回;原消息在这一段之外,就标出来再往前补读。9 月 27 日那次读回的 1853 条里,有 82 条是被引用的原消息。
- 3听语音、看图片和文件
点名那条消息,只打开那条消息自己的附件。语音转成 WAV 交给中文语音转写(已保存的语音走它的云优先转写,免费期内会传到阿里云),图片和表情一步拿到该看的文件:静图就是原文件,真动图给一张按时间排好帧的拼图,原动画也留着;AI 要真的打开看,拼图没看清就回原动画补帧,不拿第一帧当全部意思。正在聊的语音走另一条路,见实时聊天怎么读懂语音。比如一张图电脑上已经删了,就标成打不开,不拿别的图顶上。
- 4给一个人或群建档
第一次存下这台电脑上能看到的全部聊天,以后同一句话只补新的。现在有 5 份(11 月 6 日数)。对方改了微信名、我换了称呼,都还是同一份档案;旧目录里同一个人的完整档案也接着用,不另建。
- 5看朋友圈
读这台电脑上缓存着的朋友圈。缓存里没有这个人,就请我在同一个号里点开他的主页再试,不说“他没发过”。到现在还没用过。
- 6把一段聊天完整存底
我明确要求时,把那段聊天连同附件、时间、消息编号和每个文件的内容指纹存成一个文件夹,以后能核对一个字没变。到现在还没用过。
跟 AI 怎么说、例子和边界,见技能页。

这是读取之外一个可选的接口。读聊天不依赖它;只有我让 AI 代发、连续收发或接实时语音时才用,任务结束就断开。
比如我说“用副号把这个文件发给小王”:AI 先认准副号和小王是哪一个,发出去,再告诉我微信受理了没有;要确认那边真有这条,再读回来核对。
| 我可以让它做 | 要说清什么 | 我会拿到什么 |
|---|---|---|
| 发文字、图片、文件、动图表情、语音 | 哪个号、发给谁、发什么 | 微信受理了没有、实际读回没有、清理完没有,三件事分开写 |
| 连续收发一阵 | 哪个号、盯哪几个对象 | 这次任务里点名对象的新消息;最多缓冲 200 条,超了会说丢了几条 |
| 接收一条语音 | 哪个号、哪个对象 | 语音本身:连接只带语音信息没带声音时,按这条消息从本机精确取回 |
| 分条发给真人 | 哪个号、发给谁、分几条 | 发前和每条之间都看对方有没有新消息,有就停;已发的、没发的、不确定的那条分开告诉我 |
| 发完等回复 | 哪个号、等谁,我自己是不是也在聊 | 同一条连接接着等,默认对方安静 15 秒才交回、从第一条起最多 60 秒;我自己在聊时可以放宽到 120 秒 |
| 同意好友申请 | 这次连接里新收到的哪一条 | 同意的结果;连接断了申请就失效,可能要对方重新申请 |
- 没说哪个号,它不猜,也不拿昵称、窗口或另一个号顶替;选的号没登录,就提醒我登录那个号。
- 名字对不上唯一一个人或群就停;登记的称呼失效了,也不往同名的人身上发。
- 收到消息不等于要回:不自动回复,不自动同意好友,也不主动加好友。
- 结果不明(超时、回执丢了)不自动重发,先核对那条到底发没发。
- 分条发的途中对方来了新消息就停;等回复时我先回了,这一轮不叫醒 AI,接着等对方下一条。
- 微信退出登录就停:只有我能重新登录,AI 提醒我一次,然后只读地等我登回来,再从断开的地方接着读。没发的和不确定的那条分开处理。微信更新后读不到账号也会报成这样,那时重新登录不一定有用。
- 文字一条最多 1023 字节(中文约 340 字),超了不截断也不自动拆,由 AI 分段后逐条说明。

这是读取之外一个可选的接口。读聊天不依赖它;只有我让 AI 代发、连续收发或接实时语音时才用,任务结束就断开。
比如我说“用副号把这个文件发给小王”:AI 先认准副号和小王是哪一个,发出去,再告诉我微信受理了没有;要确认那边真有这条,再读回来核对。
- 没说哪个号,它不猜,也不拿昵称、窗口或另一个号顶替;选的号没登录,就提醒我登录那个号。
- 名字对不上唯一一个人或群就停;登记的称呼失效了,也不往同名的人身上发。
- 收到消息不等于要回:不自动回复,不自动同意好友,也不主动加好友。
- 结果不明(超时、回执丢了)不自动重发,先核对那条到底发没发。
- 分条发的途中对方来了新消息就停;等回复时我先回了,这一轮不叫醒 AI,接着等对方下一条。
- 微信退出登录就停:只有我能重新登录,AI 提醒我一次,然后只读地等我登回来,再从断开的地方接着读。没发的和不确定的那条分开处理。微信更新后读不到账号也会报成这样,那时重新登录不一定有用。
- 文字一条最多 1023 字节(中文约 340 字),超了不截断也不自动拆,由 AI 分段后逐条说明。

让 AI 在微信里接着聊的时候用。目标是从收到一条消息起 15 秒内,AI 拿到完整上下文:原文、它回的那句、附件和语音文字。这个目标还没拿真实微信录音验过,现在只能说接上了。
| 遇到 | 它怎么做 |
|---|---|
| 超时,或图片还没看 | 标没完成,不当成没内容 |
| 本机模型没准备好 | 不当场装模型,要重新准备这次连接 |
| 云端失败,本机先出了结果 | 先用结果,云端的问题照样要修,不算解决 |
| 两路结果对不上,影响理解 | 回原音核对 |
| 连接之前的旧消息 | 连接不补;AI 按需要读有限的一段历史 |

让 AI 在微信里接着聊的时候用。目标是从收到一条消息起 15 秒内,AI 拿到完整上下文:原文、它回的那句、附件和语音文字。这个目标还没拿真实微信录音验过,现在只能说接上了。
读不到或出事的时候| 情况 | 它怎么做 |
|---|---|
| 同一个名字在主号、副号都有,或者有重名 | 停下列出候选让我选,不猜 |
| 关键词在这一段没搜到 | 说“这一段没有”,给出接着往下读的位置;整个范围读完才说“这段时间没提过” |
| 图片、语音在电脑上已经没了 | 标成缺口,不当成这条消息没内容:10 月 11 日清点时,当时的 4 份档案里有 2329 次附件这样标着。以后在微信里重新下载到本机,可以对这份档案再补一次;还读不到就继续标缺口,不保证追得回来 |
| 群成员的昵称取不到 | 写“群成员(昵称未取到)”,不拿群名顶替:档案里有 1925 条 |
| 读的时候微信正好在写数据库,或者把文件换掉了 | 先核对还是不是同一个文件,不是就自动重读,最多三次;还不稳才停下让重跑。不把前后两份内容拼在一起 |
| 明文缓存正被另一次读取占着、上次刷新没做完,或缓存自检没过 | 占着时这次读取合计最多等约 2 秒,还拿不到就对这些库改回临时整份解密,结果一样;没做完或自检失败的缓存下次整份重建。怀疑缓存有问题,没有读取在进行时可以整个删掉,下次自动重建 |
| 档案里的文件被改过 | 拒绝更新,指出哪个文件对不上,不覆盖 |
| 档案正被别的程序占用 | 停下报“档案正被占用”,关掉占着它的程序后原地重试;已经换上新版、只是清理没做完的,先按恢复命令收尾 |
| 更新档案时断电或被强行关掉 | 旧档案原样留着;先查看现场,再撤回或完成这次更新 |
| 名字一个都没对上 | 说找不到,最多给 5 个相似的名字让我挑,不自动替我选 |
| 称呼表里登记的私聊或群已经不在当前会话列表里 | 标成失效、跳过它接着往下找,登记本身留着,确认不用了再删 |
读不到或出事的时候
它是怎么读的







仓库名 WeChatDirect(微信直读)
它是怎么读的







仓库名 WeChatDirect(微信直读)
数字截至 2026 年 11 月 6 日

入口:可选接入层 wechat-direct helper,固定适配上游 Prometheus-first/helper 提交 0a0cf6e09650fd2838af2042c4d7472c071977ee 的 NativeTextService。helper status、capabilities 只查依赖和文件,不导入原生模块、不读账号、不注入 DLL。按次动作:send-text、send-image、send-file、send-emoticon、send-voice,都要 --account primary|secondary 和 --target <原生 ID> 或 --contact <精确名称或已登记称呼>。任务内会话:helper session --account <号> --event-target <原生 ID> [--realtime --asr-root <ChineseASR 根目录>],标准输入输出走 UTF-8 JSON Lines,一行一个动作。已接线未真实验收:send-at-text、invite-group-members、create-group;group-members 只读已加载缓存,members=null 不代表空群。
分条发送和等待(11 月 5–6 日 c03da8a、cd95966、85db2ff、f35e3e5):helper send-paced --send [--wait-after],不加 --send 只出计划。发前和条间读本机记录,有新消息返回 chat_moved 和 unsent;第一条通过检查后直接发,后续按平均每分钟 100 字、0.5–2 秒思考,每条打字时间再随机调整。同一微信进程只有一条原生连接:等待可以让路,已有同聊天等待时自动让路、发完重连,发送命令返回 wait.status=existing_waiter;长活 helper session 不让路,60 秒不能接管时返回 bridge_busy,内容全在 unsent。wait-new 默认对方安静 15 秒(--settle-seconds)才交回、从首条最多 60 秒,本人先回则取消这轮唤醒继续等;返回后不会自行重挂,由调用 AI 先从 nextSince 重挂再处理。login_required 需本人登录,用 --wait-login 等到 login_restored 再按 nextSince 接续;它也可能是微信更新后读不到账号,重新登录不保证修好。进程正常结束或退出码 0 不等于收到新消息,要看 status。等待媒体验收直接用 new[].media[].locator,不用再查消息编号。停止走 stop file,已存在的 stop file 会阻止发送。
依赖和许可:主环境可选安装 .[helper],增加 pefile==2023.2.7;上游单独放置并保留它的 LICENSE 和第三方声明。上游限免费个人非商业使用,不属于本项目的 MIT 许可。不运行上游 main.py、web.py、PluginManager,因为默认插件带撤回补发这类写动作;不启动机器人插件、LLM、定时任务或网页端口。本机 helper-config.json 只放运行目录和状态目录两个绝对路径,按主号、副号分开存接收媒体。helper 缺失不影响读取和 doctor。
身份和目标:原生动作不支持 auto。先核来源身份,再把原生登录 ID 的 SHA-256 和该槽位 expected_moments_author_sha256 核对;每次动作前再读一次,退出或切号立即阻止后续动作。--contact 拒绝宽松或部分匹配;称呼失效返回 helper_stale_alias_requires_resolution,不改投同名联系人。
会话生命周期:显式目标的事件只留内存,默认目标 filehelper,最多 200 条,溢出的最旧事件计入 dropped 并返回 partial;receive 单次等 0–60 秒、取 1–100 条,取走的不重复交付。原生 Hook 本身观察当前账号的全局消息和好友申请,适配层不转交范围外事件、不持久化全账号消息,所以不能说 Hook 只看某一个人。close 或 stdin EOF 清理并卸载桥接,以及本任务启动的识别进程;没有全局 daemon、HTTP 端口、命令队列或任务结束后保留的服务。
回执:invocationCompleted 表示适配调用返回;wechatAccepted 只在上游原生完成回执明确成功时为 true;actualReadback=not_checked 表示还没从微信数据库或客户端验收实际结果。超时、异常或回执丢失返回 status=unknown、retryable=false,会话阻止继续发送,先精确读回目标。cleanup 单独报告,发送已受理但清理失败为 partial。新发语音没有服务器 ID 时,读回先按服务器 ID,再用同账号、同会话、本地消息和时间的有界唯一回退;这不会把 wechatAccepted 变成读回证据。
语音:receive 遇到 4.1.15.13 桥接只带语音元数据时,沿现有 reader 按所选账号、会话和服务器消息 ID 精确补取 SILK,核对发送者、收发方向和类型后存到接收账号的媒体目录,成功返回 ready 和 voice_source=local_database,源内容缺失仍返回 failed;不补接收前历史,不常驻,不自动重发。发送支持 Tencent SILK;单声道 16-bit PCM WAV 要上游可选编码器 pysilk,缺少时明确报错,可先用现有 Python 3.11/pilk 转成 SILK。
实时上下文:显式 --realtime 才开启,普通 session 行为不变。启动先准备本地识别并返回就绪回执,再监听消息;AI 使用规则还要求确认连接后补读到连接时刻的有限历史,按账号、会话和原生 ID 去重,这不是 session 自动补全部历史。read-context 给 target 和 native_message_id,返回精确消息、引用、原媒体路径、缺口和首个完整的转写候选;context-results 用同一 request_id 看后到候选,不重发云请求。候选绑定账号、聊天、消息 ID 和音频 SHA-256。微信转写缓存投影为 contentSource=wechat_native_cache、verbatimVerified=false。observedAt 从原生事件首次观测起计时,elapsed、onTime、late、complete 如实返回;materialComplete=true、ready_for_vision 只表示材料齐备,visualRead=false 时不得声明 complete 或 onTime=true。本机识别由 ChineseASR 的 python -m zh_asr.realtime 提供,单次预算最多 10 秒。
好友申请:friend-requests、accept-friend 只能在同一活连接里用,按次命令返回 helper_live_session_required;申请票据只留上游内存,不写回执、日志或配置;连接结束清空,旧 ID 不能恢复。已通过的再次提交返回 outcome=previously_accepted、nativeInvoked=false。
当前版本的缺口:4.1.15.13 上,主动加好友、完整联系人扫描和 helper 的朋友圈读、发、互动都明确返回不可用;数据库朋友圈缓存读取不受影响。
自动任务:只有 PCConfig Nightly Project Checks,每晚 03:00 跑 wechat-direct.exe doctor --environment-only,90 秒超时;不读账号和聊天,不是项目测试,也不是实时聊天验收。2026-11-04 09:14 回读:任务已启用,最近一次 03:00:01 结果 0,下次 2026-11-05 03:00:00;本项目这项 exit_code=0,检查于 03:01:16。曾绿后红或一直红的项目进驾驶舱由 AI 跟进,恢复绿后移出,不自动启动 AI。关掉这个任务只停自动体检,不影响微信读取。
证据分层(2026-11-04 09:09–09:14 只读):doctor --environment-only success,配置 not_checked、sourceAccess not_tested。helper status success:PIL、cryptography、pefile 为 true,pysilk 为 false,runtimeFilesMissing 为空,stateRootAvailable 为 true,accountRead、nativeCodeLoaded 为 false,capabilitiesBasis=pinned_source_not_live_test,只证明静态部署就绪。helper session --help 退出 0。2026-11-06 05:15 又只读了安装入口的 wait-new --help(已显示 --settle-seconds、--wait-login)和 media-open --help,没有调用真实媒体。那天没建立会话、没注入桥接、没发消息、没启动转写。技能说明记录 4.1.15.13 上单聊语音收发和精确本地读回验证过,那天没有复测。docs/USAGE.md 写明 15 秒完整上下文仍须真实链路验收,接口接线和模拟测试不代表达标。
未核实:真实消息从首次观察到完整上下文能否稳定在 15 秒内;分条发送、等待和登录恢复在真实联系人和副号上的效果;两个号当前登录状态和当前微信核心兼容性;群语音和群操作真实效果;这组能力第一次真实运行的时间和累计使用次数。

入口:可选接入层 wechat-direct helper,固定适配上游 Prometheus-first/helper 提交 0a0cf6e09650fd2838af2042c4d7472c071977ee 的 NativeTextService。helper status、capabilities 只查依赖和文件,不导入原生模块、不读账号、不注入 DLL。按次动作:send-text、send-image、send-file、send-emoticon、send-voice,都要 --account primary|secondary 和 --target <原生 ID> 或 --contact <精确名称或已登记称呼>。任务内会话:helper session --account <号> --event-target <原生 ID> [--realtime --asr-root <ChineseASR 根目录>],标准输入输出走 UTF-8 JSON Lines,一行一个动作。已接线未真实验收:send-at-text、invite-group-members、create-group;group-members 只读已加载缓存,members=null 不代表空群。
分条发送和等待(11 月 5–6 日 c03da8a、cd95966、85db2ff、f35e3e5):helper send-paced --send [--wait-after],不加 --send 只出计划。发前和条间读本机记录,有新消息返回 chat_moved 和 unsent;第一条通过检查后直接发,后续按平均每分钟 100 字、0.5–2 秒思考,每条打字时间再随机调整。同一微信进程只有一条原生连接:等待可以让路,已有同聊天等待时自动让路、发完重连,发送命令返回 wait.status=existing_waiter;长活 helper session 不让路,60 秒不能接管时返回 bridge_busy,内容全在 unsent。wait-new 默认对方安静 15 秒(--settle-seconds)才交回、从首条最多 60 秒,本人先回则取消这轮唤醒继续等;返回后不会自行重挂,由调用 AI 先从 nextSince 重挂再处理。login_required 需本人登录,用 --wait-login 等到 login_restored 再按 nextSince 接续;它也可能是微信更新后读不到账号,重新登录不保证修好。进程正常结束或退出码 0 不等于收到新消息,要看 status。等待媒体验收直接用 new[].media[].locator,不用再查消息编号。停止走 stop file,已存在的 stop file 会阻止发送。
依赖和许可:主环境可选安装 .[helper],增加 pefile==2023.2.7;上游单独放置并保留它的 LICENSE 和第三方声明。上游限免费个人非商业使用,不属于本项目的 MIT 许可。不运行上游 main.py、web.py、PluginManager,因为默认插件带撤回补发这类写动作;不启动机器人插件、LLM、定时任务或网页端口。本机 helper-config.json 只放运行目录和状态目录两个绝对路径,按主号、副号分开存接收媒体。helper 缺失不影响读取和 doctor。
身份和目标:原生动作不支持 auto。先核来源身份,再把原生登录 ID 的 SHA-256 和该槽位 expected_moments_author_sha256 核对;每次动作前再读一次,退出或切号立即阻止后续动作。--contact 拒绝宽松或部分匹配;称呼失效返回 helper_stale_alias_requires_resolution,不改投同名联系人。
会话生命周期:显式目标的事件只留内存,默认目标 filehelper,最多 200 条,溢出的最旧事件计入 dropped 并返回 partial;receive 单次等 0–60 秒、取 1–100 条,取走的不重复交付。原生 Hook 本身观察当前账号的全局消息和好友申请,适配层不转交范围外事件、不持久化全账号消息,所以不能说 Hook 只看某一个人。close 或 stdin EOF 清理并卸载桥接,以及本任务启动的识别进程;没有全局 daemon、HTTP 端口、命令队列或任务结束后保留的服务。
回执:invocationCompleted 表示适配调用返回;wechatAccepted 只在上游原生完成回执明确成功时为 true;actualReadback=not_checked 表示还没从微信数据库或客户端验收实际结果。超时、异常或回执丢失返回 status=unknown、retryable=false,会话阻止继续发送,先精确读回目标。cleanup 单独报告,发送已受理但清理失败为 partial。新发语音没有服务器 ID 时,读回先按服务器 ID,再用同账号、同会话、本地消息和时间的有界唯一回退;这不会把 wechatAccepted 变成读回证据。
语音:receive 遇到 4.1.15.13 桥接只带语音元数据时,沿现有 reader 按所选账号、会话和服务器消息 ID 精确补取 SILK,核对发送者、收发方向和类型后存到接收账号的媒体目录,成功返回 ready 和 voice_source=local_database,源内容缺失仍返回 failed;不补接收前历史,不常驻,不自动重发。发送支持 Tencent SILK;单声道 16-bit PCM WAV 要上游可选编码器 pysilk,缺少时明确报错,可先用现有 Python 3.11/pilk 转成 SILK。
实时上下文:显式 --realtime 才开启,普通 session 行为不变。启动先准备本地识别并返回就绪回执,再监听消息;AI 使用规则还要求确认连接后补读到连接时刻的有限历史,按账号、会话和原生 ID 去重,这不是 session 自动补全部历史。read-context 给 target 和 native_message_id,返回精确消息、引用、原媒体路径、缺口和首个完整的转写候选;context-results 用同一 request_id 看后到候选,不重发云请求。候选绑定账号、聊天、消息 ID 和音频 SHA-256。微信转写缓存投影为 contentSource=wechat_native_cache、verbatimVerified=false。observedAt 从原生事件首次观测起计时,elapsed、onTime、late、complete 如实返回;materialComplete=true、ready_for_vision 只表示材料齐备,visualRead=false 时不得声明 complete 或 onTime=true。本机识别由 ChineseASR 的 python -m zh_asr.realtime 提供,单次预算最多 10 秒。
好友申请:friend-requests、accept-friend 只能在同一活连接里用,按次命令返回 helper_live_session_required;申请票据只留上游内存,不写回执、日志或配置;连接结束清空,旧 ID 不能恢复。已通过的再次提交返回 outcome=previously_accepted、nativeInvoked=false。
当前版本的缺口:4.1.15.13 上,主动加好友、完整联系人扫描和 helper 的朋友圈读、发、互动都明确返回不可用;数据库朋友圈缓存读取不受影响。
自动任务:只有 PCConfig Nightly Project Checks,每晚 03:00 跑 wechat-direct.exe doctor --environment-only,90 秒超时;不读账号和聊天,不是项目测试,也不是实时聊天验收。2026-11-04 09:14 回读:任务已启用,最近一次 03:00:01 结果 0,下次 2026-11-05 03:00:00;本项目这项 exit_code=0,检查于 03:01:16。曾绿后红或一直红的项目进驾驶舱由 AI 跟进,恢复绿后移出,不自动启动 AI。关掉这个任务只停自动体检,不影响微信读取。
证据分层(2026-11-04 09:09–09:14 只读):doctor --environment-only success,配置 not_checked、sourceAccess not_tested。helper status success:PIL、cryptography、pefile 为 true,pysilk 为 false,runtimeFilesMissing 为空,stateRootAvailable 为 true,accountRead、nativeCodeLoaded 为 false,capabilitiesBasis=pinned_source_not_live_test,只证明静态部署就绪。helper session --help 退出 0。2026-11-06 05:15 又只读了安装入口的 wait-new --help(已显示 --settle-seconds、--wait-login)和 media-open --help,没有调用真实媒体。那天没建立会话、没注入桥接、没发消息、没启动转写。技能说明记录 4.1.15.13 上单聊语音收发和精确本地读回验证过,那天没有复测。docs/USAGE.md 写明 15 秒完整上下文仍须真实链路验收,接口接线和模拟测试不代表达标。
未核实:真实消息从首次观察到完整上下文能否稳定在 15 秒内;分条发送、等待和登录恢复在真实联系人和副号上的效果;两个号当前登录状态和当前微信核心兼容性;群语音和群操作真实效果;这组能力第一次真实运行的时间和累计使用次数。
档案怎么存、怎么更新文件夹里有:
再跑一次:先核对已有档案没被改过:清单、全文、每条记录和附件的指纹都要对得上,对不上就拒绝更新。微信库没变,就在原目录确认一下、只记一笔,不重新复制整份档案;有新消息就从上次的位置接着读,多个分库时往回重叠 1 天防漏,去掉重复再合并。普通的再跑一次只接新的:很早以前的消息后来被改过、或者附件后来才下载到本机,要我明说,才对这个人或群整份重核,或者只补缺的附件。
换新版本:只有真有变化时,才在旁边的临时文件夹里建好、核对完再换上。换的时候要改两次目录名,万一正好卡在中间断电,旧版本还在,恢复命令能撤回或完成。档案正被别的程序占着时,统一报“档案正被占用”,关掉占用的程序后原地重试。
给 AI 的只挑一小段:平时只给 ai-context.md;更早的事先在整份档案里搜到,再读附近几条。
档案怎么存、怎么更新文件夹里有:
再跑一次:先核对已有档案没被改过:清单、全文、每条记录和附件的指纹都要对得上,对不上就拒绝更新。微信库没变,就在原目录确认一下、只记一笔,不重新复制整份档案;有新消息就从上次的位置接着读,多个分库时往回重叠 1 天防漏,去掉重复再合并。普通的再跑一次只接新的:很早以前的消息后来被改过、或者附件后来才下载到本机,要我明说,才对这个人或群整份重核,或者只补缺的附件。
换新版本:只有真有变化时,才在旁边的临时文件夹里建好、核对完再换上。换的时候要改两次目录名,万一正好卡在中间断电,旧版本还在,恢复命令能撤回或完成。档案正被别的程序占着时,统一报“档案正被占用”,关掉占用的程序后原地重试。
给 AI 的只挑一小段:平时只给 ai-context.md;更早的事先在整份档案里搜到,再读附近几条。
为什么这样设计每次推送,GitHub 上用 Windows 按两套依赖(固定版本、最新版本)各跑一遍测试。
为什么这样设计每次推送,GitHub 上用 Windows 按两套依赖(固定版本、最新版本)各跑一遍测试。
数字截至 2026 年 11 月 6 日
亮点- 1主号副号曾经贴反了。
早期配置里两个号的标签对调了,按标签读,会把副号的聊天当成主号的。现在每个号只认账号编号的 SHA-256 指纹,每次读之前都核对;当时的 3 份档案按新指纹全部重建,同名的人不会再跨号串。
- 2文件传输助手的正文读成了乱码。
微信 4 把很多消息正文用 zstd 压缩存着,旧代码没解开,读出来是一堆乱码。解开之后,两个号的文件传输助手(1057 条、1105 条)能正常读出的正文分别是 398 条、633 条,正文缺口 0;其余是图片、视频这类附件,走附件那条路。
- 3只读我自己说过的话。
比如我让 AI 看我在几个群里的发言,做一次认知审计。大群里几万条都是别人的话,全部解开既慢,也没必要。它在解开正文之前,先按发送者只挑出我的,再挑重点段落细读;别人的回应只在需要时按时间补读。9 月 26 日那次,副号 10 个群里我今年说过的 61070 条就是这样取全的。
亮点- 1主号副号曾经贴反了。
早期配置里两个号的标签对调了,按标签读,会把副号的聊天当成主号的。现在每个号只认账号编号的 SHA-256 指纹,每次读之前都核对;当时的 3 份档案按新指纹全部重建,同名的人不会再跨号串。
- 2文件传输助手的正文读成了乱码。
微信 4 把很多消息正文用 zstd 压缩存着,旧代码没解开,读出来是一堆乱码。解开之后,两个号的文件传输助手(1057 条、1105 条)能正常读出的正文分别是 398 条、633 条,正文缺口 0;其余是图片、视频这类附件,走附件那条路。
- 3只读我自己说过的话。
比如我让 AI 看我在几个群里的发言,做一次认知审计。大群里几万条都是别人的话,全部解开既慢,也没必要。它在解开正文之前,先按发送者只挑出我的,再挑重点段落细读;别人的回应只在需要时按时间补读。9 月 26 日那次,副号 10 个群里我今年说过的 61070 条就是这样取全的。

在用=AI 的会话记录、理解库的微信阅读记录或留下的档案能证明真用过;说不准=功能在,但查了这些记录(Codex 会话 9 月 15 日起,理解库阅读 9 月 8 日起)没找到真用过;待验收=要等下次更新档案才能确认。收发和实时这一组 11 月 1–3 日才加,还没查使用记录,都先记“说不准”。













在用=AI 的会话记录、理解库的微信阅读记录或留下的档案能证明真用过;说不准=功能在,但查了这些记录(Codex 会话 9 月 15 日起,理解库阅读 9 月 8 日起)没找到真用过;待验收=要等下次更新档案才能确认。收发和实时这一组 11 月 1–3 日才加,还没查使用记录,都先记“说不准”。


















































演进






演进复制 AI 续作说明
项目:微信聊天读取;仓库:wlyaaaaa/WeChatDirect;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。


