集成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://
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
常见问题
- Token 过期: Token 默认 8 小时有效,过期后需要重新登录
- 未登录: 大部分操作需要先登录才能执行
- 服务名称: 服务名称区分大小写
- 输出格式: 可用
-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.jsonAPI 生成 Token - Token 默认 8 小时有效
- Token 存储在
~/.iserver-cli/config.yaml
热门AI工具
相关专题
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环境请
0
2026.11.22
本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。
0
2026.11.20
本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。
0
2026.11.20
从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。
0
2026.11.20
本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。
0
2026.11.20
本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。
0
2026.11.20
本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。
0
2026.11.20
Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。
0
2026.11.20
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
热门下载
相关下载
最新文章