{"id":"f66d08da-485e-450f-b319-a205e0cb0669","entityType":"agent","slug":"clawhub-baidu-maps-bmap-cli","name":"Baidu Map Cli（百度地图官方Cli工具）","canonicalUrl":"https://www.xpersona.co/agent/clawhub-baidu-maps-bmap-cli","canonicalPath":"/agent/clawhub-baidu-maps-bmap-cli","generatedAt":"2026-10-11T15:12:50.332Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T12:20:15.954Z","emptyReason":null},"description":"百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A... Skill: Baidu Map Cli（百度地图官方Cli工具） Owner: baidu-maps Summary: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A... Tags: latest:1.0.2 Version history: v1.0.2 | 2026-06-02T02:25:16.298Z | user bmap-cli 1.0.2 - 移除了 skill-card.md 文件。 - SKILL.md：补充与强化百度地图 Agent Plan 支持，新增“语义化 AI 搜索”“AI 路线规划”等地理任务能力描述。 - 明确 Agent Pla","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:bmap-cli","sourceUrl":"https://clawhub.ai/baidu-maps/bmap-cli","homepage":"https://clawhub.ai/baidu-maps/skills/bmap-cli","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/baidu-maps/bmap-cli","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/baidu-maps/skills/bmap-cli","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T12:20:15.954Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T12:20:15.954Z","emptyReason":null},"stars":null,"forks":null,"downloads":1066,"packageName":null,"latestVersion":"1.0.2","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T12:20:15.882Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T12:20:15.954Z","lastCrawledAt":"2026-10-11T12:20:15.882Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T12:20:15.882Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.2","createdAt":"2026-06-02T02:25:16.298Z","changelog":"bmap-cli 1.0.2 - 移除了 skill-card.md 文件。 - SKILL.md：补充与强化百度地图 Agent Plan 支持，新增“语义化 AI 搜索”“AI 路线规划”等地理任务能力描述。 - 明确 Agent Plan 必须先查后建流程，严格限制 ap create 的条件，防止误覆盖已有 plan。 - 登录流程写法规范化，禁止 timeout、后台(&)、重定向、轮询等错误调用方式，强调授权 URL 必须完整展示。 - 增补常见出错模式的禁止项，细化命令执行时的环境处理和提权流程示例。","fileCount":3,"zipByteSize":8782},{"version":"1.0.1","createdAt":"2026-05-22T07:18:52.584Z","changelog":"- 增加对百度地图 Agent Plan 的说明，支持无需开发者账户的找地点、路线规划、天气、地址解析等任务场景。 - 更新版本升级规则：必须展示完整更新命令及下载域名，提醒用户核对来源并征得同意，方可升级。 - 安装 CLI 时增加安全提示，建议用户核查下载域名和校验和，无默认签名验证。 - 扩展 Skill 安装步骤：要求自动处理 skills 复制、Token 持久化和验证，并遮掩展示 Token。 - 明确地理任务须用 baidu-ai-map skill 为唯一入口，不允许用 baidu-map-webapi 替代，并强调降级行为禁止。 - 强化浏览器端 AK 风险说明，仅允许 b_referers='*' 用于 demo 场景，生产建议使用白名单域名，并新增安全提示。","fileCount":3,"zipByteSize":7752},{"version":"1.0.0","createdAt":"2026-05-15T02:59:22.007Z","changelog":"bmap-cli 0.1.1 - 更改命令自动更新和配置变更流程，所有关键操作须先征得用户同意后执行（如更新 CLI、写入配置、创建 AK/样式等）。 - 明确操作边界，所有写入/创建类变更均需用户审核确认，仅查询类操作可自动完成。 - 新增“输出完整内容供用户审阅”要求，配置写入前必须显示内容由用户确认。 - 新增对登录流程的智能处理（检测未登录时主动引导、辅助用户完成登录后重试）。 - 规范前端地图 API 默认版本为 BMapGL（GL 版），仅用户指定时用 v3.0。 - 明确所有代码、AK、样式等关键字段获取与写入流程仅允许来源于 CLI 原始输出，严禁手填猜测。","fileCount":2,"zipByteSize":4943},{"version":"0.1.0","createdAt":"2026-05-12T07:19:07.783Z","changelog":"bmap-cli 0.1.0 - 首次发布的百度地图开放平台 CLI 工具，支持从安装、技能/MCP 配置到账户与 AK 管理全流程自动化。 - 提供一套标准流程，涉及 CLI 装配、技能/MCP 幂等合并、AK/个性化地图样式查建，并规范命令输出处理与错误排查。 - 严格控制浏览器端 AK 的 Referer（仅认 `*`），所有标识/配置一律从 CLI 原始输出获得，禁止猜测或手填。 - 支持覆盖地点/路线/地址解析、天气、开发 API、DEMO 生成等多种百度地图应用场景。 - 明确限定各步操作、AK 安全展示、白名单规则及多账户切换流程。","fileCount":2,"zipByteSize":4453}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178nge8tvzzhnan6cc08q0ech84dmtm:bmap-cli","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T15:12:50.332Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-maps-bmap-cli/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T12:20:15.954Z","emptyReason":null},"readme":"Skill: Baidu Map Cli（百度地图官方Cli工具）\n\nOwner: baidu-maps\n\nSummary: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A...\n\nTags: latest:1.0.2\n\nVersion history:\n\nv1.0.2 | 2026-06-02T02:25:16.298Z | user\n\nbmap-cli 1.0.2\n\n- 移除了 skill-card.md 文件。\n- SKILL.md：补充与强化百度地图 Agent Plan 支持，新增“语义化 AI 搜索”“AI 路线规划”等地理任务能力描述。\n- 明确 Agent Plan 必须先查后建流程，严格限制 ap create 的条件，防止误覆盖已有 plan。\n- 登录流程写法规范化，禁止 timeout、后台(&)、重定向、轮询等错误调用方式，强调授权 URL 必须完整展示。\n- 增补常见出错模式的禁止项，细化命令执行时的环境处理和提权流程示例。\n\nv1.0.1 | 2026-05-22T07:18:52.584Z | user\n\n- 增加对百度地图 Agent Plan 的说明，支持无需开发者账户的找地点、路线规划、天气、地址解析等任务场景。\n- 更新版本升级规则：必须展示完整更新命令及下载域名，提醒用户核对来源并征得同意，方可升级。\n- 安装 CLI 时增加安全提示，建议用户核查下载域名和校验和，无默认签名验证。\n- 扩展 Skill 安装步骤：要求自动处理 skills 复制、Token 持久化和验证，并遮掩展示 Token。\n- 明确地理任务须用 baidu-ai-map skill 为唯一入口，不允许用 baidu-map-webapi 替代，并强调降级行为禁止。\n- 强化浏览器端 AK 风险说明，仅允许 b_referers='*' 用于 demo 场景，生产建议使用白名单域名，并新增安全提示。\n\nv1.0.0 | 2026-05-15T02:59:22.007Z | user\n\nbmap-cli 0.1.1\n\n- 更改命令自动更新和配置变更流程，所有关键操作须先征得用户同意后执行（如更新 CLI、写入配置、创建 AK/样式等）。\n- 明确操作边界，所有写入/创建类变更均需用户审核确认，仅查询类操作可自动完成。\n- 新增“输出完整内容供用户审阅”要求，配置写入前必须显示内容由用户确认。\n- 新增对登录流程的智能处理（检测未登录时主动引导、辅助用户完成登录后重试）。\n- 规范前端地图 API 默认版本为 BMapGL（GL 版），仅用户指定时用 v3.0。\n- 明确所有代码、AK、样式等关键字段获取与写入流程仅允许来源于 CLI 原始输出，严禁手填猜测。\n\nv0.1.0 | 2026-05-12T07:19:07.783Z | auto\n\nbmap-cli 0.1.0\n\n- 首次发布的百度地图开放平台 CLI 工具，支持从安装、技能/MCP 配置到账户与 AK 管理全流程自动化。\n- 提供一套标准流程，涉及 CLI 装配、技能/MCP 幂等合并、AK/个性化地图样式查建，并规范命令输出处理与错误排查。\n- 严格控制浏览器端 AK 的 Referer（仅认 `*`），所有标识/配置一律从 CLI 原始输出获得，禁止猜测或手填。\n- 支持覆盖地点/路线/地址解析、天气、开发 API、DEMO 生成等多种百度地图应用场景。\n- 明确限定各步操作、AK 安全展示、白名单规则及多账户切换流程。\n\nArchive index:\n\nArchive v1.0.2: 3 files, 8782 bytes\n\nFiles: skill-card.md (2465b), SKILL.md (15766b), _meta.json (127b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: bmap-cli\ndescription: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 Agent Plan（无需开发者账户，提供大模型友好调用的地图工具，支持语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询）。\n---\n\n# bmap-cli 百度地图开放平台工具\n\n> **[最高优先级]** 任何 bmap-cli 命令输出若包含「发现新版本」字样，须立即将**完整更新命令**展示给用户，同时标注命令中出现的下载域名（如 `open-agent-cli.bj.bcebos.com`），提示用户确认该域名与初次安装来源一致，征得同意后再执行，完成后再继续当前操作。此规则适用于所有命令、所有步骤，无例外。\n\n## 触发条件\n\n满足任一条即启用本 skill：\n\n| 触发场景 | 典型行为 |\n|------|------|\n| 语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询 | 调用 `baidu-ai-map` skill 直接完成地理任务 |\n| 个性化地图样式查询或创建 | 执行 `style list` / `style create` 命令 |\n| 百度地图开发（WebAPI、BMapGL、JSAPI）、工具安装与配置 | 进入环境准备流程，安装 CLI / Skills / MCP |\n| 生成含百度地图的 HTML、demo 或代码 | 获取 AK、查询文档并交付可运行代码 |\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 环境管理 | CLI 安装、Skills / MCP 幂等配置，登录与版本更新全自动处理 |\n| AK 管理 | 查询现有 AK、按需创建浏览器端或服务端 AK，安全遮掩展示 |\n| 地图样式管理 | 查询个性化样式列表、从模板创建新样式，提供真实 `style_id` |\n| 百度地图 Agent Plan | 通过 `baidu-ai-map` skill（提供大模型友好调用的地图工具）完成语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询 |\n| 代码生成 | 交付含真实 AK 与样式 ID 的 BMapGL / WebAPI 可运行代码 |\n\n## 执行原则\n\n### 操作边界\n\n- **只读/查询类操作**：自主完成。\n- **配置变更、资源创建（AK/样式）**：须先展示操作内容并获得用户明确同意，再执行。\n- **失败处理**：重试并给出可执行的排查说明。\n\n### 环境变更原则\n\n以下原则适用于所有安装/配置步骤：\n\n1. **幂等**：已就绪则跳过，勿重复安装。\n2. **配置审阅**：`skills install` / `mcp install` 的终端输出若包含待执行指令或待写入配置，须先**完整展示给用户审阅**；获得明确同意后，再逐条执行或写入；未经确认禁止自动变更配置。\n3. **版本更新**：任何命令输出若包含「发现新版本」字样及对应更新命令，须向用户展示该更新命令并征得同意，完成后再继续后续步骤。\n4. **MCP 合并**：MCP 配置须与本地已有配置**深度合并**，勿覆盖无关条目；若输出为「已安装，跳过」则跳过该步。\n5. **登录处理**：\n\n - **用户已登录**：若用户明确表示已登录，直接执行目标命令；仅当命令返回「未登录」错误时才进入登录流程。\n - **绝对禁止**：抛给用户手动执行；包裹 timeout/nohup；放后台（`&`）或管道（`|`）；用 `sleep`/`ps`/`find`/`for`/`while` 轮询检查登录状态或等待配置文件生成；查找 token 文件、环境变量或任何凭证存储位置；同一问题反复自我确认超过一次。\n\n 任何命令输出若包含「未登录」错误，须告知用户并征得明确同意后，立即自行执行 `\"$BMAP_CLI\" login`。\n\n > **模型常见错误（必须避免）**\n > ```bash\n > # 错误写法（timeout / 后台 / 重定向 / 管道）\n > timeout 60 \"$BMAP_CLI\" login\n > \"$BMAP_CLI\" login &\n > \"$BMAP_CLI\" login > /tmp/out.txt 2>&1 &\n > \"$BMAP_CLI\" login | head -20\n > **唯一正确写法**：`\"$BMAP_CLI\" login`\n\n `login` 是**引导用户完成浏览器授权的人机协作流程**，不是模型获取 token 的技术脚本。执行后立刻输出授权 URL 并进入轮询等待；token 由 CLI 内部管理，模型不需要知道也不应该去查找。**模型不得等待命令结束**，必须在第一时间提取 URL 并以独立代码块展示给用户，同时告知用户在浏览器中点击授权：\n\n ```\n 请在浏览器中打开以下链接完成授权（完整链接，禁止省略或截断）。如已完成登录授权，可忽略此链接：\n <完整 URL>\n ```\n\n URL 展示后即表示模型已完成本分工作，剩余时间由用户在浏览器侧完成授权；CLI 内部管理 5 分钟轮询超时，模型无需干预。\n\n## 工作流程\n\n### 工作流总览\n\n```\n触发 skill\n ↓\n阶段一（幂等）: ① 安装 CLI → ② skills install → ③ mcp install\n ↓ 输出含「未登录」? → bmap-cli login（前台阻塞，禁止 timeout/&）→ 重试后继续\n ↓\n阶段二（响应请求）\n ├─ 语义化 AI 任务 ────────── baidu-ai-map skill（唯一入口）\n ├─ 查文档 ──────────────── baidu-maps-docs MCP\n └─ 写代码（严格四步）\n ① 确定 AK 类型（浏览器端 / 服务端）\n ② 需样式? → style list 先查，无则 style create\n ③ ak list\n ④ 选/建 AK → 写入代码交付\n横切：任何命令含「发现新版本」→ 展示更新命令，征得同意后继续\n```\n\n### 阶段一：环境准备\n\n以下三步均为幂等操作，已就绪则跳过。\n\n#### 1. 安装 CLI\n\n必须将下载地址展示给用户。Claude Code 的 Bash 工具权限确认框会将完整 curl 命令（含 URL）展示给用户，用户点击「允许」即为明确同意；点击「拒绝」则中止安装。\n\n> **安全提示（ASI04）**：当前下载流程无内置校验和或签名验证，二进制文件真实性依赖对 `open-agent-cli.bj.bcebos.com` 的信任。如需验证，请通过百度地图开放平台官方渠道获取该版本的 SHA256 校验值，下载后执行 `sha256sum \"$BMAP_CLI\"` 比对。\n\n```bash\nmkdir -p ~/bin\n```\n\n```bash\nuname -s\n```\n\n```bash\nuname -m\n```\n\n根据上两步输出确定平台后缀（勿用管道拼接探测）：\n\n- `BMAP_OS`：`Darwin`→`darwin`，`Linux`→`linux`，其余转小写\n- `BMAP_ARCH`：`x86_64`→`amd64`，`aarch64`→`arm64`，其余保持原样\n\n将 ``、`` 替换为实际值后执行：\n\n```bash\nexport BMAP_CLI=\"$HOME/bin/bmap-cli--\"\n```\n\n幂等检查：若已可执行则跳过下载与赋权。\n\n```bash\ntest -x \"$BMAP_CLI\"\n```\n\n上一条失败（退出码非 0）时，依次执行：\n\n```bash\ncurl -fL \"https://open-agent-cli.bj.bcebos.com/cli/bmap-cli--\" -o \"$BMAP_CLI\"\n```\n\n```bash\nchmod +x \"$BMAP_CLI\"\n```\n\nPATH 幂等：先检查 `~/.zshenv` 是否已含 `HOME/bin`。\n\n```bash\ngrep -q 'HOME/bin' ~/.zshenv\n```\n\n上一条失败时执行：\n\n```bash\necho 'export PATH=\"$HOME/bin:$PATH\"' >> ~/.zshenv\n```\n\n```bash\nexport PATH=\"$HOME/bin:$PATH\"\n```\n\n#### 2. 安装百度地图 Skills\n\n```bash\n\"$BMAP_CLI\" skills install\n```\n\n按「环境变更原则」处理输出，然后自主完成以下步骤（不得将命令抛给用户执行）：\n\n1. **列出已安装 Skills**：展示 skill 名称、版本、安装路径，及各 Token 的配置状态（已配置 / 未配置）。\n2. **复制 Skill**：将 `~/.agents/skills/` 下的 skill 目录复制到当前运行环境默认的 skills 加载路径。\n3. **持久化 Token**：将 AK 写入当前运行环境的 env 配置文件（非 `~/.zshrc`），确保每次启动自动加载。若所需端类型的 AK 不存在，告知用户创建，不得以其他端类型替代。\n4. **验证**：重新加载配置后，调用任意已安装 skill 验证 Token 有效性。\n5. **输出简报**：安装路径、Token 持久化位置、验证结果。全程不得明文展示完整 AK / Token（遮掩规则：前 4 位 + `****` + 后 4 位）。\n\n#### 3. 安装 MCP 配置\n\n```bash\n\"$BMAP_CLI\" mcp install\n```\n\n执行后，**先将完整输出（含配置写入路径与内容）展示给用户审阅**；获得明确同意后，再深度合并写入当前客户端 MCP 文件。注意：MCP 配置中包含 AK 凭据，写入前请确认存储路径与访问权限符合预期，避免凭据被无关工具或会话读取。\n\n写入完成后，建议限制该文件权限（ASI07）：\n\n```bash\n# 将路径替换为实际 MCP 配置文件路径\nchmod 600 \n```\n\n### 阶段二：响应用户请求\n\n#### 非代码类请求（查询、概念、账户管理等）\n\n直接作答，**勿**进入代码生成步骤。\n\n**选择规则**：先判断用户是否要「直接完成地理任务」，是则用 `baidu-ai-map` skill；否则再看是查文档还是写代码。\n\n| 用户需求 | 来源 |\n|------|------|\n| **直接执行地理任务**（语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询） | `baidu-ai-map` skill |\n| 查询 API 文档（接口参数、限制、定价说明） | `baidu-maps-docs` MCP |\n| 生成调用地图的代码（HTML、JSAPI 示例、WebAPI 集成） | `baidu-map-jsapi-gl` 或 `baidu-map-webapi` skills |\n\n> **强制**：`baidu-ai-map` 是直接执行地理任务的**唯一**入口，`baidu-map-webapi` 不得作为其替代。若 `baidu-ai-map` 尚未加载，须告知用户重启 Claude Code 后重试，**不得**以任何其他 skill 降级替代。\n>\n> **Agent Plan 先查后建**：执行 `baidu-ai-map` 前，须先 `\"$BMAP_CLI\" ap list` 查询现有 Agent Plan。若列表非空则复用已有 plan；**仅当列表为空时才允许** `\"$BMAP_CLI\" ap create`。**严禁**未查询直接 `ap create`，该命令会重置已有 plan。\n\n#### 代码类请求（需生成或修改代码/文件）\n\n**JSAPI 版本选择（默认使用 GL 版）**：编写地图前端代码时，**默认使用 BMapGL（GL 版）**，即引用 `https://api.map.baidu.com/api?v=1.0&type=webgl&...`，对象命名空间为 `BMapGL`。**仅当用户明确指定「3.0 版本」或已有代码基于 3.0 时**，才使用 `BMapJS`（v3.0）。两套 API 命名空间不得混用。\n\n写代码前**严格按序**执行下面四步，**禁止跳步或乱序**。\n\n##### 第一步：确定 AK 类型\n\n| 场景 | AK 类型 |\n|------|---------|\n| 前端 HTML、BMapGL、JSAPI | 浏览器端 |\n| 服务端 WebAPI、后端脚本 | 服务端 |\n| 同时涉及前后端 | 两种都要 |\n| 其他 | 只取实际会用到的类型 |\n\n**浏览器端 AK 白名单规则**：`b_referers` 为「不限制」时，**只认字面值 `*`**。即：\n- `b_referers` 不得为空；\n- 不得用「按用户实际访问来源填域名」等描述代替 `*`。\n\n> **安全提示（ASI03）**：`b_referers = *` 的通配符 AK 会扩大暴露面，任何页面均可调用，存在配额被滥用风险。**仅适用于本地 demo 或受控测试环境**；生产/正式项目应使用具体域名白名单（如 `example.com`）的 AK。\n\n在 `ak list` 中，浏览器端 AK **仅优先**选用 `b_referers` 等于 `*` 的项（仅限 demo 场景），**勿**选用仅含具体域名白名单的项。若无此类 AK，须**先告知用户将要新建含 `--b-referers '*'` 的 AK**（仅适合 demo，会增大 AK 暴露面并消耗账户资源），征得用户明确同意后，再进入第四步创建。\n\n##### 第二步：获取地图样式 ID（如涉及）\n\n当需求涉及地图底图外观、视觉风格或样式时：\n\n```bash\n\"$BMAP_CLI\" style list 2>&1\n```\n\n- **先查后建（强制）**：必须先完整读取 `style list` 输出，在 `user_style_list` 中逐项比对并优先复用已存在且满足需求的样式；**禁止**未检查就直接 `style create`。\n- 仅当 `user_style_list` **确实无满足项** 时，才允许从 `template_list` 选最匹配模板（优先 `need_business_accredit: false`）并创建：\n\n```bash\n\"$BMAP_CLI\" style create --tpl-id 2>&1\n```\n\n- `style_id` **只能**取自 CLI 原始输出（`style list` 的已有项或 `style create` 的返回结果）；**禁止**手写、猜测、拼接或编造。代码中**仅**使用该真实 `style_id` 的 `styleId` 方式：\n\n```javascript\nmap.setMapStyleV2({ styleId: '从 CLI 获取的 style_id' });\n```\n\n- **任何场景禁止** `setMapStyleV2` 的 `styleJson` 及等价手写 JSON 样式配置，无例外。\n\n##### 第三步：列出 AK\n\n```bash\n\"$BMAP_CLI\" ak list 2>&1\n```\n\n##### 第四步：选 AK 并写入代码\n\n通读 `ak list` 输出，按类型、服务范围选出最匹配的 AK。\n\n**浏览器端 AK 选择**：在满足类型与服务的前提下，**只**选用 `b_referers` 为 `*` 的 AK（仅限 demo 场景）；不把空串或其它写法当作不限制。**仅当列表中无此类 AK 时**，须先向用户说明将新建一个 `--b-referers '*'` 的浏览器端 AK（**仅适合 demo/受控测试，会扩大 AK 暴露面，可能造成配额被滥用；生产项目建议改用域名白名单**），并征得明确同意后，再执行：\n\n```bash\n\"$BMAP_CLI\" ak create --app-name \"<应用名称>\" --app-type 3 --b-referers '*' 2>&1\n```\n\n新建成功后，**重新执行第三步** `ak list`，再选定新 AK。\n\n**写入代码规范**：\n\n- 代码里**必须**使用列表中的**完整原始 AK 字符串**，禁止凭记忆或推断填写。\n- 涉及任何关键标识或精确字段（如 `ak`、`app_id`、`style_id` 等）时，**一律以当前轮次最新 CLI 原始输出为准**；禁止凭记忆、历史截图、先前回复回填。输出较大时必须做字段精确匹配并保证唯一（0 条或多条都先消歧）。\n- 用户已明确发出查询指令（如\"查询这个 AK 的调用量/配额\"）时，应按\"核验目标 -> 精确取字段 -> 立即执行查询 -> 返回结果\"直接执行；除非命令受阻（权限/网络/登录失效），否则禁止只道歉或反问。\n- `前4位****后4位` 等形式**仅**用于聊天说明，**禁止**写入源码。\n- 写入代码前，在对话中先发一行声明（固定格式）：\n ```\n > 已获取 AK：{前4位}****{后4位}（{app_type}，{app_name}，白名单：{b_referers}）\n ```\n\n- 交付代码中**不得**出现占位符、假 AK、「请自行替换」等提示。\n\n## 规范总览\n\n### AK 安全与展示\n\n- **存储**：AK 只写入目标代码文件；勿用 echo/print 把完整 AK 打到终端。\n- **展示**：对用户展示时用「前 4 位 + `****` + 后 4 位」（如 `ByM8****KMxw`）。\n- **列表展示**：禁止合并、分组、区间省略；保持原始顺序逐条列出；超过 20 条时按每 20 条一段连续展示直至完毕。\n\n### 输出规范\n\n登录链接（授权 URL）必须完整原样展示给用户，禁止省略、截断、折叠或以任何形式隐藏；报错堆栈、命令结果同理，禁止用「… +N 行」类截断。展示 URL 时须同时说明当前登录状态（如「已登录成功，URL 仅供参考」），避免用户误以为需要重新操作。\n\n### 配置复用与会话管理\n\n- **复用**：本环境已成功配置后，同一会话后续可直接复用，不必重复安装。\n- **切换账户**（如 `bmap-cli login` 后）旧 AK 全部作废，须依次：① `ak list` 替换本会话代码中的 AK；② `bmap-cli mcp install`（展示输出确认后更新）；③ `bmap-cli skills install` 更新 skills；④ 提醒用户自行替换其他历史会话文件。\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n \"slug\": \"bmap-cli\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1780367116298\n}\n\nFile v1.0.2:skill-card.md\n\n## Description:\n\nBaidu Map Cli guides agents through Baidu Maps CLI setup, account and API key handling, personalized map styles, Agent Plan map tools, and BMapGL/WebAPI code generation.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[baidu-maps](https://clawhub.ai/user/baidu-maps)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers use this skill to prepare Baidu Maps CLI environments, manage Baidu Maps API keys and styles with user approval, and generate runnable Baidu Maps integrations or perform supported map tasks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill may install and execute a remote Baidu-hosted CLI without a bundled checksum or signature.\n\nMitigation: Trust the download host only after confirming it matches the expected Baidu Maps source, and verify an official checksum or signature when available before use.\n\nRisk: The skill can activate additional skills or MCP configuration and persist API keys or tokens across sessions.\n\nMitigation: Review each proposed configuration change before applying it, restrict credential file permissions, and document where credentials are stored for later rotation or removal.\n\nRisk: Wildcard browser referrer API keys can be exposed or abused outside local demos.\n\nMitigation: Use wildcard referrers only for controlled local testing; use narrowly scoped domain allowlists for production projects.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/baidu-maps/skills/bmap-cli)\n- [Baidu Maps CLI download endpoint](https://open-agent-cli.bj.bcebos.com/cli/bmap-cli--)\n- [Baidu Maps WebGL JS API endpoint](https://api.map.baidu.com/api?v=1.0&type=webgl&...)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands, configuration snippets, and code blocks]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include masked API keys in explanatory text; generated code is expected to use complete keys selected from current CLI output.]\n\n## Skill Version(s):\n\n1.0.2 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.1: 3 files, 7752 bytes\n\nFiles: skill-card.md (3127b), SKILL.md (11786b), _meta.json (127b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: bmap-cli\ndescription: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 Agent Plan（无需开发者账户，可完成找地点、规划路线、查天气、解析 / 反解析地址等能力）。\nversion: 1.0.1\n---\n\n# bmap-cli 百度地图开放平台工具\n\n> **[最高优先级]** 任何 bmap-cli 命令输出若包含「发现新版本」字样，须立即将**完整更新命令**展示给用户，同时标注命令中出现的下载域名（如 `open-agent-cli.bj.bcebos.com`），提示用户确认该域名与初次安装来源一致，征得同意后再执行，完成后再继续当前操作。此规则适用于所有命令、所有步骤，无例外。\n\n## 触发条件\n\n满足任一条即启用本 skill：\n\n- 地点 / POI 搜索、路线导航、地址或坐标解析、天气查询（含 Agent Plan 场景）\n- 个性化地图样式查询或创建\n- 百度地图开发（WebAPI、BMapGL、JSAPI）、工具安装与配置\n- 生成含百度地图的 HTML、demo 或代码\n\n## 执行原则\n\n### 操作边界\n\n- **只读/查询类操作**：自主完成。\n- **配置变更、资源创建（AK/样式）**：须先展示操作内容并获得用户明确同意，再执行。\n- **失败处理**：重试并给出可执行的排查说明。\n\n### 环境变更原则\n\n以下原则适用于所有安装/配置步骤：\n\n1. **幂等**：已就绪则跳过，勿重复安装。\n2. **配置审阅**：`skills install` / `mcp install` 的终端输出若包含待执行指令或待写入配置，须先**完整展示给用户审阅**；获得明确同意后，再逐条执行或写入；未经确认禁止自动变更配置。\n3. **版本更新**：任何命令输出若包含「发现新版本」字样及对应更新命令，须向用户展示该更新命令并征得同意，完成后再继续后续步骤。\n4. **MCP 合并**：MCP 配置须与本地已有配置**深度合并**，勿覆盖无关条目；若输出为「已安装，跳过」则跳过该步。\n5. **登录处理**：任何命令输出若包含「未登录」错误，须告知用户需要登录并征得明确同意；获得同意后立即自行执行 `\"$BMAP_CLI\" login`（CLI 会自动打开浏览器，等待用户在浏览器点击授权即可），完成后重试原命令；禁止将登录命令抛给用户手动执行。\n\n## 执行流程\n\n### 阶段一：环境准备\n\n以下三步均为幂等操作，已就绪则跳过。\n\n#### 1. 安装 CLI\n\n必须将下载地址展示给用户。Claude Code 的 Bash 工具权限确认框会将完整 curl 命令（含 URL）展示给用户，用户点击「允许」即为明确同意；点击「拒绝」则中止安装。\n\n> **安全提示（ASI04）**：当前下载流程无内置校验和或签名验证，二进制文件真实性依赖对 `open-agent-cli.bj.bcebos.com` 的信任。如需验证，请通过百度地图开放平台官方渠道获取该版本的 SHA256 校验值，下载后执行 `sha256sum \"$BMAP_CLI\"` 比对。\n\n```bash\nmkdir -p ~/bin\nBMAP_OS=\"$(uname -s | tr '[:upper:]' '[:lower:]')\"\nBMAP_ARCH=\"$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')\"\nexport BMAP_CLI=\"$HOME/bin/bmap-cli-${BMAP_OS}-${BMAP_ARCH}\"\n\nif [[ ! -x \"$BMAP_CLI\" ]]; then\n curl -fL \"https://open-agent-cli.bj.bcebos.com/cli/bmap-cli-${BMAP_OS}-${BMAP_ARCH}\" \\\n -o \"$BMAP_CLI\" && chmod +x \"$BMAP_CLI\"\nfi\n\ngrep -q 'HOME/bin' ~/.zshenv 2>/dev/null || echo 'export PATH=\"$HOME/bin:$PATH\"' >> ~/.zshenv\nexport PATH=\"$HOME/bin:$PATH\"\n```\n\n#### 2. 安装百度地图 Skills\n\n```bash\n\"$BMAP_CLI\" skills install\n```\n\n按「环境变更原则」处理输出，然后自主完成以下步骤（不得将命令抛给用户执行）：\n\n1. **列出已安装 Skills**：展示 skill 名称、版本、安装路径，及各 Token 的配置状态（已配置 / 未配置）。\n2. **复制 Skill**：将 `~/.agents/skills/` 下的 skill 目录复制到当前运行环境默认的 skills 加载路径。\n3. **持久化 Token**：将 AK 写入当前运行环境的 env 配置文件（非 `~/.zshrc`），确保每次启动自动加载。若所需端类型的 AK 不存在，告知用户创建，不得以其他端类型替代。\n4. **验证**：重新加载配置后，调用任意已安装 skill 验证 Token 有效性。\n5. **输出简报**：安装路径、Token 持久化位置、验证结果。全程不得明文展示完整 AK / Token（遮掩规则：前 4 位 + `****` + 后 4 位）。\n\n#### 3. 安装 MCP 配置\n\n```bash\n\"$BMAP_CLI\" mcp install\n```\n\n执行后，**先将完整输出（含配置写入路径与内容）展示给用户审阅**；获得明确同意后，再深度合并写入当前客户端 MCP 文件。注意：MCP 配置中包含 AK 凭据，写入前请确认存储路径与访问权限符合预期，避免凭据被无关工具或会话读取。\n\n写入完成后，建议限制该文件权限（ASI07）：\n\n```bash\n# 将路径替换为实际 MCP 配置文件路径\nchmod 600 \n```\n\n### 阶段二：响应用户请求\n\n#### 非代码类请求（查询、概念、账户管理等）\n\n直接作答，**勿**进入代码生成步骤。\n\n**选择规则**：先判断用户是否要「直接完成地理任务」，是则用 `baidu-ai-map` skill；否则再看是查文档还是写代码。\n\n| 用户需求 | 来源 |\n|------|------|\n| **直接执行地理任务**（找地点、规划路线、查天气、解析 / 反解析地址） | `baidu-ai-map` skill |\n| 查询 API 文档（接口参数、限制、定价说明） | `baidu-maps-docs` MCP |\n| 生成调用地图的代码（HTML、JSAPI 示例、WebAPI 集成） | `baidu-map-jsapi-gl` 或 `baidu-map-webapi` skills |\n\n> **强制**：`baidu-ai-map` 是直接执行地理任务的**唯一**入口，`baidu-map-webapi` 不得作为其替代。若 `baidu-ai-map` 尚未加载，须告知用户重启 Claude Code 后重试，**不得**以任何其他 skill 降级替代。\n\n#### 代码类请求（需生成或修改代码/文件）\n\n**JSAPI 版本选择（默认使用 GL 版）**：编写地图前端代码时，**默认使用 BMapGL（GL 版）**，即引用 `https://api.map.baidu.com/api?v=1.0&type=webgl&...`，对象命名空间为 `BMapGL`。**仅当用户明确指定「3.0 版本」或已有代码基于 3.0 时**，才使用 `BMapJS`（v3.0）。两套 API 命名空间不得混用。\n\n写代码前**严格按序**执行下面四步，**禁止跳步或乱序**。\n\n##### 第一步：确定 AK 类型\n\n| 场景 | AK 类型 |\n|------|---------|\n| 前端 HTML、BMapGL、JSAPI | 浏览器端 |\n| 服务端 WebAPI、后端脚本 | 服务端 |\n| 同时涉及前后端 | 两种都要 |\n| 其他 | 只取实际会用到的类型 |\n\n**浏览器端 AK 白名单规则**：`b_referers` 为「不限制」时，**只认字面值 `*`**。即：\n- `b_referers` 不得为空；\n- 不得用「按用户实际访问来源填域名」等描述代替 `*`。\n\n> **安全提示（ASI03）**：`b_referers = *` 的通配符 AK 会扩大暴露面，任何页面均可调用，存在配额被滥用风险。**仅适用于本地 demo 或受控测试环境**；生产/正式项目应使用具体域名白名单（如 `example.com`）的 AK。\n\n在 `ak list` 中，浏览器端 AK **仅优先**选用 `b_referers` 等于 `*` 的项（仅限 demo 场景），**勿**选用仅含具体域名白名单的项。若无此类 AK，须**先告知用户将要新建含 `--b-referers '*'` 的 AK**（仅适合 demo，会增大 AK 暴露面并消耗账户资源），征得用户明确同意后，再进入第四步创建。\n\n##### 第二步：获取地图样式 ID（如涉及）\n\n当需求涉及地图底图外观、视觉风格或样式时：\n\n```bash\n\"$BMAP_CLI\" style list 2>&1\n```\n\n- **先查后建（强制）**：必须先完整读取 `style list` 输出，在 `user_style_list` 中逐项比对并优先复用已存在且满足需求的样式；**禁止**未检查就直接 `style create`。\n- 仅当 `user_style_list` **确实无满足项** 时，才允许从 `template_list` 选最匹配模板（优先 `need_business_accredit: false`）并创建：\n\n```bash\n\"$BMAP_CLI\" style create --tpl-id 2>&1\n```\n\n- `style_id` **只能**取自 CLI 原始输出（`style list` 的已有项或 `style create` 的返回结果）；**禁止**手写、猜测、拼接或编造。代码中**仅**使用该真实 `style_id` 的 `styleId` 方式：\n\n```javascript\nmap.setMapStyleV2({ styleId: '从 CLI 获取的 style_id' });\n```\n\n- **任何场景禁止** `setMapStyleV2` 的 `styleJson` 及等价手写 JSON 样式配置，无例外。\n\n##### 第三步：列出 AK\n\n```bash\n\"$BMAP_CLI\" ak list 2>&1\n```\n\n##### 第四步：选 AK 并写入代码\n\n通读 `ak list` 输出，按类型、服务范围选出最匹配的 AK。\n\n**浏览器端 AK 选择**：在满足类型与服务的前提下，**只**选用 `b_referers` 为 `*` 的 AK（仅限 demo 场景）；不把空串或其它写法当作不限制。**仅当列表中无此类 AK 时**，须先向用户说明将新建一个 `--b-referers '*'` 的浏览器端 AK（**仅适合 demo/受控测试，会扩大 AK 暴露面，可能造成配额被滥用；生产项目建议改用域名白名单**），并征得明确同意后，再执行：\n\n```bash\n\"$BMAP_CLI\" ak create --app-name \"<应用名称>\" --app-type 3 --b-referers '*' 2>&1\n```\n\n新建成功后，**重新执行第三步** `ak list`，再选定新 AK。\n\n**写入代码规范**：\n\n- 代码里**必须**使用列表中的**完整原始 AK 字符串**，禁止凭记忆或推断填写。\n- 涉及任何关键标识或精确字段（如 `ak`、`app_id`、`style_id` 等）时，**一律以当前轮次最新 CLI 原始输出为准**；禁止凭记忆、历史截图、先前回复回填。输出较大时必须做字段精确匹配并保证唯一（0 条或多条都先消歧）。\n- 用户已明确发出查询指令（如\"查询这个 AK 的调用量/配额\"）时，应按\"核验目标 -> 精确取字段 -> 立即执行查询 -> 返回结果\"直接执行；除非命令受阻（权限/网络/登录失效），否则禁止只道歉或反问。\n- `前4位****后4位` 等形式**仅**用于聊天说明，**禁止**写入源码。\n- 写入代码前，在对话中先发一行声明（固定格式）：\n\n ```\n > 已获取 AK：{前4位}****{后4位}（{app_type}，{app_name}，白名单：{b_referers}）\n ```\n\n- 交付代码中**不得**出现占位符、假 AK、「请自行替换」等提示。\n\n## 规范总览\n\n### AK 安全与展示\n\n- **存储**：AK 只写入目标代码文件；勿用 echo/print 把完整 AK 打到终端。\n- **展示**：对用户展示时用「前 4 位 + `****` + 后 4 位」（如 `ByM8****KMxw`）。\n- **列表展示**：禁止合并、分组、区间省略；保持原始顺序逐条列出；超过 20 条时按每 20 条一段连续展示直至完毕。\n\n### 输出规范\n\n登录链接、报错堆栈、命令结果禁止用「… +N 行」类截断，须完整原样给出。\n\n### 配置复用与会话管理\n\n- **复用**：本环境已成功配置后，同一会话后续可直接复用，不必重复安装。\n- **切换账户**（如执行 `bmap-cli login` 后）：旧账户 AK 全部作废，须依次：\n 1. 重新 `ak list`，替换**本会话**已生成代码中的 AK\n 2. 重新 `bmap-cli mcp install`，**展示输出给用户确认**后更新 MCP 中的 AK\n 3. 重新 `bmap-cli skills install` 更新 skills 中的 AK\n 4. 提醒用户：**其他历史会话**产出的文件需自行排查替换，助手无法感知跨会话写入的文件\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n \"slug\": \"bmap-cli\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1779434332584\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:
\n百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 Agent Plan（无需开发者账户，可完成找地点、规划路线、查天气、解析 / 反解析地址等能力）。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[baidu-maps](https://clawhub.ai/user/baidu-maps)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers and external users use this skill to set up and operate the Baidu Maps CLI workflow before working with Baidu Maps development, API keys, personalized map styles, POI search, routing, geocoding, reverse geocoding, and weather tasks. It guides installation, user approvals for configuration changes, account and AK handling, MCP configuration, and Baidu Maps code generation.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The workflow installs a Baidu Maps CLI binary from a remote download source without built-in checksum or signature verification.
\nMitigation: Install only when the Baidu Maps CLI download source is trusted, review every curl command before approval, and verify checksums through official Baidu Maps channels when available.
\nRisk: The workflow can create, persist, and write Baidu Maps AK credentials into environment or MCP configuration files.
\nMitigation: Review every env file path and MCP configuration write before approval, mask AKs in user-facing output, restrict credential-containing files with permissions such as chmod 600, and rotate or delete AKs if exposure is suspected.
\nRisk: Wildcard browser AKs can be abused outside local demo or controlled test contexts.
\nMitigation: Use wildcard browser AKs only for local demos or controlled tests; use domain-restricted AKs for production.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/baidu-maps/bmap-cli)
\n- [ClawHub publisher profile](https://clawhub.ai/user/baidu-maps)
\n- [Baidu Maps CLI download host](https://open-agent-cli.bj.bcebos.com)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]
\n**Output Format:** [Markdown responses with inline shell commands and code snippets]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include masked credential summaries and user-review prompts before install, login, AK creation, MCP writes, or other configuration changes.]
\n\n## Skill Version(s):
\n1.0.1 (source: frontmatter and release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.0: 2 files, 4943 bytes\n\nFiles: SKILL.md (9195b), _meta.json (127b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: bmap-cli\ndescription: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等。\nversion: 1.0.1\n---\n\n# bmap-cli 百度地图开放平台工具\n\n> **[最高优先级]** 任何 bmap-cli 命令输出若包含「发现新版本」字样，须立即将更新命令展示给用户并征得同意，获批后再执行更新，完成后再继续当前操作。此规则适用于所有命令、所有步骤，无例外。\n\n## 触发条件\n\n满足任一条即启用本 skill：\n\n- 地点 / POI 搜索、路线导航、地址或坐标解析、天气查询\n- 个性化地图样式查询或创建\n- 百度地图开发（WebAPI、BMapGL、JSAPI）、工具安装与配置\n- 生成含百度地图的 HTML、demo 或代码\n\n## 执行原则\n\n### 操作边界\n\n- **只读/查询类操作**：自主完成。\n- **配置变更、资源创建（AK/样式）**：须先展示操作内容并获得用户明确同意，再执行。\n- **失败处理**：重试并给出可执行的排查说明。\n\n### 环境变更原则\n\n以下原则适用于所有安装/配置步骤：\n\n1. **幂等**：已就绪则跳过，勿重复安装。\n2. **配置审阅**：`skills install` / `mcp install` 的终端输出若包含待执行指令或待写入配置，须先**完整展示给用户审阅**；获得明确同意后，再逐条执行或写入；未经确认禁止自动变更配置。\n3. **版本更新**：任何命令输出若包含「发现新版本」字样及对应更新命令，须向用户展示该更新命令并征得同意，完成后再继续后续步骤。\n4. **MCP 合并**：MCP 配置须与本地已有配置**深度合并**，勿覆盖无关条目；若输出为「已安装，跳过」则跳过该步。\n5. **登录处理**：任何命令输出若包含「未登录」错误，须告知用户需要登录并征得明确同意；获得同意后立即自行执行 `\"$BMAP_CLI\" login`（CLI 会自动打开浏览器，等待用户在浏览器点击授权即可），完成后重试原命令；禁止将登录命令抛给用户手动执行。\n\n## 执行流程\n\n### 阶段一：环境准备\n\n以下三步均为幂等操作，已就绪则跳过。\n\n#### 1. 安装 CLI\n\n必须将下载地址展示给用户。Claude Code 的 Bash 工具权限确认框会将完整 curl 命令（含 URL）展示给用户，用户点击「允许」即为明确同意；点击「拒绝」则中止安装。\n\n```bash\nmkdir -p ~/bin\nBMAP_OS=\"$(uname -s | tr '[:upper:]' '[:lower:]')\"\nBMAP_ARCH=\"$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')\"\nexport BMAP_CLI=\"$HOME/bin/bmap-cli-${BMAP_OS}-${BMAP_ARCH}\"\n\nif [[ ! -x \"$BMAP_CLI\" ]]; then\n curl -fL \"https://open-agent-cli.bj.bcebos.com/cli/bmap-cli-${BMAP_OS}-${BMAP_ARCH}\" \\\n -o \"$BMAP_CLI\" && chmod +x \"$BMAP_CLI\"\nfi\n\ngrep -q 'HOME/bin' ~/.zshenv 2>/dev/null || echo 'export PATH=\"$HOME/bin:$PATH\"' >> ~/.zshenv\nexport PATH=\"$HOME/bin:$PATH\"\n```\n\n#### 2. 安装百度地图 Skills\n\n```bash\n\"$BMAP_CLI\" skills install\n```\n\n按「环境变更原则」处理输出，直至安装流程全部完成。\n\n#### 3. 安装 MCP 配置\n\n```bash\n\"$BMAP_CLI\" mcp install\n```\n\n执行后，**先将完整输出（含配置写入路径与内容）展示给用户审阅**；获得明确同意后，再深度合并写入当前客户端 MCP 文件。注意：MCP 配置中包含 AK 凭据，写入前请确认存储路径与访问权限符合预期，避免凭据被无关工具或会话读取。\n\n### 阶段二：响应用户请求\n\n#### 非代码类请求（查询、概念、账户管理等）\n\n直接作答，**勿**进入代码生成步骤。\n\n| 信息类型 | 来源 |\n|------|------|\n| API 服务文档详细描述 | `baidu-maps-docs` MCP |\n| API 用法与示例代码 | `baidu-map-jsapi-gl` 或 `baidu-map-webapi` skills |\n\n#### 代码类请求（需生成或修改代码/文件）\n\n**JSAPI 版本选择（默认使用 GL 版）**：编写地图前端代码时，**默认使用 BMapGL（GL 版）**，即引用 `https://api.map.baidu.com/api?v=1.0&type=webgl&...`，对象命名空间为 `BMapGL`。**仅当用户明确指定「3.0 版本」或已有代码基于 3.0 时**，才使用 `BMapJS`（v3.0）。两套 API 命名空间不得混用。\n\n写代码前**严格按序**执行下面四步，**禁止跳步或乱序**。\n\n##### 第一步：确定 AK 类型\n\n| 场景 | AK 类型 |\n|------|---------|\n| 前端 HTML、BMapGL、JSAPI | 浏览器端 |\n| 服务端 WebAPI、后端脚本 | 服务端 |\n| 同时涉及前后端 | 两种都要 |\n| 其他 | 只取实际会用到的类型 |\n\n**浏览器端 AK 白名单规则**：`b_referers` 为「不限制」时，**只认字面值 `*`**。即：\n- `b_referers` 不得为空；\n- 不得用「按用户实际访问来源填域名」等描述代替 `*`。\n\n在 `ak list` 中，浏览器端 AK **仅优先**选用 `b_referers` 等于 `*` 的项，**勿**选用仅含具体域名白名单的项。若无此类 AK，须**先告知用户将要新建含 `--b-referers '*'` 的 AK**（会增大 AK 暴露面并消耗账户资源），征得用户明确同意后，再进入第四步创建。\n\n##### 第二步：获取地图样式 ID（如涉及）\n\n当需求涉及地图底图外观、视觉风格或样式时：\n\n```bash\n\"$BMAP_CLI\" style list 2>&1\n```\n\n- **先查后建（强制）**：必须先完整读取 `style list` 输出，在 `user_style_list` 中逐项比对并优先复用已存在且满足需求的样式；**禁止**未检查就直接 `style create`。\n- 仅当 `user_style_list` **确实无满足项** 时，才允许从 `template_list` 选最匹配模板（优先 `need_business_accredit: false`）并创建：\n\n```bash\n\"$BMAP_CLI\" style create --tpl-id 2>&1\n```\n\n- `style_id` **只能**取自 CLI 原始输出（`style list` 的已有项或 `style create` 的返回结果）；**禁止**手写、猜测、拼接或编造。代码中**仅**使用该真实 `style_id` 的 `styleId` 方式：\n\n```javascript\nmap.setMapStyleV2({ styleId: '从 CLI 获取的 style_id' });\n```\n\n- **任何场景禁止** `setMapStyleV2` 的 `styleJson` 及等价手写 JSON 样式配置，无例外。\n\n##### 第三步：列出 AK\n\n```bash\n\"$BMAP_CLI\" ak list 2>&1\n```\n\n##### 第四步：选 AK 并写入代码\n\n通读 `ak list` 输出，按类型、服务范围选出最匹配的 AK。\n\n**浏览器端 AK 选择**：在满足类型与服务的前提下，**只**选用 `b_referers` 为 `*` 的 AK；不把空串或其它写法当作不限制。**仅当列表中无此类 AK 时**，须先向用户说明将新建一个 `--b-referers '*'` 的浏览器端 AK（会扩大 AK 暴露面，可能造成配额被滥用），并征得明确同意后，再执行：\n\n```bash\n\"$BMAP_CLI\" ak create --app-name \"<应用名称>\" --app-type 3 --b-referers '*' 2>&1\n```\n\n新建成功后，**重新执行第三步** `ak list`，再选定新 AK。\n\n**写入代码规范**：\n\n- 代码里**必须**使用列表中的**完整原始 AK 字符串**，禁止凭记忆或推断填写。\n- 涉及任何关键标识或精确字段（如 `ak`、`app_id`、`style_id` 等）时，**一律以当前轮次最新 CLI 原始输出为准**；禁止凭记忆、历史截图、先前回复回填。输出较大时必须做字段精确匹配并保证唯一（0 条或多条都先消歧）。\n- 用户已明确发出查询指令（如\"查询这个 AK 的调用量/配额\"）时，应按\"核验目标 -> 精确取字段 -> 立即执行查询 -> 返回结果\"直接执行；除非命令受阻（权限/网络/登录失效），否则禁止只道歉或反问。\n- `前4位****后4位` 等形式**仅**用于聊天说明，**禁止**写入源码。\n- 写入代码前，在对话中先发一行声明（固定格式）：\n\n ```\n > 已获取 AK：{前4位}****{后4位}（{app_type}，{app_name}，白名单：{b_referers}）\n ```\n\n- 交付代码中**不得**出现占位符、假 AK、「请自行替换」等提示。\n\n## 规范总览\n\n### AK 安全与展示\n\n- **存储**：AK 只写入目标代码文件；勿用 echo/print 把完整 AK 打到终端。\n- **展示**：对用户展示时用「前 4 位 + `****` + 后 4 位」（如 `ByM8****KMxw`）。\n- **列表展示**：禁止合并、分组、区间省略；保持原始顺序逐条列出；超过 20 条时按每 20 条一段连续展示直至完毕。\n\n### 输出规范\n\n登录链接、报错堆栈、命令结果禁止用「… +N 行」类截断，须完整原样给出。\n\n### 配置复用与会话管理\n\n- **复用**：本环境已成功配置后，同一会话后续可直接复用，不必重复安装。\n- **切换账户**（如执行 `bmap-cli login` 后）：旧账户 AK 全部作废，须依次：\n 1. 重新 `ak list`，替换**本会话**已生成代码中的 AK\n 2. 重新 `bmap-cli mcp install`，**展示输出给用户确认**后更新 MCP 中的 AK\n 3. 重新 `bmap-cli skills install` 更新 skills 中的 AK\n 4. 提醒用户：**其他历史会话**产出的文件需自行排查替换，助手无法感知跨会话写入的文件\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n \"slug\": \"bmap-cli\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1778813962007\n}\n\nArchive v0.1.0: 2 files, 4453 bytes\n\nFiles: SKILL.md (8096b), _meta.json (127b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: bmap-cli\ndescription: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等。\nversion: 1.0.0\n---\n\n# bmap-cli 百度地图开放平台工具\n\n> **[最高优先级] 任何 bmap-cli 命令输出若包含「发现新版本」字样，必须立即执行输出中给出的更新命令，完成后再继续当前操作。此规则适用于所有命令、所有步骤，无例外。**\n\n处理百度地图相关需求时：**自主跑完全部流程**，不依赖用户手动操作；失败则重试并给出可执行的排查说明。\n\n## 触发条件\n\n满足任一条即启用本 skill：\n\n- 地点 / POI 搜索、路线导航、地址或坐标解析、天气查询 \n- 个性化地图样式查询或创建 \n- 百度地图开发（WebAPI、BMapGL、JSAPI）、工具安装与配置 \n- 生成含百度地图的 HTML、demo 或代码\n\n---\n\n## 执行流程\n\n**通用原则**\n\n- 以下各步**幂等**：已就绪则跳过，勿重复安装。 \n- `skills install` / `mcp install` 的终端输出是**待执行指令或待写入配置**，不是给用户的展示稿：须**逐条执行或写入**后再进入下一步；禁止只贴输出就继续。 \n- **任何命令输出若包含「发现新版本」字样及对应更新命令，须立即执行该更新命令，完成后再继续后续步骤。** \n- MCP 配置须与本地已有配置**深度合并**，勿覆盖无关条目；若输出为「已安装，跳过」则跳过该步。\n\n### 1) 检查并安装 CLI\n\n```bash\nmkdir -p ~/bin\nBMAP_OS=\"$(uname -s | tr '[:upper:]' '[:lower:]')\"\nBMAP_ARCH=\"$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')\"\nexport BMAP_CLI=\"$HOME/bin/bmap-cli-${BMAP_OS}-${BMAP_ARCH}\"\n\nif [[ ! -x \"$BMAP_CLI\" ]]; then\n curl -fL \"https://open-agent-cli.bj.bcebos.com/cli/bmap-cli-${BMAP_OS}-${BMAP_ARCH}\" \\\n -o \"$BMAP_CLI\" && chmod +x \"$BMAP_CLI\"\nfi\n\ngrep -q 'HOME/bin' ~/.zshenv 2>/dev/null || echo 'export PATH=\"$HOME/bin:$PATH\"' >> ~/.zshenv\nexport PATH=\"$HOME/bin:$PATH\"\n```\n\n### 2) 检查并安装百度地图 Skills\n\n```bash\n\"$BMAP_CLI\" skills install\n```\n\n按上节「通用原则」处理输出，直至安装流程全部完成。\n\n### 3) 检查并安装 MCP 配置\n\n```bash\n\"$BMAP_CLI\" mcp install\n```\n\n按上节「通用原则」将配置写入当前客户端 MCP 文件（深度合并）。\n\n### 4) 回答用户问题\n\n#### 非代码类（查询、概念、账户管理等）\n\n直接作答，**勿**进入下方写代码步骤。信息来源：\n\n| 类型 | 途径 |\n|------|------|\n| API 服务文档详细描述 | `baidu-maps-docs` MCP |\n| API 用法与示例代码 | `baidu-map-jsapi-gl` 或 `baidu-map-webapi` skills |\n\n#### 代码类（需生成或修改代码/文件）\n\n写代码前**严格按序**执行下面四步，**禁止跳步或乱序**。\n\n**第一步：确定 AK 类型**\n\n| 场景 | AK 类型 |\n|------|---------|\n| 前端 HTML、BMapGL、JSAPI | 浏览器端 |\n| 服务端 WebAPI、后端脚本 | 服务端 |\n| 同时涉及前后端 | 两种都要 |\n| 其他 | 只取实际会用到的类型 |\n\n**浏览器端 AK（重要）**：Referer 是否「不限制」**只认字面值 `*`**：`b_referers` **不得**为空，**不得**用「按用户实际访问来源填域名」等代替 `*`。在 `ak list` 中**仅优先**选用 `b_referers` **等于 `*`** 的浏览器端 AK；**勿**选用仅含具体域名白名单的项。若无 `*` 项，须**先创建**：`--b-referers` **必须为 `*`**，见第四步。\n\n**第二步：若涉及地图样式，用 CLI 得到 `styleId`**\n\n当需求涉及地图底图外观、视觉风格或样式（用户表述可能多维，不限于颜色、主题、元素层次等）时：\n\n```bash\n\"$BMAP_CLI\" style list 2>&1\n```\n\n- **先查后建（强制）**：必须先完整读取 `style list` 输出，在 `user_style_list` 中逐项比对并优先复用已存在且满足需求的样式；**禁止**未检查就直接 `style create`。 \n- 仅当 `user_style_list` **确实无满足项** 时，才允许从 `template_list` 选最匹配模板（优先 `need_business_accredit: false`）并创建：\n\n```bash\n\"$BMAP_CLI\" style create --tpl-id 2>&1\n```\n\n`style_id` **只能**取自 CLI 原始输出（`style list` 的已有项或 `style create` 的返回结果）；**禁止**手写、猜测、拼接或编造 `style_id`。在代码中**仅**使用该真实 `style_id` 的 `styleId` 方式，示例：\n\n```javascript\nmap.setMapStyleV2({ styleId: '从 CLI 获取的 style_id' });\n```\n\n**任何场景禁止** `setMapStyleV2` 的 `styleJson` 及等价手写 JSON 样式配置，无例外。\n\n**第三步：列出 AK**\n\n```bash\n\"$BMAP_CLI\" ak list 2>&1\n```\n\n**第四步：选 AK 并写入代码**\n\n通读 `ak list` 输出，按类型、服务范围选出最匹配的 AK；**浏览器端**还须遵守第一步中的 Referer 优先级规则：\n\n- **浏览器端**：在满足类型与服务的前提下，**只**选用 `b_referers` **为 `*`**（星号，表示不限制）的 AK；**不**把空串或其它写法当作不限制。**仅当列表中无此类 AK** 时，按下述命令新建（`--b-referers` 必须为 `*`），再 `ak list` 选用新 AK：\n\n```bash\n\"$BMAP_CLI\" ak create --app-name \"<应用名称>\" --app-type 3 --b-referers '*' 2>&1\n```\n\n新建浏览器端应用时：`--b-referers` **只能**填 `*`（星号），表示不限制；**禁止**留空、**禁止**按用户访问来源填写域名列表。创建成功后**重新执行第三步** `ak list`，再选定新 AK。\n\n- 代码里**必须**使用列表中的**完整原始 AK 字符串**，禁止凭记忆或推断填写。 \n- 涉及任何关键标识或精确字段（如 `ak`、`app_id`、`style_id` 等）时，**一律以当前轮次最新 CLI 原始输出为准**；禁止凭记忆、历史截图、先前回复回填。输出较大时必须做字段精确匹配并保证唯一（0 条或多条都先消歧）。 \n- 用户已明确发出查询指令（如“查询这个 AK 的调用量/配额”）时，应按“核验目标 -> 精确取字段 -> 立即执行查询 -> 返回结果”直接执行；除非命令受阻（权限/网络/登录失效），否则禁止只道歉或反问。 \n- `前4位****后4位` 等形式**仅**用于聊天说明，**禁止**写入源码。 \n- 写入代码前，在对话中先发一行声明（固定格式）：\n\n```\n> 已获取 AK：{前4位}****{后4位}（{app_type}，{app_name}，白名单：{b_referers}）\n```\n\n- 交付代码中**不得**出现占位符、假 AK、「请自行替换」等提示。\n\n---\n\n## 注意事项\n\n- **浏览器端与白名单**：「不限制」**仅**当 `b_referers`（列表）或 `--b-referers`（创建）为字面值 `*`；禁止空串、禁止用域名列表冒充不限制。优先选用列表中已是 `*` 的 AK；新建见第四步。勿将非 `*` 白名单的浏览器端 AK 当作默认可用项写入代码。 \n- **AK 安全**：AK 只写入目标代码文件；勿用 echo/print 把完整 AK 打到终端。对用户展示时用「前 4 位 + `****` + 后 4 位」（如 `ByM8****KMxw`）。 \n- **AK 列表展示**：禁止合并、分组、区间省略；保持原始顺序逐条列出；超过 20 条时按每 20 条一段连续展示直至完毕。 \n- **输出完整**：登录链接、报错堆栈、命令结果禁止用「… +N 行」类截断，须完整原样给出。 \n- **配置复用**：本环境已成功配置后，同一会话后续可直接复用，不必重复安装。 \n- **切换账户**（如执行 `bmap-cli login` 后）：旧账户 AK 全部作废，须依次： \n 1. 重新 `ak list`，替换**本会话**已生成代码中的 AK \n 2. 重新 `bmap-cli mcp install` 更新 MCP 中的 AK \n 3. 重新 `bmap-cli skills install` 更新 skills 中的 AK \n 4. 提醒用户：**其他历史会话**产出的文件需自行排查替换，助手无法感知跨会话写入的文件\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n \"slug\": \"bmap-cli\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1778570347783\n}","readmeExcerpt":"Skill: Baidu Map Cli（百度地图官方Cli工具） Owner: baidu-maps Summary: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A... Tags: latest:1.0.2 Version history: v1.0.2 | 2026-06-02T02:25:16.298Z | user bmap-cli 1.0.2 - 移除了 skill-card.md 文件。 - SKILL.md：补充与强化百度地图 Agent Plan 支持，新增“语义化 AI 搜索”“AI 路线规划”等地理任务能力描述。 - 明确 Agent Pla","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"> # 错误写法（timeout / 后台 / 重定向 / 管道）\n > timeout 60 \"$BMAP_CLI\" login\n > \"$BMAP_CLI\" login &\n > \"$BMAP_CLI\" login > /tmp/out.txt 2>&1 &\n > \"$BMAP_CLI\" login | head -20\n > **唯一正确写法**：`\"$BMAP_CLI\" login`\n\n `login` 是**引导用户完成浏览器授权的人机协作流程**，不是模型获取 token 的技术脚本。执行后立刻输出授权 URL 并进入轮询等待；token 由 CLI 内部管理，模型不需要知道也不应该去查找。**模型不得等待命令结束**，必须在第一时间提取 URL 并以独立代码块展示给用户，同时告知用户在浏览器中点击授权："},{"language":"text","snippet":"URL 展示后即表示模型已完成本分工作，剩余时间由用户在浏览器侧完成授权；CLI 内部管理 5 分钟轮询超时，模型无需干预。\n\n## 工作流程\n\n### 工作流总览"},{"language":"text","snippet":"### 阶段一：环境准备\n\n以下三步均为幂等操作，已就绪则跳过。\n\n#### 1. 安装 CLI\n\n必须将下载地址展示给用户。Claude Code 的 Bash 工具权限确认框会将完整 curl 命令（含 URL）展示给用户，用户点击「允许」即为明确同意；点击「拒绝」则中止安装。\n\n> **安全提示（ASI04）**：当前下载流程无内置校验和或签名验证，二进制文件真实性依赖对 `open-agent-cli.bj.bcebos.com` 的信任。如需验证，请通过百度地图开放平台官方渠道获取该版本的 SHA256 校验值，下载后执行 `sha256sum \"$BMAP_CLI\"` 比对。"},{"language":"text","snippet":"根据上两步输出确定平台后缀（勿用管道拼接探测）：\n\n- `BMAP_OS`：`Darwin`→`darwin`，`Linux`→`linux`，其余转小写\n- `BMAP_ARCH`：`x86_64`→`amd64`，`aarch64`→`arm64`，其余保持原样\n\n将 ``、`` 替换为实际值后执行："},{"language":"text","snippet":"幂等检查：若已可执行则跳过下载与赋权。"},{"language":"text","snippet":"上一条失败（退出码非 0）时，依次执行："}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: bmap-cli\ndescription: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 Agent Plan（无需开发者账户，提供大模型友好调用的地图工具，支持语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询）。\n---\n\n# bmap-cli 百度地图开放平台工具\n\n> **[最高优先级]** 任何 bmap-cli 命令输出若包含「发现新版本」字样，须立即将**完整更新命令**展示给用户，同时标注命令中出现的下载域名（如 `open-agent-cli.bj.bcebos.com`），提示用户确认该域名与初次安装来源一致，征得同意后再执行，完成后再继续当前操作。此规则适用于所有命令、所有步骤，无例外。\n\n## 触发条件\n\n满足任一条即启用本 skill：\n\n| 触发场景 | 典型行为 |\n|------|------|\n| 语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询 | 调用 `baidu-ai-map` skill 直接完成地理任务 |\n| 个性化地图样式查询或创建 | 执行 `style list` / `style create` 命令 |\n| 百度地图开发（WebAPI、BMapGL、JSAPI）、工具安装与配置 | 进入环境准备流程，安装 CLI / Skills / MCP |\n| 生成含百度地图的 HTML、demo 或代码 | 获取 AK、查询文档并交付可运行代码 |\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 环境管理 | CLI 安装、Skills / MCP 幂等配置，登录与版本更新全自动处理 |\n| AK 管理 | 查询现有 AK、按需创建浏览器端或服务端 AK，安全遮掩展示 |\n| 地图样式管理 | 查询个性化样式列表、从模板创建新样式，提供真实 `style_id` |\n| 百度地图 Agent Plan | 通过 `baidu-ai-map` skill（提供大模型友好调用的地图工具）完成语义化 AI 搜索、语义化 AI 路线规划、地理编码与逆地理编码、天气查询 |\n| 代码生成 | 交付含真实 AK 与样式 ID 的 BMapGL / WebAPI 可运行代码 |\n\n## 执行原则\n\n### 操作边界\n\n- **只读/查询类操作**：自主完成。\n- **配置变更、资源创建（AK/样式）**：须先展示操作内容并获得用户明确同意，再执行。\n- **失败处理**：重试并给出可执行的排查说明。\n\n### 环境变更原则\n\n以下原则适用于所有安装/配置步骤：\n\n1. **幂等**：已就绪则跳过，勿重复安装。\n2. **配置审阅**：`skills install` / `mcp install` 的终端输出若包含待执行指令或待写入配置，须先**完整展示给用户审阅**；获得明确同意后，再逐条执行或写入；未经确认禁止自动变更配置。\n3. **版本更新**：任何命令输出若包含「发现新版本」字样及对应更新命令，须向用户展示该更新命令并征得同意，完成后再继续后续步骤。\n4. **MCP 合并**：MCP 配置须与本地已有配置**深度合并**，勿覆盖无关条目；若输出为「已安装，跳过」则跳过该步。\n5. **登录处理**：\n\n - **用户已登录**：若用户明确表示已登录，直接执行目标命令；仅当命令返回「未登录」错误时才进入登录流程。\n - **绝对禁止**：抛给用户手动执行；包裹 timeout/nohup；放后台（`&`）或管道（`|`）；用 `sleep`/`ps`/`find`/`for`/`while` 轮询检查登录状态或等待配置文件生成；查找 token 文件、环境变量或任何凭证存储位置；同一问题反复自我确认超过一次。\n\n 任何命令输出若包含「未登录」错误，须告知用户并征得明确同意后，立即自行执行 `\"$BMAP_CLI\" login`。\n\n > **模型常见错误（必须避免）**\n > ```bash\n > # 错误写法（timeout / 后台 / 重定向 / 管道）\n > timeout 60 \"$BMAP_CLI\" login\n > \"$BMAP_CLI\" login &\n > \"$BMAP_CLI\" login > /tmp/out.txt 2>&1 &\n > \"$BMAP_CLI\" login | head -20\n > **唯一正确写法**：`\"$BMAP_CLI\" login`\n\n `login` 是**引导用户完成浏览器授权的人机协作流程**，不是模型获取 token 的技术脚本。执行后立刻输出授权 URL 并进入轮询等待；token 由 CLI 内部管理，模型不需要知道也不应该去查找。**模型不得等待命令结束**，必须在第一时间提取 URL 并以独立代码块展示给用户，同时告知用户在浏览器中点击授权：\n\n ```\n 请在浏览器中打开以下链接完成授权（完整链接，禁止省略或截断）。如已完成登录授权，可忽略此链接：\n <完整 URL>\n ```\n\n URL 展示后即表示模型已完成本分工作，剩余时间由用户在浏览器侧完成授权；CLI 内部管理 5 分钟轮询超时，模型无需干预。\n\n## 工作流程\n\n### 工作流总览\n\n```\n触发 skill\n ↓\n阶段一（幂等）: ① 安装 CLI → ② skills install → ③ mcp install\n ↓ 输出含「未登录」? → bmap-cli login（前台阻塞，禁止 timeout/&）→ 重试后继续\n ↓\n阶段二（响应请求）\n ├─ 语义化 AI 任务 ────────── baidu-ai-map skill（唯一入口）\n ├─ 查文档 ──────────────── baidu-maps-docs MCP\n └─ 写代码（严格四步）\n ① 确定 AK 类型（浏览器端 / 服务端）\n ② 需样式? → style list 先查，无则 style create\n ③ ak list\n ④ 选/建 AK → 写入代码交付\n横切：任何命令含「发现新版本」→ 展示更新命令，征得同意后继续\n```\n\n### 阶段一：环境准备\n\n以下三步均为幂等操作，已就绪则跳过。\n\n#### 1. 安装 CLI\n\n必须将下载地址展示给用户。Claude Code 的 Bash 工具权限确认框会将完整 curl 命令（含 URL）展示给用户，用户点击「允许」即为明确同意；点击「拒绝」则中止安装。\n\n> **安全提示（ASI04）**：当前下载流程无内置校验和或签名验证，二进制"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn778b6bf766ym71fdvrc5yvg98319rv\",\n \"slug\": \"bmap-cli\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1780367116298\n}"},{"path":"skill-card.md","content":"## Description:\n\nBaidu Map Cli guides agents through Baidu Maps CLI setup, account and API key handling, personalized map styles, Agent Plan map tools, and BMapGL/WebAPI code generation.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[baidu-maps](https://clawhub.ai/user/baidu-maps)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers use this skill to prepare Baidu Maps CLI environments, manage Baidu Maps API keys and styles with user approval, and generate runnable Baidu Maps integrations or perform supported map tasks.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill may install and execute a remote Baidu-hosted CLI without a bundled checksum or signature.\n\nMitigation: Trust the download host only after confirming it matches the expected Baidu Maps source, and verify an official checksum or signature when available before use.\n\nRisk: The skill can activate additional skills or MCP configuration and persist API keys or tokens across sessions.\n\nMitigation: Review each proposed configuration change before applying it, restrict credential file permissions, and document where credentials are stored for later rotation or removal.\n\nRisk: Wildcard browser referrer API keys can be exposed or abused outside local demos.\n\nMitigation: Use wildcard referrers only for controlled local testing; use narrowly scoped domain allowlists for production projects.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/baidu-maps/skills/bmap-cli)\n- [Baidu Maps CLI download endpoint](https://open-agent-cli.bj.bcebos.com/cli/bmap-cli--)\n- [Baidu Maps WebGL JS API endpoint](https://api.map.baidu.com/api?v=1.0&type=webgl&...)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands, configuration snippets, and code blocks]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include masked API keys in explanatory text; generated code is expected to use complete keys selected from current CLI output.]\n\n## Skill Version(s):\n\n1.0.2 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A... Skill: Baidu Map Cli（百度地图官方Cli工具） Owner: baidu-maps Summary: 百度地图开放平台 CLI。凡涉及百度地图开发、HTML/demo、WebAPI/BMapGL、AK/个性化地图样式/配额等，须先触发本 skill 并完成环境与 AK 流程，再查文档或写代码。涵盖：CLI 安装、Skills/MCP 配置、账户与 AK、个性化地图样式、地点/路线/地址解析等；同时支持百度地图 A... Tags: latest:1.0.2 Version history: v1.0.2 | 2026-06-02T02:25:16.298Z | user bmap-cli 1.0.2 - 移除了 skill-card.md 文件。 - SKILL.md：补充与强化百度地图 Agent Plan 支持，新增“语义化 AI 搜索”“AI 路线规划”等地理任务能力描述。 - 明确 Agent Pla","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":883,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T12:20:15.954Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T12:20:15.954Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T15:12:50.332Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}