在 DeepSeek Harness 的插件生態中，處理地理空間數據往往需要額外的 MCP 服務器或外部集成。dsh-map-tools 插件提供了一套原生工具，讓模型可以直接調用地圖規劃能力，並將計算結果以真地圖卡片的形式呈現。
核心功能¶
該插件包含 7 個原生工具，無需 MCP，直接註冊到 DSH 的 ctx.tools。它支持以下場景：
- 路線規劃：駕車、公交/地鐵換乘、步行、騎行路線。
- 地理信息查詢：地理編碼（地址轉經緯度）、逆地理編碼（經緯度轉地址）。
- POI 搜索：查詢周邊的興趣點。
- 真地圖卡片：規劃出的路線會自動繪製在真地圖卡片上（高德底圖+路線折線），出現在回答的尾部。
安裝¶
安裝前請確保環境滿足以下要求：
- DeepSeek Harness >= 0.1.2-rc.1
- Node >= 20
安裝命令如下：
dsh plugin --profile web add dsh-map-tools
安裝完成後，重啓 dsh web 即可在會話中通過 map_* 系列工具調用地圖服務。
使用示例¶
安裝並配置後，模型可以直接調用工具完成任務。例如：
- 駕車路線規劃：
從北京南站到首都機場T3，規劃駕車路線 - 地理編碼：
把「西湖區文三路478號」轉成經緯度 - POI 搜索：
116.397428,39.90923 附近 1 公里內有什麼加油站？
配置與數據源¶
插件支持兩種數據源：
- 高德 (Amap)：推薦使用。數據最全，支持所有 7 個工具。需要申請高德「Web 服務」類型的 Key。
- OSM/OSRM：免費方案，無需 Key。駕車、步行、騎行路線可走此方案，但中文地址解析不可靠，且不支持公交/POI 搜索。
安全性：高德 Key 不會出現在服務端日誌或頁面中，靜態地圖由宿主攜帶 Key 去獲取。
已知限制¶
- 版本要求：需要 DeepSeek Harness >= 0.1.2-rc.1。
- 平臺限制：路線地圖卡功能需要
web profile（dsh.client.platform: web）。在 TUI 或 headless 環境下，工具仍可正常使用，但無法顯示地圖卡片。 - 路線數量：一次請求超過 3 條路線時，只會顯示前 3 條。
- OSM 中文支持：在 OSM 模式下，中文地址解析不可靠。
結語¶
dsh-map-tools 解決了智能體在地理信息處理上的集成難題，通過原生工具和真地圖卡片，讓路線規劃更加直觀和高效。
