用途与结果
最快了解这个项目
为什么需要它
让 AI 总结一段微信群讨论，真正容易出错的地方是读错账号、漏掉最新消息、把引用当成当前发言，或者把一次空返回理解成“从来没聊过”。这个项目把这些取数规则写成可查、可验证的接口约定，并提供检查服务和恢复启动的脚本，让调用者能交代自己究竟读到了什么。
举个实际例子
“用 WeFlow 看一下这个群昨天下午的讨论，告诉我最后怎么决定的。”调用者先确认当前账号库和目标群，再按时间范围分页读取，保留谁回复谁以及有关媒体的线索。成功时能交付有时间范围、消息数量和缺口说明的结果；账号不对、消息时间对不上或重试后仍为空时，先说明实际缺口，不能编出一份完整总结。
最后我会得到什么
实际交付包括一份 WeFlow 接口地图、一套 AI 取数与返回格式约定、可运行的自检和 Windows 启动脚本，以及检查已取得文件集的工具。它不内置总结模型，也不把聊天记录自动发给 AI；用哪个模型、是否传出本机、保留哪些私有资料，仍由具体调用方按当前任务决定。
正常时
账号、会话和时间范围匹配时，调用者取得所需消息与回复线索，能交代覆盖范围，再由选用的 AI 分析。
发现问题时
账号不符、最新消息对不上、分页有缺口或文件核验失败时，保留准确的失败与缺口，不把结果写成完整历史。
入口不可用或证据不足时
服务、凭据或本次读取授权不可用时停止并说明原因；健康响应和端口连通不能代替真实聊天读取。
从哪里开始
明确选择 WeFlow 适配时，在已接通该本机服务的 AI 环境中指定账号、会话和时间范围；日常默认微信读取仍走 WeChatDirect。
需要准备什么
- 想查的联系人或会话
- 问题与时间范围
- 是否明确选择 WeFlow 路线
从开始到拿到结果
- 1先检查本机来源
明确使用 WeFlow 时，AI 先查服务、当前账号库及目标会话；服务缺失或账号不明就停在实际缺口。日常默认微信 Skill 仍走 WeChatDirect。
- 2限定账号与会话
按问题取最新、历史或朋友圈资料；历史要续页并保留引用线索。
- 3说明结果和缺口
AI 给出来源、时间范围和覆盖情况；健康入口有响应不等于真实聊天已读或全量历史完整。
- 4维护另走专门入口
看门狗、业务探测和私人文件快照按明确目标分别进行，公开页只展示安全的元数据与旧证据日期。
从这些需求了解功能
从一个实际问题看它怎样处理、交回什么；当前能做到哪一步和仍有哪些限制，也写在对应说明中。
项目指标与相关入口查看规模、覆盖范围和关联能力
当前项目指标
- WeFlow 版本
- 26.7.3.0
- 服务健康入口
- 5031 / 16000 · HTTP 200
- 源项目测试
- 31 / 31 通过
- 历史读取
- 增量分页 · 保留回复关系
它负责
- 告诉 AI 选定的 WeFlow 来源能读取什么，以及怎样确认账号与会话。
- 按问题读取最新或历史消息，保留回复关系和媒体线索，分页不全就说明缺口。
- 公开结果只留下可检查的来源和范围信息，不放真实聊天正文。
- 提供本机服务检查、按配置启动和有界恢复入口。
- 对已经合法取得的文件集核对字节，交给实际使用它的项目继续判断。
它不负责
- 本仓库不实现微信数据库解密或另一套聊天数据库。
- 不内置总结模型，不自动发消息、删除朋友圈或同步到云端。
- 不在公开仓库保存真实聊天、联系人、媒体、数据库或可复用凭据。
- 不以旧下游示例恢复已经退役的中央个人系统。
- 不把 WeFlow 健康响应当成 WeChatDirect 的验收结果。
产品思想与设计核心
先确认读对来源，再总结
账号、会话和时间范围错了，结论就可能错。最新消息对不上或读到空白时，先交代缺口。
接口说明不会替人执行
WeFlow 提供数据，调用方负责请求和分析；本项目说明如何用、如何检查。文档上的“允许读取”标记不自动拦截服务请求，结果格式文件也要由调用方实际验证。
日常检查尽量不打扰桌面
已有任务安静检查选定的程序；目标缺失才尝试启动一次，已有程序不健康时留下问题，不反复开新实例。
私人内容只进获准的任务
公开仓库只放代码和虚构样例；真实消息按本次问题在获准位置处理，公开元数据也不等于授权建立全账号档案。
文件核对不冒充完整备份
两遍读到同一组字节，只说明指定文件集当时稳定；账号覆盖、导出完成和数据库恢复仍要分别验证。
项目怎样演化到现在
先说清 AI 怎样读微信来源
以当时的 WeFlow 版本为基线，说明账号、会话、消息和返回结果该如何检查。
兼顾多份配置和已取得文件
登录检查能认准不同配置，已合法取得的私有文件集可做两遍字节核对。
服务有响应不再等于资料都能读
必需的业务入口失败会明确返回失败，不能只因为健康页面正常就宣布读取完成。
完整项目状态与证据边界
已确认事实
- PUBLIC（公开） master=7510c29ae3a95b36363b4d6ba2d1c47c4e602f85，已从远端 master 回读；之前的源码为 e075ce4627b9ea53899a8b9d214021cd2eccf6f4。此次修正让本地 CI 和 GitHub Actions 共用完整测试入口，纳入原先遗漏的 5 项快照测试。
- WeFlow.exe 的 ProductVersion 为 26.7.3.0。2026-09-08T02:37:25.8272891Z 只读检查 127.0.0.1:5031/health 与 127.0.0.1:16000/health，均返回 HTTP 200；没有读取业务接口。
- 接口契约以 WeFlow 26.7.3 / 26.7.3.0、2026-07-09 的实测为基线；OpenAPI 3.1.0、AI Consumer（使用方） Contract v2。v0.1.0 是原有发布标记，不代表后续所有提交都重新打过版本。
- 当前本地 CI 实际执行 26 项项目契约测试和 5 项私有快照测试，共 31 项通过。虚构快照测试故意失败时 CI 返回 1，且未继续执行公开边界检查。
- WeFlow Watchdog 与 WeChat AutoStart 均为 Ready（等待触发）、最近结果 0，采用 wscript 静默包装；WeChat AutoStart 保留 PCConfig 双开负责人标记。没有在本轮重新注册、启动或修改任务。
- 此项目保留 WeFlow HTTP 适配与运维能力。现役 wechat-direct Skill 使用独立的 WeChatDirect，明确不调用 WeFlow；旧规程中列出的调用插件或下游示例，不等于当前默认微信读取路线。
- 本机 CI 的已跟踪路径、文本检查和 PowerShell 解析通过，因缺少 pdftotext 跳过 3 份既有 PDF 文本。相同提交的 GitHub Actions 34180971929 已完成全部 31 项测试及 PDF 文本检查，结果 success（成功）；检查仍不覆盖全部 Git 历史。
当前缺口
- 真实消息、联系人、群成员、朋友圈和媒体未在本轮读取；健康入口有响应不证明目标账号、完整历史或全部业务端点正常。
- OpenAPI 的 AI 允许标记是调用约定，不是本仓库实现的 HTTP 拦截器；JSON Schema（数据结构） 也需要消费者实际执行验证。
- 看门狗的 TCP 回退只能证明端口可连接。目标进程存在但端口不通时，它记录问题并退出，不会强杀或反复重启。
- 快照工具只核验指定文件集当时的字节，不导出、解密、复制或锁定源文件；普通 JSON 回读收据没有数字签名，也不是不可篡改存储。
- 本轮没有重新进行登录、冷启动、黑框观察或真实快照恢复；当前任务状态与隔离测试各自说明，不能互相替代。
来源与公开边界
公开仓库保存 WeFlow 接口契约、自检与启动脚本、文件核验工具和虚构测试。真实聊天、联系人、导出文件及认证凭据保留在调用方的本地环境，不进入网页或公开仓库；服务读取与解密由 WeFlow 本体负责。
完整执行流程
- 1按任务选择读取路线
明确需要 WeFlow HTTP 适配时使用本项目。当前日常微信 Skill 走 WeChatDirect，不为本页将默认路线切回 WeFlow。
- 2确认来源和可读范围
调用方检查服务、当前账号库和目标会话，按用户问题选择联系人、群成员、朋友圈或指定消息范围；版本变化后重新核对接口行为。
- 3读取并保留上下文
最新消息检查最后时间，历史按 since/end/offset 续页，记录 hasMore、nextSince、nextOffset、watermark；引用和媒体线索与消息一起理解。
- 4给出结果与缺口
分析由具体 AI 完成；结果说明来源、范围、消息数与不确定性。公开元数据采用契约格式，私人正文仍留在获准的任务环境。
- 5运行异常时按证据恢复
脚本区分配置缺失、接口失败和进程缺失；看门狗不会反复启动已存在的目标实例。文件核验失败则保留未完成状态，不能冒充备份成功。
本页用到的名词
需要核对专业含义时，可以在这里查看它在 WeChat History AI Bridge 项目中的具体用法。
- WeFlowBridge
- 本项目工程兼容名，即 WeChat History AI Bridge；提供 WeFlow 接口适配契约、自检与启动脚本。
- ChatLab Pull（按页拉取）
- WeFlow 的结构化会话与历史消息读取方式；响应同时带会话、成员、消息和增量位置。
- Watermark（游标水印）
- 响应携带的同步标记，需要和 nextSince、nextOffset 等分页信息一起保留；不能把它当成接口未定义的 watermark 请求参数。
- media_manifest（媒体清单）
- 公开元数据只描述媒体类型、数量、时间、大小和发送者角色，不存放媒体内容或本机路径。
- Boot Guardian（开机守卫）
- 注册登录触发和定期检查任务的脚本；WeFlow 和微信仍需要已登录的交互桌面。
- MetadataOnly（纯元数据探测）
- 跳过消息正文端点，但不等于不访问业务数据，也不等于免凭据。
系统里实际有什么
下面是当前产品组件，不是概念分类。每一项都对应真实文件、入口或验证链。
实际数据来源
微信维护本地数据库，WeFlow 负责访问、解密与 HTTP 服务。本仓库没有实现另一套解密器或微信数据库。
接口地图
描述会话、联系人、消息、群成员、朋友圈、健康和推送端点；标出推荐读取项及不默认给 AI 调用的操作。
取数语义和结果格式
定义账号判断、最新自检、历史分页、回复引用、媒体清单、时区和失败说明；公开元数据示例由 JSON Schema（数据结构） 验证。
本地接口自检
读取本地配置后记录端点是否成功、返回形状与数量；MetadataOnly 跳过消息正文端点，但仍请求会话、联系人、群成员和朋友圈统计。
有界健康检查和登录启动
按指定 profile 匹配进程，缺失才启动一次；VBS 隐藏脚本窗口，注册器保留 PCConfig 已管理的微信双开任务。
已取得文件集的字节核验
生成文件清单、两遍 SHA-256 回读及普通 JSON 收据；只引用外部源文件，不复制原件。
一致的本地和 CI 检查入口
发现 tests/test_*.py 的全部测试，再执行已有公开边界检查；GitHub Actions 复用同一入口，避免漏跑快照测试或重复跑同一子集。
当前数据合同与写读边界
OpenAPI 3.1.0
docs/openapi.yaml：以 WeFlow 26.7.3 为基线；自定义 AI 标记是文档约定，服务端仍由 WeFlow 实现。
ai-consumer-envelope.v2
schemas/ai-consumer-envelope.v2.schema.json：JSON Schema（数据结构） Draft 2020-12；公开持久结果使用脱敏会话标记与无路径媒体清单，私人运行中的正文另按任务边界处理。
weflowbridge.project_manifest.v1
project_manifest.json：记录版本、职责、入口和消费交接要求；清单中的历史消费者名称不证明当前正在运行。
weflow-probe.v1
probe-weflow.ps1：ok 由五个必需端点的成功状态决定；shape、count、sync_present 是观察字段，不是完整业务 Schema（数据结构） 一致性的证明。
weflowbridge.private-snapshot-manifest.v1 / weflowbridge.private-snapshot-readback-receipt.v1
tools/build_private_snapshot_manifest.py：payload_mode=external_read_only_reference；证明指定时刻的文件字节回读，不提供导出、数字签名或不可变存储。
5 层证据分别证明什么
能证明：26 项项目契约与 5 项快照测试实际通过；探测失败分支使用接口替身，快照用临时虚构文件。
不能证明：不能证明真实微信读取、完整历史、真实恢复或每个异常分支都已端到端验证。
能证明：安装版本为 26.7.3.0，5031 与 16000 的 /health 返回 HTTP 200。
不能证明：未检查 token、当前账号、聊天正文、联系人、朋友圈或具体数据接口的可用性。
能证明：两项已命名任务为 Ready、最近结果 0，微信自启仍保留 PCConfig 双开标记。
不能证明：没有重新进行登录、断电、冷启动或桌面黑框观察；不把某个次实例任务名未找到说成全部自启不存在。
能证明：本地入口执行全部 31 项，虚构快照失败能中止 CI；同提交 GitHub Actions 34180971929 也通过，并补齐本机跳过的 PDF 文本检查。
不能证明：脚本没有遍历全部 Git 历史，也没有证明未来提交不会出现问题；远端 CI 不验证用户机器上的真实微信业务数据。
能证明：虚构文件成功生成 2 个文件的清单与回读结果；既有目标、空源、源目标嵌套和仓库内输出被拒绝。
不能证明：不证明内容能解密、原始导出完成或证据具有不可篡改性质；源文件在验收之后仍可能变化。
维护入口
GET http://127.0.0.1:5031/health只看服务是否响应：无需 token。只检查服务健康，不进入会话或联系人读取。
powershell -NoProfile -ExecutionPolicy Bypass -File probe-weflow.ps1 -Json -Mode MetadataOnly -NoMessages元数据自检：需要本地 .env 与有效数据接口凭据；会请求会话、联系人等业务接口，只输出汇总形状，不调用消息正文端点。
powershell -NoProfile -ExecutionPolicy Bypass -File tools/test-ci-local.ps1全部测试与已有公开检查：执行 tests/test_*.py 的全部 31 项和现有公开边界检查；任何跳过项必须单独阅读。
python -m unittest discover -s tests -p "test_*.py"只运行虚构样例测试：在不调用真实业务接口的情况下验证契约、探测失败行为和外部临时文件核验。
powershell -NoProfile -ExecutionPolicy Bypass -File weflow_boot_guardian.ps1注册默认启动任务：管理员操作，会注册计划任务。用于明确需要安装自启时，本轮没有执行。
powershell -NoProfile -ExecutionPolicy Bypass -File weflow_heartbeat.ps1 -Port <port> -UserDataDir <existing-profile> -InstanceName <name> -LogPath <log-file> -NoProxyServer -HiddenLaunch检查一个既有独立配置：可能启动指定 WeFlow 实例；目录、登录态和 API 设置须由该配置先准备好。参数示例不是本轮运行命令。
python tools/build_private_snapshot_manifest.py --source-root <private-source> --destination <new-private-output> --source-instance-id <account-instance>核验已经取得的文件：生成检查结果；不执行导出、解密或复制。输出须在本仓库之外，且不与源目录相互包含。
快照怎样更新
本页分别记录源码、虚构测试、安装与无正文健康观察。它没有执行真实聊天读取、任务安装或完整快照恢复，也不把测试通过包装成这些实机流程已经完成。