DSH 平台通过插件机制扩展功能。在地理信息系统（GIS）场景中，智能体通常需要查询 GeoServer 服务、发布数据图层或获取地图快照。手动操作这些 REST API 或登录后台不仅繁琐，且难以在 Agent 交互流中复用。dsh-geoserver 插件提供了这些能力。
这是一个 DSH 平台 GeoServer 交互插件。它通过设置卡片实现可视化配置，并在会话内直接获取地图图像，无需手动登录浏览器。该插件由用户 wangcong1137-hash 维护。
核心功能¶
插件提供了四个 Agent 工具和一套可视化的配置界面。
- 资源枚举：列出工作区、图层和样式，支持通过 REST API 或 WMS GetCapabilities 文档获取信息。
- 数据发布：上传本地 GeoTIFF 或包含单个 SHP 数据集的 ZIP 文件。
- 地图获取：在服务器端获取 WMS 地图图像，并返回同源显示 URL。
- 连通性诊断：检测 GeoServer 的可达性、认证状态及渲染能力。
安装与启用¶
执行以下命令将插件安装到 Web 配置文件中。
dsh plugin --profile web add dsh-geoserver
安装后重启 dsh web。即使未配置服务器 URL，Harness 也不会启动失败，但工具调用会报配置错误，直到保存 URL。
使用方式¶
插件暴露了以下命令行工具：
geoserver_list：枚举工作区、图层（标题/范围/坐标系/样式）和图像格式。geoserver_publish：上传本地 GeoTIFF 或 ZIP。支持通过 Webhook 通知业务系统。geoserver_map：服务器端获取 WMS GetMap 图像，返回同源显示 URL。geoserver_probe：执行连通性、认证状态和渲染测试。
配置与限制¶
凭证与权限¶
- 凭证管理：通过设置卡片配置连接。凭证不经过浏览器，由插件在主机端管理 Basic Auth，通过
ctx.webServer提供同源图片服务。 - 发布限制：发布文件必须位于
publishRoots目录内，且大小受publishMaxBytes限制。 - 状态独立：GeoServer 发布和 Webhook 交付有独立状态。发布失败不会回滚已创建的图层，Webhook 失败也不影响图层存在。
图像与枚举¶
- 图像限制：图像缓存在主机内存中。请求受宽高限制（4096 px）和 HTTP 超时约束。
- GetCapabilities 回退：回退模式仅解析名称/标题/样式，CRS 和边界来自 REST 路径。
- 服务范围：WFS/WMTS 服务列表尚未暴露，REST 枚举仅覆盖 WMS 图层和样式。
适用场景¶
该插件适用于需要在 DSH 智能体中集成 GeoServer 服务的场景。注意该插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
总结¶
dsh-geoserver 将 GeoServer 的操作集成到了 DSH 平台的会话流中。通过可视化的设置卡片和命令行工具，Agent 可以完成从枚举、发布到地图获取的全流程操作。
- 目录页: dsh-geoserver
- GitHub: wangcong1137-hash/dsh-geoserver
