用途
Cookbook Migrate Model 是一个迁移技能,用于把 SGLang 文档中采用旧版模板的 cookbook 页面转换为配置驱动的新模板。旧页面通常包含一个按模型单独实现的生成器组件(位于 docs/src/snippets/autoregressive/ 下)以及若干实测基准数据块。该技能把这套旧结构转录进新的数据模型,不做任何功能改进或现代化处理。
主要能力
- 盘点旧版资产:通读旧生成器源码,理解每个选项维度、门控与支持矩阵,以及每种可达组合所发出的完整命令;同时读取旧 MDX 的安装、提示、调用示例与基准块。
- 执行入站锚点扫描:通过 grep 查找指向该页面的链接与片段,修正引用方或添加锚点兼容标记。
- 设计五维映射:依据 dimension-mapping.md 判断哪个旧开关应成为 strategies 维度,哪些应成为 Playground 轴,并生成策略映射表供 PR 评审。
- 生成配置:对超过约 30 个单元格的情况,将旧 generateCommand() 移植到临时 Node 脚本枚举组合并输出 cells 字面量,再执行独立等价性审计,逐 token 对比新旧命令。
- 编写基准文件:每个实测块对应一个条目,TTFT/TPOT 取 P50 中位数,按公式计算 tokens_per_sec_per_gpu,并在有准确率数据时配置 accuracyLabels。
- 重写 MDX:保留原标题,撰写新的 SEO 描述,安装手风琴保留旧安装内容与固定镜像,调用示例与输出改为可折叠的 Accordion。
- 删除旧生成器并验证:移除旧 jsx 文件及其 import,运行 mint validate、mint broken-links 与浏览器冒烟测试。
- 提交 PR 与评审:每个模型一个 PR,附带迁移说明、verified 策略应用情况、策略映射表与审计通过计数。
使用方式
该技能按工作流分九步执行:盘点旧资产、设计五维映射、生成配置并审计、编写基准文件、重写 MDX、删除旧生成器、验证、提交 PR 与评审、最后将迁移中发现的新约定或坑点反馈回本技能。其中代码生成阶段要求输出保持为纯字面量,因为 Mintlify 禁止运行时展开或调用。等价性审计需从 git 中提取原始生成器(使用 git show main:<path> 而非 HEAD),stub 掉 React hooks 后对每种组合运行并逐 token 与新单元格对比,只允许出现预先列明的差异。
适用场景
适用于 SGLang 文档仓库中单个模型的 cookbook 页面迁移工作,即把一个旧式单文件生成器页面转成配置驱动模板。迁移维护者会在派发提示中提供该轮次的按模型清单,包括范围、批处理顺序、特殊情况与实测数据概览。
限制与硬规则
- 绝不现代化:环境变量、标志、TP 值、Docker 标签与版本字符串逐字复制,即使当前默认值已不同。
- 绝不编造版本或数字:基准数字只能来自旧页面的实测块;移动引用(如 main branch、main (2026-06-11)、开放式 0.5.8+)不可复现,须整条结果丢弃;跨模型数字一律丢弃。
- verified 采用最严格档位,仅在满足精确实测数据与参数一致性两个条件时为真,其余均为未验证状态,包括看似内存不可行的组合。
- 引擎文件只读,_deployment.jsx 与 _playground.jsx 在迁移 PR 中不得改动。
- 策略分层由信号驱动,不得凭硬件直觉自行推导倾斜方向。
- 不得为填充策略标签而编造配方。
- 文档预览仅针对仓库内分支构建,fork 发起的 PR 不渲染预览。
本技能的具体参考资料(如 dimension-mapping.md、authoring-reference.md、mintlify-authoring.md)位于技能自带的 references 目录中,其详细内容暂未在本页提供。