minemap-skills

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

Security Scan

This is an instruction-only skill that documents MineMap 4.23 usage patterns and example snippets; its stated purpose matches the instructions and it does not request unusual secrets, installs, or persistent privileges.

Purpose & Capability

Name/description (MineMap 3D map engine skills) align with the SKILL.md content: mapping/3D topics, API usage, and demos. Nothing in the metadata asks for unrelated cloud credentials, binaries, or system access.

Instruction Scope

SKILL.md is an instruction-only doc that provides example HTML/JS and many topic-specific patterns. It instructs inclusion of the remote minedata.cn CDN (minemap.js/minemap.css) and setting minemap.key/solution values (placeholders). That external script will execute in the user's page (expected for a mapping SDK); the skill does not instruct reading local files, accessing unrelated env vars, or exfiltrating data. Exercise the usual caution when loading third‑party CDN scripts and when providing API keys.

Install Mechanism

No install spec and no code files — lowest risk. The skill is documentation-only and does not download or extract archives during install.

Credentials

The skill declares no required environment variables, credentials, or config paths. The only credential-like fields shown are example placeholders (minemap.key, solution) in sample code — appropriate for a mapping SDK guide.

Persistence & Privilege

Skill does not request always:true or other elevated persistence and is user-invocable. It does not modify other skills or agent-wide configs.

Assessment

This SKILL.md is a documentation skill for MineMap and appears coherent. Before using it: (1) verify the GitHub repo and CDN URLs (the doc references minedata.cn and a GitHub repo) to ensure they're the intended upstream packages; (2) never paste real API keys into public chat — use placeholders in examples and store keys securely; (3) note that including the suggested CDN runs remote JavaScript in your page (expected for an SDK) — only include scripts from trusted sources and consider pinning to a verified release; (4) when loading 3D assets (glb, tilesets) prefer hosting from trusted storage and check CORS/permissions; (5) if you need higher assurance, ask the author for a signed release or checksum for the referenced minemap v4.23 files and inspect the linked GitHub repo contents before using in production.

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

---

适用原则

1. 优先新接口：3D 数据优先 map.addSceneComponent()，避免继续扩散废弃的 3d-tiles source/layer 写法。
2. 先判断加载状态：关键操作挂到 load / style.load 后执行，避免时序错误。
3. 围绕渲染后端做兜底：默认 auto，按 webgpu -> webgl2 -> webgl1 降级，针对特效做能力判断。
4. 优先可维护写法：采用引擎公开类（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>

---

See Also

• MineMap 官网
• GitHub 源仓库