ginka-generator/.github/copilot-instructions.md

Ginka 地图生成器 - Copilot 指引

项目概述

本项目是一个基于深度学习的二维网格状地图生成模型，用于生成魔塔（Magic Tower）类网页游戏地图。

• 模型结构：VQ-VAE 风格编码器 + MaskGIT 解码器
  • VQ-VAE 编码器将完整地图压缩为离散隐变量 z（从 codebook 查得）
  • MaskGIT 以 z 为条件，通过迭代掩码预测生成地图
  • 推理时直接随机采样 z，无需用户输入
• 地图规格：13×13 格子，7 类图块
• 目录结构
  • ginka/ — 模型定义与训练脚本（Python）
  • data/ — 数据预处理（TypeScript，因游戏是网页游戏）
  • docs/ — 设计文档
  • shared/ — 可视化等共享工具

重要约束

训练

• 不要在当前设备上运行训练，训练在其他设备上进行
• 可以运行小规模验证、推理或单步测试，但不要触发完整训练流程

代码风格

• Python：不使用三引号注释（"""..."""），一律改用 # 注释；不出现连续空格；遵循 Prettier 风格（缩进 4 空格，行宽 88）
• TypeScript：遵循 Prettier 默认风格

验证与可视化

• 编写验证代码时，优先输出可视化结果（图片文件），使用 shared/image.py 中的工具
• 验证阶段应对不同条件（不同 z 采样）分别生成图片，便于直观对比模型效果