第三部分，上下文与 Sessions

全局与项目配置

配置 settings.json 的模型、界面、网络、Compaction、重试、Sessions 和资源加载。

基础 / 11 分钟 / 第 14 篇

两层配置

全局配置位于 ~/.pi/agent/settings.json，项目配置位于 .pi/settings.json。项目层覆盖全局层，嵌套对象按键合并。

项目配置属于需要信任的资源。第一次进入包含 .pi 设置或扩展的目录时，Pi 会依据 Project Trust 流程决定是否加载。

{
  "defaultProvider": "openai",
  "defaultModel": "gpt-5.6",
  "defaultThinkingLevel": "medium",
  "compaction": { "enabled": true },
  "retry": { "enabled": true, "maxRetries": 3 }
}

配置维护原则

个人主题和键位放全局层。
仓库共同约束放项目层并进入版本控制。
密钥只引用环境变量，不写明文。
修改后用 /reload 或新会话验证。
升级 Pi 后对照官方 Settings 文档检查字段。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。

Pi Settings