SKILL.md 16.2 KB

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/ 队列中的 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 分钟的残留锁。

恢复流程

  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 临时切账号:

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 分钟跑一次,自动清理残留锁)