再看第6章，思维层级程序，如何建立？

在实际使用中。很多开发者和数据科学家会遇到以下痛点：

• 档位混淆网上常见的“三档”模型与官方真正实现的六档差距大，让人难以准确选择。
• 操作方式繁琐CLI 参数、交互命令和配置文件三种方式并行使用，记忆成本高。不过，
• 成本难控默认档位往往超出预算。需要手动设置 token 限额但步骤繁琐。其实，
• 模型兼容性自定义模型时不同 provider 的档位映射不一致。导致功能被隐藏或失效，说起来，

六档思维层级程序

Pi 真正存在一个细化到六个层级的思维机制，而非流传的三档版本：

*提示*：若你在快速原型阶段，只需从manual/low/medium/high/xhigh-1 开始切换即可。怎么说呢，每个层级都有对应的 token 成本，请结合业务需求权衡。

至于三种控制方式，CLI 参数 / 交互命令 / settings.json持久化配置

下面展示最常用的三种方法。并标注常见错误与方法：

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

交互界面内可以通过快捷命令切换：

// 安装 pi-thinking-level 社区包后可用
/talking high // 或者 /thinking high
// Shift+Tab 循环切换
// 编辑器输入框边框颜色实时反映当前档位
// 错误案例：未安装插件导致命令无效 → 请先确认插件已激活。

/settings.json 持久化默认档位示例：

{
"defaultThinkingLevel": "medium"
}

*校订*: 网传版本将此参数误认为是CreatePi函数的一部分；不过，，它属于Vercel适配器。请勿把它当作构造函数参数直接传递给 Pi 本体。

thinkingLevelMap & thinkingBudgets 精细化配置教程

Token预算管理 – thinkingBudgets

为每个思维层级设置 token 上限，以实现成本控制：

{
"thinkingBudgets": {
"minimal": 200。"low": 500,"medium": 1200,"high": 3000,"xhigh": null // 无限制，但需自行监控
}
}

自定义模型映射 – thinkingLevelMap

当接入第三方提供商时可自定义 Pi 抽象档位与 Provider 实际支持值之间的映射关系。 未支持的档位可设为null 以隐藏该选项，从而避免 UI 显示无效按钮导致困惑：

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

*注意*: 如果 Provider 未实现某些高阶功能，该条目将被隐藏；这对...有帮助防止使用者误选导致错误调用。但也代表着你无法在同一界面下同时体验所有功能，需要手动切换或编写代理脚本。

实战小贴士 & 常见问题解答

• #1 如何快速定位最合适的思维层级？建议从最低等级开始迭代，如果返回结果不满足预期，再逐步提高至高阶等级；这样能有效节省 token 并减少延迟。