MineMap Skills（基于 MineMap 4.23 源码）
MineMap 是一套"二维地图引擎能力 + 三维场景引擎能力"统一 runtime，主入口为 Map。
本技能库按主题拆包，让 AI 编码助手在生成 MineMap 代码时，优先使用源码一致、版本匹配、可直接落地的 API 与模式。
GitHub 源仓库: https://github.com/ming1zhou88/minemap-skills
使用方式
按需求主题加载对应 SKILL.md：
| 需求 | 对应技能包 |
|---|---|
| 初始化地图、控件、生命周期 | minemap-fundamentals |
| 官网入口、账号开通、文档导航 | minemap-official-resources-and-onboarding |
| key/solution、域名与资源配置 | minemap-global-configuration |
| 控件体系、自定义控件 | minemap-widget-and-controls |
| Marker / Popup / DOM 覆盖物 | minemap-marker-and-popup |
| 图层、Source、样式更新 | minemap-style-and-data |
| 图层系统与渲染顺序 | minemap-layer-system |
| style v8 结构、setStyle() | minemap-style-system |
| 二三维叠加、贴地、贴模型 | minemap-2d-3d-overlay-and-classification |
| ThreeLayer / threejs 融合 | minemap-threejs-integration |
| SceneModel / SceneTileset / SceneObject | minemap-scene-components |
| 3D Tiles 运行时着色、显隐 | minemap-3d-tiles-runtime-control |
| 模型运行时调试、线框、材质更新 | minemap-model-runtime-debug |
| Primitive、几何、材质 | minemap-primitives-and-materials |
| 包围体、碰撞检测、BVH | minemap-collision-and-bounding |
| 坐标变换与锚点矩阵 | minemap-transforms |
| 数学对象与姿态表达 | minemap-math-foundations |
| 光照、阴影 | minemap-lighting-and-shadows |
| 材质选型与着色 | minemap-material-system-and-shading |
| Primitive 贴地 | minemap-primitive-adapt-terrain |
| 屏幕空间反射（SSR） | minemap-screen-space-reflection |
| 水面材质、折射/反射 | minemap-water-surface-and-refraction |
| 事件、hover、GPU 拾取 | minemap-events-and-picking |
| 地形、量算、空间分析 | minemap-terrain-and-analysis |
| WebGL 后端选择、性能实践 | minemap-performance-and-backend |
| 后处理链、描边、雨雪、雾效 | minemap-post-process-and-render-pipeline |
| 抗锯齿与图像质量 | minemap-anti-aliasing |
| 相机限制、近裁剪面、截图 | minemap-camera-constraints-and-screenshot |
| 卷帘对比 Compare 插件 | minemap-plugin-compare-swipe |
| 编辑插件 | minemap-plugin-edit |
| ECharts 叠加插件 | minemap-plugin-echarts-integration |
| 在线示例编辑器 | minemap-plugin-demo-editor |
| 视频投影 | minemap-business-video-projection |
| 可视域 / 通视 | minemap-business-visibility-analysis |
| 淹没 / 阴影分析 | minemap-business-flood-and-shadow |
| 漫游 / 跟踪 | minemap-business-roaming-and-tracking |
| 粒子系统与特效 | minemap-business-particle-and-special-effects |
| 北斗网格码 | minemap-business-beidou-grid |
| 行政区划拉伸 | minemap-business-admin-division |
| Gaussian Splatting | minemap-business-gaussian-splatting |
| 倾斜摄影 / BIM / 3D Tiles 装载 | minemap-business-oblique-bim |
| 航线、飞线、流动轨迹 | minemap-business-airline-and-lines |
| 三维量算、贴地面积 | minemap-business-measurement |
| 地形裁剪面 | minemap-business-spatial-analysis-suite |
适用原则
- 优先新接口：3D 数据优先
map.addSceneComponent()，避免继续扩散废弃的3d-tilessource/layer 写法。 - 先判断加载状态：关键操作挂到
load/style.load后执行，避免时序错误。 - 围绕渲染后端做兜底：默认
auto，按webgpu -> webgl2 -> webgl1降级，针对特效做能力判断。 - 优先可维护写法：采用引擎公开类（
minemap.SceneModel、minemap.SceneTileset、minemap.Primitive等）而非内部私有对象。
版本基线
- 引擎版本：
minemap-3d-engine@4.23.0 - 校验依据：
source/api/map.js、source/index.js、source/style/style.js、demo/html/*.html
Quick Start
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<script src="https://minedata.cn/minemapapi/v4.23.0/minemap.js"></script>
<link href="https://minedata.cn/minemapapi/v4.23.0/minemap.css" rel="stylesheet" />
</head>
<body>
<div id="map" style="width:100%;height:100vh;"></div>
<script>
minemap.key = "YOUR_KEY";
minemap.solution = YOUR_SOLUTION_ID;
minemap.domainUrl = "https://minedata.cn";
const map = new minemap.Map({
container: "map",
style: "minemap://styles/street",
position: [116.39, 39.9, 3000],
pitch: 60,
bearing: 0,
renderBackend: "auto" // auto -> webgpu / webgl2 / webgl1
});
map.on("load", () => {
// 加三维模型
map.addSceneComponent({
id: "building",
type: "3d-model",
data: "https://example.com/building.glb",
position: new minemap.Math.Vector3(116.39, 39.9, 0),
rotation: [90, 0, 0],
scale: [1, 1, 1],
allowPick: true
});
});
</script>
</body>
</html>