用途:把尚未 Zoo-ready 的自定义模型转成目标 NN Archive,并接入 OAK 应用。转换与集成合为一个技能。
主要能力:根据来源选择分支——来源为 ONNX、TFLite、OpenVINO IR 或其他非 archive 产物时走转换,再按需集成;来源已是目标兼容的 NN Archive 时直接集成。训练、数据集采集或为新应用挑选 Zoo 模型不属于本技能范围。
使用方式:先读取 docs/brief.md、docs/device.md、源码及已有 archive 或转换说明,也读取遗留的根目录 PROJECT_BRIEF.md 与 DEVICE.md(均非必需)。若缺少 AGENTS.md,或本任务需要主机工具链而缺少 oakctl,先按 luxonis-workspace 处理再继续。转换或接线前需明确契约:目标设备与 RVC 家族(RVC2 与 RVC4 产物不可互换)、来源产物与校验和、发布者与许可、输入名称/形状/布局/dtype/颜色/预处理、输出名称/形状/头或解析器/标签或关键点顺序,以及一小份代表性输入。NN Archive 元数据是输入、预处理、头/解析器与标签的事实来源,可用 scripts/validate_nn_archive.py 校验契约;元数据通过不等于推理有效。转换或集成后,在支持的运行时下对比来源与转换后行为;实时管线结论用 luxonis-inspect。
限制与护栏:不得凭记忆编造 DepthAI API,仅用 DepthAI v3,不混用 v2。oakctl 命令与标志以本地安装的 oakctl --help 为准,其优先于文档与 MCP;若本地版本缺少当前文档所述功能,可建议更新。离线时依据 oakctl --help 与本地示例,并标明未验证事实。云端上传、全局 pip 安装或发布 archive 前需先询问;不得从源码编译 DepthAI;不得对同一设备运行竞争进程。若设备或回放(luxonis-record)可用则验证实时行为,否则说明待定的运行时检查;受阻时给出一个明确的下一步动作。