# 地图数据空间可视化预览与编辑器

在神奇代码岛（Arena）里，**数据空间本质上就是一套内置数据库**：

- 类似一张张表 / 一批键值对，
- 可以存储玩家数据、关卡进度、背包信息、排行榜等各类游戏数据，
- 在地图脚本里通过 `storage.getDataStorage(...)` / `storage.getGroupStorage(...)` 读写。

这个扩展程序做的事情，就是把这套「数据空间数据库」搬进 VS Code，用面板和树视图的方式帮你管理。

### 1.1 适合解决的痛点

在没有辅助工具时，管理数据空间大多是这样：

- 直接在脚本里拼 key / 字段名，靠日志和临时打印排查数据；
- 想确认某个玩家的数据（背包、进度、开关）时，只能写调试代码或在后台工具之间来回切；
- 策划 / 运营想检查或修一条玩家记录，只能找程序“帮忙查库 / 改库”。

当地图上线后，玩家数据、关卡记录、活动配置越来越多，这种方式既费时又容易出错。

### 1.2 扩展程序提供的能力

启用地图数据空间可视化预览与编辑器后，你可以获得：

- **树视图浏览数据空间（像看数据库表结构）**：

  - 在 VS Code 侧边栏以树视图展示当前地图的数据空间键列表；
  - 支持一键刷新、翻页、排序 / 过滤，快速定位到某个玩家 / 某个配置键；
  - 适合用来巡查数据结构、抽查存储是否符合预期。

- **临时文件编辑并自动写回（在线改库）**：

  - 支持将单个键的内容打开到临时文件中编辑；
  - 保存后自动写回服务端对应的数据空间，相当于在一个受控的环境里“改数据库记录”。

- **从源码直接跳转到对应数据空间**：

  - 通过 CodeLens，从 `storage.getDataStorage(...)` / `storage.getGroupStorage(...)` 等调用处一键跳转并加载对应数据空间；
  - 把“看代码”和“看数据”串在一起，减少在日志、控制台、后台工具之间来回切换。

点我安装：[神岛地图数据空间可视化工具](https://marketplace.visualstudio.com/items?itemName=box3lab.box3arenaprodataspace)
