tao-validate-dataset-format

验证 TAO DAFT 数据集

快速开始

tao-daft validate <format> --path <dataset-or-parent-dir>

<format> 是位置子命令（例如 metropolis-v3.0、cosmos-reason-v1.0）； --path 为必填项。通过 tao-daft validate --help 和对应的子命令 --help（见下文“CLI 约定”）了解支持的格式及各格式的标志。

预检

python -c "import nvidia_tao_daft" 2>/dev/null || {
  echo "MISSING: tao-daft not installed. Run:"
  echo "  pip install nvidia-tao-daft"
  exit 1
}

快速开始

选择格式标识前，先查看已安装的验证器格式，然后通过 --path 传入目标并运行验证：

tao-daft --version
tao-daft validate --help
tao-daft validate <format> --help
tao-daft validate <format> --path /path/to/daft-dataset

用途

针对 DAFT 数据集（或包含多个数据集的目录树）运行 tao-daft validate。 CLI 是规范；此技能负责选择子命令和标志，并解释结果。

当用户提到“TAO DAFT”、“DAFT 格式”、验证 DAFT 数据集、架构／交叉引用错误或 tao-daft validate 时触发。 对于非 DAFT 布局（COCO、YOLO、Data Factory JSONL），或 tao-daft info／tao-daft convert，不要触发——这些命令各有对应的技能。

如果用户的开场描述含糊不清，先运行几个 --help 命令以了解情况，然后再回来确认任务。

前置条件

• 已安装 nvidia-tao-daft（pip install nvidia-tao-daft；只需安装 wheel，无需源代码仓库）。通过 tao-daft --version 确认。
• 本地磁盘上有一个 DAFT 数据集，或包含多个数据集的父目录。

说明

CLI 约定

tao-daft 使用嵌套的 argparse 子命令。名称和标志会随版本变化，因此应通过 --help 了解当前可用内容，不要依赖本文中的任何列表。

1. 格式是位置子命令，不是 --format： tao-daft validate <format> [flags]。通过 tao-daft validate --help 查看当前格式；标识类似 metropolis-v3.0、cosmos-reason-v1.0。
2. 目标通过 --path PATH 指定，不是位置参数。它接受单个数据集／场景或父目录——验证器会遍历目录树。
3. 标志因格式而异；选择标志前，先查看对应格式的帮助，例如 tao-daft validate metropolis-v3.0 --help。 不要假设某个格式支持的标志也适用于其他格式。

因此，流程为：tao-daft --version → tao-daft validate --help → 选择格式（若未指定则推断，见下文）→ tao-daft validate <format> --help → 运行 → 解读结果。

格式推断

根据目录标记判断，而不是文件名：

• meta.json 与 media/、text/ 位于同一目录 ⇒ cosmos-reason-v1.0。
• 包含 contextual/ 的目录（或嵌套目录），通常还包含 raw/ 和 task/ ⇒ metropolis-v3.0。
• 未发现上述标记 ⇒ 询问用户；不要猜测。

阅读错误信息

CLI 每次运行结束时都会输出 VALIDATION RESULTS 块，接着显示 ✅ VALIDATION PASSED 或 ❌ VALIDATION FAILED；验证失败时会以非零状态码退出（可安全地在脚本中串联执行）。

大型目录树的输出可能很多——将完整输出保存到文件，再分段查看，不要直接在终端中滚动浏览。

限制

• 仅验证 DAFT。非 DAFT 布局（COCO、YOLO、Data Factory JSONL 等）应使用上游转换器技能。
• 支持的格式以已安装版本的 tao-daft validate --help 输出为准；较旧的格式标识可能已弃用。
• 仅涵盖 validate。tao-daft info 和 tao-daft convert 请使用对应的专用技能。
• 不要用 Python 重新实现验证；CLI 即为规范。

故障排除

• tao-daft: command not found——当前环境未安装 wheel。运行 pip install nvidia-tao-daft；再通过 tao-daft --version 验证。
• error: argument --path is required——以位置参数传入了路径。将路径移到 --path 后面。
• invalid choice: '<format>'——此版本未配置该格式标识。重新运行 tao-daft validate --help，并从列表中选择。
• 自动检测（raw 类型／contextual 集合）有误——使用该格式的范围限制标志覆盖；通过对应的 --help 查找标志名称。
• CI 要求警告也导致失败——添加 --strict。