在 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 解决了智能体在地理信息处理上的集成难题，通过原生工具和真地图卡片，让路线规划更加直观和高效。
