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. 报告完整性检查
太短/只有一句话/无具体信息 → 视为失败。