用途:把用旧流程(只有 visual_transcripts、没有 contact sheets)分析过的库升级到当前流程(音频转录 + 联系表 + 摘要)。音频转录与用户已创建的 cuts/plans 会保留,只重建视觉层。
主要步骤:
- 选择库。用户指定则用指定库,否则用 ruby lib/buttercut/library.rb recent 列出候选并让用户选择。用 ruby lib/buttercut/library.rb <name> exists 与 summary 确认存在并读取快照。动手前先按 AGENTS.md → Critical Principles 执行 schema 迁移。
- 与用户确认。此操作具破坏性:联系表、摘要、旧 visual_*.json 转录会被删除;音频转录保留(不重新转录);cuts/、plans/ 与库元数据不受影响。需明确确认后再继续。
- 先备份。运行 backup-library skill 备份目标库,等其完成;备份失败则停止并报错,不得继续重置。
- 重置。运行 ruby lib/buttercut/library.rb <name> reset_all_except_audio_transcripts,清除联系表、摘要、旧视觉转录并清空各片段对应字段。缺失音频转录的片段由后续 analyze-video 的转录步骤补齐。
- 重跑分析。交接到 skills/analyze-video/SKILL.md 端到端执行;快照中已有转录的片段跳过音频转录,所有片段都要跑联系表与摘要;仍建议做 confirm-footage-understanding。完成后用 ruby lib/buttercut/library.rb <name> ready 验证。
限制:属于破坏性重置,必须先备份并确认;不涉及收费、价格或平台信息,官方未提供相关内容。