geopipe-agent

项目地址： https://github.com/znlgis/GeoPipeAgent

最新版本： 0.1.0（截至2026-10，源码 pyproject.toml；发布包名 geopipe-agent 尚未上传 PyPI，需从源码安装）

许可证： MIT

概述

GeoPipeAgent 是一个 AI 原生的 GIS 分析流水线引擎。核心理念是：你（AI）生成 YAML 管道配置，框架负责执行并返回结构化结果。

核心能力：

• 声明式流水线：YAML 定义分析步骤，AI 友好
• 丰富步骤库：33 个内置步骤，覆盖矢量分析、栅格分析、网络分析、空间聚类、数据质检
• 多后端支持：7 种后端可切换（native_python / gdal_cli / gdal_python / qgis_process / pyqgis / generic_cli / curl_api），按环境自动检测可用性
• 质检框架：10 种 QC 检查，支持错误/警告/信息三级
• 结构化报告：JSON 输出，含统计信息和 QC 汇总
• 步骤引用：$step_id.output 语法实现步骤间数据传递

---

快速开始

安装

git clone https://github.com/znlgis/GeoPipeAgent.git
cd GeoPipeAgent
pip install -e ".[analysis,network]"   # 按需启用分析/网络分析可选依赖

基本用法

# 列出所有可用步骤（可按类别过滤）
geopipe-agent list-steps --category qc

# 查看步骤详情
geopipe-agent describe vector.buffer

# 校验 YAML 流水线（不执行）
geopipe-agent validate pipeline.yaml

# 执行流水线
geopipe-agent run pipeline.yaml

# 查看可用后端
geopipe-agent backends

# 查看 GIS 数据文件摘要
geopipe-agent info data/roads.shp

# 覆盖流水线变量 / 输出 JSON 步骤清单 / 生成 AI 技能包
geopipe-agent run pipeline.yaml --var input_path=roads.shp
geopipe-agent list-steps --format json
geopipe-agent generate-skill --output-dir skills/geopipe-agent

# 能力缺口：查候选能力与回退路径（自我扩展闭环入口）
geopipe-agent resolve "把 Shapefile 落库到 PostGIS"
geopipe-agent knowledge search "坐标转换" --tags crs

最小示例

pipeline:
  name: "快速缓冲区"
  steps:
    - id: read
      use: io.read_vector
      params:
        path: "data/roads.shp"
    - id: buffer
      use: vector.buffer
      params:
        input: "$read"
        distance: 500
    - id: save
      use: io.write_vector
      params:
        input: "$buffer"
        path: "output/result.geojson"
  outputs:
    result: "$save"

---

核心概念

步骤引用语法

语法	说明	示例
$step_id	等同于 $step_id.output	$buffer
$step_id.output	引用步骤输出	$buffer.output
$step_id.stats	引用步骤统计信息	$buffer.stats
$step_id.issues	引用 QC 步骤问题列表	$check.issues
$step_id.issues_count	QC 问题数量	$check.issues_count
${var_name}	变量替换	${input_path}