前言¶
在 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、路徑規劃、地理編碼等意圖時，本技能作爲統一入口，自動識別需求並協調以下官方子技能：
| 子技能 | 職責 |
|---|---|
tencentmap-jsapi-gl-skill |
Web 端地圖應用（展示、覆蓋物、可視化） |
tencentmap-webservice-skill |
WebService API（地理編碼、POI 搜索、路線規劃、天氣等） |
tencentmap-lbs-skill |
位置服務 LBS（POI 搜索、路徑規劃、軌跡可視化） |
官方說明頁：SkillHub API、SkillHub 展示頁。
核心功能¶
需求路由與子技能協作¶
用戶側只需用自然語言描述地圖類任務；技能側負責判斷應調用 JS API 能力、WebService 還是 LBS，再交給對應子技能。資料中列出的覆蓋範圍包括：地圖應用開發（網頁、小程序、App）、位置數據分析與可視化、地址/座標轉換與地理編碼、路徑規劃與導航、周邊搜索與 POI、地理圍欄與區域分析、軌跡與旅遊規劃等。
常見觸發詞包括：騰訊地圖、地圖開發、位置服務、LBS、POI 搜索、路徑規劃、地理編碼、座標轉換。
對話輸出：HTML 文件 + 預覽¶
本技能的對話輸出模式爲 HTML 文件 + 預覽。調用時應：
- 生成完整 HTML（
DOCTYPE、head含style、body）。 - 用 Write 工具保存到 workspace（例如
map-output.html）。 - 使用
preview_url打開該文件。 - 在回覆中用一兩句話說明已完成。
資料明確要求：不要在對話裏用 ```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 當前文檔爲準；本資料未給出分客戶端的一鍵安裝語句，安裝後請按各子技能要求配置密鑰。
子技能密鑰依賴（來自官方說明）：
| 子技能 | 環境變量 |
|---|---|
tencentmap-jsapi-gl-skill |
TMAP_JSAPI_KEY |
tencentmap-webservice-skill |
TMAP_WEBSERVICE_KEY |
tencentmap-lbs-skill |
TMAP_WEBSERVICE_KEY |
未配置或 Key 無效時，可能觸發上述 WebSearch 備選路徑，結果需在頁面數據來源字段中區分。
典型用法¶
下面介紹與官方示例一致的使用方式，便於在 Agent 對話裏復現。
- 用觸發詞或自然語言描述任務（如 POI 搜索、路線規劃、地理編碼）。
- 等待技能路由到對應子技能並拉取數據（或走備選搜索）。
- 在 workspace 中查看生成的
map-output.html，並通過預覽工具打開。 - 若 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。
