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。

同方向对比包与顺序阅读

@gotgenes/pi-permission-system

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

阅读该包机制详评

pi-vetter

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

阅读该包机制详评

03 安全与权限

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

返回方向总论页

看完「cc-safety-net」后的下一步

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

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

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

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

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

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

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