vmake-video-remove-watermark

移除视频水印

功能与准备

使用 video-remove-auto 移除水印。该服务会自动识别要移除的内容并修复帧。在输入和目标明确时，在现有授权范围内继续操作。保留原始文件以便对比；如需保留特定元素或控制区域，请查阅设置参考。

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

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

收集输入

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

上传并提交

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

vmake tool video-remove-auto --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。
• 如果断连、超时或无法确定是否已受理，请先查询原始会话和任务。只有确认失败并获得授权后，才能修复问题并重试处理。如果输出下载失败，请恢复下载，不要重复已成功的处理。详情请参阅运行时与恢复。