| name | minemap-skills |
| display-name | MineMap 3D Map Engine Skills |
| description | MineMap 地图引擎（4.23）完整技能库。覆盖地图初始化、二三维叠加、3D Tiles、SceneModel、地形分析、粒子系统、视频投影、漫游跟踪、后处理、GaussianSplatting 等四十余个主题。技能均经源码与 demo 双重验证，可直接落地。
|
| license | MIT-0 |
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-tiles source/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,
:
});
map.(, {
map.({
: ,
: ,
: ,
: minemap..(, , ),
: [, , ],
: [, , ],
:
});
});
See Also
