ÍRIS：AI 生成视频审核工具
ÍRIS 不只是观看视频：它会测量、逐帧分析、区分随机问题与流程缺陷，仅要求重绘有问题的场景，并从每个视频中学习。循环过程：生成、审核、重绘、学习。
1. 检查
运行此技能 scripts/ 文件夹中的检查工具：
python "<此技能所在文件夹>/scripts/inspecionar.py" 视频路径/视频.mp4 [--roteiro 剧本.json] [--referencia-voz 参考语音.wav]
--roteiro：JSON 文件，包含"cenas": [{"narracao": "...", "prompt": "...", "dur_s": 5.4}]。提供后，场景将按剧本划分，并对比旁白内容（需 faster-whisper 或 openai-whisper）。不提供时，场景由视频的硬切检测得到。参见插件根目录的exemplos/roteiro.json。--referencia-voz：被认可的语音录音。用于检查旁白是否仍为同一声音（需 librosa）。- 输出到
.iris/<视频名>/目录：medidas.json和联系页图片folha_N.jpg。 - 如果缺少 ffmpeg 或 Pillow，请告知用户需要安装的内容并停止。
2. 观看
- 完整阅读
medidas.json。 - 使用图像阅读工具打开 所有 联系页图片。每张图片包含每秒 2 帧，每行 6 帧，从左到右排列，时间戳以黄色显示在角落。对比相邻帧：对象消失、重复或变形通常出现在此处。
- 如果存在，读取
.iris/historico.json（已学经验和过往视频记录）和.iris/regras.md（频道规则，例如“禁止人物”或“禁止图像中出现文字”）。
3. 分析
使用 criterios.md 中的检查清单。对于每个问题，记录：精确的秒数、场景号、所见内容、可能原因，以及它是 随机问题（偶发，更换随机种子即可解决）还是 流程缺陷（系统性问题，或在历史视频中已出现）。切勿根据历史记录描述当前视频：历史数据仅用于识别模式。
4. 交付
将以下文件写入 .iris/<视频名>/ 目录：
revisao.json：{"nota": 7.5, "resumo": "一句摘要", "problemas": [{"segundo": 12.5, "cena": 3, "tipo": "visual|narracao|ritmo|audio|legenda|tecnico", "gravidade": "alta|media|baixa", "descricao": "...", "causa": "...", "origem": "sorteio|pipeline"}], "refazer": [{"cena": 3, "motivo": "...", "ajuste_prompt": "如有需要，该场景提示词的修改建议"}], "licoes": [{"tipo_assunto": "esporte|animais|espaco|corpo_humano|historia|tecnologia|natureza|geral", "alvo": "roteiro|geracao|montagem", "regra": "通用规则，非本视频细节"}], "pipeline": [{"onde": "文件或步骤", "mudanca": "...", "motivo": "..."}]}revisao.md：供人类阅读的简短文本版审查报告，顶部显示评分，后附需重绘的场景列表。
refazer 规则：最多 3 个场景，且仅为会破坏视频的随机问题（对象消失、重复或变形；违反频道规则的人物、手部或文字；画面跳跃；图像与旁白无关）。轻微缺陷、审美问题或流程缺陷不纳入。如果文件夹中存在 rodada: 2（用户说明这是重绘版本），则 refazer 为空，审查报告仅说明重绘的场景是否有所改善。
5. 学习
更新 .iris/historico.json（如不存在则创建）：
{"licoes": [{"tipo_assunto": "animais", "alvo": "geracao", "regra": "...", "vezes": 2, "ultima": "2026-10-17"}],
"videos": [{"video": "名称", "data": "2026-10-17", "nota": 7.5, "resumo": "...", "refazer": [3]}]}
- 若新经验与已有经验含义相近（用词不同但意思相同），则
vezes加 1，不重复添加。 - 最多保存 40 条经验（丢弃
vezes最少且最旧的记录）和最近 30 个视频。
6. 修复流程缺陷（仅在用户要求时）
如果用户项目包含生成视频的代码或配置，并且他要求修复：
- 最多 3 处修改，尽量最小化，优先修改配置和提示词文本而非逻辑；
- 绝不修改磁盘路径、密钥或秘密；
- 显示 diff，并在声明完成之前运行项目测试（如有）。
聊天回复
评分、一句摘要、需重绘的场景及原因，以及 revisao.md 的路径。不要在对话中重复完整的审查报告。