cc-safety-net
在命令执行前做语义解析的安全护栏,阻断破坏性 Shell 指令和敏感密钥文件读取。
安装命令
pi install npm:cc-safety-net 临时试用 / 替代安装命令
pi -e npm:cc-safety-net 挂接事件钩子与注册入口
tool_call(前置阻断高危命令与敏感路径)
pi.registerCommand("cc-safety-net")pi.sendUserMessage()(生成拦截说明与规则诊断提示) 1. 是什么
cc-safety-net(Coding CLI Safety Net)是 kenryu42 维护的跨多款编码 CLI 安全拦截钩子。
它同时支持 Claude Code、Cursor、OpenCode 与 Pi,在 Pi 中通过 ./dist/pi/index.js 扩展入口加载。
2. 解决什么问题
简单的正则黑名单很容易被绕过,例如给命令包一层 sh -c、调整参数顺序(rm -f -r)、或通过管道与变量拼接访问 ~/.ssh 和 .env。
cc-safety-net 的定位是在工具调用真正落到 OS 执行前,先对命令结构做语义解析拦截,同时强调自己“不是沙箱”,不会做进程隔离或网络管控。
3. 作用原理(事件钩子与工具注册层)
挂载工具调用前置拦截钩子与规则诊断命令,解析 bash 与文件读取动作并在风险命中时阻断执行。
- 扩展初始化时在 Pi 中挂载安全拦截钩子,并注册 /cc-safety-net 命令用于解释拦截原因、规则与配置诊断。
- 当模型触发工具调用时,拦截器直接解析命令真实意图,不局限于浅层字符串匹配(即便命令被包裹或参数重排也能识别)。
- 一旦命中破坏性操作(如强制删库/清理未跟踪文件)或试图读取 SSH 私钥、.env 等凭据文件,直接在执行前阻断并返回原因。
- 官方明确设计了一条容错原则:如果本地安全配置文件写坏了,程序会回退到安全默认规则,避免因为配置错误导致护栏失效或整个 Agent 瘫痪。
4. 怎么装与基本配置
- 通过 pi install npm:cc-safety-net 安装,Pi 会加载其 ./dist/pi/index.js 入口。
- 遇到被拦截但不清楚命中哪条规则时,直接在会话里运行 /cc-safety-net 让助手结合文档解释具体拦截逻辑。
- 因为 cc-safety-net 不是进程沙箱,对不可信仓库建议搭配 pi-sandbox 等系统级隔离方案使用。
5. 和同类怎么选
它是开箱即用的“危险命令+密钥读取”防呆护栏;如需按团队策略细粒度审批每个工具,则应配合权限系统。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
@gotgenes/pi-permission-system | 提供集中式、覆盖工具/bash/MCP/skill 的完整声明式权限策略矩阵,而不只是安全黑名单护栏。 | 需要明确定义“哪些路径/命令自动放行、哪些弹确认、哪些永不放行”时选 @gotgenes/pi-permission-system。 |
pi-sandbox | OS 级进程沙箱,从操作系统内核边界限制文件写范围和外网请求。 | 需要跑陌生第三方代码或限制未知二进制网络外连时选 pi-sandbox。 |
看完「cc-safety-net」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。