# 自动回复调试手册

## 常见 Bug 模式及修复

### 1. 回复内容是 hermes 命令或元数据
**症状**: 回复 `hermes --resume xxx` 或 `Resume this session with:`
**原因**: `generate()` 从 stdout 提取最后一行，hermes chat 输出末尾是元数据行
**修复**: 改用文件 I/O——hermes 写报告到文件，orchestrator 读取文件

### 2. 回复内容是完整 prompt
**症状**: 回复包含"你是火星人的微信助手..."等 prompt 原文
**原因**: hermes chat 把 prompt 原样输出到 stdout
**修复**: 同 #1，文件 I/O 彻底解决

### 3. 任务没执行但报告很漂亮
**症状**: hermes 回复"已用 plan agent 拆任务、todolist 已写好"，但飞书什么都没有
**原因**: hermes chat --yolo 优先生成文字报告，跳过实际工具调用
**修复**: prompt 加"先执行任务，不要先写报告"

### 4. 同一条消息触发多次
**症状**: 同一个 msgId 收到多次 ack 和回复
**原因**: dedup 只在 success 路径持久化，失败/跳过路径没记
**修复**: 在所有退出路径（success/fail/skip/task_failed）都持久化 msgId

### 5. 任务报告发到了群里
**症状**: admin 任务的结果报告出现在 TGO 群，不是私聊
**原因**: `talker` 是群 chatroom，不是 sender
**修复**: admin 任务结果用 `sender_wxid` 覆盖 `talker`

### 6. 删了白名单但还在回复
**症状**: 在 WeChat Viewer 删除白名单项，群里仍然自动回复
**原因**: `del()` 函数没有 `.catch()`，fetch 静默失败
**修复**: 加 `confirm()` + `.catch()` + HTTP 状态检查

### 7. hermes 自己往群里发消息
**症状**: task 执行中 hermes 调 send_text_via_hook 往群里发
**原因**: hermes 有发送工具权限
**修复**: reply-task-executor skill 第一条规则"禁止发消息"

## hermes chat 命令正确姿势

```bash
hermes chat -q "prompt" -s reply-task-executor --yolo -t terminal,file,web
```

- `-s reply-task-executor`: 加载任务执行 skill
- `--yolo`: 自动确认工具调用
- `-t terminal,file,web`: 必须带 file，否则 write_file 不可用
- GEN_TIMEOUT: 600s（GFW 下 GitHub 访问慢）