概述 本工具是一个面向短视频（Reels，9：16）创作者的智能视频编辑代理。创作者只需提供原始视频（有时附简报），代理将自主完成全部编辑决策——选择保留哪些片段、展示什么内容、插入什么素材、使用哪种预设——并交付一版供创作者在应用中审查。编辑风格参考创作者已有的示例库（biblioteca/exemplos/）。所有工具脚本负责准备、验证、时间计算和渲染。
主要流程
-
新视频：从原始视频到v1（不停顿）
- 目标：2分钟原始视频在10分钟内产出v1，并记录各阶段耗时。
- 准备阶段（etapas/01-preparar.md）：创建项目、转写、代理、人脸、音频清理。
- 剪辑阶段（etapas/02-cortes.md）：代理选择保留的词语，包括主体和（如创作者录制了替代结尾）每个结尾的出口（主体+结尾：ManyChat、落地页、描述中的提示等）。
- 导演阶段（etapas/03-direcao.md）：编写导演脚本。
- 并行执行：动态效果（先使用现有预设或库中视频；若需要新动态，则通过子代理在v1路径外处理，v1先使用最接近的预设，若新动态在渲染前完成则替换，否则放入v2）、插入素材（通过inserts.py生成简报，每个文件一个子代理，分组进行）、音频、字幕、转场。
- 丰富与预渲染：当子代理返回后，合并插入素材，预渲染层背景化处理。
- 渲染与自审（etapas/10-render.md）：交付渲染等待预渲染完成，从缓存中获取大部分层，进行一次审查，然后交付。
- 简报：如有，在剪辑之前阅读，适用于剪辑、导演和插入素材。提到的支持材料放入projetos/<slug>/apoio/，作为插入素材的首要来源。
-
修订（“我在应用里评论了”等）
- 读取etapas/11-revisao.md。评论存储在应用中（revisao.py pendentes / ler）：应用所有版本的待处理评论（创作者评论正在看的版本；已完成的块不移动），渲染下一版本，并在审查JSON中用简短一句话回复每个评论（回复说明改了什么，是最终学习记录的来源）。
-
批准（“批准 · vN”）
- 读取etapas/12-final.md，当创作者要求时导出4K终版；已批准的CTA立即预先导出，无需询问（输出将插入此终版）。已批准的版本进入校准。然后完成视频（etapas/14-concluir.md）：按领域汇总审查中的学习，展示给创作者并只记录其确认的内容；清理素材库（删除已下载但未使用的素材，改进其余描述），当创作者表示完成时结束项目（仅保留最后版本）。
-
素材库
- 创作者在应用（素材库标签）查看并聊天中组织。位置：banco/（插入素材媒体；banco.py）、presets/（丰富配方+order.json按情境的收藏）、transicoes/（+order.json按对的收藏；transicoes.py listar）、motions/presets/*.html、trilhas/catalogo.json、sons/catalogo.json、luts/。更改预设或转场会影响所有使用它们的视频的后续渲染。未经创作者批准，不批准任何内容。从参考片段创建新预设：etapas/13-presets-novos.md。
使用方式
- 所有脚本通过uv run ferramentas/<script>.py …从仓库根目录运行。
- 项目状态保存在projetos/<slug>/edicao.json（约定在edicao.md中）。
- 每个步骤前只读取该步骤的.md文件（不要一次加载所有）。
- 代码解析：当创作者引用代码（PRE-07、BAN-012.2、REF-03·p7、PRJ-02·v3…）时，使用uv run ferramentas/codigo.py <代码> 解析后再行动。
- 并行处理不依赖的任务（插入素材和动态效果的子代理后台；独立命令同轮执行）。
约束与规则
- 学习过去：每一步前及应用审查评论前，阅读该领域的学习记录（通用：biblioteca/aprendizados/<área>.md；视频类别：biblioteca/exemplos/<categoria>/aprendizados/<área>.md，若存在）。类别通过calibragem.py exemplos <slug>获取。子代理同样适用。
- 不要重复过去的纠正。
- 保存每个计划的理由（edicao.json中的porque），创作者会询问。
- 改变含义的疑问在交付时聊天中提出（每个疑问的时间和对话），不在应用中留笔记（创作者不读）。
- 不重写台词。剪辑选择已有词语；字幕仅纠正拼写。
- 原始文件永远不会被修改。.env中的密钥永远不会出现。
- 交付时用几行说明：应用链接、最终时长、总耗时、疑问（每个的时间）以及未能完成的内容（例如：没有真实媒体的插入素材）。
限制
- 资料未提供具体的系统要求、安装步骤、定价或平台限制。
- 工具依赖特定仓库结构和脚本（uv run ferramentas/…），未提供完整安装说明。
- 某些功能（如动态效果、插入素材）依赖子代理和外部媒体库，实际可用性取决于素材库内容。
- 新动态效果可能无法进入v1，需等待v2。
- 所有编辑决策由代理自主做出，创作者需在应用内审查和评论。
- 资料未提供支持的语言或视频格式范围。