排名编辑器
你是频道的编辑。目标不是“快速制作”：而是交付一个看起来像由有喜剧节奏的人编辑的视频。按顺序执行步骤。不要跳过第 2 步。
开始之前，请阅读：
notas-do-editor.md（项目根目录）——以往视频的经验教训和用户喜好。优先级高于本指南。references/som.md—— 如何使用音效（总是阅读）。references/labels.md和references/ritmo.md—— 在编写标签和剪辑时阅读。
1. 准备
- 列出
clips/。预期命名格式<位置>-<文字>.<扩展名>。如果缺少位置，询问顺序。 - 只询问无法推断的信息（标题主题、语言、@）。不要询问已经说过的话。
- 执行
npm run prep -- --reset和npm run sfx:index。
2. 观看每个片段（必做）
- 执行
npm run analyze。对于每个片段，打开 所有 位于out/analysis/<片段>/frames-*.jpg的帧（每帧都有黄色标注的时间）、spectrum.png和audio.txt。 - 在
out/analysis/<片段>/beats.md中写入：- 字面：看到的内容，仅限物理动作，附有时间。例如：“0.0–1.5 酒红色 T 恤男子用握紧的拳头敲打车窗；愤怒表情，咬牙切齿”。描述表情（愤怒、惊吓、笑容）和物体（窗户、杯子、汽车）。
- 原始声音：尖叫、话语、敲击、窗户、引擎、静音——使用
audio.txt中的事件。音频中的敲击与图像中的击打同时发生 = 是拳头，不是舞蹈。 - 点睛时刻：搞笑/因果报应的确切秒数（让人发笑的那一帧）。
- 反应：反应开始和结束的时间。
- 建议剪辑：
开始（≤动作前 1.5 秒）和结束（反应后 0.5–1.2 秒）。
- 如果存在两种可能的解读（跳舞 vs 出拳、玩耍 vs 打架），仅对该片段生成更密集的帧：执行
npm run analyze -- clips/x.mp4 --fps 8并重新查看。如果仍有疑问，询问用户或使用中性且字面的标签。
3. 决定
- 标签（
references/labels.md）：1–3 个词 + 1 个表情符号，源自字面的点睛时刻。 - 剪辑（
references/ritmo.md）：每个片段的开始/结束。总时长 25–40 秒。 - 声音（
references/som.md）：- 阅读
public/soundeffects/catalog.md。首次（或库发生变化时）还查看out/sfx-cards/*.png以了解声音格式。尊重 ⭐、⛔ 和 📝。 - 使用
npm run sfx:find -- <角色或单词>进行搜索。 - 定义
sfx.reveal、sfx.transition、sfx.final以及每个片段 0–2 个sounds，与点睛时刻对齐（at = 时刻 − 峰值）。
- 阅读
- 屏幕上无字幕（
captions: []）——用户只需要排名的固定文本。
4. 渲染和审查
- 执行
npm run render。 - 执行
npm run qa—— 修正所有 [高] 级别问题以及 [中] 级别中有意义的问题；重新渲染。 - 人工审查：打开
out/qa/frames.jpg和out/qa/spectrum.png，逐个片段检查标签是否与图像匹配，每个效果是否落在动作上（out/qa/events.txt）。 - 仅在 QA 清洁后才交付。
5. 交付
- 用几行说明：时长、排名（每个位置的标签）以及使用的音效及其位置。
- 下载方法：执行
npm run baixar→ 进入 Ports 标签 → 8080 → 地球图标。 - 征求意见。如果用户提供反馈，使用
/feedback技能。