vmake-video-repair

视频画质修复

功能与准备

使用 video-repair 提高清晰度和细节，并减少模糊和视觉噪点。输入和画质目标明确后再继续。音轨处理应转交给适当的音频功能。

使用当前 CLI 支持的参数；有关详情，请查阅帮助或契约。需要 vmake-labs-cli，目标版本为 0.1.11，兼容范围为 >=0.1.11 <0.2.0。

首次调用前，请阅读 CLI 设置，解析可执行文件，并检查其版本和 tool video-repair --help。如果 JSON 字段或媒体限制不明确，请查询相关的 vmake contracts 条目。有关输出解析、服务问题或执行中断，请阅读 运行时与恢复。

收集输入

1. 从请求或附件中获取一个实际的视频文件或 URL。信息明确时无需再次询问。如果有多个候选项且无法确定，请让用户选择；只有在获得授权时才逐一处理多个输入，并为每个输入保留记录。
2. 本地输入请使用真实且可读取的路径。按照 CLI 设置下载远程原始文件，然后提交本地文件。如果只有媒体 ID，请先查询其会话以获取真实 URL。如果下载失败，请向用户索取原始本地文件。
3. 使用 -r '<session_id>' 继续某项任务；新任务则省略此参数。按照 CLI 设置处理默认值、身份验证和缺失信息。可选参数请查阅当前帮助；未指定的值应省略。
4. 保留原始来源、本地路径和会话，以便恢复。用户提供已下载的文件时，继续既定目标。不要将失败的输出当作来源。

上传并提交

使用已解析的可执行文件，并将准备好的本地文件作为单独参数传入：

vmake tool video-repair --video-file '<local-video-path>'

CLI 会验证文件，通过内置上传流程将其上传以获取 CDN URL，然后提交并监控任务。不要先调用 create-room 或 add-media，也不要构造占位媒体引用。参数文件和单独的预检均为可选；参数处理和清理请遵循 CLI 设置。

跟进并交付

• 保留原始输入、真实的 session_id / room_url 以及每个 Task ID。分别读取原始命令的 stdout 和 stderr，不要同时启动另一个监控进程。
• 只有在状态为 TASK_STATE_COMPLETED 且获得此任务实际可用的输出 URL 后，才能交付。HTTP 200、流关闭、退出代码 0 或单独的 end.reason=result 均不能证明任务已完成。未知状态绝不能视为成功。
• 有原生预览或附件时请使用；否则提供包含查询参数的完整可点击 URL。交付每个可用的 Part 和任何成功的部分结果。请提供实际返回的会话 URL；不要根据 ID 构造 URL。
• 如果连接断开、超时或是否受理尚不确定，请先查询原始会话和任务。只有确认失败并获得授权后，才能在修正问题后重试处理。如果输出下载失败，应恢复下载，不要重复已成功的处理。详情请参阅运行时与恢复。