Py学习  »  Python

2026年5月-10月我做ArcGIS Python工具总结

GISAI • 16 小时前 • 18 次点击  

GIS 工具资产盘点

ArcGIS Pro 自定义工具箱综述

AI智能体 与 AI智能体2

2026-11-06 | 基于 .atbx 静态解析 | V1.0

272 个工具 · 34 个有效工具集 · 909 个参数 · 56,675 行明文脚本



ArcGIS Pro 自定义工具箱综述:AI智能体 与 AI智能体2

执行摘要

272 工具

 

34 有效工具集

 

56,675 明文脚本行

 

909 参数

两个工具箱合计 272 个工具,覆盖数据建库、几何处理、业务统计、制图打印与成果归档全链。 AI智能体 为通用工具库,AI智能体2 为面向生产流程的业务工具箱,二者在时间上并行积累而非版本替代。 合并的主要工作是按 7 个能力域去重、规范元数据、还原 13 个受保护脚本并固化运行依赖。

一、总体结论

两个 .atbx 工具箱合计收录 272 个工具、34 个有效工具集、909 个参数与约 5.67 万行明文脚本 ,覆盖数据建库、几何处理、业务统计、制图打印与成果归档的完整作业链。其规模与组织程度已超出零散脚本集合,构成一套面向国土调查、勘测定界与林业业务生产的 ArcGIS Pro 自动化工具体系。

两箱呈明显的代际分工:AI智能体 起于 2025 年 7 月,收录 168 个工具,以通用能力为主——几何算法构造、文档与 PDF/PPT/图片格式转换、三调符号与勘界成果表;AI智能体2 起于 2026 年 2 月,收录 104 个工具,以生产化能力为主——图斑编号、地类面积统计、工程数据源修复、pagx 版面批量维护、质检与影像配准。前者接近"通用工具货架",后者接近"生产线工位"。二者的更新时间区间大面积重叠,说明并非新旧版本替代,而是通用库与业务线并行积累。

合并视角下有三类需要处理的结构性问题:2 个同名工具在两箱中脚本 MD5 完全一致,另有约 12 组功能高度重叠;13 个工具的执行脚本为十六进制编码形态,无法直接审阅与维护;版本标记、工具别名与工具箱显示名尚未统一。建议按能力域合并为单一工具箱,并建立版本、依赖与回归基线。

二、数据范围与统计口径

项目

口径

数据来源

直接解析两个 .atbx 容器(ZIP 结构),不依赖 ArcGIS Pro 运行时

结构文件

toolbox.content(工具集)、tool.content(参数、版本、更新时间)、tool.content.rc(中文名与功能摘要)、tool.script.execute.py(执行脚本)

工具计数

按含 tool.content 的工具目录实体计数,两箱共 272 个

脚本行数

明文脚本按行计数;13 个十六进制编码脚本未计入;1 个 ModelBuilder 工具无 .py 脚本

参数计数

按 tool.content 的 params  条目计数,共 909 个

统计时点

2026-11-06

 

口径说明:依赖统计中的"引用脚本数"按工具去重后的 258 个明文脚本计算;受保护脚本因内容不可读,不参与依赖统计。

三、规模与版本分布

工具箱

显示名

有效工具集

工具数

明文脚本行数

参数数

主要 app_ver

工具更新时间区间

AI智能体.atbx

AI智能体工具箱

20

168

30,694

531

13.6(165)、13.7(2)、13.4(1)

2025-07-06 ~ 2026-10-16

AI智能体2.atbx

新建工具箱

14

104

25,981

378

13.6(96)、13.7(4)、13.3/13.0/3.6(各 1)

2026-02-28 ~ 2026-11-03

合计

—

34

272

56,675

909

以 13.6 为主

2025-07 ~ 2026-11

app_ver 中的 13.6 与 13.7 分别对应 ArcGIS Pro 3.6 与 3.7 的内部版本号。AI智能体2 的 13.7 工具数量更多、更新延续至 2026 年 11 月,反映其面向新版本的持续维护;两箱同时残留 13.0、13.3、13.4 及"3.6"等不规范标记,属于元数据治理的历史遗留。AI智能体2 的显示名仍为默认值"新建工具箱",亦应一并规范。

四、能力域图谱

将 34 个有效工具集按作业对象归并为 7 个互不重叠的能力域,可完整覆盖 272 个工具:

能力域

AI智能体

AI智能体2

合计

对应工具集(AI智能体 / AI智能体2)

空间数据工程

11

23

34

坐标与投影、数据管理、工程与辅助 / 数据转换、工程管理

几何与拓扑处理

54

21

75

几何编辑、几何创建、拓扑修复、裁剪合并、面分割 / 空间处理、对齐

制图出图与符号

19

14

33

布局与打印、符号与制图、图幅分幅 / 制图打印、符号库

国土业务与统计质检

12

22

34

三调与勘界 / 业务、编号、导线、统计输出、质检

字段与表格治理

15

19

34

字段操作、Excel表格 / 数据编辑、办公

文档与多媒体自动化

52

0

52

文档处理、PDF处理、PPT处理、图片处理、音视频与二维码 / —

栅格 DEM 与影像配准

5

5

10

影像与DEM / 影像配准

合计

168

104

272

34 个有效工具集

空间数据工程(34 个) 承担数据进出与工程可移植性。AI智能体 侧偏基础——坐标系 WKID 清单导出、按 Excel 结构自动建 GDB、工程打包为 ppkx;AI智能体2 侧明显更贴近生产——GDB 转 Shapefile 时按 UTF-8 字节自适应字段长度、图层转带真彩色填充的 DXF、按 XY 容差重建要素类、.aprx 工程自包含打包,以及数据源断链的按名修复、按前缀批量重定向与工程健康检查。

几何与拓扑处理(75 个) 是投入最大的能力域,占全部工具的 27.6%。AI智能体 侧以"构造"为主:泰森多边形无缝图斑、随机凸多边形、三维圆柱与圆锥、最大水平内接矩形、耳剪法多边形最优分解、主方向面分割;AI智能体2 侧以"修正"为主:小图斑按共享边最长合并、缝隙自动填面、面边界与线对齐、等距与自由长度分割线。这一差异反映需求从"造测试数据"向"修生产数据"迁移。

制图出图与符号(33 个) 覆盖从符号库到成品版面的全链。AI智能体 提供布局外框、固定纸张/固定比例尺打印、标注自动换行、图幅分幅与 .stylx 符号库导出;AI智能体2 进一步下沉到版面的工程化批处理能力——经纬网与公里网、按图斑批量打印(含页查询)、标签转注记、RGB 符号回填与锥状渐变线,以及直接批量修改 .pagx 中的角注、图例组合名与图例字体。

国土业务与统计质检(34 个) 是业务价值最集中的部分。AI智能体 的三调按村汇总、三调竖表、椭球面积、界址点成果表与三调符号样本构成调查成果主线;AI智能体2 补齐了二调转三调地类编码、行政区代码层级处理、属性域编码填充、占地坐标 TXT 与要素类互转、按街区/行列编号、导线计算、地类面积模板统计,以及坐标系判别与面重叠拓扑检查,形成"编码—编号—面积—统计—质检"闭环。

字段与表格治理(34 个) 处理属性结构的标准化:字段批量增删与长度修改、按 Excel 同步字段、字段可见性控制、前导零补齐、重复值标记、别名与字段名互换,以及 Excel 模板占位符批量生成、工作表拆分与 Excel/MDB/PDF 之间的表格转换。其中 GDB 与 Excel 模板的 [字段名] 占位符替换是两箱共用的数据映射范式。

文档与多媒体自动化(52 个) 全部集中在 AI智能体,与 GIS 主链弱耦合,实质上是一条独立产品线:Word/PDF/PPT/图片的相互转换、批量错别字修正、DOCX 的 OOXML 级拆合与瘦身、源码转带高亮文档、网页长图截图、二维码、视频字幕与时长提取、TTS 语音合成。建议将其单独拆分为"办公自动化工具箱",避免 GIS 工具箱检索噪声。

栅格 DEM 与影像配准(10 个) 规模最小但专业度最高:DEM 地形剖面、库容曲线(含坝址约束升级版)、栅格擦除与影像合并、等高线插值加密平滑、山顶点提取;AI智能体2 侧以 EXIF GPS 照片配准、按点中心配准 GeoTIFF、照片定位插图与在线影像分块抓屏导出为主。

五、技术架构与依赖特征

5.1 参数接口形态

909 个参数中,要素图层、文件与字符串三类合计占比近半,说明工具以"选图层 / 选路径 / 给参数"的交互式 GP 工具为主,而非纯批处理配置驱动。

参数类型

含义

次数

占比

GPFeatureLayer

要素图层

183

20.1%

DEFile

文件

119

13.1%

GPString

字符串

114

12.5%

GPDouble

双精度数值

105

11.6%

DEFolder

文件夹

91

10.0%

Field

字段

81

8.9%

GPLong

长整型

73

8.0%

GPBoolean

布尔开关

33

3.6%

GPTableView

表视图

21

2.3%

DEFeatureClass

要素类

15

1.7%

5.2 依赖栈

工具实现以 arcpy 为统一入口,向外扩展为四个层次:数据访问(arcpy.da 游标、 arcpy.management)、版面控制(arcpy.mp 与 CIM)、Office 文档(openpyxl、python-docx、python-pptx、win32com)、图像与 PDF(PIL、PyMuPDF、pdfplumber)。

依赖模块

用途

引用脚本数(共 258 个明文脚本)

arcpy

ArcGIS Pro GP 框架

258

os

路径与文件系统

183

openpyxl

Excel 读写

38

docx

Word 文档

9

PIL

图像处理

20

traceback

异常堆栈

49

pptx

PPT 文档

5

numpy

栅格与矩阵

11

win32com

Office COM 自动化

11

sqlite3

符号库(.stylx)解析

7

fitz

PDF 渲染

5

sqlite3 的出现对应 .stylx 符号库的 SQLite 解析(去重、导出、名称与类别交换);win32com 承担 Word/PowerPoint 的 COM 转换与打印。此外还有若干运行期外部组件:Office/WPS、Selenium 或 Playwright 浏览器驱动、Edge TTS、ffprobe、Pandoc、pypinyin 与百度地图检索接口。这些依赖未在工具元数据中声明,是跨机器部署的主要不确定因素。

5.3 实现形态

实现形态

数量

特征

明文 Python 脚本工具

258

均可直接审阅,其中 258 个显式引用 arcpy

十六进制编码(受保护)脚本工具

13

内容为单一行 hex 串,源码不可直读

ModelBuilder 模型工具

1

TextToPolygonModel,无 .py 脚本

合计

272

另有 34 个有效工具集、909 个参数

13 个受保护脚本集中在批量裁剪、线转曲线、缝隙生成、几何修复与在线地名查询等早期工具(如 BatchCombine、GDBBatchClip、linetocurve、gapgenerator、BaiduPlaceQuery)。其文件内容为单一行十六进制串,解码后为自定义分隔的编码数据,无法按源码审阅;这批工具的功能说明只能依赖 tool.content.rc 中的中文摘要,后续维护、排错与升级均需先还原源码。全部 258 个明文脚本均显式引用 arcpy,即"办公自动化"工具也运行在 GP 框架内,通过参数面板调用而非独立程序。

六、两箱分工、重叠与演进

同名工具 2 个——BatchClipByField(按字段记录批量裁剪)与 DEMVolumeAnalyzer(DEM 库容曲线计算)——在两箱中脚本 MD5 完全一致,属于复制同步而非各自演进;AI智能体2 另提供 BatchClipByField1 与 DEMKR(坝址约束版)作为功能升级。按业务语义进一步归并,可识别出约 12 组重叠能力:

能力主题

AI智能体

AI智能体2

关系判断

面积平差

Areaadjust

MJPCMU、MJPCGQ

通用版 → 最大余数法/公顷版

椭球面积

TQMJCal

CalAreaTQ

功能等价

编号补零

FillZero

PadLeadingZero

功能等价,规则略异

字段清单

getFieldList

TableField2Excel

字符串输出 → 格式化 Excel

符号库导出

Stylx2Excel

StylxExportExcel、StylxDedup、SwapNameCategory

导出 → 库维护

数据源修复

BatchRepairData

RepairDataSources、RepairDataSource、RepairSelectedLayers

报告式 → 精确修复式

缝隙处理

gapgenerator

FillGaps、FillGaps1

生成缝隙面 → 填面/消除

小图斑合并

GroupbyEliminate

EliminateTiny/2、MergeSmallByGroup

分组消除 → 共享边最长合并

文本转面

kctxt2polygon

TxtToFeatureClass、TextToPolygon、ExcelToPolygon

勘界报备 TXT → 通用坐标文本

度分秒转点

DMStoPointFeatureClassConverter

DMSExcelToPoint

通用表 → Excel 专用

线分割面

LineSplitPolygon

SplitPolygonByLine

功能等价

图幅网格

CreateMapNO、RectMapNO 系列

AddGraticule、AddMeasuredGrid

分幅编号 → 版面格网

一条典型的三调/勘界成果作业链可完整落在两箱能力之内:坐标 TXT 或 Excel 转面要素 → 几何修复与缝隙/重叠处理 → 按街区或行列编号、字段标准化 → 椭球面积与地类面积统计 → 符号库与 RGB 符号化 → 图幅分幅与批量打印 → PDF/Word/Excel 归档与质检。这条链路也说明两箱合并的价值不在于"减少工具数量",而在于消除同环节的多个入口。

七、质量观察与整合建议

7.1 风险清单

风险

具体表现

处置建议

源码不可审阅

13 个十六进制编码脚本,无法静态检查与升级

优先还原明文;还原前在工具说明中标注受保护状态

破坏性操作

deleteAllFC 清空工程全部图层与默认 GDB 数据;SafeCLEANFile 清理系统目录;批量错别字与图片化 Word 就地改写

增加二次确认、备份与只读预演模式

元数据不规范

显示名"新建工具箱";别名 Script、kkkk、AddFramedy;app_ver 混入 13.0/13.3/13.4/"3.6"

统一命名规范与版本号,批量改写 .atbx 元数据

外部依赖未声明

COM 组件、浏览器驱动、ffprobe、Pandoc、在线 API 等

建立依赖清单与启动前置检查,失败时给出可执行的安装提示

编码与格式兼容

中文路径、DBF 编码、GDB→Shapefile 字段字节长度

已有 GDBFeatureToShp 长度自适应,建议补 GBK/UTF-8 编码显式校验

双份维护

2 个完全复制工具与 12 组重叠能力

合并为单一工具箱,旧入口标记 deprecated 并保留一个版本周期

7.2 整合路径

1.并箱:以 7 个能力域重建工具集,将两箱 34 个工具集归并为 7 个一级工具集,保留原工具集名作为二级标签。

2.去重:对 2 个复制工具直接保留生产版;对 12 组重叠能力逐组选定主实现,其余标记 deprecated。

3.统一元数据:规范中文名、英文别名、功能摘要、作者、版本号与依赖声明,消除默认显示名与临时别名。

4.还原受保护脚本:优先处理 13 个编码脚本,纳入源码管理后再允许修改。

5.固化运行环境:输出依赖清单与前置检查脚本,明确 ArcGIS Pro 版本、Office COM、字体与编码要求。

6.建立回归基线:以本次解析出的 272 个工具清单为基线,工具增删、参数变更与脚本更新均做差异比对,避免无意的工具丢失。

判断依据:以上结论均来自对两个 .atbx 容器内结构文件与执行脚本的静态解析,未调用 ArcGIS Pro 运行工具;功能描述取自各工具自身的中文摘要,未做运行态验证。

附录 A 工具集与工具全量对照

AI智能体.atbx(168 个工具 / 20 个工具集)

工具集

数量

工具名称

布局与打印

10

布局添加外框、布局添加外框动态、批量导出工程布局为 PDF 文件、清除布局所有、Excel插入布局、固定纸张打印、布局生成表格、RGBTOCYMK、固定比例尺打印、标注的自动换行

Excel表格

8

ATBX工具箱解析与Excel导出工具、Excel模板批量生成、Excel表格转word、Excel表中的数据按分组拆分、Excel文件按工作表拆分、批量将Excel多工作表导出为PDF、批量将Excel每个工作表导出为PNG图片、基于字段别名的Excel列表记录输出

GIS\三调与勘界

12

界址点成果表生成(模板版)、自动生成界址点成果表、三调按村汇总、三调竖表计算、三调样式输出布局、三调样式输出布局点符号有样式、三调样式输出布局点符号有样式有水系不规则形状、椭球面积计算、获得拐点、勘测定界报备坐标TXT转面要素工具、生成三调样式、生成三调样式根据代码表

GIS\符号与制图

4

自动应用图层符号化、清理唯一值符号类、符号库的内容输出Excel、Excel表转面符号库

GIS\坐标与投影

4

DMS经纬度转点要素类、导出所有坐标系WKID、导出所有投影方法名称、导出所有地理坐标系

GIS\数据管理

3

提取水系建筑物道路、根据Excel属性结构表自动数据库、非常危险-删除所有图层要素类

GIS\影像与DEM

5

DEM地形剖面提取、DEM库容曲线计算工具、影像裁剪、栅格擦除、影像合并

GIS\字段操作

7

字段补0为指定位数、字段名或别名查找、字段值查找、根据Excel模板批量添加字段、删除非必要字段、获得所有字段信息、根据代码表随机填充字段值

GIS\几何编辑

13

面积自动平差处理、线端点小于一点距离合并、线要素平行复制、修改面的开始点位置、图形空间编号(从上到下、从左到右)、按线方向排序从上到下,从左到右、打断相交线、更新线的起终点编号、更新线的起终点编号高级、更新点连接线信息、统计面要素中的孔洞数量、线段转曲线固定拱高、线段转曲线

GIS\几何创建

18

根据输入中心点生成矩形面、文字转换图形、3D线生成工具、3D线生成工具有插值、生成没有缝隙简单多边形、生成没有缝隙复杂多边形、按角度绘制360个正三角形、分层面转线工具、分层面转线工具2(速度更快)、正多边形生成(范围中心)、点转多边形、随机生成凸多边形、随机生成多边形、表转面、线末端自动闭合生成面、点生成圆锥、点生成圆柱、生成公里数

GIS\图幅分幅

5

生成标准分幅、生成矩形图幅网格工具、生成矩形图幅网格工具每个部分、生成矩形图幅、路径沿线分幅工具

GIS\拓扑修复

6

批量修复几何、批量更新几何范围、分组消除、尖刺清理工具、自相交解决、自动检测并生成面要素之间的缝隙面

GIS\裁剪合并

8

按字段记录批量裁剪、矢量数据批量合并、矢量批量裁剪、数据追加、按指定字段对一个输入要素类进行分组导出、数据库批量裁剪、相交裁剪替换工具、shp矢量数据批量裁剪

GIS\面分割

9

中心对称自适应网格裁剪工具、线分割面、最大水平内接矩形工具、面按指定宽度分割面(指定角度)、面按主方向分割、面按主方向垂直方向分割、多边形最优分解工具、面按数量等宽分割面(指定角度)、多边形递归分割为水平矩形和三角形

PDF处理

8

PDF合并(选多个PDF)、PDF合并按文件夹合并、PDF按页码数分割、PDF按份数分割、PDF转图片、PDF转图片PDF、批量Pdf转PPTX、图片转PDF

PPT处理

5

批量PPT转PDF、PPT转图片、批量修改PPT错别字、PPT文字替换工具、PPTX开头替换

图片处理

10

批量图像模糊处理、批量图像清晰处理、批量图片去除水印、图片按像素分割、图片按行列分割、文本转图片工具、网页转图片、网页转图片方法2、网页中提取图片、合并长图

工程与辅助

4

工程批量打包、批量检查并修复工程图层数据源问题、清除垃圾文件、获得数据路径

文档处理

22

根据Word模板批量生成文档、批量word转图片PDF、批量Word文档修改错别字、C#源码转docx、doc文档按章节拆分、Markdown格式转docx、PDF批量转Word、py源码转docx、批量word转PDF、Word图片提取与格式转换、Word编号工具、word文档减少大小、word文档减少大小更好、批量删除多余的空行、删除多余的空行、 word文档中图片模糊处理、md转docx、合并docx、Word中表格转Excel、Word转图片一页一个、批量word转图片Word、Word转长图片

音视频与二维码

7

二维码生成、读二维码、获得视频字幕、获得视频时长、获得拼音、字符串转语音、文本文件转语音

AI智能体2.atbx(104 个工具 / 14 个工具集)

工具集

数量

工具名称

编号

5

按街区编号地块、按街区编号地块(在一起优先)、按行列顺序编号、数据库要素类顺序编号、顺序编号字段

业务

8

二调转三调地类编码、按模板统计地类面积、行政区代码层级处理、要素类转txt、文件夹批量转要素类、地类面积统计、属性域编码填充工具、txt转要素类

符号库

3

符号库名称去重、符号库信息导出Excel、符号库名称和类别交换

制图打印

11

添加经纬网、添加公里网、按图斑批量打印、根据符号获得RGB、标签转注记、pagx左下右下文本改名、pagx图例组合改名、批量修改右下角文本、pagx图例字体与可见要素、根据属性符号化、线符号(颜色 + 宽度渐变)

数据编辑

9

所有字段全部可见、修改字段长度、图层去重工具、面积平差公顷、通用面积平差、按出现次序标记重复值、字段补前导0、设置字段可见性、按Excel批量同步字段

数据转换

13

百度地名查询(一地多名)、Excel度分秒转点要素、Excel 按字段构面、三维要素转二维(点线面通用)、要素类转 Shapefile(字段长度自适应)、图层转 CAD(带颜色填充)、做3d三维、合并工程(数据打包)、按XY容差重建要素类、文本按字段构面、文本转面模型、在线影像下载、度转度分秒

空间处理

18

按字段记录批量裁剪、数据库批量裁剪(按字段值拆分GDB)、计算椭球面积、等高线插值加密平滑、02 自由长度分割线、坝址约束与连通性控制的 DEM 库容曲线计算工具、DEM库容曲线计算工具、小图斑合并、小图斑直接合并、01 等距分割线、提取山顶点、缝隙自动填面、缝隙处理(输出无缝隙结果)、多图层相交与批量擦除、面的主要拐点与交叉点、小图斑按分组字段合并、按线分割面、字段名与别名互换

办公

10

Excel工作表拷贝、Excel转MDB、生成视频播放器、PDF转Excel、PDF 转 Excel(一表一工作表)、批量修改PPTX字体大小、PDF 旋转(顺时针)、微信公众号网址转doc文档、PDF 转 PPTX(可编辑)、xls和doc2003升级到2007xlsx和docx

对齐

3

面边界与线对齐、线边界与面一致、面要素重叠处理工具

导线

2

导线计算、导线分段方位角计算

工程管理

10

批量紧缩数据库、ArcGIS Pro工程检查、清理最近工程、关闭视图窗口、打开所有视图窗口、打开指定视图窗口、按名称修复数据源、批量修复工程数据源、按名称修复所选图层、通用查找

统计输出

5

汉字频次统计、地名长度统计、数据清单生成、表结构转Excel、面节点坐标导出Excel

影像配准

5

按点中心配准图片、按照片坐标自动配准(文件夹)、按照片坐标自动配准(文件夹) 1、照片定位插图、在线影像下载-分块抓屏导出

质检

2

面重叠拓扑检查、坐标系检查与定义


 


Python社区是高质量的Python/Django开发社区
本文地址:http://www.python88.com/topic/203182