baidu-map-jsapi-three

使用 MapV-Three 构建专业的 3D 地图和 GIS 应用 - 基于 Z-up 坐标系的 3D 地图库，支持地图编辑、测量工具、要素绘制、数据管理等地理可视化功能。适用于创建地图编辑器、测量工具、空间数据可视化等 Web-GIS 应用。

Security Scan

技能声明、运行时指令和所需凭据在功能上是一致的：它是一个以 Baidu Map JS API 为目标的文档/开发指南，只要求 node 和一个 BMAP_JSAPI_KEY，没有安装脚本或可执行代码，整体内在一致性良好。

Purpose & Capability

技能名称/描述为 MapV-Three（基于 Baidu Map JS API）的 3D 地图库文档。唯一的必需环境变量是 BMAP_JSAPI_KEY（主凭据），这与地图瓦片/服务访问直接相关。需要 node 二进制用于本地构建或示例运行——对于提供前端库文档的包这是合理（尽管库主要用于浏览器）。

Instruction Scope

SKILL.md 与大量 reference 文档仅包含 API 使用示例、初始化和数据加载示例。没有指示读取系统范围的敏感文件、扫描其它凭据、或向非预期外部端点汇报数据。示例中存在普通的 fetch/Authorization 示例，这是典型的 API 调用示例。

Install Mechanism

这是指令/文档类技能，没有 install 规范，不会从不信任的 URL 下载或在安装时写入磁盘。没有可执行安装脚本，风险低。

Credentials

仅声明需要 BMAP_JSAPI_KEY（主凭据），数量和命名与技能目的匹配。没有要求与技能无关的密钥或密码，也未声明访问其它技能的配置路径。

Persistence & Privilege

技能未设置 always:true，也没有 install 脚本或自我修改配置的指令。agent 可自主调用技能是平台默认行为，但与该技能的内容/权限组合没有形成额外风险。包内的 .claude/settings.local.json 包含允许 WebSearch 与 Bash(echo:*) 的本地设置文件，这看起来像编辑器/本地测试配置而非运行时必需权限；应注意这是包内元数据但不会自动赋予更高系统权限。

Assessment

主要注意事项： - 该包只是文档/示例（无安装脚本或可执行代码），从内部一致性来看是安全的。要安装/使用时仅需提供 BMAP_JSAPI_KEY 用于访问百度地图服务。 - BMAP_JSAPI_KEY 属于访问地图服务的凭据；如果在浏览器端直接使用，它会暴露给终端用户/请求来源。为降低风险，最好对该 API Key 设置域名/Referer 限制或使用后端代理在服务器端保管敏感凭据。 - 检查并限制该 Key 的配额与权限，避免滥用导致费用或配额超限。 - 虽然包内没有安装脚本，但在把任何第三方 JS 库放入生产环境前，仍建议从官方或可信源获取运行时库/构建产物（而不是仅依赖本地文档示例），并审阅实际使用的第三方 CDN/URL。 - 注意包中包含 .claude/settings.local.json 之类的本地调试配置；这些不是必需的运行时权限，但显示了作者在本地测试时允许的操作（例如 WebSearch）。 总体：如果你只需要开发文档与示例，这个技能与其声明相符；在将 API Key 用于生产项目时采取常规的密钥保护与流量限制措施。

MapV-Three 开发指南

使用 MapV-Three 构建高性能的 3D 地图和 GIS 应用 - 一个采用 Z-up 坐标系的跨浏览器 WebGL 库。

何时适用

在以下场景中参考这些指南：

• 3D 地图编辑和要素绘制
• 地图测量工具开发
• 建筑物、区域等 3D 可视化
• 实时交通数据展示
• 路径追踪动画开发

快速参考

0. 核心引擎

• reference/engine.md - Engine 引擎核心：初始化、场景管理、渲染控制
• reference/initialization.md - 引擎初始化、资源配置、百度地图适配器

1. 数据管理

• reference/datasource.md - DataSource 数据源基类
• reference/datasource/geojson-datasource.md - GeoJSON 数据源
• reference/datasource/json-datasource.md - JSON 数据源
• reference/datasource/csv-datasource.md - CSV 数据源
• reference/datasource/dataitem.md - DataItem 数据项

2. 点对象与标签

• reference/simple-point.md - SimplePoint 简单点
• reference/effect-point.md - EffectPoint 特效点（Fan、Bubble、Wave、Breath、Radar 等）
• reference/marker-types.md - 标记类型（Icon、BallonPoint、DOMPoint、EffectModelPoint）
• reference/circle.md - Circle 圆形（屏幕空间渲染）
• reference/label.md - Label 文本/图标标签
• reference/text.md - Text 文本组件
• reference/cluster.md - ClusterPoint 点聚合

3. 线与面

• reference/polyline.md - Polyline 折线（flat 参数控制渲染模式）
• reference/simple-line.md - SimpleLine 简单线
• reference/wall.md - Wall 墙体/围栏
• reference/polygon.md - Polygon 多边形
• reference/pillar.md - Pillar 柱体

4. 覆盖物

• reference/marker.md - Marker 标记
• reference/popup.md - Popup 弹出窗口
• reference/dom-overlay.md - DOMOverlay DOM 覆盖物

5. 追踪器

• reference/tracker.md - 追踪器总览与生命周期
• reference/path-tracker.md - PathTracker 路径追踪
• reference/object-tracker.md - ObjectTracker 对象追踪
• reference/orbit-tracker.md - OrbitTracker 轨道追踪

6. 编辑与测量

• reference/editor.md - Editor 编辑器
• reference/measure.md - Measure 测量工具

7. 3D 模型

• reference/model.md - 3D 模型加载（SimpleModel/AnimationModel/LODModel）
• reference/twin.md - Twin 孪生车流（实时车流可视化、DataProvider 数据处理）
• reference/mock-twin.md - MockTwin 模拟车流（基于路线数据的车流模拟生成）

8. 材质与特效

• reference/materials.md - 材质系统（WaterMaterial、ExtendMeshStandardMaterial 等）
• reference/easing-function.md - 缓动函数（LINEAR、QUINTIC_IN_OUT、CUBIC_OUT）

9. 天空与天气

• reference/sky-weather.md - 天空系统（EmptySky/DynamicSky/StaticSky）和天气

10. 热力图

• reference/heatmap.md - Heatmap 热力图

11. 地图图层加载

• reference/imagery-tile-provider.md - 影像瓦片加载（Baidu、Tianditu、Bing、OSM、Stadia）
• reference/vector-tile-provider.md - 矢量瓦片加载（Baidu、Mapbox）
• reference/third-party-imagery.md - 第三方图层接入（WMS、WMTS、XYZ 标准协议）
• reference/terrain-tile-provider.md - 地形瓦片加载（Cesium、平面地形）
• reference/tile-mask.md - TileMask 瓦片掩膜（按区域裁剪瓦片图层显示）

12. LBS 位置服务

• reference/services.md - 位置基础服务（地理编码、搜索、路线规划、行政区划等）

13. 3DTiles 加载

• reference/3dtiles-loading.md - 3D Tiles 加载（Default3DTiles、HDMap3DTiles）

14. 基础概念

• reference/common/coordinate-system.md - 坐标系：Z-up、投影方式
• reference/common/event-binding.md - 事件绑定模式

关键注意事项

• 引擎初始化：new mapvthree.Engine(container, { map: { center: [lng, lat], range: meters } })
• 坐标系：Z-up（X-东、Y-北、Z-上），与 Three.js 默认 Y-up 不同
• 视野控制：使用 range（相机距离，米）而非 zoom
• 属性赋值：使用属性代理 obj.color = value，而非 obj.setColor(value)
• MeasureType：使用 mapvthree.Measure.MeasureType
• 图层设置：通过 MapView 设置影像/矢量/地形提供者，而非 engine.map