用途：从远程服务或本地文件出发，引导生成完整的地理空间数据目录，覆盖发现、提取/转换、远程设置、资产生成、元数据丰富、模板与 README 生成、STAC-GeoParquet 生成和推送。
主要能力：支持远程服务（WFS、ArcGIS FeatureServer/MapServer、ImageServer）与本地文件（Shapefile、GeoJSON、GeoPackage、GeoTIFF 等）。远程用 portolan extract，本地用 portolan init --auto、portolan scan、portolan check --dry-run、portolan check --fix。可生成 PMTiles（需 tippecanoe）、缩略图、元数据模板与 README，资产超过 1000 时生成 items.parquet。
使用方式：先发现并检查数据源，再提取或转换；设置目标（Source Cooperative、S3、GCS、Azure）、许可证与联系人；用 portolan add . --recursive [--pmtiles] 注册并生成资产；用 portolan metadata init --recursive 和 portolan readme --recursive 生成模板与文档；最后 portolan push --dry-run 验证后 portolan push --verbose 推送。
限制与原则：绝不臆造元数据，只使用源中已有信息；不确定时设检查点询问；始终先 dry-run；失败内联警告并在末尾汇总。本地文件必须放在子目录中，每个子目录成为一个 STAC 集合。大图层（超过 10 万要素）、超过 50 个图层、混合几何类型、缺失 CRS 等情况会给出警告。具体收费、价格、平台支持范围等资料暂未提供。