kaipai-video-repair

视频画质修复

能力与准备

使用 video-repair 智能增强视频画质，改善模糊和画面噪点，提升视觉清晰度与细节表现。素材与画质提升目标明确时直接处理；音轨处理需求按对应音频能力选择入口。

通过当前 CLI 支持的参数调用服务端处理能力，具体参数查询 help 或 contracts。依赖 meitu-kaipai-cli，已验证目标版本 0.1.11，兼容 >=0.1.11 <0.2.0。

首次执行先按平台接入运行CLI 准备脚本：缺失时默认全局安装，兼容时复用。目标、必要素材和授权齐全后沿用返回入口直接调用 CLI，不主动校验输入或运行独立预检；调用格式不明确时再按平台说明查询 help／contracts。遇到 CLI 输入错误、输出解析、服务端问询或执行异常时读取运行与恢复。

收集输入

1. 从当前请求和附件取得一个真实视频文件或 URL；信息明确时不重复询问。多个候选且目标不明时询问，不自动代选；用户已明确授权逐个处理时分别调用并记录任务。
2. 本地素材使用用户提供或上下文取得的真实路径；远程素材先按平台接入下载原资源，再作为本地文件上传。只有媒体 ID 时先查询所属会话的 Task 或历史取得真实 URL，再下载；失败时请用户自行下载并提供本地原文件。
3. 继续已有任务时添加 -r '<session_id>'；新任务省略会话。按平台说明应用默认值、准备登录和处理缺失输入；可选参数查询当前 help，未指定时省略。
4. 保留原始来源、真实本地路径与会话作为恢复输入。用户补充下载好的文件后沿用原目标继续，不把失败结果当作源素材。

上传与提交

使用已解析的 CLI 入口，将准备好的本地文件作为独立参数传入：

kaipai tool video-repair --video-file '<本地视频路径>'

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；部分成功先交付成功部分。有实际 room_url 时附开拍会话入口，不根据 ID 拼链接。
• 断线、超时或受理未知时先查询原会话和任务，不自动重复提交。失败原因已修复且用户授权重试后才发起新尝试；输出产物下载失败只恢复下载。具体问询、恢复及本地保存步骤见运行说明。