用途：为 Vue 或 Web 仪表盘生成可复用的 Three.js 3D 地理地图与地球入口，覆盖世界、国家、省、市、区县范围，并支持层级下钻（世界→国家→省→市→区县，区县为终端）。
主要能力：基于捆绑的已验证模板一对一复制地图样式；解析与校验 GeoJSON；按范围切换数据、标签、散点、飞线、轮廓、追光与相机；参数化主题色、挤出深度、侧壁渐变、标签缩放、涟漪与飞线；提供地球入口（SphereGeometry、ShaderMaterial、大气辉光、扫描网格、GSAP 相机过渡）；提供数据适配器、离线预处理、缓存与预取模板；附带多个脚本用于数据解析、纹理校验、主题生成、项目检查与模板完整性校验。
使用方式：优先从 assets/templates/smart-mine-vue/src/ 复制模板再改数据、标签、范围、主题与相机；用 scripts/resolve_map_data.py 校验或下载 GeoJSON，用 scripts/apply_map_theme.py <hex> <target-project> --no-backup 改单一主题色，用 scripts/check_three_map_project.py <target-project> --strict 做交付前检查，用 scripts/verify_template_integrity.py 校验模板基线。地球入口需整体复制 EarthView.vue、EarthChinaMap.vue、ChinaMap.vue、mapTheme.ts 及纹理资源。
适用场景：Vue 3 + Vite + Three.js 项目中的 3D 地图仪表盘、地球到中国地图的入场过渡、多级行政区下钻地图。
限制：不得自由发挥新渲染器或替换已验证效果；不得用截图、平面 SVG 或 2D 填充替代；WebGL 不可用时须诊断具体原因而非静默替换；纹理范围不得跨级拉伸；需保留 GPL-3.0-or-later 许可与作者署名注释；具体收费、价格与平台支持情况暂未提供。