npx -y cc-safety-net@latest install --pi。它会把 cc-safety-net npm 包安装到 Pi（来自 pi.dev 的编码智能体）中，由 Pi 作为进程内扩展运行。重启 Pi 加载扩展，然后运行 npx cc-safety-net doctor，确认扩展已生效。
在 Pi 中安装 CC Safety Net
1
运行安装程序
2
重启 Pi
重启 Pi，加载扩展。
3
确认扩展已生效
Pi 安装会改动什么
- 安装程序运行
pi install npm:cc-safety-net。 - 删除
settings.json中 CC Safety Net 包条目上的extensions过滤器，让 Pi 加载扩展。
settings.json 位于 Pi 智能体目录中：设置了 PI_CODING_AGENT_DIR 时取该值，否则为 ~/.pi/agent。
Pi 扩展检查什么
- 扩展把 Pi 内置的
bash和powershell工具当作 shell 命令分析，各自使用对应的 shell 方言。 - 检查其他工具输入中的受保护路径。
- 不支持名为
Shell的自定义命令工具，例如 pi-grok-cli 添加的那个。 - 添加用于管理 rulebook 的
/cc-safety-net命令。
Pi 检查失败时会怎样
CC Safety Net 扩展抛出异常时，Pi 会阻止该调用。Pi 对检查没有超时。Pi 启动时扩展加载失败，Pi 会退出；在/reload 时加载失败，Pi 会在没有扩展的情况下继续运行，因此重新加载失败后请重启 Pi。
从 Pi 卸载 CC Safety Net
Pi 故障排除
doctor打印Error (Pi): npm:cc-safety-net is installed but its extension is disabled in Pi settings。settings.json中的npm:cc-safety-net条目带有extensions过滤器，且该过滤器不加载dist/pi/index.js。重新运行install --pi即可删除该过滤器。- Pi 已安装，但在
doctor中显示n/a。doctor在settings.json中没有找到npm:cc-safety-net包。如果用PI_CODING_AGENT_DIR移动过 Pi 智能体目录，请在运行doctor的环境中设置相同的值；否则重新运行install --pi。