执行摘要
- 一句话:DFLASH2 文档指向滚动 dev 镜像标签
- 推荐动作:该 PR 为简单的文档维护,不涉及复杂设计决策,无需精读。但值得注意其背后的版本管理实践:日期化标签 vs 滚动标签的选择,对用户意味着稳定性和时效性的权衡。
功能与动机
PR #35753 曾将 DFLASH2 安装说明固定到 lmsysorg/sglang:dev-nightly-0820,因为当时 :dev 未能拾取新构建。但日期化的 nightly 标签会自然过期,不再是 main 的最新构建,因此本 PR 将其改回滚动标签。
实现拆解
- 修改
Qwen3.8-27B.mdx 中 Docker 安装块的注释行,将 lmsysorg/sglang:dev-nightly-0820 改回 lmsysorg/sglang:dev。
- 保留 #35753 的其他所有变更,包括对 #35371 和 #35496 的警示说明,以及关于
qwen38-27b 标签早于这两个功能的说明。
- 无测试、配置或部署配套改动,仅文档。
docs/scripts/check_cookbook_configs.mjs 检查通过。
关键文件:
docs/cookbook/autoregressive/Qwen/Qwen3.8-27B.mdx(模块 文档;类别 docs;类型 documentation): 唯一变更文件,修改 DFLASH2 安装说明中的 Docker 镜像标签,从 dev-nightly-0820 改回 dev。
关键符号:未识别
评论区精华
无实质讨论。zijiexia 批准了该 PR,没有留下评论。仅有的评论来自 mintlify 机器人,提供文档预览链接。
风险与影响
- 风险:风险极低。仅文档变更,无代码影响。唯一潜在风险是
:dev 标签可能再次出现拾取延迟,导致文档暂时指向不可用构建,但滚动标签是长期更稳妥的做法。
- 影响:影响范围很小,仅影响查看 Qwen3.8-27B cookbook 的用户,使他们能获取到按说明拉取的、基于 main 的最新 DFLASH2 镜像。对系统、性能、安全无影响。团队影响为文档维护成本降低。
- 风险标记:文档变更
关联脉络
- PR #35753 Pin DFLASH2 install note to a dated nightly: 本 PR 是对 #35753 的修正,将其固定的日期标签改回滚动标签。
- PR #35663 [docs] Add DFlash2 speculative cells to the Qwen3.8-27B cookbook: 该 PR 在 cookbook 中引入 DFlash2 单元格,本 PR 是对其引用镜像标签的调整。
参与讨论