决定是否信任一个项目
看到什么会触发项目信任决策,一个已保存的决策如何胜过默认值,以及为什么 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.