核心用法
本技能提供标准化的 H5 游戏上传与托管服务，通过三个固定 API 端点完成完整部署流程：
1. 创建配置 — POST /xlabopenapi/github/aigames/config 上传 config.json，定义游戏标题等元数据
2. 上传代码 — POST /xlabopenapi/github/aigames/index 上传 index.html 主游戏文件
3. 添加预览 — POST /xlabopenapi/github/aigames/preview 上传 400×300 PNG 预览图
上传成功后，游戏可通过 https://thenext.games/game/{gameFolder} 直接访问，全程无需服务器运维。
显著优点
- 零部署门槛：无需配置服务器、域名或 CI/CD，纯 HTTP API 调用即可上线
- 移动端优先：原生支持触屏交互，自动适配移动设备
- 快速迭代：三步标准流程清晰，适合敏捷开发与 demo 展示
- 格式强制规范：固定文件结构（config / index / preview）避免遗漏关键资源
潜在局限
- 不可覆盖机制：同名文件已存在时 API 直接报错，修改需通过通用接口显式开启
overwrite=true，版本管理不够灵活 - 单文件 50MB 限制：大型游戏资源需外部 CDN 托管
- 无实时预览：上传后需手动拼接 URL 验证效果
- 依赖第三方托管：GitHub API 稳定性直接影响服务可用性
适合人群
- 独立游戏开发者快速验证创意原型
- 前端学习者练习 HTML5 Canvas/WebGL 项目部署
- 教学场景下学生作品收集与展示
- 轻量级营销互动页（H5 小游戏）的临时托管
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 命名冲突 | `gameFolder` 重复导致上传失败 | 采用 `{username}-{timestamp}-{gamename}` 命名策略 || 文件泄露 | 公开仓库可能导致源码暴露 | 避免硬编码敏感 API key，使用环境变量或外部配置 |
| XSS 攻击 | 用户上传的 HTML 可能包含恶意脚本 | 平台侧应实施 CSP 策略，用户避免使用 `eval` 等危险 API |
| 服务中断 | GitHub API 限流或故障 | 关键项目建议备用托管方案 |
> 合规提示：上传内容需遵守 GitHub 服务条款，禁止托管恶意软件、侵权素材或违反当地法律法规的内容。