--- name: wechat-auto-reply description: 微信自动回复完整策略——角色判断、两段式回复、输出提取、去重、发送规则。唯一权威参考,代码只是执行引擎。v5.0。 version: 5.0 category: wechat --- # 微信自动回复策略 v5.0 自动回复系统的**唯一权威参考**。Python 代码(orchestrator)只是执行引擎。 ## 架构 ``` 消息到达 → 去重 → 角色判断 → 模式选择 → 生成回复 → 验证 → 发送 ``` ## Step 0: 去重 - msgId 只处理一次。处理后持久化到 `processed_ids.json` - 去重在**所有退出路径**都执行(成功/失败/跳过) - Daemon 重启不清空去重 ## Step 1: 角色判断 | 角色 | 模式 | 命令 | |------|------|------| | `admin` | 完整模式 | `hermes chat -q prompt -s reply-task-executor --yolo -t terminal,file,web` | | `member` | 简单闲聊 | `hermes -z` | | 其他人 | 人工审核 | — | ## Step 2: 消息分类 任务关键词:研究、学习、查一下、分析、帮我、看看、安装、配置、搭建、写一个、改一下 **任务** → 两段式 | **闲聊** → 单段式 ## Step 3A: 两段式回复(admin 任务) ### 第一段:ack(秒回) 个性化模板,根据任务类型匹配。 ### 第二段:执行 + 报告 - 命令:`hermes chat -q prompt -s reply-task-executor --yolo -t terminal,file,web` - hermes 写报告到文件,orchestrator 读文件发送 - ⛔ **禁止解析 stdout**——文件 I/O 是唯一可靠方式 ### 状态处理 | 状态 | 处理 | |------|------| | 成功 | 发任务报告 | | 任何失败 | 调 `reply-failure-report` skill,**禁止 fallback 到 member** | ## Step 3B: 单段式回复 - admin 闲聊:hermes chat → 失败回退 member - member:hermes -z → 失败直接 failed ## 发送规则 1. **From → To**:谁发的回给谁。私聊回私聊。 2. **群聊 admin 任务**:报告私聊发给 sender_wxid,不进群 3. **群聊 ack/闲聊**:群内回(带 @mention) ## 错误处理 1. hermes 写文件 → orchestrator 读文件,不走 stdout 2. admin 失败 → `reply-failure-report` skill,不回退 member 3. 不假承诺(不说"我重试") 4. 写 task contract 到 `_q/` 目录排查 ## 经验教训 1. **文件 I/O > stdout 解析**:hermes chat 输出含 prompt+工具+结果,无法可靠提取。改让 hermes 写文件再读取。 2. **hermes chat -q(查询)≠ -m(选模型)**:`-m` 是选模型参数,不是发消息。单次查询用 `-q`,加 `-Q` 静默模式。 3. **Skill > 硬编码**:逻辑放 skill,代码只是执行引擎。 4. **Loop > 一步黑盒**:Plan→Execute→Verify→Report。 5. **去重全路径**:成功/失败/跳过都要持久化 msgId。 6. **转发禁止 send_text_via_hook**:reply-task-executor skill 禁止发消息。 7. **失败不 fallback**:admin 任务失败用 reply-failure-report,不回退 member 闲聊。 8. **From→To 原则**:谁发的消息回复就发给谁。admin 任务结果私聊发 sender,不进群。 9. **Hermes 撒谎问题**:hermes 有时生成报告但不执行工具。prompt 必须写「先执行,不要先写报告」。 10. **Cron 无 root 权限**:reply-sender.py 需要 root(调 send_text_via_hook),建议 admin 任务结果直接由 orchestrator 发送。 11. **pycache 权限冲突**:看门狗 su 启动的 Flask 生成 root 属主 pycache,用户启动时报 Permission denied。用 `su -c chown` 修复。 12. **Watcher + Orchestrator 必须 su -c**:`read_uin()` 读 `/data/user/0/` 需要 root。`su` 下 PATH 不含 Termux,必须用 `/data/data/com.termux/files/usr/bin/python3` 完整路径。 13. **orch.lock 残留死锁**:orchestrator 以 root 运行为异常退出时,锁文件属主 root,普通用户删不掉,后续 drain 全被挡(静默 return 无日志)。watchdog 需在 drain 前清理 >5min 的残留锁。 14. **copy_db 缺 rcontact 表**:watcher 的暂存副本不含 rcontact,导致 `process_event` 查昵称时 sqlcipher 报错。发送本身可能成功,但日志标记「失败」。 15. **双账号:watcher 只监听当前登录账号**。另一个账号的消息需通过 wechat-viewer API 临时切换查询。 ## 安全边界 (Safety Guardrails) > 对齐 Google Cloud Skills 的「操作手册 + 安全边界」标准。本节列出本 skill **禁止自主执行**的高风险动作,必须显式 HITL(人工)授权。 ### Prohibited Operations (Denylist) 以下动作**禁止** auto-reply pipeline 自主执行,必须人工确认后才可发送: - **转账/红包/收款**:任何涉及微信支付、转账、发红包、收款码的请求 → 一律拒绝自动回复,转人工 - **加好友/拉群/改群名**:自动接受好友申请、拉人进群、修改群公告/群名 → 禁止 - **群发营销**:一次性向多个联系人或群发送相同内容(广播)→ 禁止 - **代发承诺**:代替火星人做「一定」「保证」「我答应」类承诺 → 禁止,只能给「我问一下火星人」 - **转发未确认身份联系人**:向 nickname/alias 多重匹配或未确认的联系人发送消息(见 MEMORY §转发规则)→ 必须先 `rcontact` 精确匹配,多结果→人工选择 - **删除/撤回超过 1 条历史消息**:批量删除聊天记录、批量撤回 → 禁止 - **修改账号安全设置**:改密码、改绑定手机/邮箱、开关登录设备 → 禁止 ### 执行前必做检查 | 动作 | 必做检查 | 拒绝条件 | |------|---------|---------| | 发送消息 | `rcontact` 精确匹配 → 确认 wxid 唯一 | 匹配 ≥2 个结果 → 人工 | | 涉及金钱关键词 | 触发人工确认 | 「转账/红包/多少钱/借」任一命中 → 人工 | | 涉及时间承诺 | 触发人工确认 | 「明天/下周/我X点到」→ 人工 | | 群聊 at 回复 | 已在群内 + 识别 sender | sender 不在群成员列表 → 跳过 | ### Dry Run 原则 - 发送**任何**非闲聊内容前,orchestrator 应先把待发消息写到 `_q/` 队列文件,**不直接调** `send_text_via_hook` - 队列文件由 cron `reply-sender.py` 统一消费,自带去重 + 频率控制 + root 权限隔离 - 单次任务的「直接 hook 发送」仅限 ack 一句话确认 ## 竞争定位:入口 vs 无法绕开的系统(2026-07-31 吸收) > 来源:中国To B软件被AI Agent二次降维打击 — AI时代ToB软件只有两种位置。 | 位置 | 特征 | Hermes auto-reply 映射 | |------|------|----------------------| | **入口** | 掌握用户 + 高频任务 | ✅ WeChat 是火星人最高频交互界面,auto-reply 是 Hermes 的 Agent 入口 | | **无法绕开的系统** | 掌握真实状态(消息/联系人)+ 企业权力(审批/发送)+ 现实执行 | ✅ WeChat 消息/联系人/群聊是实时状态唯一感知入口 | **核心判断**:auto-reply 同时占据两个位置——WeChat IM(入口,高频)+ 端侧实时状态(无法绕开,云端 Agent 做不到)。竞争不是「用户打开哪个 App」而是「Agent 优先调哪个系统」——端侧实时状态感知是结构性优势,不是模型能力可复制。 **与供需经济学互补**: - 供需经济学 → 状态接口 > 知识库 - 本文 → 入口(高频任务)= 状态接口的天然载体 - 两者交汇:auto-reply 不只是自动化回复,是**实时供需状态的感知器 + Agent 优先调用的入口**——双位置合一。 ## 上下文入口策略(Context Entry,2026-08-03 GenOffice 吸收) > 来源:GenOffice 两层架构与免费获客策略。免费工具不是盈利产品,是用户上下文的入口。 auto-reply 对 Hermes 的角色 = GenOffice 免费 Office 对 Genspark 的角色: | 维度 | GenOffice 免费工具 | Hermes auto-reply | |------|------------------|-------------------| | **捕获什么** | 用户任务类型/行业术语/表达习惯 | 消息类型/任务关键词/沟通模式/联系人网络 | | **流向哪** | 记忆层 → 高阶 Agent 商业化($2.5亿ARR) | learn_queue → skill 生态增强 → 更高吸收质量 | | **护城河** | 上下文入口 = 稀缺资产,AI 编程压低实现成本但无法复制上下文 | 端侧微信上下文 = 云端 Agent 无法绕开的实时状态 | ### 当前 Gap:context entry 价值流失 - auto-reply 每天处理 N 条消息,捕获了大量用户上下文(任务类型分布/行业术语/联系人关系) - 但这些上下文**未结构化流入** learn_queue 或 memory——orchestrator 只管回复,不提取学习素材 - 类比:GenOffice 如果只做格式转换而不把用户文档内容喂给记忆层,就只是一个免费 converter ### 建议方向(L2) 1. orch 在处理每条消息时,提取:行业术语/任务类型/失败模式 → 写 learn_queue 待分类 2. 高频失败模式(如 admin 任务超时/hermes 撒谎)自动生成 Bug-report 型学习素材 3. 联系人互动频率/群活跃度 → memory 结构化(社交图谱) 4. 与学习飞轮闭环:context entry → learn → better skills → 更好的 auto-reply → 更多 context ## Gate 架构(HydraMind 四层栅格,2026-07-31 审计) > 用 ETCLOVG + Graph/Loop/Harness + 四类边框架审计 orchestrator pipeline 的运行时门控结构。 ### 管线拓扑(Graph 视角) ``` 消息到达 → [G0:去重] → 构建context → [G1:角色判断] → ├─ admin任务 → ack → generate(hermes chat) → [G2:产出验证] → [G3:完整性检查] → [G4:策略判断] → [G5:发送验证] └─ member → generate(hermes -z) → [G2:产出验证] → [G4:策略判断] → [G5:发送验证] ``` ### 门控清单 | Gate | 节点 | 可验证事实 | reason_code | 动作 | |------|------|-----------|-------------|------| | G0 | `_load_processed` | msgId in set | `DUPLICATE` | skip | | G1 | `role check` | sender in whitelist_roles | — | route(admin/member) | | G2 | `_verify_draft` | empty/noise/error_marker/min_length | `EMPTY_DRAFT`/`NOISE_LINE`/`ERROR_MARKER`/`TOO_SHORT` | fallback/block | | G3 | `_is_complete_report` | len>80 + ≥2 lines + specific info | `INCOMPLETE_REPORT` | block→failure report | | G4 | `policy.decide` | 发送策略规则 | `SKIP`/`AUTO`/`MANUAL` | skip/send/review | | G5 | `_send_text_verified` | hook status + DB poll | `HOOK_FAIL`/`VERIFY_TIMEOUT` | queue/fail | ### Gate 动作完备性(Loop 视角) | 动作 | G2 | G3 | G4 | G5 | |------|:--:|:--:|:--:|:--:| | CONTINUE | ✅ | ✅ | ✅ (auto) | ✅ | | REVISE | ✅ (member fallback) | ❌ | — | ✅ (retry) | | REPLAN | ❌ | ❌ | ✅ (manual) | ❌ | | BLOCK | ✅ (failed queue) | ✅ (fail→report) | ✅ (skip) | ✅ (failed) | **Gap**: G2/G3 缺 REVISE/REPLAN 路径——失败后只有 fallback 或 block,没有「带着修正提示重试」的能力。G5 的 VERIFY_TIMEOUT 目前归类为 BLOCK,但应该是 REVISE(消息可能网络恢复后送达)。 ### 四类边审计 | 边类型 | 当前状态 | 得分 | |--------|---------|:--:| | **数据边** | G2→G3 传递 raw text, G3→G4 传递 validated text, G4→G5 传递 final text + talker | 5/10 — 字段稳定但无显式 schema | | **权限边** | ack→generate 从只读到写入(文件+API),但通过 result_file 隔离 | 6/10 — 有隔离但无 per-tool 梯度 | | **验证边** | G2/G3 是独立 verifier(非 Agent 自评),G5 是 DB 级验证 | 7/10 — 执行与验证已分离 | | **恢复边** | 失败消息入 _q/ 队列 + task contract,但无自动重试机制 | 4/10 — 有恢复 artifact 但缺自动重试 | ### 已知 Gap(可自动修复) 1. **G5 VERIFY_TIMEOUT 应 REVISE 非 BLOCK** — 网络恢复后消息可能送达,应标记 pending 等 cron 重试而非直接 failed 2. **G2 error_marker 名单需更新** — 见 `_verify_draft` 的 noise_start/marker 列表,新 hermes 版本的错误格式可能未被覆盖 3. **缺 quad-trace 格式** — 当前日志用 plain text,未输出 `[node=X,attempt=N,gate=RC,action=A]` 格式,无法被 `api_learn_gate_audit` 解析 ### 当前不可自动修复 - **per-tool 权限梯度**(Harness 层):需要改 orchestrator 调用链,涉及 HITL 设计 - **自动重试机制**(恢复边 L2):需要 cron job 扫描 _q/ 队列中的 pending_send 条目 - **quad-trace 统一格式**:需改 orchestrator 的 `log()` 函数输出结构化 trace,属于 L2 ## 代码参考 `~/pixelphone/wechat_reply/wechat_reply_orchestrator.py` - `generate()` / `process_event()` / `_is_task_request()` / `_gen_ack()` / `_queue_insert()` - `~/pixelphone/scripts/reply-sender.py` — cron 队列发送器(需 root 权限) ## 系统恢复(Watcher/Orchestrator 挂了怎么修) ### 诊断 ```bash # 检查 watcher 是否在跑(必须 su 才能看到 root 进程) su -c 'ps -A | grep watcher' # 检查 orchestrator 最后处理时间 tail -5 ~/pixelphone/wechat_reply/orchestrator.log # 检查积压 wc -l ~/pixelphone/wechat_reply/incoming.jsonl # 检查 cursor cat ~/pixelphone/wechat_reply/cursor.json # 检查是否有残留锁阻塞 drain ls -la ~/pixelphone/wechat_reply/orch.lock 2>/dev/null && echo "LOCK EXISTS — drain blocked" ``` ### Watcher 启动(必须用 su) **PITFALL**:watcher 的 `MM_BASE = /data/user/0/com.tencent.mm` 需要 root 权限才能读。 `python3` 在 su 下不可见(不在系统 PATH),必须用完整 Termux 路径。 ```bash # ❌ 错误:无 root 权限,read_uin() 读不到 shared_prefs cd ~/pixelphone/wechat_reply && python3 wechat_reply_watcher.py # ❌ 错误:su 下 python3 找不到 su -c 'cd ~/pixelphone/wechat_reply && python3 wechat_reply_watcher.py' # ✅ 正确:su + 完整 Termux 路径 su -c '/data/data/com.termux/files/usr/bin/python3 /data/data/com.termux/files/home/pixelphone/wechat_reply/wechat_reply_watcher.py' ``` ### Orchestrator Drain 也需要 su **PITFALL**:`_drain_inner()` → `account_paths()` → `read_uin()` 同样需要读 `/data/user/0/`。 用普通用户跑 drain 会静默失败(异常被吞,cursor 不更新,日志无输出)。 ```bash # ❌ 错误:无 root 权限,_drain_inner 在 account_paths() 抛异常 cd ~/pixelphone/wechat_reply && python3 wechat_reply_orchestrator.py --drain # ✅ 正确:su + 完整路径 su -c '/data/data/com.termux/files/usr/bin/python3 /data/data/com.termux/files/home/pixelphone/wechat_reply/wechat_reply_orchestrator.py --drain' ``` ### orch.lock 残留问题 当 orchestrator 以 root 运行时异常退出,`drain()` 的 finally 块删除 `orch.lock` 失败(锁文件属主 root,但异常可能跳过了 finally 或 rm 无权限)。残留锁超过 5 分钟会被下次 drain 抢占,但在这期间所有 drain 直接 return(无日志)。 ```bash # 清理残留锁 rm -f ~/pixelphone/wechat_reply/orch.lock ``` Watchdog 脚本(`~/pixelphone/scripts/wechat-viewer-watchdog.sh` §6)现在自动清理超过 5 分钟的残留锁。 ### 恢复流程 1. **抓取停机期间的消息**:`su -c '...watcher.py --once'` 2. **设 cursor baseline**:编辑 `cursor.json` 为 `{"last_msgId": <最新msgId>}` 3. **启动常驻 watcher**:`su -c '...watcher.py' &` 4. **清理残留锁**:`rm -f orch.lock` 5. **处理积压**:`su -c '...orchestrator.py --drain'` ### 已知 Bug:copy_db 缺少 rcontact 表 Watcher 的 `copy_db()` 方法创建的暂存副本(`_stage_orch/`)不包含 `rcontact` 表。 这导致 `process_event()` 在查 sender 昵称时 sqlcipher 报 `no such table: rcontact`。 虽然消息发送本身可能成功(通过 hook 直接发送),但日志会记录 `处理 #xxx 失败`。 ### 双账号注意 Watcher 只监听当前登录账号(`read_uin()` 读 `last_login_uin`)。 如果消息发到另一个账号,watcher 看不到。 查另一个账号用 wechat-viewer API 临时切账号: ```bash curl -X POST http://127.0.0.1:5001/api/accounts/switch \ -H "Content-Type: application/json" \ -d '{"account_id":"ec4f423b316d41e9af5e8398155cf105"}' # 火星人 # 查完切回 curl -X POST http://127.0.0.1:5001/api/accounts/switch \ -H "Content-Type: application/json" \ -d '{"account_id":"653cdc2320abb089e149a3f7a7683fcf"}' # 小伙子 ``` ### Watchdog 守护 `~/pixelphone/scripts/wechat-viewer-watchdog.sh`(cron 每 5 分钟)现在覆盖 6 项: 1. Flask (port 5001) 2. Hermes Gateway 3. Stuck Job Reaper 4. Orphan Report Reaper 5. **微信 Watcher daemon**(挂了自动拉起,su -c) 6. **Orchestrator drain**(每 5 分钟跑一次,自动清理残留锁)