设置配置
Pi 使用 JSON 配置文件，项目设置覆盖全局设置。
| 位置 | 范围 |
|---|---|
~/.pi/agent/settings.json | 全局（所有项目） |
.pi/settings.json | 项目（当前目录） |
可通过 /settings 命令或直接编辑文件。
模型和思考
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
defaultProvider | string | - | 默认 Provider |
defaultModel | string | - | 默认模型 |
defaultThinkingLevel | string | - | 默认思考级别 |
hideThinkingBlock | boolean | false | 隐藏思考块 |
thinkingBudgets | object | - | 每个级别的自定义 Token 预算 |
thinkingBudgets 示例
{
"thinkingBudgets": {
"minimal": 1024,
"low": 4096,
"medium": 10240,
"high": 32768
}
}
UI 和显示
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
theme | string | "dark" | 主题名称 |
quietStartup | boolean | false | 隐藏启动头部 |
collapseChangelog | boolean | false | 显示压缩版更新日志 |
doubleEscapeAction | string | "tree" | 双按 Escape 动作 |
editorPaddingX | number | 0 | 编辑器水平内边距 |
showHardwareCursor | boolean | false | 显示终端光标 |
压缩
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
compaction.enabled | boolean | true | 启用自动压缩 |
compaction.reserveTokens | number | 16384 | 保留给 LLM 响应的 Token |
compaction.keepRecentTokens | number | 20000 | 保留的最近 Token 数 |
工具执行
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
tools.enabled | boolean | true | 启用工具调用 |
tools.timeout | number | 60 | 单个工具超时（秒） |