模型配置参考
本页汇总 Midscene 的全部模型配置。如需查看支持的模型名称、模型 family 和可复制的配置示例，请参考支持的模型与配置。如需了解模型职责和组合方式，请参考模型策略。如需排查连接问题、查看日志、采集 Trace 或记录调用，请参考模型调试与可观测性。
必选配置
你需要为 Midscene 配上一个默认模型，详见 模型策略 文档。
高阶配置（可选）
如果你为 Insight 或 Planning 配置了独立模型，那么本节中的模型相关 MIDSCENE_MODEL_* 配置需要使用对应的 MIDSCENE_INSIGHT_MODEL_* 或 MIDSCENE_PLANNING_MODEL_* 配置才能在 Insight 或 Planning 意图时生效。
提示：通过 Agent 的
replanningCycleLimit入参控制重规划次数（默认 20，vlm-ui-tars为 40），不再使用环境变量。
为 Insight 意图单独配置模型
如果你想为 Insight 意图单独配置模型，需额外配置以下字段：
为 Planning 意图单独配置模型
如果你想为 Planning 意图单独配置模型，需额外配置以下字段：
模型原生思考
Midscene 默认关闭模型原生思考，以获得更好的执行速度和稳定性。如果模型不支持关闭原生思考，Midscene 会通过控制思考粒度或限制思考额度，尽可能减少模型的原生思考。
以下环境变量是 Midscene 对不同模型服务商参数的统一抽象。实际发送给模型的参数由 MIDSCENE_MODEL_FAMILY 决定。
MIDSCENE_MODEL_REASONING_ENABLED 显式控制是否启用模型原生思考：
false：强制关闭模型原生思考，也是 Midscene 的默认行为。true：强制启用模型原生思考。default：遵循模型的默认行为。Midscene 不发送启用或关闭思考的参数，并忽略显式配置的MIDSCENE_MODEL_REASONING_BUDGET和MIDSCENE_MODEL_REASONING_EFFORT。
目前支持 MIDSCENE_MODEL_REASONING_ENABLED 的模型系列及参数映射如下：
- Qwen：对应
enable_thinking。 - 豆包：对应
thinking.type。 - 智谱 GLM：对应
thinking.type。 - GPT-5：对应
reasoning_effort。启用时使用medium，关闭时使用none。 - Gemini：对应
thinking_config.thinking_level。启用时使用medium，关闭时使用minimal。 - Kimi K2 系列：对应
thinking.type。 - 小米 MiMo：对应
thinking.type。
MIDSCENE_MODEL_REASONING_BUDGET 控制模型的思考额度。目前 Qwen 系列支持该配置，对应 thinking_budget。
MIDSCENE_MODEL_REASONING_EFFORT 控制 模型的思考力度。目前支持以下模型系列：
- 豆包：对应
reasoning_effort。 - Gemini：对应
thinking_config.thinking_level。 - GPT-5：对应
reasoning_effort。 - Kimi K3 系列：对应
reasoning_effort。
不同模型服务商支持的参数和值不同。具体取值和适用模型版本请参考对应服务商的官方文档。如果当前模型不支持某项显式配置，Midscene 会忽略该配置，不会猜测服务商的私有参数。
仍兼容的模型配置（不推荐）
以下环境变量已废弃但仍然兼容，建议尽快迁移到新的配置方式。
旧版模型类型配置
通用配置
调试与可观测性配置
以下配置用于启用模型诊断、Tracing 和本地调用记录。安装步骤、使用示例、问题排查和安全说明。请参考模型调试与可观测性。
Debug 日志
支持的 DEBUG 选择器和日志行为请参考运行时配置：Debug 日志。