玩法	类型	教材单元 / 描述	状态
数据冲刺	闯关答题	多位数加减 · 单元三	✅
余数农场	闯关答题	有余数除法 · 单元一	✅
霓虹冲塔	倒计时挑战 + BOSS 战	30 层 + combo + 超频 + 数据魔王	✅
错题反击	复盘	自动复盘做错的题（错题集动态生成）	✅
每日挑战	每日 5 题	按日期 seed 全员同题 + 连签机制	✅
霓虹工坊	—	解决问题 · 单元四	待开发

「数据冲刺 / 余数农场」核心循环：

主菜单选玩法 → 弹出难度浮层（L1 入门 / L2 进阶 / L3 高难 / 混合）
每局 10 道题，3 命，按难度过滤抽取
屏幕顶部题目 + 中部 3 选项 + 底部赛道（玩家 marker 随进度推进）
答对 → 像素小机器人跳跃 + 背景加速 + 高频升调 beep
答错 → 小机器人旋转拌一下 + 屏幕震 + 低频降调 boop
通关 → C-E-G-高 C 上升音阶 + 结算页 + 自动解锁皮肤/成就/新玩法

「霓虹冲塔」核心循环（上瘾模式 + BOSS 战）：

直接进（不选难度）—— 题库混合数据冲刺 + 余数农场全部 60 题
30 层塔向上爬，每题 8 秒倒计时（环形可视化 + 最后 3 秒滴答声）
答对爬 1 层 + combo+1；答错 / 超时摔 3 层 + combo 归 0
连击 ≥ 5 进入「超频模式」：速度线滚动 + 粒子喷射 + 倒计时缩到 5.5 秒 + 双倍分
登顶 30 层 → BOSS 战 · 数据魔王
- 屏幕右上角浮现像素 BOSS（24×18 程序绘制 + 飘浮动画）
- BOSS HP 5 段，玩家 HP 3 颗心
- 答对扣 BOSS HP 1 + BOSS 闪红 + 屏震 + 黄色粒子爆炸
- 答错扣玩家 HP 1 + BOSS 冲撞玩家 + 大屏震 + 红光闪
- 杀死 BOSS → 真通关 + 解锁皮肤/成就；玩家 HP 0 → 战败重玩

「错题反击」：

自动从持久化错题集（SaveGame.mistakes）抽题，每局 5 题
答对 → 自动从错题集移除（征服了一道）；答错 → 错次数 +1
错题集为空时显示提示页

「每日挑战」：

按日期 seed（year10000+month100+day）从合并题库（60 题）抽固定 5 题
同一天每位玩家见到同样的题，可比较成绩
通关后 daily_streak 连签 +1（隔天断签则归 1）

技术栈

层	选型
引擎	Godot Engine 4.6.2 stable.official.71f334935
语言	GDScript
渲染器	Forward Plus
视口	1280×720（stretch `canvas_items/keep`）
音频	`AudioStreamWAV` 程序合成 BGM + SFX（无外部音效资源；自带 cyberpunk loop / menu loop）
美术	`Image` API 生成 32×32 像素 sprite（卡通小学生 + 可爱怪兽）+ Polygon2D 矢量背景（太阳/云/山/草地）+ ColorRect 拼装 UI
Shader	已废弃（V0.7 起改扁平无发光，shader 文件保留作历史）
平台	macOS / Windows / Linux 桌面

项目结构

zhaoyixun-mathematics-game/
├── project.godot           # Godot 项目配置（main_scene → scenes/MainMenu.tscn）
├── Main.tscn               # 旧入口（保留作占位，未使用）
├── icon.svg                # 占位图标
├── README.md               # ← 本文件
├── CLAUDE.md               # 项目级 AI 协同说明
├── .gitignore
├── scenes/
│   ├── MainMenu.tscn         # 主菜单（玩法盒子 + 难度/成就/皮肤浮层）
│   ├── RunGame.tscn          # 数据冲刺
│   ├── RemainderFarm.tscn    # 余数农场（继承 RunGame）
│   ├── NeonTower.tscn        # 霓虹冲塔（独立倒计时玩法 + BOSS 战）
│   ├── ReviewMode.tscn       # 错题反击（继承 RunGame）
│   └── DailyChallenge.tscn   # 每日挑战（继承 RunGame）
├── scripts/
│   ├── Globals.gd            # Autoload：current_difficulty
│   ├── SaveGame.gd           # Autoload：持久化 + 解锁 + 错题集 + 每日连签
│   ├── AudioSynth.gd         # Autoload：程序合成 BGM + 11 种 SFX
│   ├── MainMenu.gd           # 主菜单（3×2 玩法卡 + 难度/成就/皮肤面板）
│   ├── RunGame.gd            # 闯关游戏父类（像素 sprite / 跑酷 / 进度 / 错题钩子）
│   ├── RemainderFarm.gd      # 余数农场（继承 RunGame）
│   ├── NeonTower.gd          # 霓虹冲塔（独立 30 层塔 + combo + 超频 + BOSS 战）
│   ├── ReviewMode.gd         # 错题反击（继承 RunGame，覆盖 _get_question_pool）
│   └── DailyChallenge.gd     # 每日挑战（继承 RunGame，按日期 seed）
├── data/
│   ├── questions-add-sub.json   # 多位数加减题库（30 题 × 3 难度）
│   └── questions-remainder.json # 有余数除法题库（30 题 × 3 难度）
├── shaders/
│   └── neon_outline.gdshader    # 霓虹外发光 (alpha 距离场扩张)
└── assets/                      # 外部美术资源占位（CC0 / 自制 / AI 生成 + 手工修）
└── docs/
    ├── grade2-overview.md              # 二年级全科目大纲（学情上下文）
    ├── math-grade2-2025-2026.md        # 数学总入口/索引
    ├── math-grade2-上册.md             # 数学上册（已学完）
    ├── math-grade2-下册.md             # 数学下册（2024 新版，进行中）
    ├── textbook-fact-check-sop.md      # 教材实物核对 SOP（事故复盘）
    ├── setup-godot-mcp.md              # godot-mcp 装机与排错
    └── project-bootstrap.md            # 项目骨架建立记录

项目状态

项	状态
项目骨架	✅ 已建立
Godot MCP 工具链	✅ 已装机
主菜单 + 玩法路由 + 3×2 网格	✅
难度选择	✅ L1 / L2 / L3 / 混合
玩法 1 数据冲刺	✅ V0.2（30 题 × 3 难度）
玩法 2 余数农场	✅ V0.3（30 题 × 3 难度）
玩法 3 霓虹冲塔 + BOSS 战	✅ V0.5（30 层 + combo + 超频 + 数据魔王）
玩法 4 错题反击	✅ V0.5（自动错题集复盘）
玩法 5 每日挑战	✅ V0.5（日期 seed + 连签机制）
任意解锁机制	✅ V0.5（去掉过关门槛）
像素小机器人 + 待机帧	✅ 24×24 程序生成 + 眨眼
跑酷动画 + 屏震 + 粒子	✅
合成音效（多种 SFX）	✅
程序合成 BGM	✅ cyberpunk + menu 两套
进度可视化赛道 / 倒计时弧	✅
成就系统（7 个）	✅
皮肤系统（5 套）	✅
持久化存档	✅ user://savegame.json
玩法解锁机制	✅ 任意解锁（V0.5 去掉过关门槛）
玩法 6+	⏳ 霓虹工坊 / 钟表大师待开发
题库扩充	⏳ 当前 60 题，目标 200+

快速开始

用 Godot Editor 打开

open -a Godot --args --path /path/to/zhaoyixun-mathematics-game -e

或在 Godot 启动器里 Import 项目根目录的 project.godot。

Headless 跑项目（抓 stdout）

/Applications/Godot.app/Contents/MacOS/Godot \
  --headless \
  --path /path/to/zhaoyixun-mathematics-game

通过 godot-mcp 在 Claude Code 里开发

装机参考 docs/setup-godot-mcp.md。装好后在 Claude Code 里直接调 launch_editor / run_project / get_debug_output 等 14 个工具。

美术与设计

扁平彩色色板（V0.7 起，儿童教育 app 标准）

背景米白    #FFF8EC  暖底（不刺眼）
天空浅蓝    #DBEAFE  顶部背景
草地深绿    #16A34A  / #22C55E   底部草坡 + 高光
远山浅绿    #86EFAC  远景层
主蓝        #3B82F6  按钮 / 链接 / 主色
樱花粉      #EC4899  错误警示 / 高亮
阳光橙      #F59E0B  积分 / 太阳 / 强调
草绿        #22C55E  正确反馈 / 解锁状态
警告红      #EF4444
怪兽紫      #A855F7
深蓝文字    #1E3A8A