iserver-skills

Polar Sponsor
爱发电 赞助
.NET 9.0

集成6类60项SuperMap iServer操作技能:服务器管理、GIS服务管理、地图服务、数据服务、空间分析、几何量算等。支持自然语言转换为CLI命令执行。运行环境:Python 3.8+。

SuperMap iServer CLI Skills

功能概述

SuperMap iServer CLI Skills是一项面向实际任务的技能,主要用于本技能提供对话式界面来操作 SuperMap iServer GIS 服务器;用户可以用自然语言描述需求,自动转换为 iserver CLI 命令并执行;

核心要点

  • 第一步:检查环境(必须先做!
  • 如果 Python 未安装或版本低于 3.8 :;
  • Windows :从 https://www.python.org/downloads/ 下载安。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

SuperMap iServer CLI Skills

概述

本技能提供对话式界面来操作 SuperMap iServer GIS 服务器。用户可以用自然语言描述需求,自动转换为 iserver CLI 命令并执行。

安装

第一步:检查环境(必须先做!)

# 检查 Python 版本(必须 3.8+)
python --version

# 检查 pip 是否可用
pip --version

如果 Python 未安装或版本低于 3.8:

  • Windows:从 https://www.python.org/downloads/ 下载安装,安装时必须勾选 "Add Python to PATH"
  • Linux/macOS:使用包管理器安装,如 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

GIS服务管理

用户意图 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 类型,默认不覆盖;不加该参数时如果输出数据集已存在会报错)
  • JSON 参数在命令行工具中建议用 转义内部双引号,如:--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://:/iserver,用户名 ,密码 "

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

常见问题

  1. Token 过期: Token 默认 8 小时有效,过期后需要重新登录
  2. 未登录: 大部分操作需要先登录才能执行
  3. 服务名称: 服务名称区分大小写
  4. 输出格式: 可用 -f 参数指定输出格式
  5. 删除服务: 删除服务时要加 --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
  • Token 默认 8 小时有效
  • Token 存储在 ~/.iserver-cli/config.yaml

相关专题

更多
CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

2026.11.22

0

11

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

0

10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex官方文档
Codex官方文档

共0课时 | 0人学习

QClaw产品手册
QClaw产品手册

共0课时 | 0人学习