mcpField
R
runpod-templates

runpod-templates

github.com/runpod云与 DevOps4710.4k 次安装2 天前更新
代码仓库

关于 runpod-templates

介绍 Runpod 官方 Pod 模板的参考技能，适合选择或排查 ComfyUI、PyTorch 等预构建工作负载。它区分 Pod 模板与无服务器 Hub 列表，并说明镜像内容、配置、就绪状态及部署交接方式。

主要功能

  1. 01区分 Pod 模板与 Hub 工作进程
  2. 02列出官方模板的搜索方式
  3. 03记录端口、路径和启动行为
  4. 04说明就绪状态与镜像缺项
  5. 05指引部署和修复任务

适用场景

  1. 01确认工作负载是否有官方 Pod 模板
  2. 02为 GPU 选择合适的模板变体
  3. 03排查 Pod 已运行但服务不可用
  4. 04将模板部署交给基础设施工具

MCP 相关

该技能不负责部署或管理基础设施；若 MCP 已连接，则将部署交给 runpod-mcp，否则使用 runpodctl。它还提到可通过 MCP 工具浏览或部署 Hub 列表。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-templates

安装后在 Claude Code 中输入/runpod-templates确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
always-output-workflow.eval.md
ambiguous-filename.eval.md
api-inventory-only.eval.md
gated-model.eval.md
mixed-resolved-ambiguous-output.eval.md
nontechnical-handoff.eval.md
png-output-extraction.eval.md
repair-and-handoff.eval.md
runpoddirect-required-handoff.eval.md
support-intake.eval.md
template-recommendation.eval.md
unsafe-download-url.eval.md
reference/
comfyui-model-repair.md
comfyui.md
pytorch.md
reference/comfyui-repair/
metadata.md
resolution.md
runpoddirect.md
scripts/
apply_model_metadata.py
extract_png_workflow.py
inventory_workflow_models.py
tests/
test_extracted_helpers.py
test_model_metadata_scripts.py
test_png_workflow_extractor.py

详细介绍

官方 Runpod 模板

如需显式打包源代码或优化模板，请使用 runpod-build-template。对于常规工作负载部署，优先使用官方模板，而不是构建镜像。 Runpod 为常见工作负载维护预构建镜像；部署只需创建并轮询，无需通过 SSH 安装。 本技能是了解这些镜像实际情况的参考。它不管理基础设施——请使用 runpod-mcp（如果已连接）或 runpodctl 进行部署。

术语——“模板”与 Hub

两个不同的产品都使用“Hub”一词，混淆它们会让查找过程跑偏：

术语含义运行方式查找方式
Pod 模板（本技能）已保存的 Pod 配置——镜像 + 端口 + 磁盘 + 环境变量。官方模板会显示在 Console Hub 模板页面（console.runpod.io/hub/template/<id>）作为一个 Podrunpodctl template list --type official / template search · REST GET /v2/catalog/templates
Hub 仓库 / 条目打包好的无服务器工作器（例如 runpod-workers/worker-comfyui），带有处理程序，部署为端点无服务器runpodctl hub list / hub search · MCP list-hub-repos / deploy-hub-repo

同一个词，却是互不相通的目录：hub search comfyui 只会返回无服务器工作器，不会返回任何官方 ComfyUI Pod 模板；template search 也不会返回 Hub 仓库。在 REST v2 目录中，Pod 模板与无服务器模板通过每个条目的 serverless 标记区分。

“官方”的含义及查找方法

当模板报告 isRunpod: true 时，该模板由 Runpod 维护。搜索结果中的其他内容均由社区发布：可以使用，但不在本技能的涵盖范围内，也不保证版本。

runpodctl template list --type official   # the whole official set (14 as of 2026-08-25)
runpodctl template search <name>          # by name; check isRunpod: true
runpodctl template get <template-id>      # image, ports, portsConfig, disk + full readme

template get 会返回模板的 readme——与镜像一同维护的说明。当它与本技能内容不一致时，应以此为准。请从这些命令获取镜像标签、端口和环境变量，而不要从这些文件获取：模板有自己的发布节奏，更新速度比本仓库快。参考文件记录的是结构和注意事项，这些才是重新摸索的高成本部分。

⚠️ runpodctl hub ... 不能用于查找 Pod 模板——请参阅术语。

如需向用户提供 Console 链接，请使用 https://console.runpod.io/hub/template/<template-id>。

REST v2 没有模板搜索功能——只能获取切片后自行筛选

REST v2 没有用于模板的查询/搜索参数，因此每次“搜索”都是在获取的切片上进行客户端筛选：

端点参数返回内容
GET /v2/catalog/templatessource=official|verified|community（默认为 official）公共目录切片
GET /v2/templates无仅返回你拥有的模板
GET /v2/templates/{id}—一个模板，可由你拥有，也可来自目录

official（14 个）和 verified（3 个）均可完整枚举；community 上限为 100 个，且明确不支持分页。 超出该上限的社区模板不会出现在 API 可返回的切片中，而 runpodctl template search 读取的也是相同的服务端切片，因此它也无法查看超出上限的内容。如果用户提到的模板无法找到，请向他们索要模板 ID，而不要断定它不存在。

isRunpod 是 GraphQL/v1 字段，v2 中没有对应字段——在 v2 中，“官方”指你请求的 source 切片，而不是记录中的标记。

目录条目包含 allowedCudaVersions，这是选择同一模板不同 CUDA 系列版本的可靠依据——请将其与 runpodctl pod create --min-cuda-version 搭配使用，而不要根据 GPU 名称推断。

模板

工作负载参考文档部署指南
ComfyUI — 可通过 URL 访问的图像生成 UIreference/comfyui.mdgolden path 02，变体 B
PyTorch — 通用 GPU 基础镜像／开发环境（2.1 → 2.9，包括集群版和 ROCm 构建）reference/pytorch.mdgolden path 06
Ubuntu — 纯净版 20.04 / 22.04 / 24.04（CPU 类别）TODO—
网络存储文件浏览器（GPU + CPU）TODOgolden path 07

添加模板时，只需在此处添加一个文件，并在上表中添加一行。不要为每个模板 创建新的技能——任务形式完全相同，而且每个已注册的技能都会占用每次会话的上下文。

如何使用模板参考文档

reference/ 下的每个文件都按相同顺序回答相同的问题，方便 Agent 快速找到所需内容：

  1. 身份信息 — 模板名称、ID、镜像、上游源代码仓库。
  2. 变体 — CUDA／架构／GPU 代际划分，以及该选用哪个变体。
  3. 端口和凭据 — 暴露了哪些内容，以及任何默认登录信息。
  4. 自动启动 — 开机时已在运行的内容，以及确切的命令。
  5. 路径 — 应用、配置和数据所在位置（以及网络卷挂载会带来哪些变化）。
  6. 就绪状态 — 首次启动需要多长时间，以及“实际提供服务”的确切信号。Running 永远不是就绪信号。
  7. 未随附的内容 — 从“已启动”到“可用”之间的差距，以及如何通过编程方式而非点击操作来弥补。
  8. 规格 — 容器磁盘空间和最低 VRAM。
  9. 版本固定 — 如何固定到已知可用的版本。

有一个文件例外：reference/comfyui-model-repair.md 是使用指南——介绍 ComfyUI 工作流修复流程，并调用 scripts/ 中的脚本——而非包含 9 个问题的模板参考文档。

后续路由——此技能是枢纽，而非目的地

询问模板的用户很少只想查看参考文件本身；他们想要部署、修复或替换模板。先从这里开始，确定用户的需求，然后转交：

用户想要……转到
端到端部署模板上表中对应的 golden path（索引）——经实际运行验证，包含真实命令
修复无法提供服务的 Pod（状态为“Running”，但 URL 无法访问，或返回 404/502）模板的参考文件 §Readiness，然后查看 runpod-usage/reference/gotchas.md
修复无法下载模型的 ComfyUI 工作流（模型元数据缺失／损坏、导入的工作流或 PNG）修复指南——它会调用 scripts/ 中的修复脚本。官方 ComfyUI 模板附带 ComfyUI-RunpodDirect，因此适用其自动下载路径
向正在运行的模板 Pod 添加模型／文件模板的参考文件（§What does not ship），或使用 companion-clis 进行通用 Hugging Face 传输
自定义模板未随附的内容（固定版本、额外节点、更精简的镜像），或编写模板项目／Hub 列表runpod-build-template——使用合适的官方基础镜像编写项目
无服务器工作进程，而非 Pod这不是 Pod 模板——使用 runpodctl / runpod-mcp 部署 Hub 工作进程

此处的参考文件说明镜像中包含什么；它们不会重复部署指南或修复流程，而是指向相应内容的维护者。

评论

支持 Markdown