Pi Agent 配置参考手册
以下是 Pi Agent settings.json 所有配置项的速查表。
模型与推理
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| defaultProvider | string | - | 默认提供商 |
| defaultModel | string | - | 默认模型 ID |
| defaultThinkingLevel | string | - | 默认推理等级 |
| hideThinkingBlock | boolean | false | 隐藏推理过程 |
| showCacheMissNotices | boolean | false | 显示缓存未命中提示 |
| thinkingBudgets | object | - | 自定义各等级 token 预算 |
UI 与显示
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| theme | string | "dark" | 主题名称 |
| externalEditor | string | 自动检测 | 外部编辑器命令 |
| quietStartup | boolean | false | 隐藏启动头部 |
| defaultProjectTrust | string | "ask" | 项目信任默认行为 |
| collapseChangelog | boolean | false | 折叠更新日志 |
| enableInstallTelemetry | boolean | true | 匿名安装统计 |
| enableAnalytics | boolean | false | 用户行为分析（需主动开启） |
| doubleEscapeAction | string | "tree" | 双击 Escape 行为 |
| treeFilterMode | string | "default" | /tree 默认过滤模式 |
| editorPaddingX | number | 0 | 编辑器水平内边距（0-3） |
| outputPad | number | 1 | 消息内边距（0 或 1） |
| autocompleteMaxVisible | number | 5 | 自动补全最大条目（3-20） |
网络
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| httpProxy | string | - | HTTP 代理（仅全局） |
压缩
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| compaction.enabled | boolean | true | 自动压缩 |
| compaction.reserveTokens | number | 16384 | LLM 响应预留 token |
| compaction.keepRecentTokens | number | 20000 | 保留的最近 token |
分支摘要
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| branchSummary.reserveTokens | number | 16384 | 摘要预留 token |
| branchSummary.skipPrompt | boolean | false | 跳过摘要提示 |
重试
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| retry.enabled | boolean | true | 自动重试 |
| retry.maxRetries | number | 3 | 最大重试次数 |
| retry.baseDelayMs | number | 2000 | 基础延迟（ms） |
| retry.provider.timeoutMs | number | SDK 默认 | 请求超时 |
| retry.provider.maxRetries | number | 0 | 提供商级重试次数 |
| retry.provider.maxRetryDelayMs | number | 60000 | 最大重试延迟 |
消息传递
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| steeringMode | string | "one-at-a-time" | 导向消息策略 |
| followUpMode | string | "one-at-a-time" | 跟进消息策略 |
| transport | string | "auto" | 传输协议偏好 |
| httpIdleTimeoutMs | number | 300000 | HTTP 空闲超时 |
| websocketConnectTimeoutMs | number | 15000 | WebSocket 连接超时 |
终端与图片
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| terminal.showImages | boolean | true | 终端显示图片 |
| terminal.imageWidthCells | number | 60 | 图片宽度（单元格） |
| terminal.clearOnShrink | boolean | false | 内容收缩时清除空行 |
| images.autoResize | boolean | true | 图片自动缩放 |
| images.blockImages | boolean | false | 阻止图片发送给 LLM |
Shell
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| shellPath | string | - | 自定义 shell 路径 |
| shellCommandPrefix | string | - | 命令前缀 |
| npmCommand | string[] | - | npm 命令包装器 |
模型循环与资源
| 配置项 | 类型 | 默认值 | 说明 |
|---|
| enabledModels | string[] | - | Ctrl+P 可用模型 |
| packages | array | [] | 已安装的包 |
| extensions | string[] | [] | 扩展路径 |
| skills | string[] | [] | Skill 路径 |
| prompts | string[] | [] | 模板路径 |
| themes | string[] | [] | 主题路径 |
| enableSkillCommands | boolean | true | 注册 /skill:name 命令 |
| sessionDir | string | - | 会话存储目录 |
