用途:这是 Runpod 官方预构建 Pod 模板的参考技能,帮助判断某个官方镜像实际包含什么、暴露哪些端口与路径、如何选型与固定版本,而不是自己构建镜像。部署本身由 runpod-mcp 或 runpodctl 完成,本技能不管理基础设施。
术语区分:“模板”(Pod template)是保存好的 Pod 配置(镜像+端口+磁盘+环境变量),官方模板出现在 Console 的 console.runpod.io/hub/template/<id>;而 Hub repo(如 runpod-workers/worker-comfyui)是打包好的无服务器 worker,部署为 endpoint。二者目录互不相通:hub search comfyui 只返回无服务器 worker,不含官方 ComfyUI Pod 模板;template search 不返回 Hub repo。REST v2 catalog 中通过条目的 serverless 标志区分。
查找官方模板:isRunpod: true 表示由 Runpod 维护,否则为社区发布。可用 runpodctl template list --type official、runpodctl template search <name>、runpodctl template get <template-id>。template get 返回模板自带的 readme,若与本技能冲突以 readme 为准;镜像标签、端口、环境变量应以上述命令为准,因为模板发布节奏快于本仓库。Console 链接格式为 https://console.runpod.io/hub/template/<template-id>。
REST v2 限制:GET /v2/catalog/templates 支持 source=official|verified|community(默认 official);GET /v2/templates 只返回自有模板;GET /v2/templates/{id} 返回单个模板。official(14 个)与 verified(3 个)可完整枚举,community 上限 100 且不支持分页,超出部分任何切片都无法返回,runpodctl template search 也看不到。若用户给出找不到的模板,应索要 template id 而非断言不存在。v2 中没有 isRunpod 字段,official 指的是所请求的 source 切片。catalog 条目的 allowedCudaVersions 可用来在同模板的 CUDA 变体间选择,配合 runpodctl pod create --min-cuda-version。
参考文件:reference/comfyui.md、reference/pytorch.md 等,每份按固定顺序回答身份、变体、端口与凭据、自启动命令、路径、就绪判断、未附带内容、规格、版本固定。reference/comfyui-model-repair.md 例外,是驱动 scripts/ 中脚本的 ComfyUI 工作流修复流程。
后续分流:需要端到端部署转对应 golden path;Pod 显示 Running 但 URL 不可用转该模板 reference 的就绪章节及 gotchas;ComfyUI 模型无法下载转修复指南;向运行中的 Pod 添加模型转该模板“未附带内容”章节或 companion-clis;超出模板范围的自定义转 building-images.md;需要无服务器 worker 则改用 runpodctl / runpod-mcp 的 Hub workers。