cli-anything-qgis

cli-anything-qgis 是做什么的？

当你需要从终端通过真实的 QGIS 运行时检查或修改 QGIS 项目时，使用此技能。

要求

• 已安装 QGIS，且 qgis_process 在系统 PATH 中
• 运行 CLI 的 Python 环境中可导入 PyQGIS
• Python 3.10+

代理指导

• 对于所有机器驱动的使用场景，优先使用 --json
• 对于一次性命令，在操作现有项目时传递 --project <路径>
• 不带任何子命令运行 cli-anything-qgis 会启动有状态 REPL
• 布局导出由真实的 QGIS 处理算法支持：
  • native:printlayouttopdf
  • native:printlayouttoimage

此 CLI 涵盖的功能

• 创建、打开、保存和检查 .qgs / .qgz 项目
• 创建可写的 GeoPackage 支持矢量图层
• 通过 WKT 几何和类型化 key=value 属性添加要素
• 创建打印布局并添加地图/标签元素
• 将布局导出为 PDF 或图片
• 检查并运行通用 qgis_process 算法
• 检查会话状态和历史记录

命令组

project (项目)

• new -o/--output [--title] [--crs]
• open PATH
• save [PATH]
• info
• set-crs CRS

layer (图层)

• create-vector --name --geometry --crs [--field name:type ...]
• list
• info LAYER
• remove LAYER

feature (要素)

• add --layer LAYER --wkt WKT [--attr key=value ...]
• list --layer LAYER [--limit N]

layout (布局)

• create --name [--page-size] [--orientation]
• list
• info LAYOUT
• remove LAYOUT
• add-map --layout LAYOUT --x --y --width --height [--extent xmin,ymin,xmax,ymax]
• add-label --layout LAYOUT --text TEXT --x --y --width --height [--font-size N]

export (导出)

• presets
• pdf OUTPUT --layout LAYOUT [--dpi] [--force-vector] [--force-raster] [--georeference/--no-georeference] [--overwrite]
• image OUTPUT --layout LAYOUT [--dpi] [--overwrite]

process (处理)

• list
• help ALGORITHM_ID
• run ALGORITHM_ID [--param KEY=VALUE ...]

session (会话)

• status
• history [--limit N]

示例

创建项目并添加可写图层

cli-anything-qgis --json project new -o demo.qgz --title "Demo" --crs EPSG:4326
cli-anything-qgis --json --project demo.qgz layer create-vector \
  --name places \
  --geometry point \
  --field name:string \
  --field score:int

添加要素并检查它们

cli-anything-qgis --json --project demo.qgz feature add \
  --layer places \
  --wkt "POINT(1 2)" \
  --attr name=HQ \
  --attr score=5

cli-anything-qgis --json --project demo.qgz feature list --layer places --limit 10

创建并导出布局

cli-anything-qgis --json --project demo.qgz layout create --name Main
cli-anything-qgis --json --project demo.qgz layout add-map --layout Main --x 10 --y 20 --width 180 --height 120
cli-anything-qgis --json --project demo.qgz layout add-label --layout Main --text "Demo map" --x 10 --y 8 --width 100 --height 10
cli-anything-qgis --json --project demo.qgz export pdf output.pdf --layout Main --overwrite

检查或运行处理算法

cli-anything-qgis --json process help native:buffer
cli-anything-qgis --json --project demo.qgz process run native:buffer \
  --param INPUT=/tmp/demo_data.gpkg|layername=places \
  --param DISTANCE=1 \
  --param SEGMENTS=8 \
  --param END_CAP_STYLE=0 \
  --param JOIN_STYLE=0 \
  --param MITER_LIMIT=2 \
  --param DISSOLVE=false \
  --param OUTPUT=/tmp/buffer.geojson

REPL

cli-anything-qgis

交互式流程示例：

project new -o demo.qgz --title "Demo"
layer create-vector --name places --geometry point --field name:string
feature add --layer places --wkt "POINT(1 2)" --attr name=HQ
layout create --name Main
session status
quit