minemap-skills
v1.0.0MineMap 地图引擎(4.23)完整技能库。覆盖地图初始化、二三维叠加、3D Tiles、SceneModel、地形分析、粒子系统、视频投影、漫游跟踪、后处理、GaussianSplatting 等四十余个主题。技能均经源码与 demo 双重验证,可直接落地。
Security Scan
OpenClaw
Benign
high confidencePurpose & 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.Like a lobster shell, security has layers — review code before you run it.
latest
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>
See Also
Comments
Loading comments...
