核心用法
world-boundary-download 是一款面向 GIS 开发者、数据分析师和科研工作者的全球行政区划矢量数据下载工具。用户可通过 ISO 代码、国家名称或中文关键词搜索目标国家，灵活选择 ADM0-ADM5 多级行政边界，并指定 Shapefile、GeoJSON、GeoPackage 或 TopoJSON 格式导出。核心功能包括：单国下载、多边形 bbox 裁剪、多国合并拼接、全等级批量获取，以及简化版几何数据下载。CLI 设计遵循 Unix 哲学，子命令清晰分离搜索、元信息查询与下载任务，支持自动降级链（geoBoundaries → GADM → Natural Earth）确保数据可用性。
显著优点
1. 数据源权威且授权友好：默认 geoBoundaries 采用 CC BY 4.0 协议可商用，规避了 GADM 的非商业限制风险；Natural Earth 公共域兜底，满足合规需求。
2. 多格式输出与元数据完备：覆盖主流 GIS 格式，元信息 API 提供年份、来源、许可、面积、顶点数等关键字段，便于数据溯源与质量控制。
3. 空间裁剪与多国拼接：bbox 参数支持经纬度框选裁剪，multi 子命令实现多国边界合并，适合区域级分析场景。
4. 智能缓存机制：本地缓存避免重复下载，cache-info/clear 便于缓存管理，提升批量任务效率。
潜在缺点与局限性
- 中国数据隔离：明确排除中国行政区划，需配合独立 skill 使用，跨国研究需额外整合。
- Shapefile 字段截断：DBF 格式限制字段名 10 字符，可能导致多列名歧义（如带
_1/_2后缀），复杂属性分析建议选用 GeoPackage。 - bbox 近似计算误差：平面近似公式在极地或跨 180° 经线场景存在失真，高精度边界裁剪需谨慎验证。
- 外部依赖风险：TopoJSON 格式需额外安装
topojson包，网络出口依赖 GitHub LFS 及三数据源 CDN，偶发 502 错误需自动降级处理。
适合的目标群体
- GIS 与空间数据工程师：需要标准化全球边界底图的 WebGIS、桌面 GIS 项目开发者。
- 公共卫生与国际研究学者：疫情传播、环境评估等跨国区域研究需一致行政单元的数据分析团队。
- 数据可视化设计师：快速获取简化版 GeoJSON 制作交互式地图、信息图。
- 政策与商业分析团队：市场区域划分、供应链地理分析等需合规商用授权数据的场景。
常规使用风险
1. 网络与可用性：三数据源均托管于海外 CDN，国内访问可能存在延迟或间歇性阻断，需关注 --source 强制切换策略。
2. 缓存磁盘占用：长期未清理的缓存可能累积 GB 级矢量数据，建议定期 cache-clear 或监控磁盘空间。
3. GADM 许可陷阱：自动降级至 GADM 时触发非商业授权提示，商业项目需显式 --source geoboundaries 规避合规风险。
4. 几何精度权衡：简化版与原始数据顶点数差异显著，精细尺度分析需禁用 --simplified。