naivemap/dsh-geo-viewer

README 摘要

dsh-geo-viewer DeepSeek Harness（DSH）地理数据可视化插件：对话中出现地理数据时，模型调用 geo view 工具，对话流中直接渲染一张基于 MapLibre GL 的交互式地图卡片。 功能 - 表格地理字段识别 ： .csv / .tsv / .xlsx （含内联 CSV 文本），表头启发式识别经纬度列（ lat / lng / latitude / longitude / 经度 / 纬度 / x,y 配对 / 坐标 单列合并格式），采样数值范围校验，列头与数值角色装反时按值自动互换；支持 latColumn / lngColumn 显式覆盖 - GeoJSON 识别 ： FeatureCollection / Feature / Geometry / 数组形态自动规范化，点、线、面分层渲染 - 地址地理编码 ：地址列表直接绘图，或表格无坐标列时按 addressColumn 兜底定位；支持 Nominatim（免费）/ MapTiler / 高德（GCJ-02 自动转 WGS-84） - 对话内交互卡片 ：缩放平移、点击要素查看属性、超 500 点自动聚合、Fit 视野、页内全屏（Esc 退出）、明暗主题跟随；会话回放按字节重现 - 制品导出 ：每次渲染在工作区导出 geo/ - .geojson ，可直接复用 - 体量护栏 ： maxFeatures / maxBytes / maxGeocodeRows 三重上限，超限响亮报错并给出调参指引 安装 前置条件：Node.js = 22.19，已安装 dsh CLI（ npm i -g @deepseek-ai/dsh ）。 从 GitHub 安装 从本地目录安装 从 tarball 安装（离线分发） 未全局安装 dsh 时，可改用 npx @deepseek-ai/dsh plugin --profile web add 一次性执行； add 接受的包规格与 pnpm 一致（npm / Git / 本地路径 / file: / link: ）。 生效与验证 构建产物（ lib/ ）已随仓库提交，以上安装方式均无需额外构建。 使用 直接用自然语言让模型画图，例如： 说法 触发路径 「把 examples/cities.csv 画到地图上」 CSV 文件 → 中文列头经纬度检测 「可视化 examples/demo.geojson」 GeoJSON → 面/线/点混合渲染 「在地图上标出北京市、上海市、杭州市」 地址列表 → 地理编码 「这张表没有坐标，只有地址列，帮我定位」 表格 + addressColumn → 逐行地理编码 模型侧的工具参数（一般无需手写）： path / data / addresses 三选一，可选 latColumn 、 lngColumn 、 …

分类