# 炭火小食铺

**Repository Path**: mrjkchen/ember-skewer-studio

## Basic Information

- **Project Name**: 炭火小食铺
- **Description**: 原创 AI 美术素材与 Cocos Creator 3.8.8 制作的一屏可玩烧烤小游戏，优先验证画面、烤制与上菜动效。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-16
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 炭火小食铺

一屏可玩的原创烧烤小游戏。Cocos Creator 3.8.8 + TypeScript，先验证美术、动作反馈和操作手感。

## 0.2.0 美术对照

新增可同步操作的 A/B 对照：AI 二维重绘与 Blender 统一预渲染，各含鸡肉串四种熟度、盘子和烤炉。两边使用同一套 Cocos 布局、烤制规则和动效。

运行 `tools/build.ps1 -Config build-config-lab.json`，然后 `npm run serve:lab`，打开 `http://127.0.0.1:8843`。交付包已包含构建，可直接启动服务器。完整制作方法、源模型和限制见 [美术实验说明](docs/ART-LAB.md)。以下为仍保留的 0.1 原版说明。

## 玩法

- 点击烤熟的烤串，自动送到对应订单盘子；电脑可按 `1`–`6`。
- 每单需要两串，完成六单即可收摊。没有倒计时压力，烤串会自动补充。
- 右上角切换音效，也可按 `M`；点击“重新开炉”或按 `R` 重新开始。
- 交互反馈包括曲线飞行、落盘回弹、连单积分、星星、炭火微光、蒸汽与收摊彩纸。

## 运行

1. 用 Cocos Creator **3.8.8** 打开本仓库，等待资源导入。
2. 打开 `assets/scenes/Main.scene`，点击编辑器预览。
3. 或运行 `powershell -ExecutionPolicy Bypass -File tools/build.ps1` 生成 `build/web-mobile`。
4. 在项目目录执行 `npm run serve`，访问 `http://127.0.0.1:8842`。浏览器需要支持 WebGL。

`tools/build.ps1 -Creator "其他路径/CocosCreator.exe"` 可指定编辑器位置。构建配置在 `build-config.json`。本地服务器只绑定 `127.0.0.1`，不是公开部署。

源码仓库不提交 `build`；交付压缩包额外包含经验证的浏览器构建。

## 验证

需要 Node.js 24（测试使用原生 TypeScript 类型剥离）：

```sh
npm test
```

在 Creator 完成首次资源导入后，可使用 TypeScript 编译器执行 `tsc --noEmit`。测试覆盖未烤熟点击、重复点击、重复完成回调、超量订单拒绝、完整六单及重置。

## 目录与架构

| 路径 | 用途 |
| --- | --- |
| `assets/scripts/GameModel.ts` | 无引擎依赖的订单、烤制、预约与计分状态 |
| `assets/scripts/BBQGame.ts` | Cocos 场景构造、输入、动画、声音与界面 |
| `assets/scenes/Main.scene` | 启动场景 |
| `assets/resources/art` | 六张原创 AI 位图及 Creator 导入配置 |
| `assets/resources/sounds` | 五个程序合成原创 WAV 音效 |
| `docs/asset-prompts.json` | 实际使用的 image_gen 提示词 |
| `docs/DECISIONS.md` | 美术规范、实现决策及已解决问题 |
| `tools` | 场景生成、素材导入配置、音频生成、构建与本地服务器 |
| `tests` | 游戏状态边界测试 |

图片使用内置 image_gen 生成；界面文字、面板、星星和小粒子由 Cocos 渲染。素材未取自参考商品。透明图片保留原始 PNG，在 Cocos 导入阶段裁剪极低 Alpha 的空白边界。

## 当前范围

本版只有一屏、三种食物和六张订单。没有广告、付费、账号、联网服务、真实玩家数据或存档；刷新会重置。未进行抖音上传、提审、真机验收或公开部署。测试详情见 `docs/VALIDATION.md`。

## 协作与同步

仓库： https://gitee.com/mrjkchen/ember-skewer-studio

修改前读取 `AGENTS.md`。每次更新通过对应验证后 commit/push，检查本地与远程 SHA 一致。不要提交缓存、日志、密钥和构建产物。