Mekansm1/DSH-WebGIS

dsh-webgis

一个让 LLM 真正看见地理世界的 WebGIS 插件。它构建于 DeepSeek Harness（DSH）之上，将完整的 GIS 工作台嵌入 AI 对话中：模型可以加载地图数据、理解地图，并通过对话运行空间分析。其长期目标是实现真正的三维空间理解。

作者：Frank Wang · 反馈：cywanghn@gmail.com

0.1.4 中的新内容

- 为几何与空间统计操作新增了基于 Worker 的执行路径，并根据具体操作的工作负载阈值进行选择。
- Worker 任务会转发取消信号、强制执行时间预算，并在完成、取消或超时时终止。插件销毁时会请求清理活动 Worker 和排队任务。
- 新增了可转移的几何负载、有界任务并发、共享超时策略，以及针对编码、调度、取消和超时的回归测试。
- 新增了规则网格尺寸防护，并提供可操作的输入指引。

范围：小工作负载仍在宿主线程上同步执行。工作负载阈值并不保证每个复杂几何都会在线程外运行；此版本不承诺普遍的非阻塞执行。Worker 负载编码和结果解码同样需要宿主线程工作。

兼容性：此版本面向 DSH Web 配置文件，并需要宿主的 webServer 服务。官方 Desktop 传输尚不支持。现有的 DSH 0.1.5-rc1 兼容性基线保持不变；这并不表示已针对更新的 Desktop 版本进行验证。

0.1.3 中的新内容

- 迁移到 DuckDB 官方 Node Neo 驱动（@duckdb/node-api）。安装该插件不再需要编译旧版 duckdb 原生模块、执行 pnpm approve-builds 或 pnpm rebuild duckdb。
- 优化了超大型 CSV 坐标点图层：DuckDB 按列式分块读取坐标并直接构建 GeoArrow，避免了大量 { lon, lat } JavaScript 对象。
- 采样、视口剔除、空视图行为和拾取语义保持不变。线、面和几何列图层继续使用既有的 WKB 转换路径。

0.1.2 中的新内容

- 适配 DSH 0.1.5-rc1：重新定位新的 shell 布局（对话移入宿主 main 槽位），并迁移到 0.1.5 包集。
- 从底图导出矢量要素。“导出当前视图中的地图数据”会将真实的矢量瓦片要素提取为新的点、线和面图层；诸如“导出河流”之类的请求可以将输出限制为一种类型。
- 新增空间统计套件：除 Moran's I 外，还提供 Gini、Shannon 熵和 Getis-Ord Gi\* 热点分析，并带有 Benjamini–Hochberg FDR 校正。每个指标都会检查字段、报告发现，并在计算前请求你确认输入。
- 统一点击高亮：面使用深蓝色轮廓和蓝色填充，线使用粗蓝色描边，点使用蓝色圆点，且始终渲染在最上层。
0.1.1 中的新功能

- 修复了默认 Carto 栅格底图上的“需要 API 密钥”水印。
- 修复了 Carto 矢量底图（Positron / Dark / Voyager）无法渲染的问题。
- 新增测量工具：线长度、吸附到之前绘制的顶点，以及在起点闭合多边形以显示周长和面积。
- 改进了超大 SHP 文件的加载性能。

已针对 DSH 0.1.5-rc1 进行测试。

安装：npx --yes @deepseek-ai/dsh plugin --profile web add dsh-webgis

pnpm 与 DuckDB 运行时

该插件使用 DuckDB 官方的 Node Neo 包（@duckdb/node-api）。它通过可选依赖安装特定于平台的预构建绑定，因此 pnpm ≥ 10 不需要 pnpm approve-builds 或 pnpm rebuild duckdb。正常的 pnpm install 就足够了。目标平台仍必须受 DuckDB Node Neo 支持，并且能够从 npm registry 下载包。

亮点

- 🗺️ 对话式 GIS — 通过自然语言工具调用加载数据、浏览地图并运行空间分析
- 🚀 流畅的海量数据渲染 — 从百万行的本地 CSV 文件到包含数十万行的数据库结果，分层渲染管线可保持地图响应流畅（参见海量数据加载）
- 🧮 GIS 工具箱 — 60 多个可供 AI 调用的工具：缓冲区、叠加、核密度、Moran's I、Gini、Shannon 熵、Getis-Ord Gi\、OD 矩阵和六边形分箱热力图
- 🛰️ 也能读取底图 — 将河流、道路、建筑物、地名以及其他真实矢量底图要素提取为可分析的图层
- 🖌️ 手动工作流 — 交互式绘制点、线和多边形；管理图层；导入和导出 SHP / CSV / GeoJSON
- 🔌 多种数据源 — PostGIS、本地文件、底图本身以及在线地图服务

快速开始

1. 打开 DeepSeek Harness 并开始新对话。
2. 选择 GIS 模式。
3. 选择你的任务工作区。
4. 向模型提问，例如：“加载 xxx 并在地图上显示它。”*

功能

计算：对话式 GIS 分析

数据加载后，告诉 AI 类似“将其显示为六边形密度热力图”或“哪些点落在这个多边形内？”的内容。超过 60 个地理处理工具可以在后台串联使用：

- 构建 — 缓冲区、质心、凸包、边界框、融合、简化、炸开、平滑、网格、Voronoi，以及显示起点–终点流向的 OD 矩阵
- 叠加 — 裁剪、相交、差集和并集
- 查询 — 属性过滤、空间连接和按位置选择
- 变换 — 坐标系统重投影
- 空间统计 — 核密度热力图、平均最近邻（ANN）、带 LISA 局部聚类的全局 Moran's I、Gini、Shannon 熵和 Getis-Ord Gi\* 热点分析
- 可视化 — 原始点、平面热力图、六边形分箱热力图、弧线、行程、墙体和径向模式；调整颜色、大小和描边宽度
- 属性编辑 — 批量更新字段值、分配序列号并添加列
- 底图提取——将矢量底图要素转换为图层（参见读取底图）
- 图层管理——列出、移除、显示/隐藏、查看图层详情，以及查看要素统计信息

每个结果都会成为一个新的实时图层，下一个工具可以继续对其进行处理，形成完整的分析链。

指数在计算前会先询问。统计工具遵循检查 → 确认 → 计算的循环：Moran's I 请求会先报告数值字段、缺失值数量和几何类型，然后等待确认。如果缺少必需参数，工具会说明它需要什么，而不是进行猜测。

读取底图

矢量底图包含真实的要素数据：水道、道路、建筑物、公园、土地利用、边界、兴趣点和地名。该插件可以从当前视图中的瓦片提取要素，并将其转换为普通图层：

- “导出当前视图中的地图数据” → 三个图层：点 / 线 / 多边形
- “导出此视图中的河流” → 一个图层，同名线段会合并为一个要素

提取出的图层与任何导入数据的行为相同：可以对其进行测量、缓冲和分析。这会将可见的地图内容转换为图层；它不是批量提取。矢量瓦片会按缩放级别切分，因此缩放级别越远，暴露的图层越少，而 POI/建筑物通常只在城市或街道缩放级别出现。如需批量数据，请使用 Geofabrik 或 Overpass 并导入文件。

绘制：手动绘制和编辑

- 图层面板列出数据集、分析结果、数据库结果和导入图层，并提供显示/隐藏和删除控件
- “创建”按钮会按需打开绘图工具栏：点、线、多边形、贝塞尔平滑，以及吸附到现有图层顶点
- 右键单击图层可查看其属性表、导出 GeoJSON / CSV / SHP，或将其删除
- 导入 SHP（.shp / .zip）、CSV 或 GeoJSON；CSV 会自动检测 WKT 几何列，否则会尝试经度/纬度列

地图和数据服务

- 底图切换器——Carto Light / Dark / Voyager、OpenFreeMap 和卫星影像，可从左下角选择
- 在线叠加服务——注册 WMTS / WMS / XYZ 栅格服务；WMS 支持 {bbox-epsg-3857} 模板
- 数据源路由——优先使用屏幕上已有的数据，仅在需要时查询已配置的数据库；AI 不会凭空编造数据

海量数据加载

从数百行到数百万行，UI 都应保持响应。核心理念是“先计数、分层渲染、按需物化”，而不是一次性将所有内容推送到浏览器。

大型本地 CSV 文件（DuckDB）：

- CSV 会一次性加载到 DuckDB 内存表中，之后可进行毫秒级过滤；在我们的测试中，168 万行大约在 2.7 秒内加载完成
- 大文件最初会显示带聚类的采样视图，而完整表仍保留在内存中，供后续 SQL、条件或多边形围栏过滤使用
- 坐标点图层以 DuckDB 列式数据块读取坐标，并构建 GeoArrow，而无需百万级 JS 行对象；客户端仍通过缩放层级和视口控制抓取量
- 内置内存管理——LRU 表驱逐加上内存限制——有助于防止宿主 OOM 故障

PostGIS 数据库：

- 只读查询；首先发出 count，以决定是否以及如何加载结果
- 非 4326 几何会自动包装在 ST_Transform 中；EWKB 几何会转换为 GeoJSON 以供显示
- statement_timeout 和只读事务可防止缓慢或方向错误的查询阻塞对话

采样始终透明：当大型图层仅显示样本时，会标注为“共 N 行（已采样）”，并且基于样本得出的统计数据会如此标记。AI 绝不应将样本误认为完整数据集。

结合 deck.gl 的 GPU 驱动 3D 渲染——六边形柱、墙体拉伸和 OD 弧——数十万行在缩放、筛选和分析时仍保持流畅。

安装与配置

要求：具有 web 配置文件的 DSH 安装，以及 PATH 中的 pnpm。

dsh plugin --profile web add dsh-webgis
After installation restart with: dsh web
Then start a new conversation and select GIS mode.

可选配置（设置 → 插件 → WebGIS 插件配置，或插件配置文件 cordis.patch.yml）：

- 视觉模型——provider / model / baseURL / apiKey。为“这个地方在哪里？”以及从截图中读取地图等视觉功能配置此项。如果主模型是多模态的，插件会直接使用它，此项可留空。如果主模型仅支持文本且未配置视觉模型，视觉工具仍会返回结构化坐标和要素数据，但不会分析图像。
- PostGIS 数据库——host / port / database / user / password。密码存储在 DSH 的凭据存储中，绝不会以明文写入磁盘。
- DuckDB 阈值和内存限制。

示例提示

- “将这个 xxx.shp 加载到地图上”
- “这些点在空间上聚集吗？用六边形热力图显示它们”
- “筛选出 dataset A 中落在 region B 内的点”
- “导出当前视图中的地图数据”
- “这些县的人口是聚集的，还是随机的？”（运行 Moran's I）
- “这个地方在哪里？”（AI 截取屏幕截图并分析）

路线图：从 2D 地图到 3D 世界

- 阶段 1（进行中）：2D 地图视觉理解——AI 读取地图内容并回答“什么在哪里”以及“这个地方在哪里”。
- 阶段 2（进行中）：对话式操作与分析——从看到计算，闭合加载 → 分析 → 可视化循环。
- 阶段 3（长期）：真正的 3D 世界理解——从读取 2D 符号转向理解建筑与地形、遮挡与空间关系，以及真实世界尺度的推理。如今的三维可视化——六边形柱、墙体拉伸和 OD 弧线——只是开始。目标是让 AI 在真实 3D 场景中观察、推理并作答，具备真正的空间世界观。

长期愿景：不仅仅是描述一幅图片，而是赋予模型空间认知能力，使其理解地图背后的 3D 世界。

注意：DeepSeek 视觉模型仍在快速演进，视觉相关功能尚未经过广泛的深度测试。