用途:向 SGLang Cookbook(docs/,基于 Mintlify)新增一个模型页面。该 Cookbook 采用配置驱动:两个共享引擎 docs/src/snippets/_deployment.jsx(5 维部署矩阵)与 _playground.jsx(差异覆盖 Playground)不含模型专属代码;新增模型只需添加数据——每模型配置(可选基准)与引用它们的 MDX 页面。若迁移已有的旧模板页面,应使用 cookbook-migrate-model 技能。
主要能力:从模板实例化三份文件——templates/config.jsx.tmpl 复制为 docs/src/snippets/configs/<hf-org>/<model-slug>.jsx;templates/benchmarks.jsx.tmpl 复制为 …/<model-slug>-benchmarks.jsx(无数据时跳过);templates/page.mdx.tmpl 复制为 docs/cookbook/<category>/<Vendor>/<Model>.mdx。模板使用 TOKEN 占位符,需替换并裁剪模型不支持的部分。工作流分阶段:采集模型卡、变体/量化、已测硬件与并行、已验证启动配方、sglang 版本/镜像标签;实例化模板;校验;交互测试;撰写正文与配置提示;用 /cookbook-review-pr <PR number> 复核。
必要用法:文档校验在 docs 目录执行 mint validate、mint broken-links、mint dev(本地 http://localhost:3000/cookbook/<category>/<Vendor>/<Model>)。清理占位符用 grep -rn '[A-Z_]*' <新文件>;检查 NEW 标签用 grep -rn 'tag: NEW' docs/cookbook/<category>/<Vendor>/。git 流程:git checkout -b add-<model>-cookbook,git add 指定文件,git commit、git push -u origin 分支、gh pr create。新增厂商 logo 用 git add -f(*.png 被仓库忽略)。
参考资料(按需阅读,勿内联):references/authoring-reference.md、mintlify-authoring.md、engine-axis.md、vendor-logo.md、diffusion-authoring.md。
限制:仅添加数据,不编辑引擎;镜像版本标签不可猜测,需询问用户或默认 lmsysorg/sglang:dev,模板中的 0.0.0 是刻意 TODO;未测硬件不列出;FP4 仅限 Blackwell;扩散模型与 Omni 页面须遵循各自类别结构;Logo 须向用户索取,不得虚构或复制。资料未提供价格、收费或其他平台支持信息。