pi-vetter

Pi 扩展包的安装与更新前供应链安全审查门禁,输出带证据链的 ALLOW / ASK / DENY 判定。

安装命令
pi install npm:pi-vetter
临时试用 / 替代安装命令
pi -e npm:pi-vetter
挂接事件钩子与注册入口
静态命令入口驱动(非运行时 tool_call 拦截)
pi.registerCommand("vet")pi.registerCommand("vet-install")ctx.ui.setWidget() / notify()pi.appendEntry()

1. 是什么

pi-vetter 是 jesset 开发的供应链安全审查扩展。

它专门针对 Pi 插件运行时的一个现实风险:Pi 安装第三方 npm 扩展时会赋予与宿主相同的系统权限,且会执行包的 postinstall 脚本。

2. 解决什么问题

内置更新器只提示“某包有新版本”,不检查新版本是否引入已知 CVE 漏洞、是否出现投毒变更、是否存在高仿包名(typosquatting)或未经验证的构建来源。

pi-vetter 把“装什么版本、为什么允许装”变成可核验的证据清单,让用户看完证据再拍板安装。

3. 作用原理(事件钩子与工具注册层)

不拦截模型运行期工具,而在包安装与更新环节接入命令与终端 UI,拉取多源供应链证据并锁定精确版本。

  • 扩展注册 /vet 与 /vet-install 两个命令,并在需要时通过 ctx.ui.setWidget() 展示审查进度与结果。
  • 针对候选扩展包与目标版本,聚合多个安全证据源进行评估:包括 OSV 漏洞库、Sigstore 来源证明、仿冒包名检测及依赖变更信号。
  • 汇总后给出 ALLOW / ASK / DENY 三档判定及完整证据列表。正如作者明确提示,它只能证明“未发现已知风险信号”,不能保证包绝对安全,最终由用户查看证据后执行精确版本安装。

4. 怎么装与基本配置

  • 安装后,不要盲目升级全部扩展,可以先运行 /vet <包名> 审查候选包或待更新版本。
  • 审查通过后使用 /vet-install 锁定已批准的精确版本号安装,避免自动拉取未经检查的后续版本。

5. 和同类怎么选

pi-vetter 管的是“扩展装进来之前”的供应链准入;cc-safety-net 与权限系统管的是“装好后模型运行期间”的行为边界。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
cc-safety-net / @gotgenes/pi-permission-system 两者防护运行中模型发起的 tool_call,不负责审查扩展包本身的 npm 供应链和 postinstall 风险。 先用 pi-vetter 审一遍要装的扩展,日常再用安全护栏或权限系统管运行期操作,两者互补不冲突。

同方向对比包与顺序阅读

cc-safety-net

在命令执行前做语义解析的安全护栏,阻断破坏性 Shell 指令和敏感密钥文件读取。

阅读该包机制详评

@gotgenes/pi-permission-system

为 Pi 提供集中式、确定性的权限门禁系统,统一接管工具、bash、MCP、技能与特殊操作鉴权。

阅读该包机制详评

03 安全与权限

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「pi-vetter」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)