1
suifeng666 OP 第一个版本的开发文档,由 chatgpt 的 O3 模型进行生成。
# Coldplay Canoodlers Plus – MVP 开发文档(基础版本) [一] 项目目标 • 在网页端实现最小可玩版本,让玩家点击观众席找出情侣并播放短视频。 • 总包体≤10 MB ,移动端可流畅运行。 • 代码、资源与流程尽可能借助 AI 自动化/加速。 [二] 功能范围( MVP ) 1. 单一关卡( Coldplay 原始片段观众席)。 2. 点击命中检测:命中情侣 → 播放视频;误点无反馈。 3. 计时成绩:完成时间 ms 。 4. 本地排行榜:使用 localStorage 保存前 10 成绩。 5. 基础 UI:开始页、游戏页、结果页。 6. 音视频兼容:首触发播放、移动端静音策略。 [三] 技术栈选择 • 前端框架:Vite + Phaser 3 + TypeScript 。 • 构建部署:Vercel (零配置、自动 CI )。 • AI 辅助: – OpenAI API / GPT‑4o:生成代码片段、注释、提示文本。 – SDXL + Pixel‑art Diffusion:批量生成像素观众(可选)。 • 分析:Plausible 自建实例(简单事件埋点)。 [四] AI 在开发中的角色 1. 代码生成:使用 ChatGPT 编写场景、命中逻辑、UI 组件草稿。 2. 资产生成:提示 "pixel art crowd cheering in stadium top‑down" 生成占位图;用 DALL·E 或 SDXL 。 3. 问题排查:将错误栈复制给 GPT 获取修复步骤。 [五] 项目目录结构 ``` / 项目根 ├─public/ favicon 、manifest ├─assets/ │ ├─crowd/ 观众像素图 │ ├─video/ coldplay_clip.mp4 │ └─data/ levels.json ├─src/ │ ├─main.ts 入口,创建游戏 │ ├─game.ts Phaser 配置 │ ├─scenes/ Boot, Menu, Play, Result │ └─utils/ hitTest.ts, timer.ts └─vite.config.ts ``` [六] 数据文件示例( levels.json ) ``` [ { "id": "coldplay‑01", "image": "/assets/crowd/coldplay_a.png", "video": "/assets/video/coldplay_clip.mp4", "targets": [{ "x": 432, "y": 188, "r": 30 }] } ] ``` [七] 任务拆解 & 时间预估(单位:人日) | 阶段 | 目标 | 任务 | 预计 | AI 介入 | | ------ | ---------------- | -------------------------- | ---------- | --------- | | 0 环境 | 跑通 Hello Phaser | Node/Vite/TS 配置 | 0.5 | GPT 配置脚本 | | 1 画面 | 加载观众图,点击打印坐标 | BootScene, PlayScene 骨架 | 1 | GPT 生成代码 | | 2 命中 | 判断命中并圈选 | hitTest 、绘制圆环 | 1 | GPT 调试算法 | | 3 视频 | 命中后播放 mp4 | DOM overlay 或 Phaser Video | 0.5 | GPT 解决兼容 | | 4 计时 | 计时 & 结果页 | Timer util, ResultScene | 0.5 | GPT UI 文案 | | 5 排行 | localStorage 排行榜 | 排序、存取、展示 | 0.5 | GPT 代码改写 | | 6 部署 | Vercel 自动构建 | github → vercel | 0.5 | GPT CI 脚本 | | **合计** | 基础可玩上线 | — | **4–5 人日** | 全程辅助 | [八] 交付物 1. Git 仓库( MIT License )。 2. 线上演示 URL 。 3. README 含快速启动、Prompt 示例。 4. 未来迭代清单。 [九] 风险&对策 * 版权:使用像素化+改名处理;视频走 YouTube embed 规避包体。 * 移动自动播放:首触发后加载音视频。 * 包体超限:图像 WebP 压缩、视频 <3 MB 。 [十] 下一步升级方向(仅列题目) • 多关卡、道具系统、Supabase 在线排行、社交分享、激励广告、自动 AI 生成新关卡。 |