MapStage 用于构建或调校 MapStage 场景，涵盖地图/地球投影、卫星影像、分层设色地形、Mapterhorn 地形、区域隔离、CSS 调色以及 JSON 导出。适合需要实时调校地图与地球、卫星与地形、区域隔离的场景，也适合先锁定绘制、CSS 与相机参数后导出 JSON 到其他宿主。
模式分生产栈与调校器。生产栈把 MapStage 嵌入应用：可选卫星/栅格底图加 Mapterhorn DEM（编码必须为 terrarium）、山体阴影、OpenFreeMap 矢量水系、CSS 滤镜与城市拉伸，最终外观由导出的 JSON 驱动。调校器是 tuner/ 下的 HTTP 页面或公开演示，提供滑块、投影、隔离与预设加载/导出。
工作流：打开调校器（公开演示 https://hopechen067.github.io/MapStage/，或 cd tuner && python -m http.server 后打开终端打印的本地地址）；平铺默认使用 EOX Sentinel-2 cloudless 与 Mapterhorn（tuner/map-tiles.config.js），可用被 gitignore 的 map-tiles.config.local.js 覆盖；应用默认预设 tuner/preset-antique-default.json，schema 版本 3；调整投影、卫星、地形、隔离、CSS 与城市；导出 JSON 并确认含 version 3 及 ui.projection、ui.showSatellite、ui.showRelief、ui.showCssFilter、isolate；把这些字段迁移到生产场景。生产中用 jumpTo，等待 idle，可选预缓存瓦片；录制帧避免 easeTo/flyTo。
硬性限制：瓦片不随包分发，MapStage 仅在运行时从配置的 URL 拉取 DEM 与底图；只能使用你有权使用的底图端点，默认是公开演示瓦片（EOX），需要时通过配置替换；地形源必须设置 encoding: 'terrarium'；录制路径不得使用 easeTo/flyTo，优先 jumpTo 加 idle；不要在调校器上承载最终渲染。公开调校器的水系是 OpenFreeMap/OpenMapTiles 矢量图层（water/waterway），导出 ui.showWater 始终为 false，不要期望或提交 tuner/assets/water-data.js。
安装：克隆整个仓库不等于安装技能，技能仅为 mapstage/ 目录，可用 npx skills add hopechen067/MapStage --skill mapstage -g，或 gh skill install hopechen067/MapStage mapstage --scope user，或复制到宿主技能目录后重新加载；代理不会从克隆中自动发现 mapstage/SKILL.md。参考资料见 references/ 下的参数列表、已验证配置、调校器工作流、城市分级 schema，以及 schemas/ 与 tuner/ 目录；代理配置见 agents/openai.yaml。