minemap-skills

MineMap 地图引擎（4.23）完整技能库。覆盖地图初始化、二三维叠加、3D Tiles、SceneModel、地形分析、粒子系统、视频投影、漫游跟踪、后处理、GaussianSplatting 等四十余个主题。技能均经源码与 demo 双重验证，可直接落地。

ming1zhou88@ming1zhou88

Install

openclaw skills install @ming1zhou88/minemap-skills

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

html

<!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>