用途
ajustar 用于对已经剪辑完成的短视频(reel)应用创作者提出的修改意见,并生成一个新的版本。它面向的是“改一改”的场景,而不是从零开始剪辑。
主要能力
- 定位项目与版本:创作者可以指定 slug,或默认使用最近编辑的项目(ls -t proyectos/ | head),版本取最高的 edicion-vN.json。
- 复制版本:通过 npx tsx herramientas/ajustar.ts <slug> --desde N 生成 edicion-v(N+1).json,原版本 vN 保持只读。
- 按需修改:使用文件工具编辑新版本,只改动创作者要求的内容。示例包括:
- “把 k2 往下移 100 px” → stickers[id=k2].caja.y += 100(基准坐标 1080×1920;caja.x/caja.y 为中心点)。
- “删掉 k5 上的音效” → stickers[id=k5].sfx = null。
- “把卡片 'Free' 改成 'No cost'” → tarjetas[id=…].texto。
- “标题应该写……” → titular.texto(2 行,用 \n 分隔,每行不超过 24 个字符)。
- 新增贴纸:用 /stickers 制作(logo 或创作者自己的 PNG),并添加其时间点;其音效来自 npx tsx herramientas/sfx/elegir.ts --edicion <v(N+1)> --salida <v(N+2)>。
- 校验改动:运行 npx tsx herramientas/ajustar.ts <slug> --desde N,若 v(N+1) 已存在则进行验证并打印改动,确保内容与要求完全一致。
- 渲染与 QA:执行 npx tsx herramientas/render.ts <slug> --version N+1 和 npx tsx herramientas/qa.ts <slug> --version N+1(两者各自单独在 Bash 调用中执行),并展示带数字的改动说明。
- 通用偏好处理:对于“贴纸不要放在 X 上方”“卡片大一点”“节奏快一点”等偏好,除了本次改动外,还会保存到当前风格中(notas-director.json → estilo,或 creador.json → estilo_activo):
- 在 estilo/estilos/<id>/perfil.md 的历史中记录创作者的原话(带日期),并在上方更新规则。
- 若为引擎读取的值(速度、空中剪切、安全区、图层是否可覆盖面部、节奏)→ perfil.json → motor(结构见 herramientas/lib/perfil-estilo.ts),并附上引用创作者原话的决策。
- 若为应自动检查但档案无法表达的规则 → 在 herramientas/validar.ts 中提出新规则及其测试,等待创作者同意后再改代码。
- 提交:每次改动可单独提交一次 commit,提交信息使用创作者的语言。
使用方式
- 确定项目与版本。
- 复制版本生成新版本。
- 仅修改要求的内容。
- 校验 diff。
- 渲染并运行 QA。
- 展示改动。
- 如涉及通用偏好,更新风格档案或提出新规则。
- 按需提交 commit。
适用场景
适用于对已剪辑完成的短视频进行局部调整,例如移动贴纸、删除音效、修改卡片文案、缩短标题、新增贴纸等。也适用于将创作者的通用偏好沉淀为可复用的风格规则。
限制
- 不会覆盖已交付的版本或最终版本。
- 修改仅限创作者明确要求的内容。
- 涉及自动校验规则的新增需等待创作者确认后才修改代码。
- 回复语言跟随创作者语言(creador.json → idioma: es/en)。
- 具体收费、价格、平台支持等信息暂未提供。