AI + Godot 自动化游戏生产工作流（Game Factory）+ 用它做出来的第一款游戏。
核心想法：把「做游戏」拆成可复现、可验证、可自动化的流水线—— 规则与引擎解耦、关卡由 AI 生成并自动质检、视觉层保持薄、全部环节 headless 可测。 第一款游戏（3D 几何翻滚解谜）用来验证整条流水线，而不是为了做一款游戏而搭一套框架。
当前目标：完成首发 MVP。 先验收 Web 的电脑与手机体验，再上架 Android 与 App Store。 当前范围、关卡节奏与发布门禁见 首发计划。
https://easyindie.github.io/EasyGodot/
Godot Web 单线程导出，打开即玩（无需安装）。方向键 / WASD 移动 · R 重开 · L 选关 · V 看最佳回放。
games/<name>/ 单个游戏的完整实例
core/ 纯逻辑规则核心（RefCounted，不依赖场景/节点，headless 可跑）
solver/ 求解器（可解性 / 最优解 / 难度分级）
levels/ 关卡 JSON
scenes/ 视觉层（Godot 节点）
meta/ 元游戏层（进度 / 回放 / 本地榜 / 选关界面）
tests/ headless 测试套件
tools/ 内容生成器 / 质检 / 截图
workflow/ 跨游戏复用的平台（脚本、文档、pi 扩展）——不放游戏专属逻辑
scripts/ gf-*.sh 统一入口
docs/ 设计沉淀文档 01..07
pi-extensions/ pi 斜杠命令扩展
.agents/skills/ AI Agent 技能（Godot Game Factory）
.github/workflows/ 自动构建 + 测试 + 发布
3D 几何翻滚解谜（灵感来自 Bloxorz）：翻滚骨牌，把竖立的骨牌恰好停在目标格上， 掉出棋盘或踩空即失败。
- 20 关：最优步数 2→18，非递减且每关增加不超过 2 步；入门 → 路线规划 → 传送门 → 开关与桥 → 组合终章
- 斜 45° 等距视角、翻滚/坠落/重生动画、空洞即「地面缺失」
- 选关界面（顺序解锁）、通关回放、最佳步数与本机榜、全部通关庆祝
- 求解器 BFS 出最优解，用作关卡质检门禁
- 移动端适配：触屏操作（斜向 D-pad + 滑动 + 手势提示）、安全区域避让、竖屏取景
- 画质自适应：4 档画质（MSAA / 阴影 / 幕布）按实测帧时间升降； Web 端按设备分级给像素预算，任何设备都不会比 CSS 分辨率更模糊
操作：方向键 / WASD 移动 · R 重开 · L 选关 · V 看最佳回放 · T 切换触屏 UI
# 跑全部测试（19 个套件，包含关卡曲线、240 像素窄屏布局、多语言与主题切换）
workflow/scripts/gf-test.sh
# 首发自动门禁（加 --web 可生成 Web 候选，不部署）
workflow/scripts/gf-release-check.sh
# 本地预览 Web 版（多线程 + 禁用缓存，避免「改了代码页面没变」）
workflow/scripts/gf-serve.sh # → http://localhost:8000
# 关卡质检（非法 / 不可解时退出码非 0）
workflow/scripts/gf-run.sh -p games/puzzle-core res://tools/validate_levels.gd
# 按难度曲线生成候选（默认不覆盖正式关卡；需人工精选）
workflow/scripts/gf-run.sh -p games/puzzle-core res://tools/build_level_set.gd
# 导出构建（Web + Linux + Windows）
workflow/scripts/gf-export.sh
# 打 Steam Demo 分发包 / 生成 GitHub Pages 站点
workflow/scripts/gf-package.sh
workflow/scripts/gf-pages.shGodot 二进制放在
workflow/godot-bin/godot（未入库，需自行下载对应版本）。
| 文档 | 内容 |
|---|---|
| 01 工作流总览 | 结构化输出协议、目录约定、运行器 |
| 02 规则核心设计 | 坐标系、数据模型、通用 PolyCube 翻滚公式 |
| 03 求解器与质检 | BFS 最优解 + 「生成 → 质检 → 筛选」闭环 |
| 04 视觉层与 E2E | 视觉层薄化、输入映射、选关与回放、headless E2E |
| 05 生成与导出 | 关卡生成、导出管线、Steam 打包、GitHub Pages |
| 08 平台与竞品调研 | Steam/Apple/Google/华为的费用与门槛、移动端可行性、竞品数据 |
| 09 移动端发布 | Android / iOS 出包与上架清单、返回键与切后台约定、内容量与变现选择 |
| 06 新游戏手册 | 用同一套平台做下一款游戏 |
| 07 MVP 状态 | MVP 对照表、待办、坑与交接说明 |
| 10 关卡机制升级 | 多块棋盘 + 机关（开关/桥/闸门/传送门/碎裂砖）、求解器如何自动适配、"机关是否承重"自动判据 |
| 11 首发计划与验收 | 当前 MVP 范围、递增关卡节奏、Web 多设备验收、Android/iOS 发布门槛 |
| 12 主题与多语言 | 主题配色、系统语言、中英文与新增语种流程 |
| 13 手势输入改进 | 方向置信度、模糊轨迹纠正、多指隔离与手势回归测试 |
推送到 main 会自动触发 .github/workflows/pages.yml：
安装 Godot 4.7.2 + 导出模板（带缓存）→ 导入资源 → 跑全部测试与关卡质检 →
导出 Web → 上传 Pages 产物。
已上线：仓库已转为公开，Pages 使用 workflow 构建源， 部署地址 https://easyindie.github.io/EasyGodot/。 推送
main后约 1 分钟自动更新（构建 → 测试 → 质检 → 导出 → 部署）。
本地也可手动发布 / 预览：
workflow/scripts/gf-pages.sh games/puzzle-core # 生成 dist/pages/
python3 -m http.server 8080 --directory dist/pages # 当 GitHub Pages 跑一遍
workflow/scripts/gf-pages.sh games/puzzle-core --deploy # 强推到 gh-pages 分支- Godot Engine 4.7.2（MIT）
- Noto Sans SC（SIL OFL 1.1）
—— 已用
workflow/scripts/gf-font-subset.sh按项目实际用字裁剪为 约 148KB 子集 （原字体 16.4MB），由tests/test_font.gd守卫生效
画面主题与多语言：选关页底部可切换三套主题以及系统/中文/英文，偏好自动保存。扩展方式见 主题与多语言。