-
-
[原创]PI扩展给编码助手加一道写入确认门禁:write-gate 的实现与取舍
-
发表于: 4天前 18
-
TL;DR
把「改文件前必须经我同意」从 AGENTS.md 里的提示词,变成 tool_call 钩子上的技术拦截。edit/write 用结构化匹配,bash 用正则尽力而为——后者必然有漏网,这是设计上接受的。
核心取舍:一个会被无脑点掉的门禁,等于没有门禁。
完整实现约 200 行 TypeScript,MIT 协议。
用 AI 编码助手久了,会形成一种很别扭的状态:信任它读,但不完全信任它写。
它能一口气改 20 个文件,也能把 rm -rf 混在三条 && 中间发出去。事后 git diff 翻半天,才发现某个配置被悄悄动了。
一开始我的做法是写规则:在 AGENTS.md 里写清楚「改文件前必须先说明、等同意」。结果很稳定——遵守了 80%,剩下 20% 取决于当天状态。
规则是提示词,提示词是概率性的。想让 100% 的东西变成 100%,只能上代码。

pi 的扩展 API 提供一个 tool_call 钩子,在工具真正执行前触发,返回 { block: true } 即可拦下。
不点「允许」,文件就不会变。这是技术保证,不是提示词。
session_start 里重置 allowAll,保证「本会话全部允许」不会泄漏到下一个会话。
这是整个扩展最重要的设计决策:
源码注释里写得很直白:
不明说这一点,使用者会误以为它是安全边界。
edit 的预览渲染成 - / + 摘要,观感与 git diff 一致:
坑 1:正则的单词边界
看着没问题。但 \b 在 -- 和空格之间不成立(- 是非单词字符),所以规则必须写成:
坑 2:同一个动作有一百种写法
第一版只覆盖了 > file、>>、sed -i、tee、rm。然后逐条补:
每一条都对应一次「我原以为拦住了,其实没有」。
坑 3:故意不拦的那一类
误报的代价是烦,漏报的代价是没审核。 但每天几十条 python3 -c 只用来算个 JSON,全弹出来,人就会开始无脑点「允许」——那时候门禁就废了,比没有更糟。
一个会被无脑点掉的门禁,等于没有门禁。
同一个操作,参数天天变:
存原文没意义,得归一化:
选项里加一个「记住此命令形态」,写进 JSON:
缓存按文件 mtime 失效,记忆写入后立即生效,不用重启:
临时目录免打扰
验证脚本天天往 /tmp 写,每步都弹窗会疯。所以只放开约定好的几个目录,不是整个 /tmp:
命令替换放弃静态判断
rm -rf $(cat dir.txt) 里到底删什么,静态分析不出来。宁可多弹一次。
headless 默认拦截
pi -p 这类跑批模式没有确认 UI。默认策略必须是不执行——没有确认能力的时候,默认值是「否」。