# PR #28454 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs(cookbook): fix GLM-5.2 thinking toggle kwarg + document reasoning effort
- 合并时间：2026-06-17 02:17
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/28454

---

## 执行摘要
此 PR 是 #28448 的纯文档修复，修正了 GLM-5.2 cookbook 中思考开关的错误参数名（`thinking` → `enable_thinking`），并补充了推理力度参数 `reasoning_effort` 的行为文档。只改了 1 个文件，安全无风险。

## 功能与动机
PR #28454 由作者 JustinTong0323 在合并 #28448 后立即提出，原因是 #28448 中 cookbook 文档使用了错误的 chat template 参数名 `thinking`，而实际应为 `enable_thinking`。经渲染 `chat_template.jinja` 验证，`{"thinking": False}` 不会关闭思考模式，只有 `{"enable_thinking": False}` 才生效。同时 PR 补充了 `reasoning_effort` 的文档，因为其行为（仅两个有效级别、默认最高）容易让人困惑。

## 实现拆解
1. **修正参数名**：在 `GLM-5.2.mdx` 的文字说明和 Python 示例中，将 `chat_template_kwargs: {"thinking": False}` 改为 `{"enable_thinking": False}`，并注明变量名是 `enable_thinking` 而非 `thinking`。
2. **新增 reasoning_effort 表格**：清晰列出不传参数、`"high"`、其他值三种情况对应的系统提示行和实际效果，强调 `Max` 是默认最高推理力度，`"high"` 是唯一降低力度的值。
3. **更新 Python 示例**：在示例中将 `extra_body` 改为同时使用 `enable_thinking: True` 和 `reasoning_effort: "high"`，展示正确用法。

## 评论区精华
无 review 评论。审核者 zijiexia 直接批准。

## 风险与影响
**风险**：极低，仅文档文字改动，无代码变更。
**影响**：修复了可能误导用户的错误参数名，帮助用户正确配置模型推理。

## 关联脉络
此 PR 是 #28448 的微调修复，进一步提升了 GLM-5.2 cookbook 的准确性和可用性。