From 6746e969946c36d13121e4304c0afd6ff3481a7e Mon Sep 17 00:00:00 2001
From: unanmed <1319491857@qq.com>
Date: Tue, 12 May 2026 22:38:36 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E5=AE=9A=E4=B9=89=E4=BE=9D=E8=B5=96?=
 =?UTF-8?q?=E7=89=88=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/copilot-instructions.md | 30 ++++++++++++++++++++++++++++++
 requirements.txt                | 15 +++++++--------
 2 files changed, 37 insertions(+), 8 deletions(-)
 create mode 100644 .github/copilot-instructions.md

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000..82fdf57
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,30 @@
+# 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 采样）分别生成图片，便于直观对比模型效果
diff --git a/requirements.txt b/requirements.txt
index 6134b46..2136b16 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,8 +1,7 @@
-torch
-tqdm
-torch-geometric
-transformers
-scipy
-numpy
-cv2
-perlin-noise
\ No newline at end of file
+torch==2.6.0
+tqdm==4.66.5
+torch-geometric==2.6.1
+transformers==4.49.0
+scipy==1.13.1
+numpy==2.2.6
+opencv-python==4.11.0.86