首页
社区
课程
招聘
[原创]PI扩展给编码助手加一道写入确认门禁:write-gate 的实现与取舍
发表于: 4天前 18

[原创]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。默认策略必须是不执行——没有确认能力的时候,默认值是「否」。


传递专业知识、拓宽行业人脉——看雪讲师团队等你加入!!

收藏
点赞 ・1
打赏
分享
最新回复 (0)
游客
登录 | 注册 方可回帖
返回