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 打开地图编辑器。
• 在 Authoring Files 视图中切换地图文件。
• 在地图视图中选择格子、绘制地形、编辑 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 项目工作区。
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/Project/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：地图 Authoring 文件扫描规则。
• slgMapEditor.compatApiUrl：兼容编译 API 地址。
• slgMapEditor.mcp.enabled：扩展激活时是否自动启动本地 MCP Host，默认开启。
• slgMapEditor.mcp.port：本地 MCP Host 端口，默认 57327；0 表示使用内置默认端口。

最近更新

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 视图快速定位内容。