「危险操作要不要做」只有三种答案
前两种都是偷懒的正确,第三种才是能长期跑下去的。
全部放行
Agent 想干什么就干什么。它会替你 rm -rf、git push --force、npm publish。
方便,直到某一天不方便。
一律拦死
只读之外全部拒绝。安全,但 Agent 会卡在第一步,你得到的是一个不会干活的 Agent。
分级 + 腕上确认
无害操作静默放行,高危操作推到你手腕上等你点一下。
既不放任,也不卡死。
一次确认,就是一次请求与一次结算
Agent 宿主的 PreToolUse hook 在命令真正执行之前拦下来,向本地网关发一个请求;
网关把卡片送出去、等你选择,再把结论回填给 hook。链路两端都是本地 HTTP / WebSocket,
推送这一跳才交给 Home Assistant。
# Agent 宿主 → 网关(本地回环 127.0.0.1) POST /v1/approvals { "tier": "L3", "title": "高危操作确认", "body": "git push --force origin main", "ttl": 120, "wait": 90000, "session_id": "…" }
# 网关 → Agent 宿主(回填结论) 200 OK { "verdict": "allow", "decidedBy": "ha", "latencyMs": 8420 } # 其余时刻(超时 / 推送失败) "verdict": "deny" ← fail-closed,绝不放行
关键分工:Home Assistant 只负责送通知、收事件,不做任何判断。 令牌校验、重放拦截、超时兜底、审计留痕全部在网关里。
走一遍完整链路
点下面的按钮,看一条 L3 命令怎么从 Agent 走到你的手腕、再走回来。 中途把「手机离线」打开,可以看它在推送失败时怎么换一条路继续问你 —— 判定仍然是拦住,但询问会交回宿主原本的确认框,你不必离开工作流。
四档,决定打扰你的频率
分级只看命令文本的正则。设计目标不是「把危险的都抓出来」——而是 不把无害的判高:打扰预算一旦被噪音消耗完,人就会开始无脑点「允许」,整套方案等于白接。
复合命令取最危险的那一段,不让无害段稀释它:
for f in a; do sudo true; done 仍是 L3。反过来,rm 会看目标路径是否落在
node_modules / dist / /tmp 这类常规清理目录,以及是否递归 ——
目录内清理判 L1,非递归删单文件判 L2,递归删外部路径判 L3。
为什么它敢拦住而不是放行
推送失败时最糟的处理,是「静默放行」。这里的每一层都朝着 fail-closed 长。
令牌 + HMAC 绑定
每次确认签一张绑定到「这一次动作」的令牌。手改过期时间会直接判定签名无效。
单次消费
一次授权只放行一次。同一条命令再跑,还得重新问你。重放会被拦截。
时限兜底
L2 / L3 默认 120 秒无响应即拒绝。挂在你腕上的卡片过期后自己作废。
推不出去就拦住,但不会只剩一句拒绝
判定恒为 deny(不赌权限模式)。拦住的同时降级继续往下走:先用本机一次性授权;
没有就让 Agent 用宿主原本的确认框问你一次;再不行转场本地审批页;
最后才停在拒绝,并把这一条记进 blocked-last.json。
全程留痕
每一次创建、结算、超时、撤销都写进 audit 日志,标明是谁决定的。
只走本机回环
网关 ↔ Home Assistant 走 127.0.0.1,不受局域网 IP 漂移影响,也不出网。
你可能想问的六件事
通道选型、Watch 镜像、防绕过、降级行为、误伤控制、重放防护。
为什么要自建 Home Assistant 推送,不接第三方推送服务?
三个原因:整条链路不出内网,确认指令这种敏感动作不经过任何第三方服务器;不用注册、不用付费、不受第三方限流或接口改版影响;Home Assistant 本来就 7×24 在跑,推送只是它顺手做的事。iPhone 上也不用装任何新 App——官方 HA Companion App 的通知通道就够。
Apple Watch 上怎么收到确认卡片?
iPhone 锁屏或息屏时,系统会把 Home Assistant 的通知自动镜像到手表。卡片上带「允许 / 拒绝」两个按钮,点一下,结论就经 WebSocket 事件回传给网关,全程不用掏手机。
Agent 会不会绕过网关直接执行?
拦截挂在宿主的 PreToolUse hook 上,命令在真正执行之前必经这一关;判定策略是 fail-closed——查询不到结论时一律拒绝,绝不默认放行。所以网关出问题的表现是「什么都做不了」,而不是「什么都做了」。
推送失败或者我不在手表旁边,会怎么样?
判定恒为 deny,但不是干等一句拒绝:先试本机一次性授权,再降级到宿主原生确认框问你一次,最后转本地审批页。每一跳都留痕,120 秒没响应就按拒绝结算。
分级会不会把日常操作也拦下来?
设计目标恰恰是「不把无害的判高」。rm 会看目标路径:node_modules / dist / /tmp 这类清理目录只记审计;复合命令取最危险的一段,不让无害部分稀释等级。打扰预算花在真正值得确认的操作上。
令牌被截获、重放怎么办?
每次确认签发的令牌都绑定这一次动作的 HMAC,单次消费、120 秒过期;同一条命令再跑必须重新确认,重放直接拦截。创建、结算、超时、撤销全部写进 audit.jsonl,谁决定的、什么时候决定的,查得到。