第6章 thinkingLevel 思维层级体系

来源：互联网时间：2026-07-27 22:15:53

第6章 thinkingLevel 思维层级体系

Pi 的思维层级机制是真实存在的，而且比网上流传的“三档”说法要细得多——实际上是六档，从完全关闭到极致推理，一应俱全。下面这个表格把每个档位的适用场景说得很清楚，先扫一眼。

档位	适用场景
`off`	完全关闭推理，适合完全不需要推理的简单指令
`minimal`	最低程度推理，极轻量任务
`low`	简单问答、固定话术、格式转换
`medium`	常规编码任务（多数模型默认档位）
`high`	复杂逻辑推理、多文件重构
`xhigh`	最高强度推理（部分模型如 GPT-5.2/Codex 系列专属档位），适合“宁可慢一点也要对”的关键任务

6.2 三种控制方式：CLI 参数 / 交互命令 / `settings.json`

那么问题来了——怎么控制这些档位呢？有三种方式：CLI 参数、交互命令，还有 settings.json 持久化配置。先看命令行玩法：

pi --thinking high "解决这个复杂问题"   # CLI 参数显式指定
pi --model sonnet:high "解决这个复杂问题"  # 模型名+档位快捷写法

交互界面里，可以用 /thinking high 命令（需要安装 pi-thinking-level 等社区包提供支持），或者直接用 Shift+Tab 循环切换。切换时编辑器输入框的边框颜色会实时变化，当前档位一目了然。

// settings.json 持久化默认档位
{ "defaultThinkingLevel": "medium" }

6.3 `thinkingLevelMap` 与 `thinkingBudgets` 精细化配置

如果觉得六档还不够精细，还有两个配置项可以玩：thinkingBudgets 和 thinkingLevelMap。前者给每个档位设置具体的 token 预算上限，方便做成本控制——比如让 minimal 档只花 1024 个 token，而 high 档可以给到 32768：

{
  "thinkingBudgets": {
    "minimal": 1024,
    "low": 4096,
    "medium": 10240,
    "high": 32768
  }
}

thinkingLevelMap 则是用来做模型适配的：当接入自定义模型时，把 Pi 的抽象档位映射到具体 Provider 支持的取值。如果某个档位不被支持，直接映射为 null 就能隐藏掉，免得用户选了也白选。比如下面这个配置，只保留了 high 和 xhigh，其他档位统统隐藏：

{
  "id": "custom-model",
  "reasoning": true,
  "thinkingLevelMap": {
    "minimal": null,
    "low": null,
    "medium": null,
    "high": "default",
    "xhigh": "max"
  }
}

第6章 thinkingLevel 思维层级体系