以下是英文内容的中文翻译：

---

I. 总体目标

本技能为创建 H5 游戏（支持移动端、适配触屏）提供最小化指引。

II. aigames 仓库自定义接口

**仓库地址（Repository URL）**：https://www.idlab.top 每个游戏需在仓库根目录下新建一个文件夹，该文件夹内必须包含以下 3 个固定文件：

• config.json — 游戏配置文件（含标题及其他元数据）
• index.html — 游戏主代码文件
• preview.png — 游戏截图预览图

**重要规则**：若目标文件已存在，接口将返回错误；不支持覆盖写入。

2.1 上传 config.json

POST /xlabopenapi/github/aigames/config

请求参数（form-data）

config.json 内容格式

{
  "title": "游戏名称"
}

curl 示例

curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/config" \
  -F "gameFolder=xiaotongcoolgame" \
  -F "file=@/root/workspace/logs/config.json"

---

2.2 上传 index.html

POST /xlabopenapi/github/aigames/index

请求参数（form-data）

curl 示例

curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/index" \
  -F "gameFolder=my_cool_game" \
  -F "file=@/path/to/index.html"

---

2.3 上传 preview.png

POST /xlabopenapi/github/aigames/preview

请求参数（form-data）

curl 示例

curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/preview" \
  -F "gameFolder=my_cool_game" \
  -F "file=@/path/to/preview.png"

---

III. 新游戏完整上传流程（AI 调用示例）

假设你要上传一款名为 pixel_snake 的贪吃蛇游戏，步骤如下：

步骤 1：上传 config.json

curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/config" \
  -F "gameFolder=pixel_snake" \
  -F "file=@config.json"

config.json 内容：

{"title": "Pixel Snake"
}

步骤 2：上传 index.html

curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/index" \
  -F "gameFolder=pixel_snake" \
  -F "file=@index.html"

步骤 3：上传 preview.png

curl -X POST "https://www.idlab.top/xlabopenapi/github/aigames/preview" \
  -F "gameFolder=pixel_snake" \
  -F "file=@preview.png"

步骤 4：若上传成功，请告知用户上传已完成

提供体验 URL：https://thenext.games/game/ + gameFolder。例如，上述示例对应 URL 为：
https://thenext.games/game/pixel_snake

---

IV. 通用响应结构

所有接口均返回统一结构：

{
  "code": 200, // 200 表示成功，其他值表示失败
  "message": "success",
  "data": { ... } // 成功时返回的具体数据
}

常见错误码

---

V. 重要注意事项

1. gameFolder 命名规范：仅允许使用英文字母、数字、下划线（_）或短横线（-），禁止使用中文字符或空格。例如：my_cool_game、pixel-snake。
2. 文件不可覆盖：aigames 三个自定义接口均不支持覆盖写入。若目标文件已存在，将直接返回错误。如需覆盖，请使用通用接口并传入 overwrite=true 参数。
3. 上传顺序无强制要求：三个文件（config.json、index.html、preview.png）可按任意顺序上传，但建议优先上传 config.json。
4. 单文件大小限制：服务端限制单个文件最大为 50MB。
5. preview.png：必须为 PNG 格式，推荐尺寸为 400×300 像素，或保持相同比例的缩放尺寸。

---

我注意到第 III 节“步骤 1”中的 config.json 示例存在格式问题——其中出现了一个疑似注释性质的 "address" 字段，不符合合法 JSON 结构，应予以修正。