# 微信自动回复系统架构 ## 完整流程图 ``` 微信消息到达 → 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. 报告完整性检查 太短/只有一句话/无具体信息 → 视为失败。