# PR #36719 完整报告 - 仓库：`sgl-project/sglang` - 标题：[Docs] GLM-5.3-Flash: point at compute-mamba-ratio for the KDA/KV pool split - 合并时间：2026-08-28 03:16 - 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/36719 --- # 执行摘要 - 一句话：GLM-5.3-Flash 文档指向 compute-mamba-ratio 技能计算 KDA/KV 比例 - 推荐动作：值得快速浏览，尤其是 GLM-5.3-Flash 或混合模型用户。该文档变更展示了如何将仓库内技能与具体模型文档关联，是良好的实践。对于需要调优 KDA/KV 池比例的用户，应阅读该 Note 并参考 `compute-mamba-ratio` 技能。整体价值一般，但针对性明确。 # 功能与动机 GLM-5.3-Flash 是混合模型，包含分页的 MLA/DSA KV 池和一个独立的 KDA 状态池。部署面板不生成 --mamba-full-memory-ratio，所以所有生成的命令都使用 ServerArgs 默认值 0.9，该值并非针对工作负载调优：过低会饿死 KDA 状态池并限制 max_running_requests，过高会过度配置并缩小 KV 池。页面已有的“Size both memory pools”提示建议调整该旋钮，但未说明如何确定具体值。仓库内已有 compute-mamba-ratio 技能，可根据平均请求长度和启动日志中打印的两个池大小来推导平衡比例，本 PR 旨在将两者连接起来，指导用户如何调优。 # 实现拆解 1. **定位文档位置**：在 `docs/cookbook/autoregressive/GLM/GLM-5.3-Flash.mdx` 中，紧接部署面板（Deployment 组件）之后插入一个 `` 组件。 2. **添加说明内容**：Note 中明确说明生成命令默认使用 `0.9` 作为 `--mamba-full-memory-ratio`，并解释该默认值是通用起点而非工作负载调优结果：过低会饿死 KDA 状态池并限制 `max_running_requests`，过高会过度配置并缩小 KV 池。 3. **提供解决方案**：指向仓库内 `.claude/skills/compute-mamba-ratio/SKILL.md` 技能，说明如何根据平均请求长度和启动日志中的两个池大小计算平衡比例，或使用 `--max-mamba-cache-size` 固定值。 4. **交叉链接**：在 Note 中交叉链接到现有的 `#size-both-memory-pools` 章节，帮助用户理解每个池限制什么。 5. **验证**：文档变更通过 `node docs/scripts/check_cookbook_configs.mjs` 检查，无测试或配置配套改动。 关键文件： - `docs/cookbook/autoregressive/GLM/GLM-5.3-Flash.mdx`（模块 文档；类别 docs；类型 documentation）: 这是本 PR 唯一修改的文件，在其中添加了指向 compute-mamba-ratio 技能的 Note，指导用户如何调优 KDA/KV 池比例。 关键符号：未识别 # 评论区精华 该 PR 获得审核人 wisclmy0611 的明确批准（APPROVED），无 review 评论。因此没有公开的讨论线程或争议点。鉴于 PR 是纯文档变更且已批准，可以认为内容正确且清晰，无未解决的疑虑。 - 暂无高价值评论线程 # 风险与影响 - 风险：本 PR 仅修改文档，无代码或配置变更，技术风险极低。潜在风险包括： - 文档中链接的 `.claude/skills/compute-mamba-ratio/SKILL.md` 路径可能失效或内容变动，但该链接指向仓库内文件，相对稳定。 - Note 中的建议可能被用户误读为必须使用技能，但文档措辞为建议性。 - 交叉链接锚点 `#size-both-memory-pools` 依赖于文档结构，若章节标题变更可能导致失效，但当前检查通过。 - 影响：影响范围：文档读者，主要是 GLM-5.3-Flash 用户。影响程度：低，但有助于用户正确配置混合模型的 KDA/KV 内存池比例，避免因默认值导致的性能退化或资源浪费。团队影响：无代码影响，仅增加文档维护点。 - 风险标记：文档链接可能失效 # 关联脉络 - PR #36544 GLM-5.3-Flash cookbook: HiCache for LL, fusion-flag drop, EAGLE, default-cell numbers, DCP4 overlay: 同一 cookbook 文件（GLM-5.3-Flash.mdx）的近期修改，可能与部署面板和配置相关。 - PR #36660 cookbook: fix GLM-5.3-Flash speculative flag, size Hopper memory, record GSM8K: 同样修改 GLM-5.3-Flash.mdx，属于同一文档的持续优化。