执行摘要
本次PR对DeepSeek V3.2和GLM-5模型的使用文档进行了修正，主要移除了关于skip-softmax的错误描述（根据flashinfer库约束，该功能不适用于DSA稀疏注意力），并修复了多处拼写、语法和术语格式问题。变更仅涉及单个文档文件，不影响代码逻辑，风险极低，但遗留了一个无效的arXiv链接占位符待后续处理。
功能与动机
为什么做：根据PR body中的说明，作者发现文档中关于skip-softmax的描述存在技术错误。引用flashinfer库源码（flashinfer/mla.py第730-731行）的约束条件：
if skip_softmax_threshold_scale_factor is not None and sparse_mla_top_k != 0: raise ValueError("skip_softmax is not supported for sparse MLA")
这表明skip_softmax仅适用于密集注意力（dense attention），而不适用于DeepSeek Sparse Attention（DSA）的稀疏MLA。因此需要移除相关描述以避免用户误用。同时，作者还希望改进文档的表述准确性，修复如“server GLM-5”拼写错误等问题。
实现拆解
仅修改了docs/basic_usage/deepseek_v32.md文件，变更可分为三类：
-
技术描述修正：
- 移除skip-softmax相关段落（原文档可能暗示其适用于DSA）。
- 统一术语大小写：将“DSA(Deepseek sparse attention)”改为“DSA (DeepSeek Sparse Attention)”。
-
语言表述优化：
- 拼写修正：“server GLM-5” → “serve GLM-5”。
- 语法补充：为“reasoning parser”添加定冠词“the”。
- 句子结构调整以提升可读性。
-
格式微调：
变更总计11行新增、12行删除，均为文本内容调整，无代码逻辑变动。
评论区精华
review中仅有一条实质性讨论：
gemini-code-assist[bot] 指出：
“The arXiv link https://arxiv.org/abs/2603.12201 appears to be a placeholder, as it points to a future date and is not a valid arXiv ID format. This could be confusing for readers.”
该评论指出文档中一个arXiv链接指向未来日期（2603年），显然是占位符，可能误导读者。但作者和审阅者均未回复此问题，且后续提交未修改该链接，导致问题遗留。Fridge003作为审阅者直接批准了PR，并在关联Issue中感谢作者发现skip-softmax问题。
风险与影响
风险分析：
- 技术风险几乎为零：纯文档变更，不涉及任何代码执行逻辑。
- 移除skip-softmax描述有明确依据（flashinfer库约束），不会引入错误配置。
- 唯一遗留风险是无效arXiv链接可能影响文档可信度，但不会导致功能问题。
影响分析：
- 对用户：帮助正确理解DeepSeek V3.2/GLM-5的DSA特性，避免错误尝试使用skip-softmax；提升文档可读性。
- 对系统：无任何运行时影响。
- 对团队：文档维护更准确，但遗留链接问题需后续跟进。
关联脉络
从近期历史PR看，本PR与以下PR存在关联：
-
PR #22006（DeepSeek V3路由方法修复）和PR #22143（DeepSeek V2量化格式检测缓存）：
- 同属DeepSeek模型相关改进，但那些PR涉及代码bugfix和性能优化，而本PR是纯文档修正。
- 反映团队对DeepSeek模型生态的持续维护，涵盖代码、性能、文档多方面。
-
文档维护趋势：
- 近期多个PR（如#22189、#21921、#22111）都包含文档更新，表明团队重视文档与代码同步。
- 本PR延续了这一趋势，针对具体模型（DeepSeek/GLM-5）的技术细节进行校准。
本PR虽小，但体现了文档基于依赖库约束及时修正的重要性，避免用户因文档错误而产生配置失误。
参与讨论