You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

91 lines
3.2 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 2026 具身仿真合成挑战赛:可复现 Baseline
本项目提供两条清晰区分的路径:
1. **路径 A:快速精确复现。** 使用冻结中间包,在无 GPU 环境下重建历史 `67.6000` 候选的同一字节,并做本地校验。
2. **路径 B:从官方输入重建。** 以 `question.zip` 与 `submission_example.zip` 为竞赛数据输入,在阿里云 GPU 上执行可审计的资产生成流程。
源码位于 [public_asset_baseline](public_asset_baseline/README.md)。官方原始数据、视频、模型缓存和任何密钥均不随本项目分发。
## 下载与解压
发布后,从 GitHub Release 下载 `public_asset_baseline_release.zip`。下载链接固定为:
```text
https://github.com/ben1234560/AiLearning-Theory-Applying/releases/latest/download/public_asset_baseline_release.zip
```
解压并进入 Baseline:
```bash
unzip public_asset_baseline_release.zip
cd public_asset_baseline
```
本地待上传的同名文件位于 `release_assets/`;该目录中的 ZIP 被 Git 忽略,待官方核验通过后由仓库维护者在 GitHub Release 页面上传。上传前后均应对照 [CHECKSUMS.md](CHECKSUMS.md)。
## 校验
Release ZIP 的 SHA-256 和历史候选的 MD5/SHA-256 见 [CHECKSUMS.md](CHECKSUMS.md)。解压后,先校验预生成的提交包:
```bash
md5 quick_output/submission.zip
shasum -a 256 quick_output/submission.zip
```
预期值:
```text
MD5: a220303381c7bb8886684778e34689df
SHA256: 2e979d08d10a785e0c47a4a1ba923131a52c8e53970bb0578f815893585e8d4b
```
再执行结构、纹理引用和轻量物理校验:
```bash
python scripts/validate_submission.py \
--package quick_output/submission.zip \
--report quick_output/submission_recheck.json
```
合格结果应为 `valid: true`、`valid_tasks: 34`、`physics_probe_steps: 120`。
## 路径 A:无需 GPU 的快速精确复现
Release 包已附带 `quick_output/submission.zip`,可直接比对或提交。若要从冻结中间包重建它:
```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install .
python -m pip install -r requirements-dev.txt
python scripts/quick_reproduce.py --output-root reproduced_quick_output
python scripts/validate_submission.py \
--package reproduced_quick_output/submission.zip \
--report reproduced_quick_output/validation_recheck.json
```
`reproduced_quick_output/submission.zip` 的 MD5 和 SHA-256 应与上方预期值一致。路径 A 不访问网络、不使用 GPU;它保证候选文件相同,而未来线上分数仍由平台评测环境决定。
## 路径 B:从官方 ZIP 的 GPU 重建
将官方获取的两份 ZIP 放在私有目录,且不要提交到 Git:
```text
/data/competition_input/question.zip
/data/competition_input/submission_example.zip
```
完整资源选择、许可前提、GPU 宿主机预检与运行方式见 [GPU_BUILD.md](public_asset_baseline/GPU_BUILD.md)。完成许可确认后,在 `public_asset_baseline/` 目录执行:
```bash
export DATA_DIR=/data/competition_input
export OUT_DIR=/data/asset_baseline_output
export ACCEPT_HUNYUAN_LICENSE=yes
bash scripts/run_aliyun.sh
```
路径 B 的输出是独立重建结果,可能因为精度等原因与路径 A 线上分数不一致。