SuperAPI AI 工具集

tasteforge-video

设计与创作

查看项目

更新于 10-15 11:19

技能介绍

TasteForge Video 是 ECC 项目中的一项创意管线技能,目标是把“让作品有这种参考的感觉”变成可重复、可检查的工作流。它围绕品味访谈、风格蒸馏、风格包校验、节奏应用和可编辑时间线导出展开,并强调本地确定性操作与服务商生成之间的严格边界。

用途

该技能适用于以下场景:在拍摄前对视频品味进行访谈;把审美方向蒸馏为结构化约束,形成可复用的风格包;校验风格包是否元数据完整、符合 schema、节奏已测量、规格已蒸馏;将风格包应用到本地素材,按测得的节奏确定性地规划剪辑;导出 EDL/FCPXML,实现帧精确的可编辑交接,供 DaVinci Resolve、Premiere 或 Final Cut 使用;对生成媒体进行溯源审计,说明风格包、规格或剪辑的来源,哪些是本地测量、哪些由服务商生成、哪些是干跑;以及基于本地参考文件发现或规划图像、视频、3D 资产输出,包括独立清单、主体锚定的 CV 效果或 Resolve 效果配方。

主要能力

本地确定性操作包括:品味访谈生成画像、风格包检查与 schema 校验、将画像与测量依据蒸馏为规格、将风格包节奏应用到本地媒体并生成报告与时间线、导出 CMX3600 EDL 与 FCPXML 1.9、生成溯源与谱系报告。这些操作均为离线执行,ECC 可以运行。

服务商生成类操作不属于本通道,包括:对静帧进行视觉模型蒸馏、参考图生视频、图像生 3D、托管合成等。这些必须失败关闭,任何实时 Fal 或其他服务商调用都需要在单独通道中显式授权并单独审查。在本兼容通道中,ECC 从不调用 Fal,从不读取任何 API 密钥或凭据(包括 FAL_KEY),不上传媒体,也不修改服务商账户状态。

使用方式

规范实现位于 affaan-m/ECC 仓库,Python 发行包为 ecc-tasteforge,包目录为 skills/taste-application/scripts/tasteforge/。可从解压后的 ECC 包安装:python3 -m pip install ./skills/taste-application/scripts。示例项目 Ito-Markets/ito-video 固定了特定的 ECC 提交。

CLI 为 python3 -m tasteforge <command>,支持 provenance、inspect、validate、interview、distill、apply、export、multimodal 等命令。--live 标志会以退出码 2 退出并拒绝执行。

典型工作流:先进行访谈(interview),收集外观轴(调色板、颗粒、光照、焦距、镜头运动、主体取景、调色、情绪形容词、避免清单)以及单独的内容简报,保持外观与内容分离;然后蒸馏(distill),将画像离线映射到规格 schema,并在提供风格包时嵌入其测量依据,结果为干跑规格,provider 为 none;接着校验(validate/inspect),检查风格包是否符合 schema,报告错误与警告;再应用(apply),根据风格包测得的节奏在本地片段上规划镜头时长,生成应用报告与帧精确时间线事件;之后导出(export),写出 CMX3600 EDL 与 FCPXML 1.9,使用有理数、NTSC 安全的时间;最后审计(provenance),报告谱系,包括恢复源摘要、生成历史、fixture 溯源、仅作指针记录的服务商引用。

文件驱动多模态契约使用命令:python3 -m tasteforge multimodal --config workflow.json --out-dir out/multimodal。配置中命名编号的流派与本地证据文件,保持候选流派彼此独立,例如 Flash Ethereal、3D Cyber Glitch、Fluid Sketch。该命令用 ffprobe/ffmpeg 测量本地参考,为每个流派输出一个风格规格、独立的图像/视频/3D 资产清单、溯源以及 Resolve 效果配方。效果调度必须为种子化非周期;CV 效果需要真实主体锚点,其丢失跟踪策略必须为 disable_effect_until_track_recovers,其他策略失败关闭。每个效果都带有放置约束,以保留人脸和可读文字,并防止装饰性角落网格替代全帧 3D 工作。

返回的回执是捆绑边界,按相对路径、字节大小、SHA-256、流派、模态、provider_execution:false 以及精确的参考/时间溯源绑定每个产出的证据工件。回执要求 provider_calls:0 为精确整数(JSON 布尔 false 无效)、provider_execution:false、dry_run:true。每个流派规格也要求显式 dry_run:true。Resolve 效果配方要求相同的精确整数 provider_calls:0、provider_execution:false、dry_run:true。每个模态清单及每个嵌套请求必须包含全部四个精确失败关闭字段:整数 provider_calls:0、provider_execution:false、dry_run:true、submit:false;每个请求还要求 provider_call_mode:"disabled"。缺失字段即拒绝,而非默认值;dry_run:false 必须在写出输出前被拒绝。

适用场景

适用于需要在本地对参考素材进行测量、规划剪辑节奏、生成可编辑时间线并交接给 NLE 的创意项目;适用于需要将审美方向结构化为可复用风格包的团队;适用于需要对生成媒体进行溯源审计的场景;适用于基于本地参考文件规划图像、视频、3D 资产输出的多模态工作流。

限制

该技能不执行服务商生成,不调用 Fal,不读取凭据,不上传媒体,不修改服务商账户状态。任何需要服务商生成的请求,必须明确说明边界,只运行本地部分(访谈、风格包校验、规划、导出)并停止。不得声称 Fal 工作流已保存;本地对 Fal 端点、模型 ID 或干跑 URL 的引用仅为参考,不代表服务商侧工作流已保存、持久化或获授权运行。离线产出均带有干跑语义,应称为“干跑规格”或“确定性计划”,而非“由模型生成”。应用报告是剪辑计划,不执行视觉镜头排序、素材调色、应用 LUT、渲染叠加或导入 Resolve 项目。导出 CLI 期望 {"clips": [...]},需将应用的时间线事件包装在 clips 下再导出,并传入与应用相同的 --fps。捆绑验证必须在创建后运行,缺失图像、视频或 3D 资产清单必须失败关闭。输出根、中间产物或工件若为符号链接或特殊文件(包括 FIFO 和设备)必须拒绝。若本地 ffmpeg 或 ffprobe 不可用,CLI 必须返回有界的非零本地媒体处理错误,不输出 Python 回溯。不得通过删除证据或弱化验证来修复失败的回执。