前言¶

在 Agent 里做地图相关需求时，常见做法是碰到「画地图」「搜 POI」「算路线」就分别去找 JS API、WebService、LBS 的文档和对应 Skill。能力边界不同，密钥也不一致，对话里还要自己判断该走哪条链路。地图指挥官把腾讯地图相关能力收成一个入口：由技能识别需求类型，再协调官方子技能执行；结果以带特效的 HTML 文件落盘并预览，而不是在回复里贴一大段代码。

这是什么¶

地图指挥官（坐标 @user_fcba917f/map-commander）是 SkillHub 上的社区 Skill，分类为 dev-programming，当前版本 1.0.2，发布者 user_fcba917f，作者标注为 WorkBuddy AI，创建与最后更新时间为 2026-05-20。页面标签为 requires_api_key=true，表示依赖腾讯地图相关 API Key。

定位一句话：腾讯地图统一协作入口。用户表达腾讯地图、位置服务、LBS、POI、路径规划、地理编码等意图时，本技能作为统一入口，自动识别需求并协调以下官方子技能：

官方说明页：SkillHub API、SkillHub 展示页。

核心功能¶

需求路由与子技能协作¶

用户侧只需用自然语言描述地图类任务；技能侧负责判断应调用 JS API 能力、WebService 还是 LBS，再交给对应子技能。资料中列出的覆盖范围包括：地图应用开发（网页、小程序、App）、位置数据分析与可视化、地址/坐标转换与地理编码、路径规划与导航、周边搜索与 POI、地理围栏与区域分析、轨迹与旅游规划等。

常见触发词包括：腾讯地图、地图开发、位置服务、LBS、POI 搜索、路径规划、地理编码、坐标转换。

对话输出：HTML 文件 + 预览¶

本技能的对话输出模式为 HTML 文件 + 预览。调用时应：

1. 生成完整 HTML（DOCTYPE、head 含 style、body）。
2. 用 Write 工具保存到 workspace（例如 map-output.html）。
3. 使用 preview_url 打开该文件。
4. 在回复中用一两句话说明已完成。

资料明确要求：不要在对话里用 ```html 代码块代替文件与预览。

HTML 需满足赛博朋克视觉与交互规范，例如主色 #00d4ff、副色 #7b2dff、强调色 #ff00ff；渐变文字（background-clip: text）、发光、悬浮（translateY + scale）、扫光（::before + left 动画）、脉冲（@keyframes pulse）；背景含粒子、扫描线、网格；卡片悬浮 3D 与边框发光；@media 做移动端适配。内容区需包含：标题区（渐变 + 发光）、参数/数据（卡片 + 交替动画）、步骤（时间线 + 连线动画）、结果（网格 + 悬浮缩放）。

示例触发（来自官方说明）：

• 用户：「搜索北京咖啡馆」→ 生成 map-output.html → preview_url 预览。
• 用户：「规划跑步路线」→ 路线图、数据面板、卡路里等动态数字展示。

API 失败时的备选机制¶

当腾讯地图 API 调用失败时，技能会切换到联网搜索（WebSearch），并在 HTML 中标注「数据来源：联网搜索（API 不可用）」，并提示精度可能低于 API。搜索策略包括：

• 地理编码失败 →「地名 + 地址 + 经纬度」
• POI 搜索失败 →「类型 + 城市 + 推荐」
• 路线规划失败 →「起点 → 终点 路线」
• 天气查询失败 →「城市 + 天气预报」

备选数据源说明为：联网搜索（WebSearch 工具）。

安装与启用¶

在 SkillHub 安装或引用时，以页面坐标为准：

@user_fcba917f/map-commander

版本 1.0.2，来源 community。具体在 Cursor、Codex CLI、Claude Code 中的安装命令以你使用的客户端与 SkillHub 当前文档为准；本资料未给出分客户端的一键安装语句，安装后请按各子技能要求配置密钥。

子技能密钥依赖（来自官方说明）：

未配置或 Key 无效时，可能触发上述 WebSearch 备选路径，结果需在页面数据来源字段中区分。

典型用法¶

下面介绍与官方示例一致的使用方式，便于在 Agent 对话里复现。

1. 用触发词或自然语言描述任务（如 POI 搜索、路线规划、地理编码）。
2. 等待技能路由到对应子技能并拉取数据（或走备选搜索）。
3. 在 workspace 中查看生成的 map-output.html，并通过预览工具打开。
4. 若 API 不可用，在 HTML 内确认是否标注为联网搜索来源。

路线类需求可期望页面包含路线可视化区域、指标卡片与时间线步骤；搜索类需求以 POI/参数卡片与结果网格为主，具体字段取决于子技能返回与任务类型。

适用场景与注意¶

适合谁： 需要在 Agent 对话里快速完成腾讯地图能力组合、且希望结果以可预览 HTML 交付的开发者；涉及 Web 地图、WebService、LBS 的脚本或原型验证。

限制与注意：

• 必须配置 TMAP_JSAPI_KEY 或 TMAP_WEBSERVICE_KEY（按子技能），否则易落入 WebSearch 备选，精度与结构化程度会下降。
• 输出形态固定为写文件 + 预览，不适合「只在聊天里要一段 curl」的场景。
• HTML 特效与布局是技能契约的一部分，自定义主题时需仍满足资料中的动画与区域要求，以免与技能预期不一致。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 4275，安装 29；社区来源，维护节奏以 SkillHub 更新记录为准。

结尾¶

地图指挥官把腾讯地图的三类官方子技能收成单一入口，用需求识别减少选 Skill 的成本，并用赛博朋克风格 HTML + 预览统一交付形态。安装与详情见 https://www.skillhub.cn/skills/user_fcba917f/map-commander。