# 15 · 地图与商店模块

> **命名空间** `BaseGames.World.Map`、`BaseGames.World.Shop`  
> **程序集** `BaseGames.World`  
> **路径** `Assets/Scripts/World/Map/`、`Assets/Scripts/World/Shop/`  
> **依赖** `BaseGames.Core.Events`、`BaseGames.Core.Save`、`BaseGames.Dialogue`（IInteractable）

---

## 目录

1. [地图系统](#1-地图系统)
   - [MapRoomDataSO](#11-maproomdataso)
   - [MapManager](#12-mapmanager)
   - [MapPanel（全屏地图 UI）](#13-mappanel)
2. [商店系统](#2-商店系统)
   - [ShopItemSO](#21-shopitemso)
   - [ShopInventorySO](#22-shopinventoryso)
   - [ShopController](#23-shopcontroller)
   - [ShopNPC](#24-shopnpc)
3. [ISaveable 集成](#3-isaveable-集成)
4. [事件频道清单](#4-事件频道清单)

---

## 1. 地图系统

### 1.1 MapRoomDataSO

```csharp
// 路径: Assets/Scripts/World/Map/MapRoomDataSO.cs
[CreateAssetMenu(menuName = "World/Map/RoomData")]
public class MapRoomDataSO : ScriptableObject
{
    [Header("基础信息")]
    public string     RoomId;           // 与场景名一致，如 "Room_Forest_01"
    public string     RegionId;         // 所属区域，如 "Forest"
    public string     DisplayName;      // 可选，地图 Tooltip

    [Header("地图布局（格子坐标，单位：格）")]
    public Vector2Int GridPosition;     // 左下角坐标
    public Vector2Int GridSize;         // 宽×高（格）

    [Header("房间轮廓纹理")]
    public Texture2D  RoomOutlineTex;   // 用于地图 UI 显示房间形状（可空，回退到矩形格子）

    [Header("出口信息")]
    public RoomExitData[] Exits;        // 该房间所有出口定义

    [Header("特殊标记")]
    public bool       IsBossRoom;
    public bool       IsSavePoint;
    public bool       IsShop;
    public Sprite     MapIconOverride;  // null = 按 isXxx 自动选择图标
}

[Serializable]
public struct RoomExitData
{
    public string    TargetRoomId;      // 连接的目标房间 ID
    public Vector2Int ExitGridPos;      // 出口在格子地图上的位置
    public ExitDirection Direction;     // 出口方向
}

public enum ExitDirection { Up, Down, Left, Right }

// 全局地图数据库 SO（编辑器配置一次，不重复）
[CreateAssetMenu(menuName = "World/Map/MapDatabase")]
public class MapDatabaseSO : ScriptableObject
{
    public MapRoomDataSO[] AllRooms;

    // 运行时快速查找
    private Dictionary<string, MapRoomDataSO> _index;
    public MapRoomDataSO GetRoom(string roomId)
    {
        if (_index == null)
            _index = AllRooms.ToDictionary(r => r.RoomId);
        _index.TryGetValue(roomId, out var r);
        return r;
    }
}
```

### 1.2 MapManager

```csharp
// 路径: Assets/Scripts/World/Map/MapManager.cs
[DefaultExecutionOrder(-700)]
public class MapManager : MonoBehaviour, ISaveable
{
    public static MapManager Instance { get; private set; }

    void Awake()
    {
        if (Instance != null && Instance != this) { Destroy(gameObject); return; }
        Instance = this;
    }

    [SerializeField] private MapDatabaseSO  _database;

    [Header("Event Channels")]
    [SerializeField] private StringEventChannelSO _onRoomEntered;       // 订阅：房间进入时
    [SerializeField] private StringEventChannelSO _onMapUpdated;        // 发布：房间发现时刷新地图

    // 三级可见性：
    //   Unknown  → 未进入过（默认）
    //   Explored → 进入过但未购买地图（显示轮廓/格子）
    //   Mapped   → 已完整获取地图信息（显示图标/名称）
    private HashSet<string> _exploredRooms = new();   // 玩家踏入过
    private HashSet<string> _mappedRooms   = new();   // 完整地图信息（购买 MapFragment 或存档点揭示）

    // ── ISaveable ─────────────────────────────────────────────────────
    public void OnSave(SaveData data)
    {
        data.Map.ExploredRooms = _exploredRooms.ToList();
        data.Map.MappedRooms   = _mappedRooms.ToList();
    }

    public void OnLoad(SaveData data)
    {
        _exploredRooms = new HashSet<string>(data.Map.ExploredRooms ?? new List<string>());
        _mappedRooms   = new HashSet<string>(data.Map.MappedRooms   ?? new List<string>());
    }

    // ── 事件驱动房间发现 ─────────────────────────────────────────────
    private void OnEnable()
        => _onRoomEntered.OnEventRaised += OnRoomEntered;
    private void OnDisable()
        => _onRoomEntered.OnEventRaised -= OnRoomEntered;

    private void OnRoomEntered(string roomId)
    {
        bool changed = _exploredRooms.Add(roomId);
        if (changed) _onMapUpdated.Raise(roomId);
    }

    /// <summary>标记为已完整获取地图信息（购买 MapFragment SO 触发）。</summary>
    public void SetMapped(string roomId)
    {
        _exploredRooms.Add(roomId);
        if (_mappedRooms.Add(roomId))
            _onMapUpdated.Raise(roomId);
    }

    public bool IsExplored(string roomId) => _exploredRooms.Contains(roomId);
    public bool IsMapped(string roomId)   => _mappedRooms.Contains(roomId);
    // 向后兼容：仅检查已探索
    public bool IsDiscovered(string roomId) => _exploredRooms.Contains(roomId);
}
```

### 1.3 MapPanel

```csharp
// 路径: Assets/Scripts/World/Map/MapPanel.cs
// 全屏地图 UI，由 UIManager PanelStack 管理
public class MapPanel : MonoBehaviour
{
    [SerializeField] private MapDatabaseSO    _database;
    [SerializeField] private RectTransform    _roomContainer;      // 格子图放置根节点
    [SerializeField] private MapRoomCellUI    _cellPrefab;         // 地图格子预制

    [Header("图标 Sprites")]
    [SerializeField] private Sprite _iconSavePoint;
    [SerializeField] private Sprite _iconBossRoom;
    [SerializeField] private Sprite _iconShop;
    [SerializeField] private Sprite _iconPlayerPos;

    [Header("颜色")]
    [SerializeField] private Color _colorDiscovered   = Color.white;
    [SerializeField] private Color _colorUndiscovered = Color.black;

    [Header("Event Channels")]
    [SerializeField] private StringEventChannelSO _onMapUpdated;   // 房间发现时刷新

    private Dictionary<string, MapRoomCellUI> _cells = new();

    private void OnEnable()
    {
        BuildGrid();
        _onMapUpdated.OnEventRaised += OnMapUpdated;
    }

    private void OnDisable()
        => _onMapUpdated.OnEventRaised -= OnMapUpdated;

    // 根据 MapDatabaseSO 生成格子 UI
    private void BuildGrid()
    {
        foreach (var room in _database.AllRooms)
        {
            var cell = Instantiate(_cellPrefab, _roomContainer);
            cell.Setup(room, MapManager.Instance.IsDiscovered(room.RoomId));
            _cells[room.RoomId] = cell;
        }
    }

    private void OnMapUpdated(string roomId)
    {
        if (_cells.TryGetValue(roomId, out var cell))
            cell.SetDiscovered(true);
    }
}

// 单个地图格子 UI 组件
public class MapRoomCellUI : MonoBehaviour
{
    [SerializeField] private Image _bg;
    [SerializeField] private Image _icon;

    public void Setup(MapRoomDataSO room, bool discovered) { /* 设置 grid 位置+颜色 */ }
    public void SetDiscovered(bool v) => _bg.color = v ? Color.white : Color.black;
}
```

### 1.4 MapPlayerTracker

```csharp
// 路径: Assets/Scripts/World/Map/MapPlayerTracker.cs
// 将玩家世界坐标转换为地图像素/格子坐标，供 MapPanel 显示玩家位置图标
public class MapPlayerTracker : MonoBehaviour
{
    [SerializeField] private Transform       _playerTransform;
    [SerializeField] private MapDatabaseSO   _database;
    [SerializeField] private MapManager      _mapManager;

    [Header("世界坐标 → 格子坐标换算参数")]
    [SerializeField] private float           _worldUnitsPerCell = 18f;   // 1 格 = N 世界单位

    /// <summary>返回玩家当前所在房间 ID（用于地图高亮当前房间）。</summary>
    public string CurrentRoomId { get; private set; }

    /// <summary>玩家在当前格子房间内的归一化坐标（0~1）。</summary>
    public Vector2 NormalizedPositionInRoom { get; private set; }

    private void LateUpdate()
    {
        if (_playerTransform == null) return;
        Vector2 worldPos = _playerTransform.position;
        Vector2Int cellPos = WorldToCell(worldPos);

        // 遍历已知房间，找到包含该格子的房间
        foreach (var room in _database.AllRooms)
        {
            var rect = new RectInt(room.GridPosition, room.GridSize);
            if (rect.Contains(cellPos))
            {
                CurrentRoomId = room.RoomId;
                Vector2 inRoom = (Vector2)(cellPos - room.GridPosition);
                NormalizedPositionInRoom = new Vector2(
                    inRoom.x / room.GridSize.x,
                    inRoom.y / room.GridSize.y);
                return;
            }
        }
    }

    private Vector2Int WorldToCell(Vector2 worldPos)
        => new Vector2Int(
            Mathf.FloorToInt(worldPos.x / _worldUnitsPerCell),
            Mathf.FloorToInt(worldPos.y / _worldUnitsPerCell));
}
```

### 1.5 MapPin 系统

```csharp
// 路径: Assets/Scripts/World/Map/MapPin.cs
/// <summary>玩家在地图上放置的自定义标记。</summary>
[Serializable]
public class MapPin
{
    public string   RoomId;              // 所在房间 ID
    public Vector2  NormalizedPos;       // 房间内归一化位置（0~1）
    public PinType  Type;
    public string   Note;               // 玩家文字备注（可选，最多 64 字符）
}

public enum PinType
{
    Marker,          // 通用标记
    Chest,           // 宝箱/收藏品
    Enemy,           // 危险/敌人
    Path,            // 路径指引
    Note,            // 笔记
}

// MapPinManager 负责增删查；存档通过 ISaveable 持久化
public class MapPinManager : MonoBehaviour, ISaveable
{
    private List<MapPin> _pins = new();

    public IReadOnlyList<MapPin> Pins => _pins;

    public void AddPin(MapPin pin) => _pins.Add(pin);
    public void RemovePin(MapPin pin) => _pins.Remove(pin);

    public void OnSave(SaveData data) => data.Map.Pins = _pins;
    public void OnLoad(SaveData data) => _pins = data.Map.Pins ?? new List<MapPin>();
}
```

---

## 2. 商店系统

### 2.1 ShopItemSO

```csharp
// 路径: Assets/Scripts/World/Shop/ShopItemSO.cs
[CreateAssetMenu(menuName = "World/Shop/ShopItem")]
public class ShopItemSO : ScriptableObject
{
    [Header("标识")]
    public string    ItemId;
    public string    DisplayName;
    [TextArea(2, 5)]
    public string    Description;
    public Sprite    Icon;

    [Header("价格")]
    public int       BasePrice;
    public bool      IsUnique;          // 购买一次后永久从库存移除

    [Header("商品类型")]
    public ShopItemType ItemType;

    // 按 ItemType 填写以下字段（其余留空）
    public int       HealthRestoreAmount;     // HealthRestoration
    public CharmSO   CharmReference;          // CharmItem
    public string    KeyItemId;               // KeyItem
    public int       MaxPurchaseCount = -1;   // -1 = 无限
}

public enum ShopItemType
{
    HealthRestoration,
    CharmItem,
    KeyItem,
    ConsumableBuff,
    MapFragment,
}
```

### 2.2 ShopInventorySO

```csharp
// 路径: Assets/Scripts/World/Shop/ShopInventorySO.cs
[CreateAssetMenu(menuName = "World/Shop/ShopInventory")]
public class ShopInventorySO : ScriptableObject
{
    public string           ShopId;               // 全局唯一
    public List<ShopItemSO> DefaultInventory;      // 初始商品列表
    public int              MaxDisplaySlots = 6;   // UI 最多同时显示的商品格数
    public RestockPolicy    RestockPolicy = RestockPolicy.Never;
    public Sprite           KeeperPortrait;
    public string           KeeperName;
}

/// <summary>库存补货时机策略。</summary>
public enum RestockPolicy
{
    Never,          // 永不补货（唯一商品卖完即消失）
    OnSavePoint,    // 激活存档点时补货
    OnBossDefeat,   // 击败 Boss 后补货
    Periodic,       // 周期性补货（由 ShopController 定时或条件检查）
}
```

### 2.3 ShopController

```csharp
// 路径: Assets/Scripts/World/Shop/ShopController.cs
public class ShopController : MonoBehaviour, ISaveable
{
    [SerializeField] private ShopInventorySO _inventory;
    [SerializeField] private ShopPanel       _shopPanel;

    [Header("Event Channels")]
    [SerializeField] private StringEventChannelSO        _onShopOpen;          // Raise 商店开启
    [SerializeField] private ShopPurchaseEventChannelSO  _onItemPurchased;     // Raise → PlayerStats 扣 Geo
    [SerializeField] private StringEventChannelSO        _onBossDefeated;      // 订阅 → 可能触发补货
    [SerializeField] private VoidEventChannelSO          _onSavePointActivated; // 订阅 → 可能触发补货

    // key = itemId，value = 已购次数
    private Dictionary<string, int>  _purchaseCounts = new();
    private HashSet<string>          _soldUniqueItems = new();

    private void OnEnable()
    {
        if (_inventory.RestockPolicy == RestockPolicy.OnBossDefeat && _onBossDefeated != null)
            _onBossDefeated.OnEventRaised += _ => Restock();
        if (_inventory.RestockPolicy == RestockPolicy.OnSavePoint && _onSavePointActivated != null)
            _onSavePointActivated.OnEventRaised += Restock;
    }

    private void OnDisable()
    {
        if (_onBossDefeated != null) _onBossDefeated.OnEventRaised -= _ => Restock();
        if (_onSavePointActivated != null) _onSavePointActivated.OnEventRaised -= Restock;
    }

    public void Open()
    {
        _shopPanel.Show(GetAvailableItems(), this);
        _onShopOpen.Raise(_inventory.ShopId);
    }
    public void Close() => _shopPanel.Hide();

    public List<ShopItemSO> GetAvailableItems()
    {
        return _inventory.DefaultInventory
            .Take(_inventory.MaxDisplaySlots)
            .Where(item =>
                !_soldUniqueItems.Contains(item.ItemId) &&
                (item.MaxPurchaseCount < 0 || GetPurchaseCount(item.ItemId) < item.MaxPurchaseCount))
            .ToList();
    }

    /// <summary>
    /// 按 RestockPolicy 补货：重置非唯一商品的购买次数（唯一商品已售出不恢复）。
    /// </summary>
    public void Restock()
    {
        var nonUniqueIds = _inventory.DefaultInventory
            .Where(i => !i.IsUnique)
            .Select(i => i.ItemId);

        foreach (var id in nonUniqueIds)
            _purchaseCounts.Remove(id);
    }

    // 由 ShopPanel 的购买按钮调用
    public bool TryPurchase(ShopItemSO item, int playerGeo)
    {
        if (playerGeo < item.BasePrice) return false;
        if (_soldUniqueItems.Contains(item.ItemId)) return false;

        // 扣 Geo（通过事件频道，PlayerStats 监听）
        _onItemPurchased.Raise(new ShopPurchaseEvent { Item = item, Price = item.BasePrice });

        // 更新库存
        _purchaseCounts[item.ItemId] = GetPurchaseCount(item.ItemId) + 1;
        if (item.IsUnique) _soldUniqueItems.Add(item.ItemId);

        return true;
    }

    private int GetPurchaseCount(string id)
        => _purchaseCounts.TryGetValue(id, out var c) ? c : 0;

    // ── ISaveable ────────────────────────────────────────────────────
    public void OnSave(SaveData data)
    {
        if (!data.Shops.ShopRecords.ContainsKey(_inventory.ShopId))
            data.Shops.ShopRecords[_inventory.ShopId] = new ShopRecord();

        var record = data.Shops.ShopRecords[_inventory.ShopId];
        record.SoldUniqueItems = _soldUniqueItems.ToList();
        record.PurchaseCounts  = new Dictionary<string, int>(_purchaseCounts);
    }

    public void OnLoad(SaveData data)
    {
        if (data.Shops.ShopRecords.TryGetValue(_inventory.ShopId, out var record))
        {
            _soldUniqueItems = new HashSet<string>(record.SoldUniqueItems ?? new List<string>());
            _purchaseCounts  = record.PurchaseCounts ?? new Dictionary<string, int>();
        }
    }
}
```

### 2.4 ShopNPC

```csharp
// 路径: Assets/Scripts/World/Shop/ShopNPC.cs
public class ShopNPC : MonoBehaviour, IInteractable
{
    [SerializeField] private ShopController     _shopController;
    [SerializeField] private DialogueSequenceSO _greetDialogue;   // 可选开场白
    [SerializeField] private DialogueManager    _dialogueManager;
    [SerializeField] private VoidEventChannelSO _onDialogueEnded; // 订阅：对话结束后开商店

    public bool   CanInteract    => true;
    public string InteractPrompt => "购物";

    public void Interact(Transform player)
    {
        if (_greetDialogue != null)
        {
            _dialogueManager.StartDialogue(_greetDialogue);
            // 等对话结束后再 Open Shop：订阅 EVT_DialogueEnded 一次性
            void OpenAfterDialogue()
            {
                _shopController.Open();
                _onDialogueEnded.OnEventRaised -= OpenAfterDialogue;
            }
            _onDialogueEnded.OnEventRaised += OpenAfterDialogue;
        }
        else
        {
            _shopController.Open();
        }
    }

    public void OnPlayerEnterRange(Transform player) { }
    public void OnPlayerExitRange() { }
}
```

---

## 3. ISaveable 集成

| 组件 | SaveData 目标字段 |
|------|-----------------|
| `MapManager` | `SaveData.Map.DiscoveredRooms` |
| `ShopController` | `SaveData.ExtensionData["shops"]` (JObject, key=ShopId) |

---

## 4. 事件频道清单

| 资产名 | 类型 | Raise 方 | Subscribe 方 |
|--------|------|---------|-------------|
| `EVT_RoomEntered` | `StringEventChannelSO` | `RoomController` | `MapManager`（标记发现）|
| `EVT_MapUpdated` | `StringEventChannelSO` | `MapManager` | `MapPanel`（刷新格子）|
| `EVT_ShopOpened` | `StringEventChannelSO`（shopId） | `ShopController.Open()` | `HUDController`（隐藏 HUD）、`InputReaderSO`（切 UI）|
| `EVT_ShopClosed` | `VoidEventChannelSO` | `ShopController` | `HUDController`（恢复 HUD）|
| `EVT_ItemPurchased` | `ShopPurchaseEventChannelSO` | `ShopController` | `PlayerStats`（扣 Geo）、`AchievementManager`（购买成就）|

---

## 5. MapRoomDataEditor — Scene Handles 可视化编辑

> **P3 优化**：`MapRoomDataSO` 的 `GridPosition` / `GridSize` 依赖手动输入整数，易与实际场景房间大小错位。`MapRoomDataEditor` 在 Scene View 中叠加可拖拽边界框，直接将世界坐标映射为格子坐标，消除手动对齐误差。

```csharp
// 路径: Assets/Editor/Map/MapRoomDataEditor.cs
#if UNITY_EDITOR
using UnityEditor;
using UnityEngine;

namespace BaseGames.Editor.Map
{
    [CustomEditor(typeof(MapRoomDataSO))]
    public class MapRoomDataEditor : UnityEditor.Editor
    {
        // 每格对应的世界单位大小（与 MapPanel 的 cellSize 一致）
        private const float CELL_SIZE = 1f;

        private static readonly Color FillColor    = new(0.2f, 0.6f, 1f, 0.15f);
        private static readonly Color OutlineColor = new(0.2f, 0.6f, 1f, 0.9f);
        private static readonly Color HandleColor  = new(1f, 0.85f, 0.2f, 1f);

        private MapRoomDataSO _target;

        private void OnEnable()  => _target = (MapRoomDataSO)target;

        // ── Inspector 覆盖：保留默认 Inspector 外加 "Edit in Scene" 按钮 ──
        public override void OnInspectorGUI()
        {
            DrawDefaultInspector();
            EditorGUILayout.Space(8);

            EditorGUILayout.HelpBox(
                "在 Scene View 中可直接拖拽房间角点调整 GridPosition / GridSize。\n" +
                "需要 Scene View 处于激活状态。",
                MessageType.Info);

            if (GUILayout.Button("居中 Scene View 到此房间", GUILayout.Height(28)))
                FocusSceneViewOnRoom();
        }

        // ── Scene GUI：绘制可拖拽边界框 ──────────────────────────────────
        private void OnSceneGUI()
        {
            if (_target == null) return;

            var origin  = (Vector3)(Vector2)_target.GridPosition * CELL_SIZE;
            var size    = (Vector3)(Vector2)_target.GridSize     * CELL_SIZE;

            // 填充矩形
            Handles.DrawSolidRectangleWithOutline(
                new Rect(origin.x, origin.y, size.x, size.y),
                FillColor, OutlineColor);

            // 房间 ID 标签（居中）
            Handles.Label(origin + size * 0.5f, _target.RoomId,
                new GUIStyle(GUI.skin.label)
                {
                    alignment  = TextAnchor.MiddleCenter,
                    fontStyle  = FontStyle.Bold,
                    normal     = { textColor = Color.white }
                });

            // ── 四角 FreeMoveHandle ──────────────────────────────────────
            EditorGUI.BeginChangeCheck();

            // 左下角（= GridPosition）
            var newBL = DragHandle(origin, "BL");
            // 右上角（= GridPosition + GridSize）
            var newTR = DragHandle(origin + size, "TR");

            if (EditorGUI.EndChangeCheck())
            {
                Undo.RecordObject(_target, "Resize MapRoom");

                // 保证 BL ≤ TR
                var bl = new Vector2(
                    Mathf.Min(newBL.x, newTR.x),
                    Mathf.Min(newBL.y, newTR.y));
                var tr = new Vector2(
                    Mathf.Max(newBL.x, newTR.x),
                    Mathf.Max(newBL.y, newTR.y));

                _target.GridPosition = ToGrid(bl);
                _target.GridSize     = ToGrid(tr) - _target.GridPosition;
                // GridSize 最小 1×1
                _target.GridSize = new Vector2Int(
                    Mathf.Max(1, _target.GridSize.x),
                    Mathf.Max(1, _target.GridSize.y));

                EditorUtility.SetDirty(_target);
            }
        }

        // ── 拖拽把手（黄色圆点）────────────────────────────────────────
        private static Vector3 DragHandle(Vector3 pos, string id)
        {
            float size   = HandleUtility.GetHandleSize(pos) * 0.12f;
            var oldColor = Handles.color;
            Handles.color = HandleColor;
            var result = Handles.FreeMoveHandle(pos, size, Vector3.zero, Handles.DotHandleCap);
            Handles.color = oldColor;
            return SnapToGrid(result);
        }

        // 吸附到格子
        private static Vector3 SnapToGrid(Vector3 world)
            => new(Mathf.Round(world.x / CELL_SIZE) * CELL_SIZE,
                   Mathf.Round(world.y / CELL_SIZE) * CELL_SIZE,
                   0f);

        private static Vector2Int ToGrid(Vector2 world)
            => new(Mathf.RoundToInt(world.x / CELL_SIZE),
                   Mathf.RoundToInt(world.y / CELL_SIZE));

        // ── Scene View 定位 ───────────────────────────────────────────
        private void FocusSceneViewOnRoom()
        {
            var sv = SceneView.lastActiveSceneView;
            if (sv == null) return;
            var center = ((Vector2)_target.GridPosition +
                          (Vector2)_target.GridSize * 0.5f) * CELL_SIZE;
            sv.pivot = new Vector3(center.x, center.y, 0f);
            sv.size  = Mathf.Max(_target.GridSize.x, _target.GridSize.y) * CELL_SIZE * 1.5f;
            sv.Repaint();
        }
    }
}
#endif
```

**工作流**：

1. 在 Project 面板选中 `MapRoomDataSO` 资产（或在 Inspector 固定它）
2. 打开 Scene View，即可看到蓝色房间边界框 + 黄色角点把手
3. 拖动左下角把手调整房间起点；拖动右上角把手调整房间大小
4. 所有拖动操作自动吸附到 1 格精度，并支持 Undo
5. 点击 **"居中 Scene View 到此房间"** 可快速定位视图

> **`CELL_SIZE` 配置**：若地图格子实际对应世界坐标不是 1 单位（如 16px 像素游戏 = 0.16 世界单位），修改 `MapRoomDataEditor` 顶部 `const float CELL_SIZE` 即可，无需改运行时代码。