使用说明 | 百度地图API SDK

所有文档

Skills专区

Skills技能介绍

JSAPI

Android

iOS

HarmonyOS NEXT

WebAPI

更新时间: 2026/03/13 16:53

本产品提供一组面向 HarmonyOS NEXT 百度地图 平台的 AI Coding Agent Skills，帮助开发者在智能研发工具（如 Cursor / Claude Code等）中高效完成鸿蒙应用的创建、地图 SDK 集成与 ArkTS 代码开发。

Skills 概览

Skill	说明
Skill	说明
baidu-map-harmonyos-sdk	百度地图鸿蒙 SDK 开发助手：提供完整开发辅助，涵盖地图展示交互功能，如组件初始化、类型切换等；支持多种覆盖物绘制；具备强大检索能力，可进行 POI/AOI 等多种检索；能实现驾车、步行等多路线规划；提供步骑行导航，含引擎初始化、语音播报等；定位能力包括前后台连续定位等；还有距离计算、坐标转换等工具类功能，以及调起百度地图客户端的便捷操作。
harmony-arkts-dev-assistant	HarmonyOS ArkTS 开发规范助手：在生成或重构 ArkTS/ArkUI 代码时，提供涵盖组件装饰器与状态管理、生命周期与资源清理、样式布局调用顺序、类型与空值安全（ArkTSCheck）、性能优化（缓存复用、LazyForEach等）、错误处理、日志规范及代码审查清单的全方位规范约束。
harmony-empty-project	HarmonyOS NEXT 空工程模板生成助手：生成器能由零开始创建标准的 Stage 模型 + ArkTS 最小可运行工程。它涵盖完整的工程目录结构，如AppScope等模块及配置；包含标准配置文件，像oh-package.json5等；具备入口能力与首页；提供资源文件和 SVG 图标占位；还支持依赖管理与构建自检流程。

使用方式

通过 skills.sh 一键安装（推荐）

skills.sh 是一个开放的 AI Skills 生态平台，支持 Claude Code、Cursor、GitHub Copilot 等 20+ 种 AI 工具。通过以下命令可以直接安装 Skills：


npx skills add baidu-maps/harmony-sdk-skills

安装完成后 Skills 会自动注册到当前环境的 skills 目录中。

2. 手动安装（可选）

（1）将 Skill 下载到本地
方式一：克隆本仓库


git clone https://github.com/baidu-maps/harmony-sdk-skills.git
cd harmony-sdk-skills

方式二：从 Release 下载
你也可以直接从 Release 下载附件 harmony-sdk-skills.zip，然后解压使用：


unzip harmony-sdk-skills.zip
cd skills

（2）将 Skill 注册到你的 AI 助手
把 skills/ 目录下的 baidu-map-harmonyos-sdk、harmony-arkts-dev-assistant、harmony-empty-project 链接或复制到当前环境对应的 skills 目录，这样 AI 在对话时会自动读取这些文档。
Claude Code（本地）

Skills 目录一般为：~/.claude/skills/
注册（软链，推荐）：


ln -sfn "$(pwd)/skills/baidu-map-harmonyos-sdk" ~/.claude/skills/baidu-map-harmonyos-sdk
ln -sfn "$(pwd)/skills/harmony-arkts-dev-assistant" ~/.claude/skills/harmony-arkts-dev-assistant
ln -sfn "$(pwd)/skills/harmony-empty-project" ~/.claude/skills/harmony-empty-project

或直接把 skills/ 下的文件夹复制到 ~/.claude/skills/ 下。

Cursor

Skills 目录一般为：~/.cursor/skills-cursor/
注册（软链，推荐）：


ln -sfn "$(pwd)/skills/baidu-map-harmonyos-sdk" ~/.cursor/skills-cursor/baidu-map-harmonyos-sdk
ln -sfn "$(pwd)/skills/harmony-arkts-dev-assistant" ~/.cursor/skills-cursor/harmony-arkts-dev-assistant
ln -sfn "$(pwd)/skills/harmony-empty-project" ~/.cursor/skills-cursor/harmony-empty-project

或直接把 skills/ 下的文件夹复制到 ~/.cursor/skills-cursor/ 下。

3. 在对话中使用

在支持 Skills 的客户端里，当你的问题涉及「百度地图」「鸿蒙百度地图 SDK」「HarmonyOS NEXT」「ArkTS 开发规范」「鸿蒙空工程」等关键词时，助手会优先参考本仓库中对应 Skill 的文档来回答，从而给出更贴合百度地图 HarmonyOS NEXT SDK 的代码与用法。

仓库结构


harmony-sdk-skills/
├── CHANGELOG.md              # 变更日志
├── README.md                 # 中文
├── README_EN.md              # English README
└── skills/
    ├── baidu-map-harmonyos-sdk/
    │   ├── SKILL.md          # Skill 定义文件
    │   └── references/       # API 文档、开发指南、资源文件
    ├── harmony-arkts-dev-assistant/
    │   └── SKILL.md          # Skill 定义文件
    └── harmony-empty-project/
        └── SKILL.md          # Skill 定义文件

SKILL.md中会列出其下所有参考文档，便于 AI 按需读取。

更新日志

本篇文章对您是否有帮助？