@gotgenes/pi-permission-system

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

安装命令
pi install npm:@gotgenes/pi-permission-system
临时试用 / 替代安装命令
pi -e npm:@gotgenes/pi-permission-system
挂接事件钩子与注册入口
session_startresources_discoverbefore_agent_startinputtool_callsession_shutdown
pi.setActiveTools()ctx.ui.confirm()(交互审批)

1. 是什么

@gotgenes/pi-permission-system 是 gotgenes 维护的权限策略执行扩展。

它把分散在各个工具或提示词里的安全约定收拢成一套集中式策略引擎,覆盖内建工具、Shell 命令、MCP 调用和 Skill 资源。

2. 解决什么问题

当 Pi 安装了十几个扩展、多个 MCP 服务和各类技能后,每个扩展各自做不做确认完全不统一。团队或个人需要一个单一、确定的控制面来声明授权规则。

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

在会话启动、资源发现、用户输入与每次 tool_call 前执行确定性策略匹配,并控制当前激活工具面。

  • 在 session_start 与 resources_discover 阶段加载权限策略配置,并结合当前会话信任与策略规则通过 pi.setActiveTools() 收敛可用工具面。
  • 每次发起对话或处理用户输入(input / before_agent_start)时维护当前回合的权限上下文。
  • 核心拦截落在 tool_call 事件:所有普通工具、bash 指令、MCP 工具调用、skill 访问与特殊操作都会先经过策略评估,确定放行、拒绝还是挂起等待人工确认。

4. 怎么装与基本配置

  • 通过 pi install npm:@gotgenes/pi-permission-system 安装。
  • 按照仓库文档配置个人或项目级权限策略文件,划分免确认只读操作、需确认写操作与禁止清单。

5. 和同类怎么选

它是三个安全代表包里唯一承担“统一权限决策中心”角色的系统,与只管防误删的护栏或安装前审计并不重叠。

与同类方案的选型对照

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

对比对象 机制差异 怎么选
cc-safety-net 专注开箱即用的危险 bash 命令与密钥文件拦截,不需要用户从头编排整套工具权限策略。 希望零配置快速兜底高危命令行误操作时选 cc-safety-net。
pi-verdict 使用独立轻量 LLM 分类器动态判断风险(类似 Auto Mode),而非纯确定性策略表。 不想手工维护大量白名单正则,接受基于分类模型做自动放行裁决时选 pi-verdict。

同方向对比包与顺序阅读

cc-safety-net

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

阅读该包机制详评

pi-vetter

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

阅读该包机制详评

03 安全与权限

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

返回方向总论页

看完「@gotgenes/pi-permission-system」后的下一步

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

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

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

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

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

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

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