### 技术细节

**架构**

- 两个编辑器类协作：`TilePainterWindow`（EditorWindow：状态、调色板、层管理、放置/擦除 API）+ `TilePainterSceneView`（`SceneView.duringSceneGui` 回调：射线拾取、网格与光标绘制、鼠标/键盘事件处理）。

- 全部代码位于 `Assets/TilePainter/Editor`，编译进 `Assembly-CSharp-Editor`，不生成任何运行时程序集。

**数据模型**

- **场景层级即唯一数据源**：每层是 `TilePainterRoot/<层名>` 节点，层高 = 节点 `position.y ÷ 层高步长`。占用表（层名 → 吸附键 → 对象）在窗口开启、Undo、Hierarchy 变化时从层级**重建**——不存在私有序列化文件，重启编辑器、跨工程复制场景都不丢管理状态。

- 吸附键 `PosKey = round((世界坐标 − 原点) / 格宽 × 2)`：奇偶性天然区分格心（奇,奇）、交点（偶,偶）、边（一奇一偶），三种吸附点共用同一套"同点同类替换、异类共存"语义。

- 自由放置物体收在各层 `Free` 子节点下，不参与格子占用表。

- 窗口设置（格宽、层高、原点、扫描目录等）保存在编辑器本地（Library 中的窗口状态），**不随场景或工程文件分发**——多人协作时需各自保持相同参数。

**对齐与坐标**

- 层 N 可行走表面 = 原点Y + (N+1)×层高；地块按合并 bounds **顶面**贴表面，装饰按**底面**站表面。

- bounds 取预制体全部 Renderer 的合并 bounds（带缓存），因此任意尺寸、任意轴心的预制体都能正确对齐——对齐规则与模型实际包围盒绑定，而非假定 1×1×1。

- 类别判定：资产路径含 `/Tiles/`（任意层级）→ 地块；否则装饰；窗口内可按笔刷强制覆盖。

**编辑器集成**

- 鼠标：`HandleUtility.AddDefaultControl` 独占 SceneView 点击，避免误选场景物体；按住 Alt 时所有左键事件放行给场景导航（视角旋转不受影响）。

- 快捷键：R/E/G/PgUp/PgDn 注册为 ShortcutManager 的 **SceneView 上下文快捷键**（优先于 Q/W/E/R/T 全局工具键），可在 Edit > Shortcuts 改键；工具停用后 R/E 自动回落为 Unity 默认工具键。

- 撤销：`PrefabUtility.InstantiatePrefab` + `Undo.RegisterCreatedObjectUndo` / `Undo.DestroyObjectImmediate`，一次拖刷经 `Undo.CollapseUndoOperations` 合并为单条撤销记录。

- 幽灵预览：`Object.Instantiate` + `HideFlags.HideAndDontSave`，不写入场景、不可被选中，关闭窗口自动销毁。

- 网格线与吸附光标全部用 `Handles` API 绘制——不创建任何材质、Shader、纹理或 RenderTexture，因此与渲染管线完全无关。

**迁移与性能**

- 自动迁移两类历史结构：`Layer_N` 数字层（子物体坐标重定基，世界位置不变）与 `Tiles/`+`Decorations/` 双节点层（合并为根下单节点）。

- 占用表重建为 O(已放置数量)，仅在层级实际变化时触发，并对窗口 UI 做帧内快照防抖；实测 1800+ 已放置物体时连刷、切层、网格绘制均保持流畅。