核心用法
world-boundary-download 是一款面向地理信息分析、数据科学与可视化领域的专业数据获取工具。用户可通过 ISO 国家代码、中英文名称或模糊搜索定位目标国家，下载从国家级（ADM0）到村级（ADM5，视国家可用性）的多层级行政区划矢量数据。工具提供丰富的子命令体系：
- 数据探索：
search模糊搜索国家、levels查看可用行政层级、info获取详细元数据（含边界框、面积、数据来源、授权许可等） - 精准下载：
country下载全国数据、region按经纬度框选裁剪、multi多国拼接合并、all-levels一键获取某国全部层级 - 格式灵活：支持 ESRI Shapefile（zip）、GeoJSON、GeoPackage、TopoJSON 四种主流 GIS 格式，其中
--simplified参数可获取简化版 GeoJSON，大幅缩减文件体积 - 智能降级：默认优先使用 CC BY 4.0 商用友好的 geoBoundaries，失败时自动降级至 GADM 4.1 和 Natural Earth，确保数据可获取性
显著优点
1. 数据源权威可信：整合 geoBoundaries（威廉玛丽学院 GeoLab 维护）、GADM 4.1（加州大学戴维斯分校）、Natural Earth 三大业界标准数据源，数据质量经过学术验证
2. 商用授权友好：默认 geoBoundaries 采用 CC BY 4.0 许可，明确支持商业用途；Natural Earth 公共域授权，规避了 GADM 的非商业限制
3. 接口设计专业：提供完整的元数据 API（年份、来源、许可证、面积、顶点数等），便于数据溯源与合规审查
4. 空间操作完备：内置 bbox 裁剪、缓冲区扩展（--expand-km）、多边形简化等常用 GIS 预处理功能，减少下游处理成本
5. 离线缓存机制：智能缓存策略避免重复下载，配合 cache-info/cache-clear 实现缓存生命周期管理
潜在缺点与局限性
1. 中国数据限制：明确排除中国行政区划（需使用专用 china-admin-divisions skill），对国内用户不够便利
2. Shapefile 字段截断：ESRI Shapefile 的 DBF 格式限制字段名 10 字符，可能导致多列名带 _1/_2 后缀，需改用 GeoPackage/GeoJSON 规避
3. 极地坐标失真：bbox 框选采用平面近似算法，极地区域或跨 180° 经线场景会产生几何失真
4. GADM 许可风险：自动降级链可能静默使用 GADM 4.1，该数据源仅限非商业用途，商用场景需显式指定 --source geoboundaries 规避
5. 网络依赖性强：三大数据源均托管于境外服务器（GitHub LFS、UC Davis、NACIS CDN），国内访问可能受网络条件制约
适合的目标群体
- GIS 与遥感从业者：需要快速获取标准化行政边界底图
- 数据科学与量化研究人员：进行空间计量、区域统计、疫情/灾害等地理分布分析
- 可视化开发者：为地图应用（Leaflet、Mapbox、D3.js 等）准备 lightweight 地理数据
- 国际业务分析师：评估跨国市场、物流网络、供应链的地理覆盖
- 学术科研人员：发表论文需注明数据来源的规范边界数据
常规使用风险
- 性能风险：全球 ADM0 数据量较小，但 ADM3+ 细分层级数据量可能达数百 MB，低带宽环境下载超时概率增加
- 依赖项风险：TopoJSON 格式需额外安装
topojsonPython 包，未安装时调用会报错 - 缓存膨胀：长期高频使用可能导致
~/.cache/world-boundary-download/目录膨胀，建议定期清理 - 数据时效性：各数据源更新周期不一（geoBoundaries 约年度更新），对边界敏感场景（如争议地区）需核实
year字段 - 并发限制：GitHub LFS 存在匿名下载速率限制，大规模批量下载可能触发 403/502 错误