视频人脸高清修复

视频人脸高清修复（Video Face HD Restoration）——来源：鲸歌科技 / Jinge Technology。

要解决的问题

视频中的人脸常因压缩、缩放、拍摄抖动或原始素材分辨率不足而模糊。通用超分会把所有画面元素一起放大，可能带来伪影、噪点或不自然纹理。这个技能只做一件事：把 Windows 视频里的人脸区域修复得更清晰，并把结果写成新的本地视频文件。它适合“整段视频主要人物脸糊了，需要恢复可辨认性”的场景，不适合当作所有画面元素的万能增强器。

核心能力与关键步骤

技能围绕鲸剪桌面端的 ai.quality.enhanceFace 能力展开。执行前会先检查 CLI 是否开放该命令、登录态是否有效，以及当前账号是否具备 VIP 权限；若命令未开放，需要先 cli enable --id ai.quality.enhanceFace；若登录或 VIP 失效，则给出可执行恢复建议。标准流程是：确认 auth whoami、传入待修复视频的 --input、指定输出目录或输出文件名、等待命令结束，然后只解析 stdout 中的单行 JSON。成功时关注 ok === true 与 data.outputPath 等业务字段；失败时根据退出码区分命令未开放、登录过期、VIP 校验失败、用法错误等。

适用边界

仅支持 Windows 上已安装鲸剪桌面端并可调用 CLI 的环境，macOS 不应编排该技能。修复范围聚焦人脸画质，不代表整帧通用超分；输出质量依赖输入分辨率、人脸可见度和账号权限。失败排查只面向路径、登录、VIP、配额等可行动原因，不向用户暴露内部字段、stderr 或算法细节。