用途:把 Harbor parity 实验输出发布到共享 Hugging Face 数据集,并取得 discussion URL,用于 adapter 的 parity_pr 字段。
主要能力:创建或复用数据集 PR;用 git sparse-checkout、--depth 1 与 --filter=blob:none 只获取目标 PR 引用与当前 adapter 所需路径,不做整库克隆;将本地结果复制进稀疏工作树;对大于 10 MiB 的文件做 Git LFS 跟踪后再提交;直接 git push 到 PR 引用;输出 discussion URL 记录。
前置条件:需具备 Hugging Face 讨论写权限(经典 write token 或启用全局 discussion.write 的细粒度 token),否则 create_pr.py 会返回 HTTP 403;目标数据集默认固定为 harborframework/parity-experiments。
使用方式:先用 uv run python scripts/create_pr.py create-pr --title ... --description-file ... 创建 PR,获取 pr_number、discussion_url、repo_id;再初始化稀疏检出,执行 git remote add origin git@hf.co:datasets/harborframework/parity-experiments、git sparse-checkout set adapters/<adapter_name>、git fetch --depth 1 --filter=blob:none origin refs/pr/<number>:pr/<number>、git checkout pr/<number>;用 rsync 复制本地结果;扫描大于 10 MiB 的文件,必要时在 adapters/<adapter_name>/.gitattributes 内用 (cd adapters/<adapter_name> && git lfs track "<pattern>") 添加规则;提交后用 git push origin pr/<number>:refs/pr/<number> 推送,可加 GIT_SSH_COMMAND 保持连接。
适用场景:Harbor 适配器的 parity/oracle 结果批量上传,尤其是大型 parity 包。限制与注意:不要误传 Harbor 仓库本体;不要整库克隆;不要修改仓库根 .gitattributes(应放在 adapter 目录下的 .gitattributes);始终排除 .DS_Store;若推送中断,先原样重跑同一 push 命令;hf upload-large-folder 仅作为 raw git 不可用或用户明确要求时的回退方案。具体 PR 编号、路径与 adapter 名称需用户提供,资料未给出更多细节。