完成开发后，你需要把作品提交到野生Club。提交不是只交一个游戏链接，而是交一份能证明你真实完成作品的项目档案。

这份档案会被用于 3 件事：

1. Review 你的作品是否达到 YSWS 门槛。
2. 在口袋街机厅展示你的游戏。
3. 作为 AI 面试和线下 Game Jam 筛选依据。

---

01. 提交前置准备

申请审核前，你的项目必须满足这些硬性指标：

• 完整可玩的项目：必须有明确的开始、游戏循环、胜负判定，不能是半成品 demo。
• README 详细说明：介绍玩法、规则、创作主题、你和 AI 如何完成它。
• MakeCode Share 链接：别人打开链接就能试玩。
• 1-2 张游戏截图：展示游戏运行画面。
• 至少 3 篇开发日志：记录真实开发路径，不能只写“今天写了一点代码”。

建议你在电脑上建立一个项目文件夹：

my-pocket-game/
  README.md
  log-01.md
  log-02.md
  log-03.md
  screenshot-01.png
  screenshot-02.png

插图建议：这里放一张项目文件夹截图，让学生知道要保存哪些材料。

02. README 应该怎么写？

README 是别人认识你游戏的入口。

可以直接使用这个模板：

# 游戏名称

## 一句话介绍
这是一个关于 [主题] 的 MakeCode Arcade 游戏。玩家需要 [核心玩法]，最终目标是 [胜利条件]。

## 怎么玩
- 方向键 / WASD：移动角色
- A 键：跳跃或攻击
- 目标：达到 [分数/关卡/时间] 即可获胜
- 失败：生命值归零或时间结束

## 试玩链接
MakeCode Share 链接：
[粘贴你的链接]

## 截图
![游戏截图](screenshot-01.png)

## 我用 AI 做了什么
- AI 帮我解释了原始代码。
- AI 帮我增加了 [功能]。
- 我自己修改了 [参数/美术/规则]。

## 我学到了什么
这次我学会了 [Sprite / 碰撞 / 分数 / 随机生成 / 调试]。

README 不需要写得像论文，但必须让别人知道：你的游戏怎么玩、为什么这样设计、AI 参与了哪部分。

03. 开发日志应该怎么写？

至少 3 篇。推荐结构：

第 1 篇：第一个可玩版本

写你如何让角色移动、生成道具、做出胜负条件。

第 2 篇：AI 帮我扩展

写你把代码交给 CodeBuddy 后，AI 帮你增加了什么，你理解了什么。

第 3 篇：调试和打磨

写一个真实问题：报错、难度太高、角色消失、得分不对、Share 链接打不开等，以及你怎么解决。

一篇合格日志通常包含：

• 今天想做什么。
• 实际完成了什么。
• 卡在哪里。
• AI 给了什么建议。
• 你最后怎么判断和修改。

04. 生成 MakeCode Share 链接

1. 打开你的 MakeCode Arcade 项目。
2. 点击左上角 Share。
3. 输入游戏名称。
4. 点击 Publish project。
5. 复制生成的链接。
6. 用无痕窗口或另一个浏览器打开一次，确认别人也能访问。

如果链接打不开，先不要提交。

05. 通过 API 创建与提交

野生Club 采用统一的 API 提交机制。你可以查看 通用提交指南 了解如何生成 API Token。接口调用参数如下。

创建项目时，program_id 必须是 arcade：

curl -X POST https://yesheng.preview.tencent-zeabur.cn/api/v1/projects \
  -H "Authorization: Bearer ysk_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "program_id": "arcade",
    "slug": "my-pocket-adventure",
    "name": "口袋大冒险",
    "tagline": "像素风横版躲避接水果游戏"
  }'

接着，用 readme 接口和 logs 接口把你的文档和 3 篇日志依次发送上来。具体方法见 通用提交指南。

如果你不熟悉命令行，可以把通用提交指南和你的 API Token 交给 CodeBuddy，让它帮你生成 curl 命令。但不要把 Token 发到公开群聊或截图里。

06. 申请 Review

确认 README 和 3 篇日志上传无误后，发送请求申请 Review：

curl -X POST https://yesheng.preview.tencent-zeabur.cn/api/v1/projects/my-pocket-adventure/review/request \
  -H "Authorization: Bearer ysk_xxxx"

这会触发 AI 审核与管理员队列。AI 将核对日志的真实性，并进行第一轮合规判断。

07. Review 会看什么？

Review 不是只看游戏好不好玩，也会看过程是否真实。

我们会检查：

• Share 链接是否有效。
• 游戏是否有完整闭环。
• README 是否解释了玩法。
• 日志是否具体。
• AI 使用是否透明。
• 项目是否适合进入街机厅展示。
• 是否存在明显抄袭、代写或无法解释的代码。

Review 结果可能是：

• 通过：进入面试或发货流程。
• 需要修改：根据建议补 README、日志、截图或游戏功能。
• 暂不通过：作品还没有达到最低完成度，需要继续开发。

08. AI 面试 / Interview

为了保障真实性并防止作弊，所有 YSWS 选手在 Review 推荐后均需参加一次简短的 AI 面试或真人面谈：

• 形式：管理员会通过微信、GitHub、Discord 或邮件与你联系，进行 5-10 分钟沟通。
• 内容：请你展示 MakeCode 的 TypeScript 编辑器，解释几段核心逻辑，或者当场修改一个小参数。
• 目的：确认作品确实由你参与完成，并且你理解 AI 帮你写的代码。

面试前请准备好：

• 能打开的 MakeCode 项目。
• 能运行的 Share 链接。
• README。
• 3 篇开发日志。
• 你最想展示的一段代码。

面试可能会让你现场做一个小修改，比如：

• 把胜利分数从 20 改成 30。
• 把敌人速度提高。
• 增加一条生命。
• 改一个 Sprite 图片。
• 解释 AI 帮你新增的功能。

这不是考试，是确认作品是你真实参与完成的。

09. 通过以后会发生什么？

通过后，作品会进入后续流程：

1. 项目状态更新。
2. 作品进入口袋街机厅。
3. 如果有掌机名额，进入发货流程。
4. 优秀作品可能被邀请参加 AI Arcade Game Jam 展示。
5. 线下展示作品可能会运行在真实掌机或街机装置上。

如果你想参加 Game Jam，建议继续打磨作品：补主题、补截图、补玩法说明，让它不只是能玩，也适合被别人试玩和理解。