auto-reply-architecture.md 2.22 KB

微信自动回复系统架构

完整流程图

微信消息到达
  → Watcher (wechat_reply_watcher.py, inotify)
  → incoming.jsonl
  → Orchestrator (wechat_reply_orchestrator.py, --drain)
  → process_event():
      ├─ Step 0: 去重 (processed_ids.json)
      ├─ Step 1: 角色判断 (admin/member/other)
      ├─ Step 2: 消息分类 (_is_task_request)
      ├─ Step 3A: admin任务 → 两段式
      │     ├─ ack秒回 → talker
      │     └─ hermes chat -q -s reply-task-executor --yolo -t terminal,file,web
      │         → 写报告到 result_file
      │         → orch 读文件 → 私发到 sender_wxid (群内不公开)
      ├─ Step 3B: admin闲聊/member → 单段式
      └─ Step 5: 发送 + 去重持久化

10 条关键教训

1. 文件 I/O > stdout 解析

hermes chat 输出包含 prompt + 工具调用 + 结果,无法可靠从 stdout 提取。 解决:让 hermes 把报告写入 result_file,orchestrator 读文件。

2. Skill 定义逻辑,代码执行

不要硬编码 prompt/ack模板/失败消息。 解决:wechat-auto-reply/ reply-task-executor/ reply-failure-report 三个 skill 分工明确。

3. 发送者路由 (From→To)

群内 @ 触发的任务,ack 在群里回,结果必须私发给 sender_wxid。 解决:override_talker = sender_wxid when event.isGroup

4. 去重全路径

processed_ids 在所有退出路径(成功/失败/跳过)都持久化,漏了就会重复触发。

5. Hermes chat 命令

-m = 选模型, -q = 发查询, -Q = 安静模式(无banner)。 正确用法:hermes chat -q prompt -s skill --yolo -t terminal,file,web

6. pycache 权限

daemon (root) 生成的 pycache 导致非 root 用户无法覆盖。清缓存前先 kill daemon。

7. 前端 fetch 必须 catch

fetch().then().then() 没 .catch() → 网络错误静默丢失。 解决:加 .catch(e => alert(...))

8. Plan Agent 分组审核

主任务+子任务作为一个整体一起审,不能分开。

9. Plan Agent 写而非审

缺描述→从父任务推断补写→自审→通过,不是直接 FAILED。

10. 报告完整性检查

太短/只有一句话/无具体信息 → 视为失败。