jetson-video-recipe

Jetson 视频配方

创建一份确定性的 nvcodec-recipe schema 2.0 文档。配方工作在目标设备之外进行，且不涉及媒体：不会探测、安装、编码、解码，也不会声称支持情况、质量或性能。

边界

• 如果请求仅涉及 PSNR、SSIM 或其他客观质量指标，请说明需要单独授权的质量工作流，然后停止。
• 如果提供的 CQ 与平均或最大比特率冲突，先解决冲突。返回 input_required，仅询问要保留哪一个，然后停止；不要重新解释比特率是上限，也不要输出配方。
• 未限定的“低延迟”无法确定用例。询问指的是会议、直播还是其他约定，返回 input_required，然后停止且不输出配方。
• 保留每项明确指定的控制项。如果某个投影无法表达该控制项，则公布投影损失；绝不能悄悄丢弃或弱化它。

工作流

1. 收集用例、编解码器、正整数宽度/高度/fps、输入格式、GPU，以及任何明确指定的 profile、preset、tuning、rate-control、bitrate、GOP、B-frame、lookahead、AQ、multipass 或 buffering 控制项。在原始编码或测量之前必须提供 frame_count，但对于压缩输入，可以在经过认证的解码器/转码器报告帧数之前将其保留为未知。如果缺少 use_case、width 或 height，返回 input_required，准确列出缺少的项目，然后停止；其他未提供的项目均应用文档规定的默认值。未提供的 profile 保留为由 SDK 选择。
2. 应用 recipes-knobs-and-constraints.md 中的固定默认值和约束，然后严格按照 recipes-workflow.md 中的说明构建 schema-2 文档。调用方提供的值和默认值必须分别标明来源。
3. 对文档进行结构验证：schema/kind 必须准确；JSON 必须有限；整数必须为正且有界；枚举字符串必须合法；速率控制字段必须互斥；格式/profile 约束必须满足；投影必须从同一个 encoder_intent 派生；每个明确指定的调用方控制项都必须在每个投影中有所体现，或列于该投影的损失项中。接受的配方应重新生成，而不是编辑。如果重新生成的文档仍未通过结构验证，则返回 failed，准确说明缺陷，且不要输出配方。
4. 将规范化排序后的 JSON 写入一个新的路径，不得覆盖任何内容。记录其规范绝对路径、字节数和 SHA-256；每个使用方都必须重新计算该确切文件的哈希。如果没有安全的新路径，或写入/重新计算哈希失败，则返回 failed，准确说明原因，且不要声称已生成配方。
5. 返回意图、假设/默认值、两个投影、所有损失项，以及配方文件的规范绝对路径、字节数和 SHA-256。对于 both，保留两种结果。auto 表示保留两个投影，但不选择其中任何一个；由管道或基准测试根据最新的实时资格证据进行选择。

对于仅规划的配方，这些 Markdown 规则是完整依据。不要探测目标设备、检查已安装的 SDK/示例源代码、扫描文件系统查找示例 JSON，也不要仅为确认投影而调用其他技能。仅规划仍须执行步骤 2–5，包括写入并重新计算全新的规范配方 JSON 的哈希，并报告其绝对路径、字节数和 SHA-256；它禁止的是目标设备和媒体操作，而非本地创建配方文件。

实时工作与下游工作

对于请求的实时分类，应从 jetson-video-setup 获取针对所选产品和 GPU 的最新只读就绪结果，并从 jetson-video-capability 获取适用的原始结果或文档结果。缺失事实仍标记为 unknown；明确的否定结果或无法表示的投影标记为 unsupported。API 报告的能力并不能证明操作可行。

将原始配方标识作为数据传递给 jetson-video-pipeline 以执行，或传递给 jetson-video-benchmark 以测量。这些技能必须重新计算其哈希，并保持未参与比较的控制项不变。不要导入或重新创建兄弟技能的实现。

必需结果

• H.264 1920x1080@60、6 Mbps CBR 实时流默认采用 P4、low_latency、GOP 60、一个 B 帧、零前瞻、全分辨率多遍、最大码率 6,000,000 和 VBV 3,000,000。
• 显式指定的 H.264 High 配置文件在原生投影中必须精确匹配，在公开的 PyNvVideoCodec 2.1 示例投影中则为 unrepresentable。
• 在 CQ 与平均码率同时请求的情况下，只有问题得到解决后才能生成配方。

限制

此技能仅生成基础编码器配置。内容选择、容器或转码工作、独立解码、基准测试和证据采集均由各自负责的技能处理。