Example

决定是否信任一个项目

看到什么会触发项目信任决策,一个已保存的决策如何胜过默认值,以及为什么 AGENTS.md 不是触发项。

只有当工作目录里含有某个将要加载的东西时,Pi 才会提出项目信任问题,而答案决定哪些受保护资源加载。顺序是:命令行标志,然后 project_trust 扩展,然后已保存的决策,然后 defaultProjectTrust。像 AGENTS.md 这样的上下文文件不是触发项,两条路都会加载。这是对第 8 章测试的一次决策表走查。

什么会触发决策

工作目录中存在的东西 需要决策
.pi/settings.json 是
.pi/mcp.json 是
.pi/extensions、.pi/skills、.pi/prompts、.pi/themes 是
.pi/SYSTEM.md、.pi/APPEND_SYSTEM.md 是
本目录或某个祖先目录中的 .agents/skills 是
一个空的 .pi 目录 否
AGENTS.md 或 CLAUDE.md 否——上下文文件

请求信任是因为有东西将要加载,而不是仅仅因为 .pi 存在。上下文文件携带指令,且无论答案如何都会到达,这就是拒绝信任挡不住它的原因。

已保存的决策

决策按规范化目录路径存放在 <agent-dir>/trust.json 中。最近的路径适用,所以父级的决策覆盖其子级:

{
  "<canonical-directory>": true,
  "<canonical-directory>/subdir": false
}

持久化一个决策就是 /trust 做的事。把一个路径设为 null 会清除它。

决策顺序

顺序 来源 说明
1 --approve / --no-approve 级别高于一切,包括扩展
2 project_trust 处理器 返回决策的第一个处理器拥有它
3 trust.json 中已保存的决策 最近的祖先路径胜出
4 defaultProjectTrust 智能体目录设置,默认 "ask"

print、JSON 和 RPC 模式无法显示这个提示,所以在它们之上什么都没有时,"always" 加载受保护资源,而 "ask" 和 "never" 跳过它们。要在脚本里得到一个显式的一次性答案,用 --approve 或 --no-approve。

机制与限制

**有文档记载:**锁定的 security.md 触发项清单、trust.json 的位置,以及 defaultProjectTrust。已观察:trust.test.ts 检查每一个触发项,包括上下文文件什么都不会问;decision.test.ts 在 print 模式下运行随附的 pi,配一个会写标志文件的项目扩展,把上面的顺序以及"已保存的决策胜过默认值"固定下来。

这个顺序是一道加载闸门,不是沙箱:Pi 一旦运行,已启用的工具就使用进程的操作系统权限。随附的二进制文件显示出一个契约细节:project_trust 处理器返回一个对象,{ trusted: "yes" | "no" | "undecided", remember?: boolean },而不是裸字符串;裸字符串会被静默忽略。这里的片段是说明性的。

完整源码与测试 。

Understand this example

Copy this prompt into your AI tool. No code runs here.

Apply this example

Copy this prompt into your AI tool. No code runs here.