模板商店（Template Store）
模板商店页适合在“我还没有模板，但想尽快拿到一个可用模板”时使用。相比自己从零填写模板创建表单，它更像一个预置模板目录：
- 帮你快速浏览官方推荐模板
- 按类别筛选适合的运行环境
- 直接从预置镜像安装模板
- 在安装完成后跳转到模板详情继续查看状态
如果你刚完成安装，这是比手工创建模板更容易上手的一条路径。
模板商店适合什么场景
模板商店特别适合下面几类用户：
- 第一次接触 Cube Sandbox，还没有自己的模板参数
- 想先用官方模板验证控制面、模板构建和沙箱链路是否正常
- 希望快速拿到代码执行、浏览器或基础镜像模板
- 想减少手工填写镜像、探针和端口参数的出错概率
页面里通常有什么
模板商店页通常会提供一组预置模板卡片，并包含：
- 模板名称和用途说明
- 类别，如代码执行、浏览器、基础镜像
- 镜像大小
- 关键标签
- 是否为官方模板
- 当前是否已安装
- 是否存在可更新版本
从源码里看，当前预置模板至少覆盖：
sandbox-code：代码执行模板sandbox-browser：浏览器自动化模板cubesandbox-base：基础镜像模板
分类、搜索与官方模板标记
模板商店一般支持：
分类筛选
常见分类包括：
- 全部
- 代码执行
- 浏览器
- AI / LLM
- 基础镜像
搜索
适合在模板较多时快速定位目标模板，尤其适合按名称、描述或标签查找。
官方模板标记
官方模板通常更适合作为第一批体验模板，因为它们默认已经配置好了更合理的镜像、探针与暴露端口组合。
已安装、可更新、官方标记分别是什么意思
已安装
模板商店会根据当前已有模板列表，判断某个商店模板是否已经安装。源码中当前只把状态为 READY 的模板视为“已安装”。
这意味着：
- 只是创建过但还没
READY的模板，不一定会被标记为已安装 - 如果同一模板安装了多个 READY 实例，页面可能会显示安装数量或下拉列表
可更新
如果模板商店检测到商店模板镜像与本地已安装模板不一致，通常会给出“可更新”提示。
这更适合作为“版本漂移提醒”，而不是强制升级机制。
官方
官方标记说明该模板来自预置目录，适合优先用于演示、验证和标准场景接入。
一键安装流程
模板商店的安装通常会打开一个安装弹窗，并自动带入预置参数，例如：
- 镜像地址
- 暴露端口
- 探针端口
- 探针路径
- 默认可写层大小
用户通常只需要补或调整：
templateIDwritable-layer-size
然后提交安装请求即可。
安装后如何判断模板可用
模板商店的安装不是“点一下立刻完成”，而是一个带轮询的过程。安装后通常会持续检查模板列表，直到出现下面几种结果之一：
- 模板状态变为
READY - 模板状态变为
FAILED - 轮询超时
因此，安装成功后的正确动作通常是：
- 等待安装结果提示
- 成功后跳转到模板详情页
- 在 模板管理 中继续确认模板状态和副本分布
与模板管理页如何分工
你可以把两页理解为：
- 模板商店：帮你快速“拿到一个合适的模板”
- 模板管理：帮你持续“管理已经存在的模板”
如果你还没有模板，优先看模板商店；如果你已经有模板并要做查看、重建、删除、排障，优先看模板管理。
推荐使用路径
路径一：首次部署后的最快验证
路径二：排查为什么“模板明明装了但用不了”
- 先确认模板商店中的安装状态
- 再到模板管理页查看该模板详情
- 再看 可观测性（Observability） 中是否存在失败模板或管理 API 异常
- 必要时再结合运维日志继续排查
如果你碰到的是“官方模板看起来装过但状态不对、安装后长期转圈、商店状态与模板页不一致”，建议直接查看 模板商店与官方模板排障。
如果你碰到的是“提示可更新，但不确定是否该在当前窗口处理”，建议继续查看 模板更新策略与版本漂移治理。