🚀 神岛 Arena 地图数据空间可视化工具 | ArenaPro Data Space

注意：本插件仅提供数据空间可视化预览与编辑功能，不包含其他能力。

如果你使用的是基于ArenaPro Creator的神岛 Webpack 脚手架，强烈建议直接安装 ArenaPro Creator 插件配套使用即可，其中已经集成了本插件的数据空间预览与编辑能力，并额外提供了更多强大的开发功能。

这个 VS Code 插件用于在编辑端可视化查看和编辑神奇代码岛（Arena）地图的数据空间：

• 在侧边栏以树视图展示当前地图的数据空间键列表
• 支持一键刷新、翻页、排序 / 过滤
• 支持打开单个键的内容到临时文件中进行编辑，保存后自动写回服务端
• 支持通过 CodeLens 从源码里 storage.getDataStorage(...) / storage.getGroupStorage(...) 直接跳转并加载数据空间

1. 前置条件

1.1 工作区文件

扩展会在以下条件满足时自动激活：

• 工作区根目录下存在 dao3.config.ts

1.2 环境变量 .env

扩展会从当前工作区根目录的 .env（或带模式的 env 文件）读取访问数据空间所需的环境变量：

• VITE_DAO3_MAP_ID：地图 ID（如果 dao3.config.ts 未配置 map.id 时作为兜底）
• VITE_ARENAPRO_MODE（可选）：配置后会优先读取对应的 .env.<mode> 文件
• VITE_DAO3_UA（可选）：覆盖全局 UA
• VITE_DAO3_AUTH（可选）：覆盖全局鉴权 Token

环境变量加载优先级：

1. 如果 .env 中存在 VITE_ARENAPRO_MODE=dev，且存在 .env.dev，则优先解析 .env.dev
2. 否则解析基础 .env

1.3 结合 @box3lab/arenapro-cli 使用

本扩展需要配合 @box3lab/arenapro-cli 使用，用于提供访问数据空间所需的全局鉴权信息（UA、Token 等）。

• 请先全局安装 Arenapro CLI：npm i -g @box3lab/arenapro-cli
• 通过 CLI 完成登录与授权 apc login 命令
• CLI 会在用户目录下写入全局配置文件，本扩展会从该全局配置中读取访问数据空间所需的 UA 和 Token

只有在 CLI 完成登录并写入配置后，本扩展的数据空间读写功能才能正常工作。若本地 .env 中配置了 VITE_DAO3_UA 或 VITE_DAO3_AUTH，则会优先使用本地值；未配置时会回退到 Arenapro CLI 写入的全局配置。

2. 打开数据空间视图

1. 保证当前工作区是一个 Arena 地图项目，并已配置好 dao3.config.ts 和 .env
2. 在 VS Code 左侧活动栏中找到 “Arena地图数据空间” 图标
3. 点击后会展开一个树视图 dao3storageMap

首次打开时视图为空，顶部会显示欢迎文案，引导你先配置数据空间名。

3. 视图顶部按钮说明

在 Arena地图数据空间 视图标题栏，会显示一排按钮：

• 刷新数据列表 ：重新请求当前配置的数据空间数据
• 上一页 ：翻到上一个分页
• 下一页 ：翻到下一个分页
• 链接【组】数据空间 ：配置并加载当前地图的“组”数据空间
• 链接【普通】数据空间 ：配置并加载当前地图的“普通”数据空间
• 新增数据 ：在当前数据空间下新增一个键，并通过临时文件编辑其内容
• 设置过滤目标路径 ：设置排序 / 区间过滤使用的目标字段路径（如 score、a.b.c 等）
• 数据升序 / 降序 ：切换排序方向
• 设置数值范围 ：设置过滤区间 [min,max]