Files
pbf/tools/provider-pipeline/README.md
2026-10-06 09:31:05 +08:00

1.3 KiB
Raw Blame History

Provider-neutral PBF Pipeline

执行

在仓库根目录安装 requirements-provider-pipeline.txt 后,执行:

python tools/provider-pipeline/run_provider_pipeline.py --manifest providers/navsea/manifest.json
python tools/provider-pipeline/run_provider_pipeline.py --manifest providers/cm95/manifest.json

也可重复传入 --sample-tile z/x/y 覆盖 manifest 中的样本候选;Pipeline 复用 manifest 声明的现有人工 assignment 或冻结 Catalog,不会用自动 matcher 覆盖审核结果。已有视觉目录和实例化目录会从 .tmp/provider-pipeline/ 复用;需要从头重算时删除对应 work 目录。--no-export 只运行到 Package 校验。

PBF-01 保存原 Style、Sprite 和真实 PBF 样本并计算 SHA-256 / source fingerprint。PBF-02 直接复用现有 Style Visual Object Tool。PBF-03 接收 provider/dataset 参数并为每个 feature 写 occurrence 及可追溯证据。PBF-04 从冻结 Standard Catalog 的视觉 hash 对照,或读取声明的人工 assignment。PBF-05/06 使用共享契约和校验逻辑。只有 PASS 或 PASS_WITH_WARNINGS 才能 PBF-07 导出。

输出目录默认 dist/<provider>/<dataset>/<version>/,运行缓存位于 .tmp/,不纳入 Git。Pipeline 不生成 ProviderExecutionPlan。