用途:检查一台机器能否真正产视频,排查已停止工作的管线,并决定该补充哪些第三方工具或 API 密钥。核心理念是针对眼前这台机器作答,把已安装的工具说成缺失会浪费时间。
主要能力:随技能附带的 scripts/doctor.py 仅用标准库,安装后即可运行,按类别报告可达性(公共领域档案、素材库、生成视频、生成图像、生成音频、语音)及所需二进制。用法:python3 scripts/doctor.py 查看当前可达项,python3 scripts/doctor.py --json 输出机器可读结果。密钥读取顺序为当前项目的 .env、~/.config/video-studio/.env、shell。doctor 只检查密钥是否存在,不验证是否可用,配额耗尽或模型下线仍需调用时才报错。
修复方式:setup.py 不随本技能分发,需先安装引擎,命令为 pip install 'video-studio-engine @ https://github.com/scrollmark/social-skills/archive/refs/heads/master.tar.gz',安装后以 video-studio setup 运行;未安装则没有安装计划与 auto/system/manual 分类。命令示例:video-studio setup(只报告与计划,不做改动)、video-studio setup --yes(执行可运行的修复)、video-studio setup --yes --only composer,voice。缺失组件分三类:auto 限定在工具链目录内、幂等可重跑;system 会改动该目录外的机器,例如安装 ffmpeg 或 node;manual 必须人工操作,如获取 API 密钥、开通计费、接受条款。任何操作都需先询问,只有 --yes 才运行。
教学与底线:video-studio tutor --list 列出内置教程,--step <name> <n> 一次只提供一步。Tier-0 基础三项缺一不可:ffmpeg + ffprobe、node 18+、uv;之后最高价值的补充是免费的 Pexels 密钥。
限制:showwatcher 为内部工具,未公开发布,任何“从其仓库安装”的说法已过时;第 8 步改用 video-production 技能自带的 qc_render 脚本,仅用标准库检查时长、计划一致性、黑尾、冻结结尾、分辨率与帧率,但无法判断画面模糊、字幕重叠、偏色调色与文字裁切,需人工抽帧查看。所有外部服务的费用与输出使用权见 SERVICES.md,音乐一行的再分发权利尤其需注意。切勿未确认就安装,也不要假设沙箱有网络。