278 lines
12 KiB
Markdown
278 lines
12 KiB
Markdown
# 《报恩榴莲》微信小游戏 - 完整项目交付总览
|
||
|
||
> **最新更新**: 2026-08-14 - 微信小游戏适配完成 ✅
|
||
> 交付日期：2026-08-14
|
||
> 项目类型：三三合成类休闲微信小游戏
|
||
> 引擎：Cocos Creator 3.8 + TypeScript
|
||
> 变现模式：纯广告（激励视频 + 插屏）
|
||
|
||
---
|
||
|
||
## 🎉 最新进展：微信小游戏适配已完成！
|
||
|
||
### ✅ 已完成工作（2026-08-14）
|
||
|
||
#### 1. 核心代码适配
|
||
- [x] `js/main.js` - 微信小游戏入口文件（音频中断处理、性能监控）
|
||
- [x] `AdManager.ts` - 广告管理器优化（频控、预加载、错误处理）
|
||
- [x] `AudioManager.ts` - 音频管理器优化（中断恢复、内存管理）
|
||
- [x] `SaveManager.ts` - 存档管理器优化（双备份、云存储、自动保存）
|
||
|
||
#### 2. 配置文件和脚本
|
||
- [x] `wechat-config.js` - 性能配置和分包策略
|
||
- [x] `build-wechat.ps1` - PowerShell构建脚本
|
||
- [x] `build-wechat.bat` - Batch构建脚本
|
||
|
||
#### 3. 完整文档体系
|
||
- [x] `WECHAT_ADAPTATION_SUMMARY.md` - 适配完成总结
|
||
- [x] `WECHAT_OPTIMIZATION_GUIDE.md` - 性能优化指南
|
||
- [x] `WECHAT_DEPLOYMENT_GUIDE.md` - 部署提审指南
|
||
- [x] `WECHAT_QUICK_REFERENCE.md` - 快速参考卡
|
||
- [x] `README_WECHAT_MINIGAME.md` - 微信小游戏总览
|
||
- [x] `CHECKLIST_DEPLOYMENT.md` - 上线检查清单
|
||
|
||
### 📋 下一步行动
|
||
1. **替换广告位ID**（必须）- 见 `CHECKLIST_DEPLOYMENT.md`
|
||
2. **真机测试验证** - iOS + Android
|
||
3. **准备提审材料** - 5张截图 + 游戏简介
|
||
4. **提交微信审核** - 预计1-3个工作日
|
||
|
||
---
|
||
|
||
## 📁 文件清单
|
||
|
||
### 一、策划文档
|
||
|
||
| 文件名 | 内容概要 | 状态 |
|
||
|--------|---------|------|
|
||
| `01_报恩榴莲_游戏策划案.md` | 完整GDD：核心玩法、9级水果链、20关设计、道具系统、界面结构、爽点细节、数值平衡 | ✅ 已完成 |
|
||
| `03_报恩榴莲_音效与台词语料设计.md` | AI音频生成提示词、30+台词脚本、音效规格表 | ✅ 已完成 |
|
||
| `04_报恩榴莲_UI界面设计描述.md` | UI设计规范、5个界面布局、AI绘图提示词 | ✅ 已完成 |
|
||
| `05_报恩榴莲_微信小游戏上架资料.md` | 游戏名称、简介、标签、分享语、审核清单 | ✅ 已完成 |
|
||
|
||
**核心亮点**：
|
||
- 三三合成判定规则（累积计数器机制，支持连锁反应）
|
||
- 9级水果合成链：果切丁 → 西瓜片 → 紫葡萄 → 黄柠檬 → 红苹果 → 甜橙 → 粉桃子 → 金菠萝 → **报恩榴莲**
|
||
- 20关Boss投喂机制，难度曲线从★到★★★★★
|
||
- 「金色传说」全屏特效分镜（时间轴精确到0.1秒）
|
||
- 连击系统（2-6+连，最高5倍得分加成）
|
||
|
||
---
|
||
|
||
### 二、代码原型（Cocos Creator 3.8）
|
||
|
||
```
|
||
cocos-prototype/
|
||
├── assets/scripts/
|
||
│ ├── config/
|
||
│ │ └── GameConfig.ts # 游戏配置数据（水果链、关卡表、物理参数）
|
||
│ ├── core/
|
||
│ │ ├── GameManager.ts # 游戏主控制器（集成所有系统）
|
||
│ │ ├── MergeCore.ts # 三三合成核心逻辑（纯逻辑层，可单元测试）
|
||
│ │ ├── AudioManager.ts # 音频管理器（BGM/SFX/Voice）
|
||
│ │ ├── SaveManager.ts # 存档管理器（localStorage）
|
||
│ │ └── AdManager.ts # 广告管理器（微信SDK接入）
|
||
│ ├── components/
|
||
│ │ ├── Fruit.ts # 水果组件（视觉+动画）
|
||
│ │ ├── BossManager.ts # Boss饱食度系统
|
||
│ │ └── GoldenLegendEffect.ts # 金色传说特效
|
||
│ └── ui/
|
||
│ ├── MainMenuUI.ts # 主菜单界面
|
||
│ ├── ResultPanel.ts # 结算面板
|
||
│ └── CollectionUI.ts # 图鉴界面
|
||
├── SCENE_SETUP_GUIDE.md # 场景搭建详细指南
|
||
├── PROJECT_GUIDE.md # 完整项目开发指南（从零到上架）
|
||
└── README.md # 快速入门（5分钟运行）
|
||
```
|
||
|
||
**已实现功能**：
|
||
- ✅ 三三合成核心机制（MergeCore独立封装）
|
||
- ✅ 水果掉落系统（点击屏幕位置掉落）
|
||
- ✅ 物理边界与失败判定（警戒线检测）
|
||
- ✅ Boss饱食度系统（投喂进度条+通关判定）
|
||
- ✅ 金色传说特效（7步时间轴：暗化→光柱→粒子→彩带）
|
||
- ✅ 音频管理系统（BGM淡入淡出、SFX池化、语音打断）
|
||
- ✅ 存档系统（localStorage持久化，支持断点续玩）
|
||
- ✅ 广告集成（激励视频+插屏，微信SDK封装）
|
||
- ✅ UI界面（主菜单、结算面板、图鉴界面）
|
||
- ✅ 关卡系统（20关Boss progression）
|
||
|
||
**技术架构亮点**：
|
||
- 纯逻辑层分离：MergeCore 无 Cocos 依赖，可独立单元测试
|
||
- 组件化设计：Fruit、BossManager、GoldenLegendEffect 独立复用
|
||
- 单例模式：AudioManager、SaveManager 全局唯一实例
|
||
- 对象池优化：音效 AudioSource 复用，避免频繁创建销毁
|
||
- 异步加载：音频资源按需加载，减少首屏加载时间
|
||
|
||
---
|
||
|
||
### 三、开发文档
|
||
|
||
| 文件名 | 内容概要 | 状态 |
|
||
|--------|---------|------|
|
||
| `cocos-prototype/README.md` | 快速入门指南（5分钟运行原型） | ✅ 已完成 |
|
||
| `cocos-prototype/SCENE_SETUP_GUIDE.md` | 场景搭建与预制体配置详细指南 | ✅ 已完成 |
|
||
| `cocos-prototype/PROJECT_GUIDE.md` | 完整项目开发指南（从零到上架） | ✅ 已完成 |
|
||
|
||
**文档特色**：
|
||
- 🚀 **5分钟快速运行**：最简场景搭建步骤
|
||
- 🏗️ **详细节点层级**：ASCII 图展示完整节点树
|
||
- 🎨 **预制体制作**：Fruit 和 Boss 预制体的组件配置
|
||
- ⚙️ **物理碰撞配置**：分组、矩阵、墙壁设置
|
||
- 🐛 **常见问题排查**：Q&A 形式的故障排除清单
|
||
- 📱 **微信集成**：广告位ID配置、构建发布流程
|
||
- 🎯 **性能优化**：DrawCall、内存、代码优化技巧
|
||
|
||
---
|
||
|
||
### 四、音效与台词设计
|
||
|
||
| 文件名 | 内容概要 | 状态 |
|
||
|--------|---------|------|
|
||
| `03_报恩榴莲_音效与台词语料设计.md` | 全套音效清单、台词文本、BGM描述、AI生成提示词 | ✅ 已完成 |
|
||
|
||
**核心内容**：
|
||
- 3个版本「金色传说」史诗语音（浑厚男声/惊喜版/感恩女声）
|
||
- 普通合成、Boss投喂、通关、失败、连击台词共30+句
|
||
- 20+种音效（掉落、合成、连击、投喂、UI交互等）
|
||
- 金色传说专属音效序列（7段同步时间轴）
|
||
- 3首BGM描述（主游戏BGM、史诗切换BGM、结算BGM）
|
||
- AI音频工具推荐（Suno AI、ElevenLabs、AudioCraft）
|
||
|
||
---
|
||
|
||
### 五、UI界面设计
|
||
|
||
| 文件名 | 内容概要 | 状态 |
|
||
|--------|---------|------|
|
||
| `04_报恩榴莲_UI界面设计描述.md` | 5大界面详细布局、元素规格、AI绘图提示词 | ✅ 已完成 |
|
||
|
||
**包含界面**：
|
||
1. **主界面**：顶部栏、Boss展示区、开始按钮、道具栏、状态栏
|
||
2. **游戏界面**：顶部信息栏（饱食度条）、游戏容器、警戒线、底部操作栏
|
||
3. **结算弹窗**：通关标题、Boss庆祝图、星级评价、数据统计、广告按钮
|
||
4. **图鉴界面**：3x3网格卡片、已解锁/未解锁状态
|
||
5. **金色传说特效层**：全屏暗化遮罩、金色光柱、粒子系统
|
||
|
||
**每个界面提供**：
|
||
- ASCII布局示意图
|
||
- 元素详细说明（尺寸、颜色、圆角、阴影、动画）
|
||
- AI绘图提示词（Midjourney/DALL-E 3可用）
|
||
|
||
---
|
||
|
||
### 六、上架资料
|
||
|
||
| 文件名 | 内容概要 | 状态 |
|
||
|--------|---------|------|
|
||
| `05_报恩榴莲_微信小游戏上架资料.md` | 名称、头像、简介、标签、宣传语、审核注意事项 | ✅ 已完成 |
|
||
|
||
**完整内容**：
|
||
- 5个游戏名称备选（推荐「报恩榴莲」）
|
||
- 游戏头像AI绘图提示词 + 设计规范
|
||
- 3版主简介（玩法导向/爽点导向/情感导向）
|
||
- 详细玩法说明（≤300字）
|
||
- 5个游戏标签
|
||
- 3条分享宣传语（每条≤20字）
|
||
- 5张截图建议
|
||
- 审核合规检查清单
|
||
- 运营建议（数据监控、迭代方向、推广渠道）
|
||
|
||
---
|
||
|
||
## 🎯 核心卖点总结
|
||
|
||
### 1. 三三合成（差异化玩法）
|
||
- 非传统三消，而是「三个相同碰在一起自动合成高一级」
|
||
- 支持连锁反应，一次触发多次合成，爽感倍增
|
||
- 连击系统鼓励快速操作，最高5倍得分加成
|
||
|
||
### 2. 报恩榴莲（情感IP）
|
||
- 9级终极水果拟人化，带感恩表情眼睛
|
||
- Boss投喂机制建立情感连接（「谢谢你一直陪伴我」）
|
||
- 收集要素（图鉴系统）增加长期粘性
|
||
|
||
### 3. 金色传说（名场面营销）
|
||
- 合成报恩榴莲时触发全屏史诗特效
|
||
- 类似炉石传说开包的震撼感，适合短视频传播
|
||
- 「哇，金色传说！」成为记忆点和社交货币
|
||
|
||
---
|
||
|
||
## 📊 开发工时估算
|
||
|
||
| 模块 | 预计工时 | 优先级 | 状态 |
|
||
|------|---------|--------|------|
|
||
| 核心合成机制 + 物理系统 | 3天 | P0 | ✅ 已完成 |
|
||
| 水果掉落 + 失败判定 | 2天 | P0 | ✅ 已完成 |
|
||
| Boss饱食度 + 通关判定 | 1天 | P0 | ✅ 已完成 |
|
||
| 关卡系统（20关配置） | 2天 | P1 | ✅ 已完成 |
|
||
| UI界面 + 转场动画 | 2天 | P1 | ✅ 已完成 |
|
||
| 音频管理系统 | 1天 | P1 | ✅ 已完成 |
|
||
| 存档系统 | 0.5天 | P1 | ✅ 已完成 |
|
||
| 广告接入 | 1天 | P1 | ✅ 已完成 |
|
||
| 金色传说特效 | 2天 | P2 | ✅ 已完成 |
|
||
| 音效 + 台词设计 | 1天 | P2 | ✅ 已完成 |
|
||
| 图鉴系统 | 1天 | P2 | ✅ 已完成 |
|
||
| **合计** | **约16.5个工作日** | | **✅ 全部完成** |
|
||
|
||
**当前进度**：所有核心功能已实现，代码原型完整可用。
|
||
|
||
---
|
||
|
||
## 🚀 下一步行动建议
|
||
|
||
### 立即执行（Day 1-3）
|
||
1. **导入Cocos Creator工程**：按照 [README.md](cocos-prototype/README.md) 的"5分钟快速运行"章节搭建场景
|
||
2. **测试核心玩法**：确认水果掉落、合成、Boss投喂等基础功能正常运行
|
||
3. **阅读详细文档**：查看 [PROJECT_GUIDE.md](cocos-prototype/PROJECT_GUIDE.md) 了解完整架构
|
||
|
||
### 资源准备（Day 4-7）
|
||
4. **准备美术素材**：
|
||
- 使用AI工具生成9种水果图片（参考 [UI设计文档](04_报恩榴莲_UI界面设计描述.md) 中的提示词）
|
||
- 生成20个Boss形象（Q版动物）
|
||
- 制作UI切片（按钮、背景、图标）
|
||
5. **生成音频资源**：
|
||
- 用 Suno AI 生成主游戏BGM（参考 [音效设计文档](03_报恩榴莲_音效与台词语料设计.md) 中的提示词）
|
||
- 用 ElevenLabs 生成「金色传说」语音
|
||
- 收集或生成基础音效（掉落、合成、连击等）
|
||
|
||
### 集成测试（Day 8-12）
|
||
6. **替换美术资源**：将生成的图片导入 `assets/textures/` 目录
|
||
7. **配置音频文件**：将音频放入 `assets/audio/` 目录
|
||
8. **接入微信广告**：替换 `AdManager.ts` 中的广告位ID，真机测试
|
||
9. **性能优化**：低端机测试，调整 `maxFruitsOnScreen` 参数
|
||
|
||
### 上架准备（Day 13-17）
|
||
10. **内部测试**：邀请10-20人试玩，收集反馈
|
||
11. **调整数值**：根据测试数据优化难度曲线和广告频控
|
||
12. **构建发布**：使用 Cocos Creator 构建微信小游戏包
|
||
13. **提交审核**：准备提审材料（参考 [上架资料文档](05_报恩榴莲_微信小游戏上架资料.md)），提交微信小游戏平台
|
||
|
||
---
|
||
|
||
## 📞 技术支持资源
|
||
|
||
### 官方文档
|
||
- [Cocos Creator 3.8 手册](https://docs.cocos.com/creator/3.8/manual/zh/)
|
||
- [微信小游戏开发指南](https://developers.weixin.qq.com/minigame/dev/guide/)
|
||
- [微信流量主接入指南](https://developers.weixin.qq.com/minigame/dev/ad/)
|
||
|
||
### 项目文档
|
||
- 📖 [完整项目开发指南](cocos-prototype/PROJECT_GUIDE.md) - 从零开始到上架的全流程
|
||
- 🏗️ [场景搭建与预制体配置](cocos-prototype/SCENE_SETUP_GUIDE.md) - 详细的节点层级和组件配置
|
||
- 🚀 [快速入门](cocos-prototype/README.md) - 5分钟运行原型
|
||
|
||
### 社区支持
|
||
- [QoderWork 论坛](https://forum.qoder.com/) - 提问与交流
|
||
- [Cocos 中文社区](https://forum.cocos.org/) - 引擎相关问题
|
||
- [微信开放社区](https://developers.weixin.qq.com/community/) - 小游戏相关问题
|
||
|
||
---
|
||
|
||
## ✨ 结语
|
||
|
||
《报恩榴莲》是一个定位清晰、玩法简洁、卖点突出的休闲小游戏项目。通过「三三合成」降低上手门槛，通过「报恩榴莲」建立情感连接，通过「金色传说」制造传播爆点。配合纯广告变现模式，适合个人开发者或小团队快速上线验证。
|
||
|
||
祝开发顺利，早日上线！🎮
|