
名称	tao-convert-dataset-format
描述	运行`tao-daft convert`，在支持的格式之间转换NVIDIA TAO DAFT数据集。不要用于非DAFT数据。当用户要求转换DAFT数据集、更改DAFT格式、更改TAO数据集格式或运行`tao-daft convert`时使用。
开源协议	Apache-2.0 compatibility: 需要Python 3.10+和nvidia-tao-sdk包（pip install nvidia-tao-daft）。 metadata:
作者	NVIDIA Corporation
版本	“0.1.0” allowed-tools: Read Bash tags: - tao-daft - 数据集 - 转换 - vlm - cosmos-reason

转换TAO DAFT数据集

独立安装？ 如果此会话未由TAO技能库插件初始化，请先运行tao-setup技能（主机预检、凭据、跨技能发现）。

快速入门

tao-daft convert <source-format> <target-format> --path <input> --output <output>

源格式和目标格式是位置子命令；--path和--output是标志。从叶子--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
}

快速入门

在选择格式slug之前，先发现已安装的CLI表面，然后运行带有显式--path和--output标志的叶子转换命令：

tao-daft --version
tao-daft convert --help
tao-daft convert <source-format> --help
tao-daft convert <source-format> <target-format> --path /path/to/daft --output /path/to/converted

目的

驱动tao-daft convert，将DAFT数据集（或它们的树）在支持的格式之间转换。CLI执行实际工作；技能选择正确的源/目标对和标志，然后解释结果。

在以下情况下触发：转换DAFT数据集、为VLM训练打包DAFT QA/摘要/时间任务、生成meta.json风格的训练集，或命令tao-daft convert。不要触发非DAFT→DAFT转换（COCO、YOLO、Data Factory JSONL）——请重定向到上游nvidia-tao-daft仓库的转换技能。

如果用户表述模糊，先运行一些--help调用。

先决条件

已安装nvidia-tao-daft（仅wheel，不是源代码仓库）。用tao-daft --version确认。
本地磁盘上有DAFT数据集，或包含许多DAFT数据集的父目录。

说明

CLI约定

tao-daft是嵌套的argparse子命令。下面的约定在各版本中是稳定的，即使格式名称或标志会变化，所以始终从--help发现当前表面，而不是依赖本文档恰好提到的名称。

源和目标都是位置子命令，不是--from/--to: tao-daft convert <source> <target> [flags]。格式slug是小写、点分隔、带版本号如（metropolis-v3.0, cosmos-reason-v1.0, …）。
路径和输出是标志——--path PATH（源），--output OUTPUT（目标）。两者在叶子处都需要；作为位置参数传递会失败。
--path接受两种粒度——单个场景/数据集或父目录；转换器会遍历树。
每对标志位于叶子处——不同目标的标志集是不同的（例如媒体处理）。始终检查叶子--help。

操作程序：

tao-daft --version — 确认安装，在任何报告中固定版本。
tao-daft convert --help — 列出支持的源格式。
tao-daft convert <source> --help — 列出该源的有效目标。
从布局推断源（与tao-validate-dataset-format技能的“格式推断”相同的目录标记）。如果无法推断或目标未指定，则询问。
tao-daft convert <source> <target> --help — 为用户意图选择标志（任务子集、媒体复制与引用、元数据）。
执行，然后解释（见下文）。

读取输出

每个场景的进度打印到stdout；失败时非零退出。转换后的数据集写在--output下——在训练前使用tao-validate-dataset-format技能抽查它。对于大型树，捕获完整输出并在大时部分读取。

限制

仅支持DAFT支持的源格式。对于非DAFT布局，请使用上游仓库的转换技能。
支持的对是安装版本--help报告的——不要传递未确认的对。
源和目标是位置参数；--path / --output是标志。
convert仅——validate和info有自己的技能。
不要在Python中重新实现转换；CLI是规范。

故障排除

tao-daft: command not found — 未安装wheel；pip install nvidia-tao-daft，用tao-daft --version验证。
error: argument --path/--output is required — 作为位置参数传递；移动到标志后面。
invalid choice: '<format>' — slug在此版本中未被启用。重新运行相关的--help。
输出被tao-daft validate拒绝 — 重新检查每对标志（媒体处理、任务子集）通过叶子--help；错误的标志通常会产生结构上有效但语义错误的目标。