remix-submission-rules

Remix 提交规则（remix-submission-rules）用于定义 Remix 游戏提交时的校验标准与发布约束。该规则的核心用途是判断一个游戏版本是否具备“可上线”条件，并规范通过 Agent REST 进行游戏创建与更新的流程。

主要能力

规则给出一组明确的“可上线”前置条件，只有全部满足时才应视为可发布：

1. 游戏代码存在。
2. 游戏具有名称、图标，并且至少有一个分类。
3. 代码中存在规定的 SDK 钩子，具体包括：
   • HTML 的 <head> 中引入脚本： <script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script>
   • window.RemixSDK.singlePlayer.actions.gameOver(...)
   • window.RemixSDK.onPlayAgain(...)
   • window.RemixSDK.onToggleMute(...)

Agent REST 流程约束

规则对通过 Agent REST 操作游戏的流程作出限制：

• 通过 POST /v1/games 创建游戏草稿。
• 通过 POST /v1/games/{gameId}/versions/{versionId}/code 更新当前版本代码。
• 不得从 Agent REST 创建额外版本（没有 create-version 路由）。
• 不得从 Agent REST 提交（没有 submit 路由）。
• 永远不要更新已上线的版本（live version）。

元数据要求（当前）

• 名称：通过现有的游戏元数据 API 设置。
• 分类：通过现有的游戏元数据 API 添加 1 至 3 个分类。
• 图标：在 Remix Studio/应用流程中上传（暂未有专用的 Agent REST 图标上传路由）。
• 二进制资源：在 Remix Studio/应用流程中上传，然后使用 GET /v1/games/{gameId}/assets 获取托管 URL 并映射到代码中。

使用方式与校验接口

• 使用 GET /v1/games/{gameId}/versions/{versionId}/validate 确认是否存在阻断项。
• 当需要聚合的就绪信号时，使用 GET /v1/games/{gameId}/launch-readiness?versionId={versionId}（包含 valid 与 readyForSubmission）。

适用场景

适用于通过 Agent REST 管理 Remix 游戏版本、在提交前检查发布条件、确认代码中是否包含必要 SDK 钩子，以及在 Remix Studio/应用流程中处理图标与二进制资源的场景。

限制

规则未提供从 Agent REST 创建版本或提交的接口，因此这些操作需通过其他既有流程完成。图标暂未提供专用的 Agent REST 上传路由。除上述接口与要求外，其他功能、收费、价格、平台或效果信息暂未提供。