hopechen067/MapStage

MapStage 是做什麼的？

在建立或調整 MapStage 場景時使用此技能：地圖/地球儀投影、衛星、高程暈渲、Mapterhorn 地形、區域隔離、CSS 顏色調色與 JSON 匯出。

使用時機

• 需要即時 MapStage 調諧器（地圖 vs 地球儀、衛星 vs 暈渲、隔離）。
• 需要鎖定繪圖 / CSS / 相機，然後將 JSON 匯出到另一個主機。
• 需要分層聚落（capital / large / medium / small / pass / station / ordos）。

不要將調諧器頁面作為最終渲染主機。

模式

模式	用途
生產堆疊	在你的應用程式中嵌入 MapStage：可選衛星/網格 + Mapterhorn DEM（encoding: 'terrarium'）+ 山影 + OpenFreeMap 向量水域 + CSS 濾鏡 + 城市擠出。透過匯出的 JSON 驅動外觀。
調諧器	tuner/ 下的本機 HTTP 頁面，用於滑桿、投影、隔離、預設載入/匯出。

工作流程

1. 啟動調諧器：cd tuner && python -m http.server 8765 → http://localhost:8765/
2. 圖磚：預設 EOX Sentinel-2 無雲 + Mapterhorn（tuner/map-tiles.config.js）。可用已加入 .gitignore 的 map-tiles.config.local.js 覆蓋。
3. 套用預設預設 tuner/preset-antique-default.json（與 tuner/presets/antique-default.json 相同）。
4. 調整投影 / 衛星 / 暈渲 / 隔離 / CSS / 城市，直到外觀鎖定。
5. 從調諧器匯出 JSON（複製或下載）。
6. 將繪圖 + 相機 + CSS 欄位遷移到生產 MapStage 場景（參見參考資料）。
7. 在生產環境中：使用 jumpTo 定位相機；等待 idle 事件；可選預先快取圖磚。對於錄製幀避免使用 easeTo / flyTo。
8. 始終使用 encoding: 'terrarium' 設定 DEM。錯誤的編碼會破壞山影/地形。
9. 最終幀從生產主機渲染 — 不要從調諧器 UI 渲染。

硬性規則

• 圖磚不打包 — MapStage 在執行時僅從已設定的 URL 擷取 DEM 和底圖。
• 僅使用您有權使用的底圖端點 — 預設為公開示範圖磚（EOX）；必要時透過設定切換。
• 地形來源上使用 encoding: 'terrarium' — 強制要求。
• 在錄製的生產路徑中不使用 easeTo / flyTo；優先使用 jumpTo + idle。
• 不要在調諧器上託管最終渲染。
• 水域是內建的 OpenFreeMap / OpenMapTiles 向量圖層。不要預期或提交 tuner/assets/water-data.js。

參考資料

• references/參數列表說明.md — 參數表格 + 預設值
• references/tested-config.md — 來源、圖層順序、jumpTo + idle
• references/tuner-workflow.md — HTTP 調諧器 → 匯出 → 生產
• references/city-tier-schema.md — 聚落層級
• schemas/map-preset.schema.json
• schemas/sample-sites.schema.json
• tuner/ — 即時頁面、驗證腳本、預設預設、範例站點

代理

請參閱 agents/openai.yaml 以取得顯示名稱/預設提示詞。