video-autopilot-kit 统一滤镜库完全指南38 个调色、转场与主体滤镜的调用契约与 QA 规则【免费下载链接】video-autopilot-kitFill-in-your-own-data framework for YouTube / short-form video automation: CapCut JSON ffmpeg tooling an onboarding questionnaire. Ships with zero private data.项目地址: https://gitcode.com/gh_mirrors/vi/video-autopilot-kitvideo-autopilot-kit是一套面向 YouTube / 短视频自动化的开源框架CapCut JSON ffmpeg 工具链 引导问卷开箱零私有数据。它的隐藏王牌是 src/filter_runtime.py 中的统一滤镜库10 组调色、14 组动态、10 组转场、4 组主体滤镜共38 个预设全部受素材证据 色彩流程双重约束避免滤镜乱用把片子做脏。本文带你像剪辑软件一样使用它list、inspect、apply、transition、gallery、doctor六大命令一次讲清。一、为什么需要统一滤镜库普通做法是调色叠一个 LUT、转场套一个特效、主体加个蒙版——顺序混乱、强度失控。video-autopilot-kit 把所有滤镜收敛到同一张注册表并强制执行四条工作契约定义在 knowledge/runtime/filter_library.json 的working_contract一支片只允许一个调色 Look且必须在字幕、Logo、Tracking、VFX 等图形之前套one_grade_look_only、grade_before_graphics✂️干净切clean cut永远是默认证据不足的转场自动降级主体滤镜必须有人工验证的 matte否则拒绝渲染原始素材不可变缺图时 fail-closed回IMAGEGEN_REQUIRED而不是用假渐变凑数二、38 个滤镜预设四大类速查表完整清单可执行python filter_runtime.py list查看也可以直接读 JSON 注册表。四类滤镜的定位如下1. 调色滤镜grade10 组素材级色彩处理路由到 src/visual_master.py 的题材 Look按内容域自动匹配预设适用题材默认强度clean_neutral干净自然去雾教学、通用0.28cinematic_warm_soft电影暖柔纪录、故事0.30vlog_bright_clean明亮 Vlog日常、开箱0.30podcast_skin_neutral肤色中性播客、访谈0.25travel_airy_local旅行明亮通透旅行、城市0.40food_warm_appetite美食暖香美食、咖啡0.30toy_energy_clean玩具竞技清亮玩具、产品0.31toy_arena_punch战斗玩具竞技场游戏、娱乐0.40ai_cobalt_crispAI 钴蓝清晰AI、科技0.28night_neon_controlled夜景霓虹受控夜景、汽车0.252. 动态滤镜temporal14 组单镜头的时间性外观黑白网点mono_halftone、影印脉冲xerox_pulse、扫描聚焦scanline_focus、色差撞击chromatic_impact、模糊弹回blur_snap、暖色回忆、冷静纪实、高调柔光、底片颗粒、水墨单色、CMYK 错位、精致类比印刷、实拍光学棱镜掠光、日系和纸柔质。Shorts 中一般只维持0.2–0.9 秒长片只在章节节点使用不可当全片皮肤。3. 滤镜转场transition10 组撕纸三兄弟直向 / 斜向 / 双边、网点撕纸、墨水晕染、底片灼光、棱镜闪切、镜头失焦、色差甩镜、亮度溶解。转场不是单镜头运算——它由 outgoing/incoming 两颗真实镜头、时间 alpha、核准材质、阴影与可选音效组成每个预设都声明了requires证据清单如two_real_source_shotspaper_or_chapter_semanticsaudio_transient_or_tear_sfx。4. 主体滤镜subject4 组只作用于被追踪的主体全黑转彩subject_black_to_color、主体网点化、轮廓脉冲、保彩背景去色。硬性前置条件editor-verified matte缺 matte 直接raise ValueError。三、调用契约命令怎么跑、门禁怎么过CLI 入口在 src/filter_runtime.py新手最常用的几条python filter_runtime.py list --category transition python filter_runtime.py inspect torn_paper_vertical python filter_runtime.py apply input.mp4 output.mp4 --preset travel_airy_local python filter_runtime.py apply input.mp4 output.mp4 --preset subject_black_to_color --matte subject.mp4 python filter_runtime.py transition a.mp4 b.mp4 out.mp4 --preset torn_paper_vertical \ --motivation 照片翻页进入下一站 --evidence two_real_source_shots \ --evidence paper_or_chapter_semantics --evidence audio_transient_or_tear_sfx三条关键契约新手最容易踩坑强度自动夹取resolve_strength会把--strength限制在default_strength与max_strength之间超过上限自动收敛不会过曝滤镜转场证据门禁resolve_transition检查证据清单缺项时selected变为clean_cut、状态DOWNGRADED人工指定可用--manual-approved越过但仍必须填写--motivation且成品继续走 Quality-95 审片Imagegen 材质契约需要 premium 固定图像的滤镜撕纸、灼光、墨水等 6 个材质家族见 knowledge/runtime/filter_materials.json不可用程序图形假装。材质缺失或未过人工审核时src/filter_materials.py 一律回IMAGEGEN_REQUIRED并 fail-closedhuman_reviewpending的素材只可用--allow-pending-materials生成候选预览永远禁止用于生产渲染想看全部 38 组实际效果python filter_runtime.py gallery a.mp4 gallery --source-b b.mp4会产出 contact sheet、逐预设 MP4 和gallery_report.json。四、QA 规则7 层自检链滤镜库的可信度来自一条固定的 selftest 链详见 references/filter-library.md✅ src/imagegen_asset_gateway.py selftest —— 验证缺图与真实证据分流✅ src/filter_materials.py selftest —— 验证材质登录、审核状态与不可选用闸门✅ src/filter_runtime.py selftest —— 验证 38 组预设、全部 renderer style 与 fail-closed 决策✅ src/composition_runtime.py selftest —— 验证滤镜 adapter 能进入整数帧 render graph✅ src/mediastorm_craft.py selftest —— 验证撕纸缺证据时退 clean cut✅ 真素材gallery产生 contact sheet 与逐预设 MP4pending 材质只能形成候选审查版✅ 所有视觉成品固定执行review deliver交人工审核validate_library还会对注册表做结构校验强度区间必须0 ≤ default ≤ max ≤ 1、转场必须有requiresmotivation、主体滤镜必须声明verified_subject_matte、material_id必须真实存在——任何一条不满足doctor命令即报BLOCK。五、相关文件速查滤镜运行时CLI 入口src/filter_runtime.py滤镜注册表38 组预设knowledge/runtime/filter_library.json材质登录表knowledge/runtime/filter_materials.json材质解析与审核闸门src/filter_materials.py底层算子网点/扫描/色差/撕纸 alphasrc/filter_primitives.py渲染层src/filter_renderers.py调色 Look 体系src/visual_master.py、references/color-science-and-visual-master.md滤镜库完整参考文档references/filter-library.md六、写在最后video-autopilot-kit 的统一滤镜库给新手的最大启示是滤镜不是叠上去而是过闸后调用。一支片一个 Look、转场讲动机、主体要 matte、缺图就 fail-closed——这套契约让 38 个预设从特效按钮变成了可审计的自动化管线也是它能在长片与 Shorts 间安全复用的原因。先跑一遍selftest再用gallery生成预览对照表你就能在几分钟内建立起属于自己的滤镜调用直觉 【免费下载链接】video-autopilot-kitFill-in-your-own-data framework for YouTube / short-form video automation: CapCut JSON ffmpeg tooling an onboarding questionnaire. Ships with zero private data.项目地址: https://gitcode.com/gh_mirrors/vi/video-autopilot-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考