# PR #33345 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Docs] Fix overlapping quality-profile table headers on MiniMax-H3 page
- 合并时间：2026-08-03 13:22
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/33345

---

# 执行摘要

本 PR 为 MiniMax-H3 文档页修复质量对比表表头文字重叠问题，改动仅 1 行，通过插入显式 `<br />` 换行解决 Mintlify 主题 `white-space: nowrap` 导致的窄列溢出。经实测溢出从 4 处降为 0，文档可读性显著改善，无任何运行时影响。

# 功能与动机

PR body 明确指出根因："the Mintlify theme sets `white-space: nowrap` on `th`"，导致在 512px 内容列宽度下，每列仅约 79px，而 `Mean inference latency` 等 4 个表头需要 126-172px，从而溢出到相邻单元格。目标是在不改变表头文本（保持 Ctrl+F 可查）的前提下修复渲染。

# 实现拆解

1. 定位问题： 在文档页 `docs_new/cookbook/diffusion/MiniMax/MiniMax-H3.mdx` 中，质量对比表有 6 列，其中 4 个表头为多词组合，Mintlify 主题的 `th` 设置 `white-space: nowrap` 禁止自动换行。
2. 修改方案： 在表头单元格内插入 `<br />` 显式换行，例如 `Mean <br />inference <br />latency`。由于 `nowrap` 仅抑制自动换行，手动换行仍生效，使得每个表头可以折行，列宽降至可用宽度以内。
3. 细节处理： 每个 `<br />` 前保留一个空格，确保 DOM 的 `textContent` 仍为原始短语（如 `Mean inference latency`），不影响页面内搜索（Ctrl+F）与复制。
4. 验证： 作者在线上页面以失败宽度（512px）注入新标记测量，表头溢出从 4 处降为 0，行高从 119px 降至 57px；本地 `mint dev` 确认 `<br />` 编译为真实 `br` 元素，且在 512/600/760/960px 宽度均无溢出，数字列右对齐不变；`mint validate` 通过。
5. 测试配套： 文档变更不涉及模型与代码逻辑，无需单元测试或性能测试。

## 关键源码片段

### 修改后的表格头部与数据行（完整表格前 3 行）如下，注释说明了修改意图与前后行为差异：

```mdx
{/* 修复前： Mean inference latency 与 Speedup 等表头因 Mintlify 主题的 white-space: nowrap 在窄列中溢出到相邻单元格，渲染为相互碰撞的文本 */}
{/* 修复后： 在每个多词表头中插入显式 <br /> 换行，并保留空格使 textContent 仍是原始短语，既解决溢出又不破坏 Ctrl+F 查找与复制 */}
| `quality` | Mean <br />inference <br />latency | Speedup | SSIM vs <br />lossless | PSNR vs <br />lossless | Expected <br />trade-off |
| --- | ---: | ---: | ---: | ---: | --- |
| `lossless` | 75.10 s | 1.00× | 1.000 | exact | Native reference path |
| `high` | 53.70 s | 1.40× | 0.931 | 28.16 dB | Smallest same-seed visual change |
```

# 评论区精华

该 PR 无实质 review 评论，仅包含 Mintlify 预览部署 bot 的自动通知与 Gemini Code Assist 停止服务的提示。reviewer `wisclmy0611` 直接批准（APPROVED），未提出疑问或修改建议。

# 风险与影响

- 风险： 极低。改动仅涉及表头文本，不影响数据行、链接或页面脚本；作者已实测 4 档常用宽度无溢出，且 `mint validate` 通过。唯一潜在细微影响是 `<br />` 前的空格会使 `textContent` 中包含多余空格，但该空格在原始文本中本就存在，无实际影响。
- 影响： 仅改善 MiniMax-H3 文档页在中等宽度视口下的可读性，对用户阅读体验有正向作用；不影响任何代码、API 或性能。

# 关联脉络

本 PR 与 #33282（docs(diffusion): update skills for MiniMax-H3）同属 MiniMax-H3 文档完善工作线，后者更新了 diffusion 相关技能与基准脚本，本 PR 则修复了该页面表格的显示问题。此类文档微调与前期 cookbook 建设相互补充，体现文档质量持续打磨。