SLG Map Authoring VS Code Editor

面向 SLG 地图 Authoring JSON 的 VS Code 扩展，提供地图浏览、编辑、保存、编译导出，以及通过 MCP 接入外部 Agent 的工作流。

功能亮点

• 在 VS Code 内打开 Webview 地图编辑器。
• 扫描工作区内的地图 Authoring 文件，并支持保存修改。
• 支持地图显示、选择、笔刷、POI、区域标签、线性地貌 FeaturePath、PNG 导入等编辑能力。
• 支持 Compile 和 Export，将 Authoring JSON 编译并保存 FeatureMap。
• 支持外部 Agent 通过插件内置 MCP Host 读取、修改、校验和保存地图。
• 支持 MCP 访问当前 Webview 内存态地图，包括尚未保存到文件的地图。

使用说明

• 执行 SLG Map Editor: Open 打开地图编辑器。
• 工作区可打开 Unity/Cocos 项目根目录，也可直接打开 Assets/Project/Data/SLG 下的 MapAuthoring 或 ProceduralFeatureMapData 等数据目录；Cocos 的小写 assets 会自动识别。
• 在 Authoring Files 视图中切换地图文件。
• 在地图视图中选择格子、绘制地形、编辑 Inspector 属性并保存。
• 文件操作集中在编辑器标题栏的 Map Editor 菜单；画布使用互斥的 Brush、Tile、POI、Linear、Region 模式，每个模式只开放对应对象与 Inspector。
• 按需执行 Refresh、Compile、Export 等命令。

侧边栏包含 Map Editor、Authoring Files、POIs、Region Labels、Linear Features 等视图。

External Agent Workflow Through MCP

扩展不再内置 AI 生成地图逻辑。外部 Agent 应连接插件内置的 SLG Map Authoring MCP endpoint，并使用确定性的工具来读取、修改、校验、编译和保存地图 Authoring JSON。

MCP Host 运行在 VS Code Extension Host 内，主流程不要求用户单独安装 Node.js。默认只监听本机回环地址：

http://127.0.0.1:57327/mcp

执行命令 SLG Map: Copy MCP Config 可复制当前连接配置：

{
  "mcpServers": {
    "slg-map-authoring": {
      "url": "http://127.0.0.1:57327/mcp"
    }
  }
}

推荐流程：

1. 在 VS Code 中打开 Unity/Cocos 项目工作区，或其 Assets/Project/Data/SLG 数据目录。
2. 确认 SLG Map Authoring 扩展已激活。
3. 执行 SLG Map: Copy MCP Config。
4. 将配置粘贴到外部 Agent 的 MCP 配置中。
5. 调用 slg_editor_get_state 或 slg_editor_get_authoring 读取当前编辑器状态。
6. 调用 slg_editor_patch_authoring 或 slg_editor_apply_authoring 修改当前地图。
7. 调用 slg_editor_validate_current 校验当前地图。
8. 调用 slg_editor_save_current 保存当前地图。

MCP 工具

文件级工具：

• slg_map_list：列出当前工作区地图 Authoring 文件。
• slg_map_get：读取指定地图 Authoring JSON。
• slg_map_create_default：创建默认地图 Authoring JSON。
• slg_map_patch：对地图 JSON 执行结构化补丁。
• slg_map_validate：校验地图 JSON。
• slg_map_compile：编译地图 JSON。
• slg_map_save：保存地图 JSON，仅允许写入 Assets/Settings/SLGResourcesProjectSettings.asset 所配置项目的 Data/SLG/MapAuthoring/**/*.json。

当前编辑器工具：

• slg_editor_get_state：读取当前 Webview 编辑器状态。
• slg_editor_get_authoring：读取当前 Webview 内存态 Authoring JSON，包括未保存修改。
• slg_editor_apply_authoring：替换当前 Webview 内存态 Authoring JSON。
• slg_editor_patch_authoring：对当前 Webview 内存态 Authoring JSON 执行结构化补丁。
• slg_editor_validate_current：校验当前 Webview 内存态地图。
• slg_editor_save_current：保存当前 Webview 地图。
• slg_editor_focus：聚焦当前 Webview 中的坐标或 Authoring 对象。

配置说明

• slgMapEditor.unityBridgeUrl：Unity 本地桥接地址。
• slgMapEditor.authoringGlob：可选扫描规则覆盖；留空时读取 Assets/Settings/SLGResourcesProjectSettings.asset 的 projectRoot。
• slgMapEditor.compatApiUrl：兼容编译 API 地址。
• slgMapEditor.mcp.enabled：扩展激活时是否自动启动本地 MCP Host，默认开启。
• slgMapEditor.mcp.port：本地 MCP Host 端口，默认 57327；0 表示使用内置默认端口。

最近更新

0.1.13

• Tile Inspector 新增 Editor Group，可将多个格子编组、设置旋转中心并按 60° 步进整体旋转。
• Editor Group 旋转会同步更新组内 Cell、Designated Tile、POI、Region Label 等地图内容，并支持撤销与碰撞校验。
• 修正 River 等有方向线性要素的 Incoming / Outgoing 箭头显示方向。
• Export 保存 FeatureMap 后会通过 Unity Bridge 自动生成对应的 WorldMapData，并在编译日志中返回生成路径。

0.1.12

• 支持从 Assets/Settings/SLGResourcesProjectSettings.asset 读取配置的资源项目根目录，Authoring 与 FeatureMap 路径不再写死为 Assets/Project。
• 工作区刷新会重新下发项目路径配置，Webview 默认地图、导入路径和导出 FeatureMap 路径会跟随当前工程配置更新。
• 监听 SLGResourcesProjectSettings.asset 创建、修改和删除事件，配置变化后自动刷新地编上下文。
• FeatureMap 保存接口会限制写入当前项目的 ProceduralFeatureMapData 目录，并返回实际保存的 AssetPath。
• 补充 MCP Authoring 路径校验与 Webview 工作区保护测试，覆盖动态项目根目录场景。

0.1.11

• 未打开 VS Code 工作区时，地图编辑器会显示明确提示并禁止编辑。
• 当前目录不是有效 Unity/Cocos SLG 工程时，页面会展示工作区路径和所需数据目录结构。
• 工作区有效性由 Extension Host 统一校验，编辑命令、Host API 和 MCP 运行时修改均不能绕过锁定。
• 切换工作区后会自动重新校验并在有效工程中恢复地图数据加载。

0.1.10

• 支持直接打开 Unity 或 Cocos 工程中的 SLG 地图数据目录，并自动识别对应的项目根目录与资源路径。
• 编辑器调整为顶部模式栏、右侧 Inspector 和全尺寸地图画布布局，新增互斥的 Brush、Tile、POI、Linear、Region 编辑模式。
• 文件与导出操作集中到左侧 Map Editor 菜单；编辑器页面打开或关闭时，侧栏会在 Menu 与 Open Editor 之间切换。
• 优化 Corner Biomes 批量预览性能，并将开关移动到画布缩放控件下方。
• Brush 新增高度绘制，可选择仅修改 Biome、仅修改 Height Level，或同时修改两者。

0.1.9

• 地貌类型调整为 Meadow、Water、Desert、SnowField。
• Designated Tile 支持旋转、专用标记和 Cell 属性锁定，锁定格不会被笔刷修改。
• POI 和 Designated Tile 描述的河流、山脉等线性元素会作为不可编辑的固定要素展示，并暴露连接点。
• 新增角点地貌颜色预览开关，用投票结果显示六边形过渡关系，并保留内层小六边形区域。
• 导出 FeatureMap 时 Corners 使用编译后的角点投票结果，保证编辑器预览与导出数据一致。

0.1.8

• Linear Features 选中节点后，Inspector 会自动滚动到对应节点属性位置。
• 支持选中 Linear Features 节点后按 Delete / Backspace 删除节点。
• 支持右键 Linear Features 节点后执行 Split Linear Feature，从当前节点处分割为两个 Linear Features。
• Linear Feature 类型选择中移除 AllEdges 类型，旧数据会归一到基础类型。
• Mountain 与 MountainRange 使用不同的山脉渲染样式，保留类型区分。

0.1.7

• MCP Host 固定默认端口为 57327，并移除本机访问的 Bearer 鉴权要求。
• 新增当前编辑器态 MCP 工具，外部 Agent 可以读取、修改、校验和保存未落盘的地图。
• 移除内置 AI 生成地图入口，改为通过 MCP 由外部 Agent 驱动地图生成。
• 修复地图属性 Done 未完整保存、地图大小不生效、新建未保存地图切换异常、保存提示重复弹出等编辑器问题。
• 将笔刷能力整合到 Inspector 的 Cell 属性区域，移除地图顶部工具条并将缩放控件移动到地图左上角。
• 支持通过 MCP 生成和修改当前地图内容，例如湖泊、中国轮廓、黄河和长江等设计辅助流程。

0.1.6

• 完善地图编辑工作台，常用编辑流程在 VS Code 内更集中。
• 强化编译与保存流程，支持直接编译并保存 FeatureMap。
• 优化侧边栏数据浏览，支持从 Authoring Files、POIs、Region Labels、Linear Features 视图快速定位内容。