执行摘要

本次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文件，变更可分为三类：

1. 技术描述修正：

   • 移除skip-softmax相关段落（原文档可能暗示其适用于DSA）。
   • 统一术语大小写：将“DSA(Deepseek sparse attention)”改为“DSA (DeepSeek Sparse Attention)”。

2. 语言表述优化：

   • 拼写修正：“server GLM-5” → “serve GLM-5”。
   • 语法补充：为“reasoning parser”添加定冠词“the”。
   • 句子结构调整以提升可读性。

3. 格式微调：

   • 调整部分标点和空格使用。

变更总计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存在关联：

1. PR #22006（DeepSeek V3路由方法修复）和PR #22143（DeepSeek V2量化格式检测缓存）：

   • 同属DeepSeek模型相关改进，但那些PR涉及代码bugfix和性能优化，而本PR是纯文档修正。
   • 反映团队对DeepSeek模型生态的持续维护，涵盖代码、性能、文档多方面。

2. 文档维护趋势：

   • 近期多个PR（如#22189、#21921、#22111）都包含文档更新，表明团队重视文档与代码同步。
   • 本PR延续了这一趋势，针对具体模型（DeepSeek/GLM-5）的技术细节进行校准。

本PR虽小，但体现了文档基于依赖库约束及时修正的重要性，避免用户因文档错误而产生配置失误。