空间数据库与 GeoServer
读写 PostgreSQL / PostGIS、MySQL 空间数据库，把数据发布到 GeoServer。
每个插件的详情也可以在客户端「设置 → 插件」点开插件卡片查看。插件是否包含在你的会员方案中，以插件页和插件市场的标注为准。
PostgreSQL / PostGIS
连接 PostgreSQL / PostGIS 数据库，浏览空间表与结构，预览和分页读取数据，按行修改并把 GeoJSON 导入成表。
主要功能
- 空间表发现：列出库内各 schema 的表、视图和外部表及中文表注释，默认含无几何列的普通表；对空间图层可查看字段、几何类型、SRID、范围与要素数，图层同时出现在数据源页。
- 预览与分页读取：预览最多 100 个要素，GeoJSON 一律写入会话产物目录，供看图或 GDAL 继续处理；属性按页读取，默认每页 50 行、上限 200 行，结果较大或指定输出路径时同样落盘。
- GeoJSON 入库：把会话产物目录里的 GeoJSON 或 GeoJSONSeq 建成新表、追加或删表重建；属性列自动推断为 bigint、double precision、text、jsonb 等类型，几何列按实际类型收窄并建空间索引。
- 事务与回滚：整个导入在一个事务里完成，失败自动回滚，报错带出错行号附近的信息；Shapefile、GPKG、KML 等格式先经 GDAL 转成 GeoJSON 再导入，SRID 缺省读文件 crs 声明。
- 受控修改：导入的新表自带系统主键 _id，可按 _id 更新或删除单行；所有写操作需用户审批，且连接器须设为「读写」，只读连接器直接拒绝。
- 数据脱敏：内联返回的真实坐标与属性值只显示在界面上，模型只看到条数、字段名等摘要；数据库口令只保存在连接器中，不交给模型拼连接串。
支持范围
- PostgreSQL 17 + PostGIS 3.5 已实测。
- IvorySQL 5 已实测，含 Oracle 兼容端口，连接后自动切回 PostgreSQL 语法。
- openGauss 7 已实测，账号需改用 MD5 认证，默认的 SHA256 认证不支持。
- GaussDB（同样需 MD5 认证）、人大金仓、瀚高、PolarDB for PostgreSQL 等兼容库未实测。
- 未启用 PostGIS 扩展的库只能浏览普通表，读不到空间图层；扩展装在非 public schema 时可自动识别。
- 导入格式：GeoJSON FeatureCollection（.geojson / .json，单文件上限 512 MB）与 GeoJSONSeq（.geojsonl，逐行读取，适合大文件）。
- 导入坐标系按 EPSG 代码指定 SRID，缺省读文件 crs 声明，再缺省视为 EPSG:4326。
- 仅支持明文连接，不支持 SSL 加密连接。
使用前提
- 需先添加 PostgreSQL / PostGIS 连接器，填写主机、端口、数据库名、用户和密码。
- 读取空间图层需该库已启用 PostGIS 扩展（管理员执行 CREATE EXTENSION postgis;）。
- 入库和改表需使用有建表或写入权限的账号，并把连接器设为「读写」。
- 连接远程数据库时，服务器 pg_hba.conf 需允许本机 IP 登录，防火墙需放行端口（默认 5432）。
- 连接 openGauss / GaussDB 时，需请管理员为账号改用 MD5 认证。
连接器
PostgreSQL / PostGIS（可选只读或读写）：在「设置 → 连接器」配置，需要填写主机、端口、数据库、用户、密码。
- 主机、端口、数据库名、用户和密码向数据库管理员索取。本机自装的 PostgreSQL 通常是 localhost、端口 5432、用户 postgres，密码是安装时设置的。
- 支持 PostgreSQL、IvorySQL、openGauss；openGauss / GaussDB 默认的 SHA256 认证不支持，需请管理员为账号改用 MD5 认证。暂不支持 SSL 加密连接。
- 数据库需要启用 PostGIS 扩展（管理员在该库执行 CREATE EXTENSION postgis;）；没启用时只能看到普通表，读不到空间图层。
- 连远程数据库时，服务器的 pg_hba.conf 要允许本机 IP 登录，防火墙要放行端口。
- 只浏览和查询可以用只读账号；入库、写表需要有建表或写入权限的账号，并在连接器上选择「读写」。填好后点「测试」检查能否连上。
可以这样说
- “列出 gis 库里有哪些空间表”
- “看一下 public.parcels 的字段、坐标系和要素数”
- “把 result.geojson 导入成 analysis.flood_zone 表”
- “把 _id 为 12 的那条记录的 name 改成「东湖」”
提供的工具
智能体会按任务自动选用下面的工具，你不需要记住它们的名字。写入类工具执行前会弹出审批卡片。
| 工具 | 类型 |
|---|---|
| 列出表、查看结构与范围、预览和分页读取数据 | 只读 |
| 按系统主键 _id 更新或删除单行数据 | 写入 · 需审批 |
| 把 GeoJSON 新建成表、追加或重建到 PostGIS | 写入 · 需审批 |
默认交给：处理专家、WebGIS 专家（总管也可以直接使用）。可以在「专家」页调整每位专家能用哪些插件。
MySQL
连接 MySQL / MariaDB 数据库，浏览空间表与结构，预览和分页读取数据，按行修改并把 GeoJSON 导入成表。
主要功能
- 空间表发现：列出库内的表、视图及表注释，默认含无几何列的普通表；对空间图层可查看字段、几何类型、SRID、范围与要素数，图层同时出现在数据源页。
- 预览与分页读取：预览最多 100 个要素，GeoJSON 一律写入会话产物目录且坐标统一经度在前；属性按页读取，默认每页 50 行、上限 200 行，结果较大或指定输出路径时同样落盘。
- GeoJSON 入库：把会话产物目录里的 GeoJSON 或 GeoJSONSeq 建成新表、追加或替换；属性列推断为 BIGINT、DOUBLE、LONGTEXT、JSON 等类型，几何列按实际类型收窄，无空几何时建空间索引。
- 失败自动撤销：新建失败会删掉刚建的表；替换时先导入新表，成功后原子换名，失败则原表不动；追加失败会回滚（目标表非 InnoDB 时无法回滚）。
- 受控修改：经本插件导入的表带系统主键 _id，可按 _id 更新或删除单行；写操作需用户审批，连接器须设为「读写」，只读连接器直接拒绝。
- 数据脱敏与只读会话：内联返回的真实坐标与属性值只显示在界面上，模型只看到摘要；读取工具把会话设为只读事务，数据库口令只保存在连接器中。
支持范围
- MySQL 8.0 及以上、MySQL 5.7、MariaDB 10.6 及以上已实测。
- MariaDB 10.2–10.5 理论可用，未实测。
- OceanBase（MySQL 模式）、PolarDB for MySQL 可连接，空间功能未实测。
- TiDB 没有空间类型，只能浏览普通表。
- 不支持 MySQL 5.6 及更早版本。
- MySQL 5.7 与 MariaDB 的几何列不登记坐标系，SRID 从数据第一行读取，为 0 表示数据未设坐标系。
- 导入格式：GeoJSON FeatureCollection（.geojson / .json，单文件上限 512 MB）与 GeoJSONSeq（.geojsonl，逐行读取，适合大文件）；只保留平面坐标，不支持 Z / M 值。
- 仅支持明文连接，不支持 SSL 加密连接。
使用前提
- 需先添加 MySQL 连接器，填写主机、端口、数据库名、用户和密码。
- 入库和改表需使用有 CREATE、INSERT、UPDATE、DELETE、ALTER、DROP 权限的账号，并把连接器设为「读写」。
- 连接远程数据库时，账号需为本机地址授权，服务器 bind-address 不能只绑本机，防火墙需放行端口（默认 3306）。
连接器
MySQL（可选只读或读写）：在「设置 → 连接器」配置，需要填写主机、端口、数据库、用户、密码。
- 主机、端口、数据库名、用户和密码向数据库管理员索取。本机自装的 MySQL 通常是 localhost、端口 3306、用户 root，密码是安装时设置的。
- 支持 MySQL 5.7、8.0 及以上和 MariaDB 10.6 及以上；MySQL 5.6 及更早版本不支持。TiDB 等兼容 MySQL 协议但没有空间类型的库也能连，只能浏览普通表。暂不支持 SSL 加密连接。
- 连远程数据库时，账号要为本机地址授权（MySQL 账号按「用户名@来源地址」区分），服务器的 bind-address 不能只绑本机，防火墙要放行端口。
- 只浏览和查询可以用只读账号；入库、写表需要有 CREATE、INSERT、UPDATE、DELETE、ALTER、DROP 权限的账号，并在连接器上选择「读写」。填好后点「测试」检查能否连上。
可以这样说
- “列出 MySQL 库里的空间表”
- “预览 poi 表的前 100 个要素”
- “把 stations.geojson 追加到 stations 表”
提供的工具
智能体会按任务自动选用下面的工具，你不需要记住它们的名字。写入类工具执行前会弹出审批卡片。
| 工具 | 类型 |
|---|---|
| 列出表、查看结构与范围、预览和分页读取数据 | 只读 |
| 按系统主键 _id 更新或删除单行数据 | 写入 · 需审批 |
| 把 GeoJSON 建表导入、追加或替换到已有表 | 写入 · 需审批 |
默认交给：处理专家、WebGIS 专家（总管也可以直接使用）。可以在「专家」页调整每位专家能用哪些插件。
GeoServer
通过 REST 接口连接 GeoServer，查询工作空间、图层与范围，把 PostGIS 表发布为图层并应用 SLD 样式。
主要功能
- 图层清单查询：列出工作空间、已发布图层及其所属工作空间，图层同时出现在数据源页；清单较大或指定输出路径时写入会话产物目录，只回路径、条数和预览。
- 图层范围查询：按工作空间与图层名查询图层的经纬度范围，便于在地图上定位或作为后续裁剪、制图的范围依据。
- 发布 PostGIS 表：指定 PostGIS 连接器、schema、表和几何列，把表发布为 WMS / WFS 图层；工作空间和数据存储不存在时自动创建，SRID 从 PostGIS 读取，图层名为「工作空间:表名」。
- SLD 样式管理：上传完整 SLD 创建全局样式并设为图层默认样式，同名样式会被更新；插件本身不生成 SLD，由智能体按字段与几何类型编写。
- Shapefile 发布流程：配合 GDAL 与 PostGIS 插件，先把 Shapefile 转成 GeoJSON 并导入 PostGIS，再发布为图层并配置样式，一次对话完成从文件到服务。
- 写操作管控：发布与样式都需用户审批，GeoServer 连接器须设为「读写」，只读连接器直接拒绝；schema、表、工作空间等标识符只允许字母、数字、下划线和连字符。
支持范围
- 通过 GeoServer REST 接口访问，服务地址支持 http 与 https。
- 发布的数据源仅限 PostGIS 表，在 GeoServer 中以 PostGIS 数据存储方式登记。
使用前提
- 需有可访问的 GeoServer 服务，并添加 GeoServer 连接器，服务地址填到 /geoserver 为止。
- 只查询可用只读账号；发布图层和管理样式需有 REST 写权限的账号，并把连接器设为「读写」。
- 发布 PostGIS 表前需先配置 PostGIS 连接器，且目标表已存在。
- PostGIS 连接器中的主机、端口、账号会写入 GeoServer 数据存储，需保证 GeoServer 服务器能用该地址访问数据库。
- GeoServer 在其他机器上时，对方防火墙需放行端口（默认 8080）。
连接器
GeoServer（可选只读或读写）：在「设置 → 连接器」配置，需要填写服务地址、用户、密码。
- 服务地址填到 /geoserver 为止，例如 http://192.168.1.10:8080/geoserver；在浏览器里能打开这个地址的 GeoServer 管理页面，说明地址是对的。
- 用户和密码填 GeoServer 的登录账号（全新安装默认是 admin / geoserver，正式环境应已改掉，请向管理员索取）。只查看图层可以用只读账号；发布图层、管理样式需要有 REST 写权限的账号，并在连接器上选择「读写」。
- GeoServer 在别的机器上时，确认对方防火墙放行了端口（默认 8080）。填好后点「测试」检查能否连上。
可以这样说
- “列出 GeoServer 上的工作空间和图层”
- “把 PostGIS 的 public.roads 发布成图层，按道路等级分色”
- “把 D:\data\landuse.shp 发布到 GeoServer（会先导入 PostGIS）”
提供的工具
智能体会按任务自动选用下面的工具，你不需要记住它们的名字。写入类工具执行前会弹出审批卡片。
| 工具 | 类型 |
|---|---|
| 查询工作空间、图层清单与图层经纬度范围 | 只读 |
| 把 PostGIS 表发布为图层或为图层应用 SLD 样式 | 写入 · 需审批 |
默认交给：处理专家、WebGIS 专家（总管也可以直接使用）。可以在「专家」页调整每位专家能用哪些插件。