# 报恩榴莲 - 微信小游戏上线检查清单

## 📋 使用说明

请按顺序完成以下检查项，每完成一项打勾 ✅

---

## 阶段一：开发完成确认

### 核心功能
- [ ] 三三合成玩法实现完成
- [ ] 9级水果链配置完成
- [ ] 20个关卡Boss配置完成
- [ ] Boss饱食度系统正常
- [ ] 通关/失败判定正确
- [ ] 连击系统工作正常
- [ ] 道具系统实现完成

### UI界面
- [ ] 主界面设计完成
- [ ] 游戏界面布局合理
- [ ] 结算面板显示正常
- [ ] 图鉴界面可访问
- [ ] 设置面板功能完整
- [ ] 按钮点击有反馈

### 音频系统
- [ ] BGM能正常播放
- [ ] 音效触发时机正确
- [ ] 音量控制有效
- [ ] 静音功能正常
- [ ] **音频中断处理已实现**（来电暂停/恢复）

### 存档系统
- [ ] 游戏进度自动保存
- [ ] 重新进入能加载存档
- [ ] 最高分记录正确
- [ ] 图鉴解锁状态保持
- [ ] **双备份机制已启用**

---

## 阶段二：微信适配确认

### 代码适配
- [x] `js/main.js` 微信入口文件已创建
- [x] `AdManager.ts` 广告管理器已优化
- [x] `AudioManager.ts` 音频管理器已优化
- [x] `SaveManager.ts` 存档管理器已优化
- [x] `wechat-config.js` 配置文件已创建

### 性能优化
- [x] 对象池管理实现
- [x] GC主动触发机制
- [x] 内存监控代码
- [x] 分包加载配置
- [x] 资源预加载策略

### 构建脚本
- [x] `build-wechat.ps1` 已创建
- [x] `build-wechat.bat` 已创建
- [x] 版本信息自动生成
- [x] 包体大小自动检查

---

## 阶段三：资源配置

### 广告位配置 ⚠️ 必须完成
- [ ] **替换复活广告位ID**（AdManager.ts 第23行）
- [ ] **替换道具广告位ID**（AdManager.ts 第26行）
- [ ] **替换插屏广告位ID**（AdManager.ts 第29行）

**获取广告位ID步骤**：
1. 登录 https://mp.weixin.qq.com/
2. 左侧菜单：推广 → 流量主
3. 创建广告位（需要3个）：
   - 激励视频 - 复活
   - 激励视频 - 道具
   - 插屏广告 - 关卡结束
4. 复制AD Unit ID到代码中

### 美术资源
- [ ] 9种水果图片准备完成
- [ ] 20个Boss形象设计完成
- [ ] UI切片（按钮、背景、图标）完成
- [ ] 特效素材（金色传说）准备完成
- [ ] 游戏图标（200x200 PNG）准备完成

### 音频资源
- [ ] 主游戏BGM制作完成
- [ ] 金色传说BGM制作完成
- [ ] 结算BGM制作完成
- [ ] 音效文件（合成、掉落、连击等）完成
- [ ] 语音台词（金色传说）录制完成

**音频格式要求**：
- BGM: MP3, 128kbps, 立体声
- SFX: MP3, 96kbps, 单声道
- Voice: MP3, 64kbps, 单声道

---

## 阶段四：本地测试

### 模拟器测试（微信开发者工具）
- [ ] 游戏能正常启动（< 3秒）
- [ ] 主界面显示正常
- [ ] 点击「开始游戏」进入关卡
- [ ] 水果掉落和合成逻辑正常
- [ ] Boss饱食度系统工作
- [ ] 通关/失败判定正确
- [ ] 按钮点击有反馈
- [ ] 面板打开/关闭动画流畅
- [ ] 分数实时更新
- [ ] 道具使用正常
- [ ] BGM正常播放
- [ ] 音效触发正常
- [ ] 音量控制有效
- [ ] 静音功能正常
- [ ] 游戏进度自动保存
- [ ] 重新进入游戏能加载存档
- [ ] 最高分记录正确
- [ ] 图鉴解锁状态保持

### 真机测试（必须！）

#### iOS设备测试
- [ ] iPhone 8或以上测试通过
- [ ] 游戏启动时间 < 3秒
- [ ] 帧率稳定 60 FPS
- [ ] 内存占用 < 200 MB
- [ ] 触摸响应灵敏
- [ ] 音频播放正常
- [ ] **广告能正常展示**（激励视频）
- [ ] **广告能正常展示**（插屏）
- [ ] 观看完广告奖励发放
- [ ] 音频中断后能恢复

#### Android设备测试
- [ ] 中高端机型测试通过
- [ ] 游戏启动时间 < 3秒
- [ ] 帧率稳定 60 FPS
- [ ] 内存占用 < 300 MB
- [ ] 触摸响应灵敏
- [ ] 音频播放正常
- [ ] **广告能正常展示**
- [ ] 观看完广告奖励发放
- [ ] 音频中断后能恢复

#### 低端机测试（可选但推荐）
- [ ] 降级到30 FPS后流畅运行
- [ ] 减少水果数量后不卡顿
- [ ] 内存占用可控（不崩溃）

---

## 阶段五：性能验证

### 包体检查
- [ ] 主包大小 ≤ 20MB
- [ ] 总包大小 ≤ 200MB
- [ ] 资源文件已压缩

**检查命令**：
```bash
# 查看总大小
powershell -Command "(Get-ChildItem build/wechatgame -Recurse | Measure-Object -Property Length -Sum).Sum / 1MB"

# 查看主包大小（排除subpackages）
powershell -Command "(Get-ChildItem build/wechatgame -Exclude subpackages -Recurse | Measure-Object -Property Length -Sum).Sum / 1MB"
```

### 性能指标
- [ ] FPS 稳定 60（或低端机30）
- [ ] 内存占用 < 200MB（iOS）
- [ ] 内存占用 < 300MB（Android）
- [ ] Draw Calls < 100
- [ ] 启动时间 < 3秒
- [ ] 无内存泄漏（长时间运行测试）

### 压力测试
- [ ] 连续游玩30分钟不崩溃
- [ ] 切换场景10次无问题
- [ ] 快速点击按钮无异常
- [ ] 网络断开时能正常游戏（单机）

---

## 阶段六：提审材料准备

### 游戏截图（5张）
要求：
- 尺寸：1280x720 或更高
- 格式：PNG 或 JPG
- 内容：真实 gameplay 截图

建议包含：
- [ ] 截图1：主界面
- [ ] 截图2：游戏进行中（水果合成）
- [ ] 截图3：金色传说特效瞬间
- [ ] 截图4：Boss投喂界面
- [ ] 截图5：结算面板

### 游戏简介
```
《报恩榴莲》是一款创新的三三合成益智小游戏。

玩法特色：
🎮 三个相同水果碰在一起自动合成更高级水果
🍉 9级水果链，终极形态是拟人化报恩榴莲
👾 20个可爱Boss，投喂它们通关
✨ 合成终极水果触发「金色传说」史诗特效
💎 收集图鉴，解锁所有水果形态

轻松休闲，适合碎片时间游玩~
```

### 其他材料
- [ ] 游戏分类：休闲 → 益智
- [ ] 游戏图标：200x200 PNG
- [ ] 隐私政策链接（如需要）
- [ ] 测试账号（如需要，本游戏不需要）

---

## 阶段七：上传和提交

### 上传版本
- [ ] 构建最终版本
  ```bash
  .\build-wechat.ps1 -Version "1.0.0"
  ```

- [ ] 用微信开发者工具打开 `build/wechatgame`

- [ ] 点击「上传」按钮
  - 版本号：1.0.0
  - 版本备注：
    ```
    v1.0.0 首次提交
    - 核心三三合成玩法
    - 20个关卡
    - 广告系统接入
    - 存档系统
    ```

- [ ] 等待上传完成（1-5分钟）

### 提交审核
- [ ] 登录 [微信公众平台](https://mp.weixin.qq.com/)
- [ ] 左侧菜单：管理 → 版本管理
- [ ] 找到刚上传的版本，点击「提交审核」
- [ ] 填写审核信息：
  - [ ] 功能页面列表
  - [ ] 游戏简介
  - [ ] 分类选择（休闲 → 益智）
  - [ ] 上传5张截图
  - [ ] 补充说明（可选）
- [ ] 确认无误后点击「提交」

---

## 阶段八：审核期间

### 监控审核状态
- [ ] 每日登录后台查看审核进度
- [ ] 如有驳回，根据反馈修改
- [ ] 审核通过后，准备发布

### 准备运营计划
- [ ] 设计分享诱因文案
- [ ] 准备微信群推广素材
- [ ] 规划第一版迭代内容
- [ ] 设置数据监控看板

---

## 阶段九：发布上线

### 灰度发布（推荐）
- [ ] 点击「灰度发布」
- [ ] 设置比例：10%
- [ ] 观察24-48小时数据
- [ ] 无问题后全量发布

### 全量发布
- [ ] 点击「全量发布」
- [ ] 等待发布完成（约1小时）
- [ ] 用户可搜索到游戏

---

## 阶段十：发布后监控

### 每日检查
- [ ] 查看新增用户数
- [ ] 查看活跃用户数
- [ ] 查看留存率
- [ ] 查看广告收入
- [ ] 查看崩溃率（目标 < 1%）
- [ ] 查看用户反馈

### 每周分析
- [ ] 分析留存率趋势
- [ ] 分析广告eCPM
- [ ] 分析关卡通过率
- [ ] 收集用户建议
- [ ] 规划下周迭代

### 关键指标目标
| 指标 | 目标值 | 当前值 |
|------|--------|--------|
| 次日留存 | > 30% | ___% |
| 7日留存 | > 10% | ___% |
| 平均时长 | > 5min | ___min |
| 广告完成率 | > 60% | ___% |
| eCPM | > ¥50 | ¥___ |
| 崩溃率 | < 1% | ___% |

---

## 🎯 里程碑检查

### MVP版本（最低可行产品）
- [x] 核心三三合成玩法
- [x] 5个基础关卡
- [x] 基础UI界面
- [x] 简单存档
- [ ] 广告接入
- [ ] 真机测试通过

**预计完成时间**: _______

### v1.0.0（正式发布）
- [ ] 完整20个关卡
- [ ] 9级水果链
- [ ] Boss系统
- [ ] 完整存档
- [ ] 广告系统
- [ ] 音效配音
- [ ] 金色传说特效
- [ ] 图鉴系统
- [ ] 审核通过

**预计完成时间**: _______

### v1.1.0（第一次迭代）
- [ ] 新增10个关卡
- [ ] 新增3种道具
- [ ] 优化新手引导
- [ ] 修复已知bug

**预计完成时间**: _______

---

## 📝 备注区

### 遇到的问题及解决方案
```
日期: _______
问题: 
解决: 
```

### 待优化事项
```
1. 
2. 
3. 
```

### 用户反馈记录
```
日期: _______
反馈: 
处理: 
```

---

## ✨ 完成庆祝

当所有检查项都打勾后，恭喜你！

🎉 《报恩榴莲》正式上线微信小游戏平台！

接下来：
- 持续监控数据
- 快速迭代优化
- 收集用户反馈
- 规划新内容

祝游戏大获成功！🚀🍈💰

---

**检查清单版本**: v1.0  
**最后更新**: 2026-08-14  
**适用项目**: 报恩榴莲微信小游戏