# 在 iNeed 上发布与接入

这页回答三个问题：发布时要在 iNeed 填什么，登录、广告、支付这些真实服务由谁接，提交前自己要查哪些项目。按这页准备好的作品，通常一次就能通过审核，不需要来回补材料。

## 分工：你负责什么，iNeed 负责什么

你的作品负责玩法、界面、规则和等待反馈，把调用外部服务的地方集中在可替换的服务模块里（见[架构与接口设计](../development/architecture.md)）。真实账号、扣款、广告请求、排行榜写入、联机连接和 AI 密钥都由 iNeed 提供，作品不自己实现，也不在包里放任何密钥。

| 功能 | 你在作品里做 | 发布时在 iNeed 选择或填写 | iNeed 负责 |
| --- | --- | --- | --- |
| 登录 | 游客能玩什么、哪些动作要登录、登录或取消后回到哪里 | 无需单独设置 | 账号会话、登录弹窗、跨设备和切号 |
| 普通广告 | 允许出现广告的位置和时机；关闭后恢复声音、输入和计时 | 变现方式选「广告收益」，选广告档位 | 真实广告请求、没有广告时隐藏、频率控制 |
| 激励广告 | 看完才发奖、只发一次；取消或失败不发 | 选了买断或章节解锁时，勾选「允许激励广告兑换权益」并填时长（5–30 秒） | 播放、完成判定和奖励确认 |
| 内购 | 卖什么、永久还是按次、什么时候真正使用；购买和使用分开 | 变现方式选「基础免费＋内购」，逐个填写商品（最多 20 个） | 扣款、确认付款和权益恢复 |
| 买断 / 章节解锁 | 免费部分在哪里结束，解锁后进入哪里 | 选「一次买断」或「章节解锁」并填价格（单位 I币） | 收费、解锁状态和恢复 |
| 排行榜 | 分数含义、一局何时结束、只在结束时提交一次 | 无需单独设置 | 分数写入、个人最佳和榜单读取 |
| 存档 | 版本、冲突和超限处理（单个存档 1 MiB） | 无需单独设置 | 按账号保存和读取 |
| 联机 | 输入、状态同步、碰撞、结算和断线表现 | 在发布页对话里说明要随机匹配、联机大厅还是邀请（目前为双人），确认助手给出的设置卡 | 匹配、房间、连接和中转 |
| AI 文本 / 图片 | 用途、输入、结果怎样进入玩法，以及等待和失败界面 | 在发布设置里开启「作品内 AI 支持」，凭据只在安全表单里填写 | 密钥保管、调用和限流 |

引擎差异：Godot 作品使用本 Skill 附带的插件接入这些功能（见 [Godot](../../skills/engines/godot/SKILL.md)），不要自己发网络请求代替。原生网页和框架作品保留清楚的服务模块和调用点即可，并在提交说明里写明位置。

只选你真正需要的功能。没有确认过的价格、奖励和权限不要自己定，先问作者。

## 在发布页的三步

1. **上传作品**：创作者中心 → 发布内容，选择 ZIP 或单个 HTML，也可以粘贴 HTML 或从 GitHub 导入。容量见[容量与数量](../packaging/limits.md)。
2. **核对资料**：标题（1–50 字）、英文网址、简介（15–200 字）、分类、标签、展示端（电脑 / 手机），以及一张 4:3 封面。普通作品没有封面不能提交。
3. **发布设置并提交**：选择变现方式和公开范围（「公开收录」或「仅链接分享」），勾选确认后提交审核。

提交后作品进入审核，审核期间不能直接修改；要改就先撤回，改完重新提交，审核会重新排队。从没发布过的草稿最后一次操作后保留 3 天。

## 提交前自检

下面每一项都对应审核时最常退回的问题。逐项在最终导出的运行包上实际操作，而不是只看代码。

- **请求**：启动和断网时都没有循环请求或无限重试；失败有提示，并能手动重试。
- **等待**：每个会等待的按钮都有反馈，等待中重复点击不会重复提交。
- **登录**：游客点到需要登录的动作时有提示；登录成功或取消后回到原来的位置，进度不丢。
- **广告**：没有广告时界面照常可用；关闭广告后声音、输入和计时恢复；激励奖励只在看完后发一次。
- **购买**：取消或失败不给东西；刷新后已买的还在；连续点击只扣一次；买了还没用的不需要重买。
- **排行榜**：只在一局结束时提交一次分数；提交失败不影响继续游玩。
- **联机**：对方离开或断线时能回到菜单；重开一局不会带上上一局的状态。
- **AI**：真实生成的结果进入了玩法，而不是只打印出来；慢、失败、被审核拦下时都有界面。
- **包**：根目录有 index.html、路径都是相对路径、没有外链脚本、容量和文件数在限制内（见[打包](../../skills/packaging/SKILL.md)）。
- **安全**：包里没有密钥、服务 token、测试账号和调试开关。

更细的场景见[功能自测清单](acceptance.md)和各功能页末尾的「本地自测和通过标准」。

## 提交说明怎么写

在发布页的对话里，或随源码一起，用几行写清下面的内容。内容越具体，审核和后续维护越快：

```text
作品：一句话说明玩什么、给谁玩
入口：打开后从哪里开始，主流程怎么走完
选用功能：如 登录、内购（商品：复活币 ×1，按次）、排行榜（通关用时，越短越好）
服务模块：各功能的调用点在哪个文件、哪个函数
已自测：上面的自检做了哪些，结果如何；没做的写「未测」
已知问题：还没解决的
```

不要求填写技术字段，也不需要把源码贴进说明里。