第6章 thinkingLevel 思维层级机制
作者：袖梨
2026-07-29
thinkingLevel 思维层级体系：第6章
6.1 体系包含六档：off/minimal/low/medium/high/xhigh
Pi确实具备思维层级机制，其档位比网传的“三档”描述更细，共分为六档：
| 档位 | 适用场景 |
|---|---|
off | 彻底关闭推理，适用于完全无须推理的简单指令 |
minimal | 极轻量任务：以最低程度推理 |
low | 格式转换、固定话术、简单问答 |
medium | 多数模型默认档位：用于常规编码任务 |
high | 多文件重构、复杂逻辑推理 |
xhigh | 关键任务适合最高强度推理，原则是"宁可慢一点也要对"；该专属档位仅见于部分模型，如 GPT-5.2/Codex 系列 |
6.2 控制方式共有三种：交互命令 / CLI 参数 / settings.json
pi --thinking high "解决这个复杂问题" # CLI 参数显式指定pi --model sonnet:high "解决这个复杂问题"# 模型名+档位快捷写法
在交互界面内：
/thinking high # 需要安装 pi-thinking-level 等社区包提供 /thinking 命令
也可以使用 Shift+Tab 循环完成档位切换，编辑器输入框的边框颜色会随当前档位实时变化。
// settings.json 持久化默认档位{ "defaultThinkingLevel": "medium" }
6.3 thinkingLevelMap 与 thinkingBudgets 精细化配置
thinkingBudgets 为各个档位设置明确的 token 预算上限，从而实现精细化成本控制：
{"thinkingBudgets": { "minimal": 1024, "low": 4096, "medium": 10240, "high": 32768 }}
thinkingLevelMap 用于自定义模型接入时，把 Pi 的抽象档位映射到具体 Provider 支持的取值，未支持的档位可以映射为 null 直接隐藏：
{"id": "custom-model","reasoning": true,"thinkingLevelMap": {"minimal": null,"low": null,"medium": null,"high": "default","xhigh": "max"}}
