dsh-geo-viewer
DSH 地理可视化插件：geo_view 工具可检测 CSV/XLSX 表格、GeoJSON 和地址列表中的地理数据，然后在对话中呈现交互式 MapLibre 地图卡片。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:naivemap/dsh-geo-viewer#a4ef7b451f5892d71dd9cbe89f3179049b96b217Geo Viewer 以 dsh-geo-viewer 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness（DSH）地理数据可视化插件：对话中出现地理数据时，模型调用 geo_view 工具，对话流中直接渲染一张基于 MapLibre GL 的交互式地图卡片。
.csv / .tsv / .xlsx（含内联 CSV 文本），表头启发式识别经纬度列（lat / lng / latitude / longitude / 经度 / 纬度 / x,y 配对 / 坐标 单列合并格式），采样数值范围校验，列头与数值角色装反时按值自动互换；支持 latColumn / lngColumn 显式覆盖FeatureCollection / Feature / Geometry / 数组形态自动规范化，点、线、面分层渲染addressColumn 兜底定位；支持 Nominatim（免费）/ MapTiler / 高德（GCJ-02 自动转 WGS-84）geo/<slug>-<hash>.geojson，可直接复用maxFeatures / maxBytes / maxGeocodeRows 三重上限，超限响亮报错并给出调参指引前置条件：Node.js >= 22.19，已安装 dsh CLI（npm i -g @deepseek-ai/dsh）。
dsh plugin --profile web add github:naivemap/dsh-geo-viewer
# 可用 #<tag|branch> 锁定版本，如 github:naivemap/dsh-geo-viewer#main
git clone https://github.com/naivemap/dsh-geo-viewer.git
dsh plugin --profile web add /path/to/dsh-geo-viewer
pnpm pack # 生成 dsh-geo-viewer-0.1.0.tgz
dsh plugin --profile web add ./dsh-geo-viewer-0.1.0.tgz
未全局安装 dsh 时，可改用 npx @deepseek-ai/dsh plugin --profile web add <规格> 一次性执行；add 接受的包规格与 pnpm 一致（npm / Git / 本地路径 / file: / link:）。
# 重启后生效（dsh web 正在运行则重启并刷新页面）
dsh --profile web
# 确认插件进入最终配置
dsh --profile web --dump-config
构建产物（lib/）已随仓库提交，以上安装方式均无需额外构建。
直接用自然语言让模型画图，例如：
| 说法 | 触发路径 |
|---|---|
| 「把 examples/cities.csv 画到地图上」 | CSV 文件 → 中文列头经纬度检测 |
| 「可视化 examples/demo.geojson」 | GeoJSON → 面/线/点混合渲染 |
| 「在地图上标出北京市、上海市、杭州市」 | 地址列表 → 地理编码 |
| 「这张表没有坐标，只有地址列，帮我定位」 | 表格 + addressColumn → 逐行地理编码 |
模型侧的工具参数（一般无需手写）：path / data / addresses 三选一，可选 latColumn、lngColumn、addressColumn、title、styleUrl。
全部配置项（底图 mapStyleUrl、cardHeight、maxFeatures / maxBytes / maxGeocodeRows 护栏、地理编码供应商与 key 等）均在 Web 端「设置 -> 插件 -> 插件配置」的 dsh-geo-viewer 卡片上编辑，保存即生效（无需重启）；「重置」可回退到 YAML 层取值。
nominatim（默认，免费、无需 key）/ maptiler / amap（国内地址效果最好，结果自动 GCJ-02 -> WGS-84）；后两者需填 key，缺失时首次地理编码即报错提示cordis.patch.yml（或 home 级 $DSH_HOME/cordis.patch.yml）中覆盖同名键：- replace:
- id: dsh-geo-viewer
name: 'dsh-geo-viewer'
config:
geocodingProvider: 'amap'
geocodingKey: '<你的高德KEY>'
DSH 插件双半侧架构：
lib/index.js，Node）：注册 geo_view 工具；解析输入 → 转标准 GeoJSON → 连同渲染参数写入持久化 tool/result meta（presentationMeta）→ 工作区导出制品lib/client.js，由 DSH Web UI 经 __ModuleLoader__ 注入）：以键控 toolview 注册 geo_view 卡片，按 meta 从 CDN 动态加载 maplibre-gl 渲染地图；不读工作区文件，回放稳定pnpm install
pnpm run check # typecheck（双侧）+ vitest + 构建
pnpm run test # 仅测试
pnpm run build # 仅构建 lib/
修改源码后需重新 pnpm run build（lib/ 随仓库提交），再在 profile 中重新加载或重启 dsh。
geocodingBaseUrl 指向内网服务maxFeatures / maxBytes 护栏约束，超大 GeoJSON 请先降采样MIT