集成6类60项SuperMap iServer操作技能:服务器管理、GIS服务管理、地图服务、数据服务、空间分析、几何量算等。支持自然语言转换为CLI命令执行。运行环境:Python 3.8+。
SuperMap iServer CLI Skills是一项面向实际任务的技能,主要用于本技能提供对话式界面来操作 SuperMap iServer GIS 服务器;用户可以用自然语言描述需求,自动转换为 iserver CLI 命令并执行;
它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
本技能提供对话式界面来操作 SuperMap iServer GIS 服务器。用户可以用自然语言描述需求,自动转换为 iserver CLI 命令并执行。
# 检查 Python 版本(必须 3.8+) python --version # 检查 pip 是否可用 pip --version
如果 Python 未安装或版本低于 3.8:
sudo apt install python3 python3-pip 或 brew install python3系统要求:如使用 Windows 系统,暂不支持 Windows 7 及更早版本。推荐使用 Windows 10/11 或 Windows Server 2016+ 运行。
使用 pip 安装:
pip install iserver-cli
| 用户意图 | CLI 命令 |
|---|---|
| 登录 iServer | iserver login --url {url} -u {username} -p {password}(url 需带协议,如 http://) |
| 使用 Token 登录 | iserver login --url {url} -t {token} |
| 登出 | iserver logout |
| 查看版本 | iserver version |
| 测试连通性 | iserver ping |
| 测试指定地址连通性 | iserver ping --url {url} |
| 查看配置 | iserver config --show |
| 设置服务器地址 | iserver config --set-url {url} |
| 设置输出格式 | iserver config --set-format {json|table|plain} |
| 设置超时时间 | iserver config --set-timeout {seconds} |
| 生成 Token | iserver token --url {url} --expire-hours {hours} --description {desc} -u {username} -p {password} |
| 查看系统日志 | `iserver logs [--level INFO |
| 用户意图 | CLI 命令 |
|---|---|
| 列出所有服务 | iserver service list [--url {url}](未登录时如需查看匿名用户可访问的服务,需加 --url) |
| 查看服务状态 | iserver service status {name}(需带接口后缀,如 map-jingjin/rest) |
| 启动服务 | iserver service start {name}(仅组件名,如 map-jingjin,不接 /rest) |
| 停止服务 | iserver service stop {name}(仅组件名,如 map-jingjin,不接 /rest) |
| 重启服务 | iserver service restart {name}(仅组件名,如 map-jingjin,不接 /rest) |
| 删除服务 | iserver service delete {name} --force(仅组件名,如 map-jingjin,不接 /rest) |
| 设置服务公开访问 | iserver service authorization {name} --type PUBLIC |
| 设置服务需要登录 | iserver service authorization {name} --type AUTHENTICATED |
| 设置服务私有 | iserver service authorization {name} --type PRIVATE --add-role {role} (多个角色用逗号分隔,如: ADMIN,PUBLISHER) |
| 发布服务 | iserver service publish --workspace {path} --types {types}(注意:{path} 为 iServer 服务器上的路径,不应做任何拼接或转换处理,保持原始路径字符串直接传入) |
| 清除服务缓存 | iserver service cache-clear {name}(仅组件名,如 map-jingjin,不接 /rest) |
| 用户意图 | CLI 命令 |
|---|---|
| 列出所有地图服务 | iserver map list |
| 列出服务中的地图 | iserver map maps -s {service} |
| 查看地图详情 | iserver map info {name} -s {service} |
| 导出地图图片(指定范围) | iserver map export {name} -s {service} --view-bounds '{"leftBottom":{"x":minx,"y":miny},"rightTop":{"x":maxx,"y":maxy}}' -o {output} --format {format} |
| 导出地图图片(中心点+比例尺) | iserver map export {name} -s {service} --center '{"x":cx,"y":cy}' --scale {scale} --width {w} --height {h} -o {output} |
| 获取图例 | iserver map legend {name} -s {service} |
| 获取指定图层图例 | iserver map legend {name} -s {service} --layer {layer} |
| 保存图例图片 | iserver map legend {name} -s {service} --layer {layer} --output {file}(注意:图层组 @@LayerGroup 路径暂不支持) |
| 地图范围查询 | iserver map query {name} -s {service} -m BoundsQuery --bounds "{"leftBottom":{"x":0,"y":0},"rightTop":{"x":100,"y":100}}" --layer {layer} (必填: bounds, layer) |
| 地图距离查询 | iserver map query {name} -s {service} -m DistanceQuery --geometry {json} --distance {n} --distance-unit {unit} --layer {layer} (必填: geometry, distance (默认1.0), layer) |
| 地图最近地物查询 | iserver map query {name} -s {service} -m FindNearest --geometry {json} --distance {n} --layer {layer} (必填: geometry, distance (默认1.0), layer) |
| 地图空间查询 | iserver map query {name} -s {service} -m SpatialQuery --geometry {json} --spatial-mode {mode} --layer {layer} (必填: geometry, spatial-mode (默认INTERSECT), layer) |
| 地图SQL查询 | iserver map query {name} -s {service} -m SqlQuery --sql "{condition}" --layer {layer} (必填: sql, layer) |
服务名称兼容两种写法:
map-China或map-China/rest,数据服务同理(data-China或data-China/rest)。
| 用户意图 | CLI 命令 |
|---|---|
| 列出所有数据服务 | iserver data list |
| 列出数据源 | iserver data datasources {service} |
| 列出数据集 | iserver data datasets {datasource} -s {service} |
| 查询要素(基础) | iserver data query {dataset} -s {service} -d {datasource} --mode {mode} --limit {n} |
| ID 模式查询 | iserver data query {dataset} -s {service} -d {datasource} --mode ID --ids "[1,2,3]" |
| SQL 模式查询 | iserver data query {dataset} -s {service} -d {datasource} --mode SQL --attribute-filter "SMID < 10" |
| BOUNDS 矩形查询 | iserver data query {dataset} -s {service} -d {datasource} --mode BOUNDS --bounds "minx,miny,maxx,maxy" |
| 范围+属性组合查询 | iserver data query {dataset} -s {service} -d {datasource} --mode BOUNDS_ATTRIBUTEFILTER --bounds "..." --attribute-filter "..." |
| BUFFER 缓冲查询 | iserver data query {dataset} -s {service} -d {datasource} --mode BUFFER --geometry {json} --buffer-distance {n} --buffer-unit meter |
| SPATIAL 空间查询 | iserver data query {dataset} -s {service} -d {datasource} --mode SPATIAL --geometry {json}(当前暂不支持自定义空间查询模式,默认使用 INTERSECT) |
| 仅返回数量 SQL 模式查询 | iserver data query {dataset} -s {service} -d {datasource} --mode SQL --attribute-filter "..." --return-count-only |
| 添加要素 | iserver data add {dataset} -s {service} -d {datasource} --feature @{file} |
| 更新要素 | iserver data update {dataset} -s {service} -d {datasource} --feature @{file}(需数据服务可编辑) |
| 删除要素 | iserver data delete {dataset} -s {service} -d {datasource} --id {id} --force |
| 批量删除要素 | iserver data delete {dataset} -s {service} -d {datasource} --ids "[{ids}]" --force |
| SQL条件删除要素 | iserver data delete {dataset} -s {service} -d {datasource} --sql "{condition}" --force(注意:含 < > 时需转义,如 --sql "smid^<9") |
| 用户意图 | CLI 命令 |
|---|---|
| Geometry 缓冲区(单向距离) | iserver analysis buffer --type geometry --geometry {json} --distance {n} --unit meter --output {file} |
| Geometry 缓冲区(左右不等距) | `iserver analysis buffer --type geometry --geometry {json} --left-distance {n} --right-distance {n} --unit {unit} --end-type {round |
| Dataset 缓冲区(单向距离) | iserver analysis buffer --type dataset --dataset "{dataset}@{datasource}" --filter "{sql}" --distance {n} --unit meter --output {resultDataset} [--force] |
| Dataset 缓冲区(左右不等距) | iserver analysis buffer --type dataset --dataset "{dataset}@{datasource}" --filter "{sql}" --left-distance {n} --right-distance {n} --unit {unit} --output {resultDataset} [--force] |
| Geometry 叠加 | iserver analysis overlay --type geometry --source {json} --target {json} --operation {op} --output {file} |
| Dataset 叠加 | iserver analysis overlay --type dataset --source-dataset {dataset} --operate-dataset {dataset} --source-fields {field} --operation {op} --output {resultDataset} [--force] (--source-fields optional: if omitted, auto-fetch all fields with duplicate suffix) |
参数说明:
--type geometry 时使用 --geometry 指定几何,--dataset 参数被忽略;--output 保存结果到文件--type dataset 时使用 --dataset dataset@datasource 指定数据集,--geometry 参数被忽略;--output 指定输出数据集名称--distance 单向缓冲距离(左右等距);--left-distance / --right-distance 分别设置左右缓冲距离(不等距,两者需同时指定)--operation 叠加分析操作类型,当前支持以下 4 种:intersect(相交)、union(合并)、difference(差集)、clip(裁剪)--force 覆盖已有结果数据集(用于 dataset 类型,默认不覆盖;不加该参数时如果输出数据集已存在会报错) 转义内部双引号,如:--geometry "{"type":"POINT","points":[...]}"| 用户意图 | CLI 命令 |
|---|---|
| 计算面积 | iserver geometry area --point2ds {json} --unit {unit} --epsg {code} |
| 计算距离 | iserver geometry distance --point2ds {json} --unit {unit} --epsg {code} [--distance-mode Geodesic|Planar] |
参数说明:
--point2ds: 点集 JSON 数组,计算面积时首尾点应重合形成闭合多边形--unit: 结果单位,如 METER、KILOMETER 等--epsg: 坐标系 EPSG 编码,如 4326(WGS84)、3857(Web Mercator)--distance-mode: 距离模式,Geodesic(测地线,默认) 或 Planar(平面)--service: 几何服务名,默认 geometry--no-cache: 禁用缓存@file.json 语法从文件读取 point2Ds 参数用户也可以预先编辑配置文件 ~/.iserver-cli/config.yaml,填入 url 和 token,之后所有命令无需手动 login 即可使用:
url: http://: /iserver token: timeout: 30 verify_ssl: true output_format: json
这种情况下,Skill 直接使用配置文件中的凭证执行命令,无需调用 iserver login。
iserver map list iserver service status myService
iserver CLI 支持三种输出格式:
| 格式 | 参数 | 说明 |
|---|---|---|
| JSON | -f json |
默认格式,适合程序处理 |
| Table | -f table |
表格形式,适合人类阅读 |
| Plain | -f plain |
纯文本,简洁输出 |
使用方式:
iserver config --set-format table — 设置后所有命令默认以此格式输出iserver -f json 某命令 — 仅本条命令使用指定格式,不影响全局设置位置: ~/.iserver-cli/config.yaml
典型配置:
url: http://: /iserver token: YOUR_API_TOKEN timeout: 30 verify_ssl: true output_format: json
用户: "帮我登录到 http://
Skill 执行:
iserver login --url http://: /iserver -u -p
用户: "列出所有地图服务"
Skill 执行:
iserver map list
用户: "查看 map-China/rest 服务中名为 China 的地图详情"
Skill 执行:
iserver map info China -s map-China/rest
-f 参数指定输出格式--force 参数,且不要带 /rest 后缀,应该用 iserver service delete {服务名} --force 而不是 iserver service delete {服务名}/rest,例如:iserver service delete data-China-6 --force 而不是 iserver service delete data-China-6/rest,地图服务同理/services/security/tokens.json API 生成 Token~/.iserver-cli/config.yaml