这是 Word Tetris（单词俄罗斯方块）游戏的 Cocos Creator 版本，从原始的 HTML5 Canvas 版本迁移而来。
原始项目位置：../proj/
设计文档：../word_tetris_game_design.md
- ✅ 环境准备完成
- ✅ 项目结构规划完成
- ✅ 资源迁移方案完成
- ✅ 核心逻辑迁移方案完成
- 🔄 渲染系统迁移（待实现）
- 🔄 UI 系统重建（待实现）
- 🔄 音频系统适配（待实现）
- 🔄 测试与优化（待实现）
完整的迁移文档位于 docs/ 目录：
- 迁移总览 - 从这里开始！
- 环境准备 - Cocos Creator 安装配置
- 项目结构设计 - 目录组织和场景设计
- 资源迁移指南 - 单词库、音频、图片迁移
- 核心逻辑迁移 - 游戏代码迁移
- 渲染系统改造 - Canvas 到节点系统
- UI 系统重建 - DOM 到 Cocos UI
- 音频系统适配 - TTS 和音频缓存
- 测试验证清单 - 完整测试方案
- 常见问题FAQ - 故障排查
- Cocos Creator: 3.8.3 或更高版本
- Node.js: v16 或更高版本
- TypeScript: 项目自带配置
- 操作系统: Windows 10/11, macOS, Linux
-
安装 Cocos Creator
# 下载并安装 Cocos Dashboard # https://www.cocos.com/creator-download
-
打开项目
# 在 Cocos Creator 中打开本项目 # 文件 → 打开项目 → 选择此目录
-
安装依赖
cd proj-cocos npm install -
运行测试
# 在 Cocos Creator 中点击"预览"按钮 # 或使用快捷键 Ctrl+P
proj-cocos/
├── assets/ # 资源目录
│ ├── scenes/ # 场景文件
│ ├── scripts/ # TypeScript 脚本
│ ├── prefabs/ # 预制体
│ ├── resources/ # 动态加载资源
│ ├── textures/ # 纹理资源
│ └── animations/ # 动画资源
│
├── build/ # 构建输出（自动生成）
├── library/ # 编译缓存（自动生成）
├── temp/ # 临时文件（自动生成）
│
├── docs/ # 迁移文档
│ ├── 01_迁移总览.md # 迁移路线图
│ ├── 02_环境准备.md # 环境配置
│ ├── 03_项目结构设计.md # 目录组织
│ ├── 04_资源迁移指南.md # 资源处理
│ ├── 05_核心逻辑迁移.md # 代码迁移
│ ├── 06_渲染系统改造.md # 渲染系统
│ ├── 07_UI系统重建.md # UI 系统
│ ├── 08_音频系统适配.md # 音频系统
│ ├── 09_测试验证清单.md # 测试方案
│ ├── 10_常见问题FAQ.md # 问题排查
│ ├── QUICK_START.md # 快速开始 ⚡
│ ├── MIGRATION_PROGRESS.md # 进度跟踪 📊
│ ├── Game-Layout-Reference.md # UI 布局 🎨
│ ├── README.md # 文档索引
│ └── 快速参考.md # API 速查
│
├── package.json # npm 依赖配置
├── tsconfig.json # TypeScript 配置
├── project.json # Cocos 项目配置
├── .gitignore # Git 忽略配置
└── README.md # 本文件
- ✅ 单词顺序下降系统
- ✅ 缓冲区倒计时（红黄绿信号灯）
- ✅ 字母缺失和实时输入验证
- ✅ 炮管自动瞄准和射击
- ✅ 爆炸粒子效果
- ✅ 中文翻译爆炸动画
- ✅ 堆叠区管理
- ✅ 分数和等级系统
- ✅ 三级层级化词库（按天/专项/年级）
- ✅ TTS 语音朗读（多提供商降级）
- ✅ 单词图片展示（视觉记忆）
- ✅ 重音音节高亮（发音学习）
- ✅ 生词本管理
- ✅ 考试统计系统
- ✅ 休闲模式（有字母提示）
- ✅ 挑战模式（无提示）
- Cocos Creator 3.8.3 - 主要开发工具
- Visual Studio Code - 代码编辑器
- Chrome - 调试浏览器
- Cocos Creator Extension
- ESLint
- Prettier
- TypeScript Importer
- GitLens
- 使用 TypeScript
- 遵循 ESLint 规则
- 组件类使用
@ccclass装饰器 - 属性使用
@property装饰器 - 遵循 Cocos Creator 生命周期
# 在 Cocos Creator 中
# 菜单 → 项目 → 构建发布
# 选择平台：Web Mobile/Desktop
# 点击"构建"# 需要安装 Android Studio 和 SDK
# 构建平台选择：Android# 需要 macOS 和 Xcode
# 构建平台选择：iOS-
项目无法打开
- 检查 Cocos Creator 版本（需要 3.8.x）
- 删除
library/和temp/目录后重新打开
-
预览白屏
- 打开浏览器控制台查看错误
- 检查场景中是否有 Canvas 节点
-
TypeScript 编译错误
- 检查
tsconfig.json配置 - 运行
npm install安装依赖
- 检查
-
资源加载失败
- 检查资源路径是否正确
- 确认资源在
resources/目录下
更多问题请查看 文档 FAQ（待完成）
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
- 确保所有功能符合设计文档
- 遵循代码规范
- 添加必要的注释
- 通过所有测试
本项目继承原项目的许可证。
如有问题或建议，请：
- 提交 Issue
- 发起 Discussion
- 查看文档
感谢所有为 Word Tetris 项目做出贡献的开发者！
- ✅ 完成主界面移植到 proj-cocos
- ✅ 创建完整目录结构
- ✅ 创建核心脚本框架（GameManager, GameConfig）
- ✅ 创建类型定义（Word, GameState）
- ✅ 创建参考文档（UI 布局、迁移进度、快速开始）
- ✅ 所有说明文档迁移到 docs/
- ✅ 创建 Cocos Creator 项目
- ✅ 完成迁移文档编写
- 🔄 开始代码迁移工作
开始你的 Cocos Creator 开发之旅！ 🚀
⚡ 快速了解项目：docs/QUICK_START.md
📊 查看迁移进度：docs/MIGRATION_PROGRESS.md
📖 系统学习迁移：docs/01_迁移总览.md