English | 中文
本页是 InferenceX 流程知识库的低上下文入口。先读本页,再只打开与当前任务相关的一份聚焦指南。默认不要读取所有流程页面。每份聚焦指南都包含前置条件、步骤、验证、停止条件与实现来源链接。
仓库源代码、Workflow YAML、启动器脚本与结果收集器是行为的权威来源。如果指南与代码不一致,应以代码为准。英文页面是文档主版本,先更新英文,再在同一变更中根据英文内容更新对应的中文翻译。
| 任务 | 首先打开 | 然后检查 |
|---|---|---|
| 新增模型或 GPU 基准测试 | 配置流程 | 最近的基准测试脚本、启动器、主 YAML、变更日志 |
| 修改已有配置 | 配置流程 | CONFIGS.md、校验 Schema、生成器、运行时消费者 |
| 新增 Runner | 配置流程 | Runner 初始化、configs/runners.yaml、启动器 |
| 修改 srt-slurm 或 llm-d | 配置流程 | Recipe YAML、主配置、srtctl 映射、启动器 |
| 修改 MTP | 配置流程 | MTP 同类实现、draft model、聊天模板路径 |
| 校验矩阵 | CI 流程 | 生成器 CLI 与 Pydantic 校验 |
| 派发或监控任务 | CI 流程 | e2e-tests.yml、运行日志、产物 |
| 准备 PR 扫描 | CI 流程 | run-sweep.yml、标签、变更日志差异 |
| 复用绿色扫描 | CI 流程 | 复用门禁、源产物、合并工具 |
| 新增或调试评估 | 评估与 AgentX 流程 | EVALS.md、评估模板、分数校验器 |
| 运行 AgentX | 评估与 AgentX 流程 | Agentic 配置、Trace 来源、实时运行 Skill |
| 检查结果或入库 | 恢复与结果流程 | 产物 Schema、收集器、App 入库 Workflow |
| 恢复失败入库 | 恢复与结果流程 | 恢复工具、源 Run 产物、祖先关系规则 |
| 调试 Runner 或 Workspace | 恢复与结果流程 | 启动器清理、KLAUD_DEBUG.md、集群日志 |
| 新增或更新文档 | 文档流程 | 最近的源文件、文档索引、_zh.md 配对 |
先完成 Agent 指南的安全开始,然后:
- 只阅读聚焦流程链接的实现章节。行为由源文件定义,不由复制的文案定义。
- 在昂贵的 CI 或 GPU 工作前运行其中最窄的验证。
- 流程产生外部证据时,记录 Run ID、attempt、产物名称、source SHA 与故障分类。
- 流程或契约变化时,更新相关英文指南及其中文对应页面。
聚焦指南会链接以下现有 Playbook,而不是复制其中完整的历史背景:
| Playbook | 范围 |
|---|---|
add-model-hardware.md |
Day-zero 模型与 SKU Recipe |
recover-failed-ingest.md |
仅维护者可执行的产物复用恢复 |
clean-amd-mi355-runner-root-files.md |
AMD Runner root 文件恢复 |
debug-mi300-enroot-pyxis.md |
MI300X 集群初始化调试 |
merge-prs.md |
维护者 PR 合并协调 |
fix-klaud-cron-prs.md |
自动镜像更新 PR 修复 |
nuke.md |
自动更新镜像标签,每个 Recipe 系列创建一个 PR |
聚焦页面是可发现的流程层。这些源 Playbook 保留为实现细节或特权维护路径,只有在聚焦指南明确链接时才打开。
遵循 docs/index_zh.md 的上下文规则。优先读取源文件的标题或行区间,并将大型 YAML、JSON、日志、生成矩阵与产物作为定向数据源。