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
发送规则
- From → To:谁发的回给谁。私聊回私聊。
- 群聊 admin 任务:报告私聊发给 sender_wxid,不进群
- 群聊 ack/闲聊:群内回(带 @mention)
错误处理
- hermes 写文件 → orchestrator 读文件,不走 stdout
- admin 失败 →
reply-failure-reportskill,不回退 member - 不假承诺(不说"我重试")
- 写 task contract 到
_q/目录排查
经验教训
- 文件 I/O > stdout 解析:hermes chat 输出含 prompt+工具+结果,无法可靠提取。改让 hermes 写文件再读取。
- hermes chat -q(查询)≠ -m(选模型):
-m是选模型参数,不是发消息。单次查询用-q,加-Q静默模式。 - Skill > 硬编码:逻辑放 skill,代码只是执行引擎。
- Loop > 一步黑盒:Plan→Execute→Verify→Report。
- 去重全路径:成功/失败/跳过都要持久化 msgId。
- 转发禁止 send_text_via_hook:reply-task-executor skill 禁止发消息。
- 失败不 fallback:admin 任务失败用 reply-failure-report,不回退 member 闲聊。
- From→To 原则:谁发的消息回复就发给谁。admin 任务结果私聊发 sender,不进群。
- Hermes 撒谎问题:hermes 有时生成报告但不执行工具。prompt 必须写「先执行,不要先写报告」。
- Cron 无 root 权限:reply-sender.py 需要 root(调 send_text_via_hook),建议 admin 任务结果直接由 orchestrator 发送。
- pycache 权限冲突:看门狗 su 启动的 Flask 生成 root 属主 pycache,用户启动时报 Permission denied。用
su -c chown修复。 - Watcher + Orchestrator 必须 su -c:
read_uin()读/data/user/0/需要 root。su下 PATH 不含 Termux,必须用/data/data/com.termux/files/usr/bin/python3完整路径。 - orch.lock 残留死锁:orchestrator 以 root 运行为异常退出时,锁文件属主 root,普通用户删不掉,后续 drain 全被挡(静默 return 无日志)。watchdog 需在 drain 前清理 >5min 的残留锁。
- copy_db 缺 rcontact 表:watcher 的暂存副本不含 rcontact,导致
process_event查昵称时 sqlcipher 报错。发送本身可能成功,但日志标记「失败」。 - 双账号: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)
- orch 在处理每条消息时,提取:行业术语/任务类型/失败模式 → 写 learn_queue 待分类
- 高频失败模式(如 admin 任务超时/hermes 撒谎)自动生成 Bug-report 型学习素材
- 联系人互动频率/群活跃度 → memory 结构化(社交图谱)
- 与学习飞轮闭环: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(可自动修复)
- G5 VERIFY_TIMEOUT 应 REVISE 非 BLOCK — 网络恢复后消息可能送达,应标记 pending 等 cron 重试而非直接 failed
- G2 error_marker 名单需更新 — 见
_verify_draft的 noise_start/marker 列表,新 hermes 版本的错误格式可能未被覆盖 - 缺 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/ 队列中的 pendingsend 条目
- 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 挂了怎么修)
诊断
# 检查 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 路径。
# ❌ 错误:无 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 不更新,日志无输出)。
# ❌ 错误:无 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(无日志)。
# 清理残留锁
rm -f ~/pixelphone/wechat_reply/orch.lock
Watchdog 脚本(~/pixelphone/scripts/wechat-viewer-watchdog.sh §6)现在自动清理超过 5 分钟的残留锁。
恢复流程
- 抓取停机期间的消息:
su -c '...watcher.py --once' - 设 cursor baseline:编辑
cursor.json为{"last_msgId": <最新msgId>} - 启动常驻 watcher:
su -c '...watcher.py' & - 清理残留锁:
rm -f orch.lock - 处理积压:
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 临时切账号:
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 项:
- Flask (port 5001)
- Hermes Gateway
- Stuck Job Reaper
- Orphan Report Reaper
- 微信 Watcher daemon(挂了自动拉起,su -c)
- Orchestrator drain(每 5 分钟跑一次,自动清理残留锁)