跳转到内容

模型、思考强度与主题

模型、思考级别和界面主题是三件事:模型决定请求发给谁,思考级别表达本次请求的推理设置,主题决定界面怎样呈现。更高档位不保证每个问题都更准确,也可能增加延迟或成本。

看当前选了什么

在 Pi 中运行 /model 可查看或切换模型,/thinking 可查看或调整当前模型支持的思考级别;主输入框默认用 Shift+Tab 循环思考级别。按 /hotkeys 检查当前会话的实际快捷键。

Pi 为模型调用的 bash 和 powershell 工具注入会话变量。因此你可以让 Pi 在工具中运行:

终端窗口
printf '%s/%s\n' "$PI_PROVIDER" "$PI_MODEL"
printf 'reasoning=%s\n' "$PI_REASONING_LEVEL"

这三个值在每次工具命令启动时解析,不需要重启 Pi。它们表示 Pi 当前选中的 provider、模型和生效档位;用户自己输入的 ! / !! 命令不注入这些会话变量,SDK 也不能假定有同样的 CLI 环境。

如果选中的是虚拟模型,变量显示选择的虚拟名称,不一定是实际处理请求的物理模型。切勿通过变量推断网关背后的真实型号。

调整并保存思考级别

Pi 识别 off、minimal、low、medium、high、xhigh 和 max,但不是所有模型都支持所有档位。Pi 会根据模型能力限制可选项;不同供应商对相同名称的实现也不必相同。

记成七级台阶:off 在最下面,max 在最上面,xhigh 是 high 之上再加一级(x 读作 extra)。

目标操作
当前会话换档/thinking 选择,或按 Shift+Tab 循环
保存启动默认级别在 /thinking 选择器中按 Ctrl+S
本次启动指定pi --model <provider/model> --thinking high
同时指定模型与级别pi --model <provider/model>:high
切换聊天模型/model 或 Ctrl+L

--thinking 会覆盖 --model 后缀中的级别,并按模型支持情况调整。会话记录模型与思考级别变化,恢复历史会话时恢复该会话的选择;这不等于改变所有新会话的默认值。

让新会话默认使用 max

当前在用 max,不代表下次启动也默认 max。 临时切档和保存默认值走两条路径。记成:Enter 只管这次,Ctrl+S 才管以后。

应用当前档位:thinking max、Enter、Shift Tab 或 CLI 参数,不保存默认值。保存默认值:选择 max 后按 Ctrl S,或配置 defaultThinkingLevel。下次直接运行 pi 新建会话验证,同时检查旧会话、参数、模型和项目覆盖。
Enter 是应用,Ctrl+S 才是保存启动默认值。打开 SVG ↗

推荐:在选择器中保存

  1. 运行 /thinking,找到 max。看不到它时,先检查当前模型支持的档位,不能靠写配置让不支持的模型获得新能力。
  2. 将光标移到 max,按 Ctrl+S,不要只按 Enter。Pi 会应用当前选择,并提示 Default thinking level: max。
  3. 下次直接运行 pi,创建新会话,不带 -c 或 -r。再用 /thinking 确认实际档位。
  4. 终端足够宽时,页脚模型名后也可看到 • max;不要仅靠边框颜色判断。见状态栏怎么看。

如果终端拦截 Ctrl+S,先按 /hotkeys 核对快捷键和终端设置,或使用下面的文件配置方法。

文件配置:全局默认 max

把下面字段合并进 ~/.pi/agent/settings.json,保留原文件的其他字段。如果已配置 defaultThinkingLevel,只修改其值,不要添加重复键:

{
"$schema": "https://pi.dev/schemas/settings.schema.json",
"defaultThinkingLevel": "max"
}

这是默认 agent 目录的路径;设置了 PI_CODING_AGENT_DIR 时应修改对应目录的 settings.json。手动修改后,重启并用新会话验证。只修改配置文件不会自动把正在进行的会话切到 max;当前会话可以另行执行:

/thinking max

命令只接受当前模型可用的档位;不支持 max 时会提示可用值。max 是更高的思考设置,不是权限模式、无限上下文或必定更准确的承诺,也可能增加等待和消耗。

只对一个项目或一个模型默认 max

  • 仅当前项目:把同一个 "defaultThinkingLevel": "max" 字段放进项目的 .pi/settings.json。项目受信任后,同名项目设置覆盖用户级设置。
  • 仅特定模型:使用 modelThinkingLevels。下面的 provider/model-id 是占位符,必须换成 /model 中真实、精确的 provider 和 model ID:
{
"modelThinkingLevels": {
"provider/model-id": "max"
}
}

逐模型设置优先于通用 defaultThinkingLevel。如果原来该模型写了 high,只把全局默认改成 max,仍可能得到 high;按需求修改或删除这条逐模型覆盖,不要清空其他模型的设置。

保存了,为什么还是不是 max?

先确认确实按过 Ctrl+S 或写入了配置,再按 模型 → 会话 → 参数 → 覆盖 四层查:

  1. 模型能力:/thinking 没有 max 时,配置不能强行增加该能力。
  2. 旧会话:pi -c、pi -r、/resume 恢复的是会话记录;需要时在旧会话里另行 /thinking max。
  3. 临时指定:--thinking 优先于 --model 的档位后缀;--models / enabledModels 中的 :high 等后缀也可能指定档位。
  4. 持久覆盖:modelThinkingLevels 优先于通用默认;已信任项目的 .pi/settings.json 可覆盖用户配置。只在一个模型或项目不生效时,先查对应项。

验证默认值时用一个不带思考参数、不恢复历史的新启动,然后看 /thinking。pi --thinking max 适合临时指定,却不能证明设置文件中的默认值已经生效。

依据:Pi Settings 的 model and thinking、模型选择文档,以及 1.5.0 思考设置与持久化实现。

为什么输入框边框会变色

Pi 的编辑器边框用主题颜色提示当前思考档位。以 1.5 内置 dark 主题为例,大致是:

档位大致颜色
off灰
minimal灰蓝
low蓝
medium蓝紫
high紫
xhigh玫红
max橙红

这是所选档位的视觉提示,不是实际耗时、token 消耗或答案质量的仪表。界面中的 shell 输入等特殊模式也可能使用其他颜色。

1.5 默认主题为 system:Pi 尝试从终端的前景、背景和 ANSI 色板生成颜色。你也可以在 /settings 中选择 dark、light 或自定义主题;实际颜色受主题、终端及其真彩色能力影响。自定义主题不提供 thinkingMax 时会回退到 thinkingXhigh,所以不同档位不一定都能用颜色区分。

想自定义时,把主题文件放在 ~/.pi/agent/themes/<name>.json,修改 thinkingOff、thinkingMinimal、thinkingLow、thinkingMedium、thinkingHigh、thinkingXhigh 和可选的 thinkingMax,再从 /settings 选择。完整格式见 Pi Themes。

目录、账号权限和 latest 别名

/model 和 pi --list-models 显示 Pi 已识别且 provider 具有可用认证的模型目录;这不保证账号有权限调用每一个模型。模型可用性、窗口和价格可能按供应商、计划和时间变化。

像 chat-latest 这样的名字通常是别名:实际指向由提供方决定,可能变化。第三方网关还可能动态路由;仅凭名称不能确定底层型号。需要结果可复现时,优先选择供应商提供的固定版本,并记录 provider、模型、级别和请求环境。

记成:别名 ≠ 固定版本;要可复现,就固定到具体模型 ID。

1.5 增加 GPT-6.1 Terra,并把内置 OpenAI 默认模型改为 GPT-6.1 Sol。这里的默认值不是当前会话保证使用的模型:已保存的设置和历史会话可以覆盖它。详见认证与模型及 1.5 变化。

虚拟模型:选择与实际派发

虚拟模型由 Extension 注册,在 /model 中像模型一样可选,但会为每次请求选择实际模型与思考级别:

用户选择 router/auto:high
↓ 路由器决定
实际请求 provider/model:medium
  • PI_MODEL、PI_PROVIDER、PI_REASONING_LEVEL 和会话中的选择记录表示虚拟选择。
  • 每条 assistant 消息记录响应使用的物理 provider、模型和思考级别;交互页脚可显示路由结果,/session 可按物理模型列出费用。
  • 扩展可以按任务、状态或分类结果路由;模型切换会影响缓存和延迟。虚拟档位的意义由路由器定义,不一定是物理推理预算。
  • 恢复时如果原虚拟模型不再注册,Pi 会回退到最后作答的物理模型。会话分支中的路由状态随分支恢复。

虚拟模型从 0.99.0 起提供,不是 1.5 新增。先用简单固定模型验证需求,再考虑路由;实现细节与示例见 Pi Virtual Models。

接下来