Videoskill — 端到端视频编辑(白标)
白标技能:代码中不包含任何固定的名称、Logo 或颜色。所有信息均来自
marca/(marca.json 品牌标识与颜色、canal.json 频道与社交平台、proyecto.json
团队与文件夹)。工作语言:西班牙语。
激活契约
当用户要求编辑视频或原始素材、制作 Shorts / Reels / TikTok、剪辑 YouTube 剧集、创建带配音的动画广告、缩略图或 LinkedIn 轮播图时使用。当用户带来了用于录制的脚本(videos/_shared/plantillas/guiones.md)或希望执行项目的完整流程(proyecto01、promo01、anuncio01)时也同样适用。
硬性规则
- 未经询问,不得发布任何内容、消耗任何额度或向任何服务上传文件
(例外情况始终允许:将交付物复制到其 Drive
final/<id>/)。消耗额度时, 需告知消耗了多少以及剩余多少。 - 公开链接:始终使用
https://tumarca.com(绝不使用长域名)。社交平台信息在marca/canal.json中。 - 始终使用真实摄像机镜头;数字分身(例如 HeyGen)仅作为备选方案。
- 在进行任何操作之前,请阅读
references/reglas-tecnicas.md。 当某个环节失败并 修复后,需记录在此:系统会随着每个视频不断学习。 - 在设计场景、背景、卡片、缩略图或其他内容之前,请查阅
references/diseno.md(经过验证并映射到管线的灵感来源)。 - 每次渲染前执行
npx tsc --noEmit;始终进行逐帧 QA (node remotion/scripts/qa.mjs …)并在全面渲染之前查看这些帧。 - 始终在本地磁盘上进行处理;在
<DRIVE>上仅进行复制,绝不进行加工处理 (pipeline/brutos.py traer|entregar <id>)。
结构
marca/ 品牌标识(唯一包含名称、颜色、Logo、社交平台的地方)
pipeline/ Python 脚本(按流程顺序编号) + comun.py
remotion/ 合成:Intro|Disclaimer|Catalogo (Parte), Grueso/GruesoGraficos,
Short, Linkedin, Lamina, Miniatura · 场景在 src/escenas · scripts/qa.mjs
videos/ Remotion 的 publicDir:仅包含 Remotion 读取的文件(片段、JSON、B-roll、音乐、Logo)
_shared/ music/, logos/, fx/, marca/, obj/, descripciones/, plantillas/
<id>/ plan.md, guia_grabacion.md, partes.json, <parte>.json, shorts.json, …
references/ 辅助手册(查看决策门)
raw/<id>/ 从 Drive 复制的原始素材 + 重型中间文件(不在 Git 中)
out/ 渲染结果, qa/, miniatura/, entregas/<id>/(不在 Git 中)
流程(摘要)
| 步骤 | 内容 | 关键命令 |
|---|---|---|
| 0 | 脚本和录制指南 | 模板在 videos/_shared/plantillas/ |
| 1 | 拉取原始素材并检查(ffprobe、方向、旋转) | python pipeline/brutos.py traer <id> … |
| 2 | 摄像机部分:语音同步 → 转录 → 镜头 → 静音剪切 | 05_sync → 02 → 03 → 01 (+ 仅 alinear.py) |
| 3 | 概念和锚定到语音的场景 | lectura.py → historial.py → <parte>.json → qa.mjs |
| 4 | 屏幕块(主体):准备、像素化、缩放、混合渲染 | 04_grueso → 06_zooms → render_grueso |
| 5 | B-roll、缩略图(Higgsfield + Remotion)和分部分渲染 | out/lote_<id>.cmd |
| 6 | 最终剪辑至 -14 LUFS,含章节和描述 | 07_final.py |
| 7 | 竖版 + LinkedIn(Shorts/Reels/TikTok/4:5、PDF 轮播图) | 09_shorts.py → 10_linkedin.py |
| 8 | 收尾:记录历史和信息报告 | historial.py registrar <id> → LEEME_<id>.md |
变体:短广告(promo01,带 cola 的高密度竖版)和带配音的动画广告(anuncio01,无摄像机镜头,3D 面板)。逐命令详情:references/flujo.md。
决策门
| 你需要… | 阅读 |
|---|---|
| 执行完整流程或某个具体步骤及其命令 | references/flujo.md |
从目录(type)、图层、背景、样式和音效中选择场景 | references/escenas.md |
| 设计:开场/钩子、CTA、结尾、玻璃卡片、3D 图标、动画背景 | references/diseno.md |
| 缩略图、Higgsfield、ElevenLabs 语音、Logo、本地模型、环境 | references/herramientas.md |
| 调试已知故障或避免已踩过的坑 | references/reglas-tecnicas.md |
输出契约
每个项目最终交付:
- 横版 YouTube(1920×1080,-14 LUFS):剪辑好的各部分、有效的章节、 包含来源和缩略图的描述。
- 竖版 → 3 种不同文本的版本:YouTube Shorts(带音乐)、 Instagram Reels 和 TikTok(无音乐;用户发布时自行添加)。
- LinkedIn:4:5 视频、PDF 轮播图、单张图片和帖子文本。
- 所有内容位于
<DRIVE>/final/<id>/(shorts/、linkedin/)和信息报告out/entregas/<id>/LEEME_<id>.md: 包含哪些内容、需要检查什么、消耗的额度以及可供粘贴的文本。发布为手动操作。