合并用户设置与项目设置
看到一个标量取项目的值,defaultTools 如何编辑或替换用户的选择,以及一个未获信任的项目的设置根本不会被读取。
Pi 合并两个文件:用户级的 <agent-dir>/settings.json,以及在你信任该项目之后的 <project>/.pi/settings.json。标量值遵循普通的覆盖规则,但 defaultTools 有它自己的规则,而一个未获信任的项目的设置根本不会被读取。下面这些片段是小的说明性设置;第 7 章的测试会在真实文件上断言每一个结果。
标量设置:项目胜出
用户文件:
{
"compaction": { "reserveTokens": 1000, "keepRecentTokens": 5000 }
}项目的 .pi/settings.json:
{
"compaction": { "reserveTokens": 2000 }
}项目的值逐键胜出,而项目没有设置的嵌套键仍然来自用户文件:合并后的 reserve 是 2000,保留的 token 值是 5000。
defaultTools 会编辑,它并不总是替换
一个只含 +name 和 -name 条目的项目列表会编辑用户的选择;列表里的一个普通名称则会直接替换它。
用户 defaultTools |
项目 defaultTools |
结果 |
|---|---|---|
["read","bash"] |
["+grep","+find","+ls"] |
["read","bash","grep","find","ls"] |
["read","bash","edit","write"] |
["read","powershell"] |
["read","powershell"] |
["read","bash","edit","write"] |
["-bash"] |
["read","edit","write"] |
| (unset) | ["read","bash","-bash","+grep"] |
["read","grep"] |
在一个列表内部,普通名称构成选择,然后 + / - 按顺序应用。
未获信任的项目不会被读取
在暂不授予信任时,项目文件被完全忽略,用户的值保持有效——这里 reserveTokens 保持 1000。之后授予信任会让项目层生效,值变成 2000。
机制与限制
有文档记载:锁定的 settings.md 规则——项目设置覆盖智能体目录的设置,且资源列表合并——以及导出的 SettingsManager。已观察:settings.test.ts 通过真实的 SettingsManager 在真实文件上跑这次合并,并断言上面每一行;union.test.ts 通过 DefaultResourceLoader 加载资源,显示两个文件的资源列表被取并集,且排除过滤器只能触及列出它的那个文件里的资源——项目里的 !pattern 不会移除用户级的技能。并集是在加载时已观察到的,而 SettingsManager 的 getter 返回某一个作用域的列表。
这些片段是说明性的;它们展示的是合并,不是你的文件。defaultProjectTrust 只属于智能体目录文件——项目文件无法设置它。第 6 章讲全 defaultTools 的重新加载行为。
完整源码与测试 。
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.