用途：Process Library 是 Buttercut 中 Analyze Video 工作流步骤的主线程操作手册，处理已存在素材库中的素材。适用于三种情况：分析刚创建的新库（create-library 完成脚手架后交接至此）、回到已有库从上次中断处继续、向已有库追加新素材并只分析新片段。它编排完整的“音频转写→联系表→摘要”流水线，各分析步骤的具体机制位于 skills/analyze-video/SKILL.md，本技能负责调用。
主要能力与用法：
- 定位素材库。用 ruby lib/buttercut/library.rb <name> exists 判断是否存在；存在则用 ruby lib/buttercut/library.rb <name> summary 读取快照，获取顶层元数据与片段完成情况（video_count、incomplete_count 及缺失字段列表），并按 AGENTS.md 的 Critical Principles 先执行 schema 迁移，再从任一未完成步骤继续。若目录存在但 exists 返回 1（缺 library.yaml），检查现有文件并告知用户，需用 create-library 恢复一致性后再返回。若目录不存在，则先用 create-library 技能。查找最近库可用 ruby lib/buttercut/library.rb recent [N]（默认 10）。
- 追加新素材。用 ruby lib/buttercut/library.rb <name> add_media /abs/new1.mov /abs/photo.jpg，视频与图片可一起添加，类型按扩展名推断。新视频条目的 transcript、contact_sheet、summary 为空，新图片仅 summary 为空；空即待办。分析步骤幂等，只处理缺失产物的片段，因此只处理新片段；转写与联系表阶段仅针对视频，图片直接进入摘要步骤。仅续跑或处理新库时跳过此步。
- 分析素材。先告知用户“Found [N] videos ([total size]). Starting footage analysis...”，然后端到端遵循 skills/analyze-video/SKILL.md，涵盖处理期间保持电脑唤醒、素材处理（先转写后联系表，两次确定性的 process_footage.rb 运行）、可选的转写精修、摘要（Sonnet 子代理，分批加滚动）以及分析后的素材理解阶段。不要仅凭文件名或相机品牌臆测素材内容，例如 DJI 片段不一定是无人机素材，除非画面本身表明。可用 ruby lib/buttercut/library.rb <name> update_metadata footage_summary "subjects/locations/activities/visual style" 更新元数据。必须分析完所有视频后再提议创建粗剪。
- 验证就绪。报告分析完成前，用 ruby lib/buttercut/library.rb <name> ready 确认通过 cut 技能使用的同一门槛；若非零退出，用 summary 列出未完成片段，补齐缺失产物后重跑 ready 直到通过，不得在 Library.ready? 为 false 时声称分析完成。
- 备份。分析全部完成后，自动用 backup-library 技能备份，范围仅限本次处理的库：ruby lib/buttercut/backup_libraries.rb --library <library-name>，在 ~/Documents/buttercut-video-editor-backups/<library-name>/（或 libraries/settings.yaml 中 backups_dir 指向处）写入单个归档；若 backups_dir 未设置，脚本静默使用默认值，process-library 期间不要提示。
限制与注意事项：所有临时文件统一放在 buttercut 项目根目录下的单个 tmp/ 目录，按需创建子目录并在用后删除。重新处理素材时，process_footage.rb 只处理缺失产物的片段；要重建已存在的产物，需对相应步骤（transcripts 或 contact-sheets）加 --force 重跑，可选 --clips a.mov,b.mov，详见 analyze-video 第 2 步。每次读取 library.yaml 都要对照 templates/library_template.yaml 检查 schema，若有缺失或重命名，运行 ruby lib/buttercut/library.rb migrate 一次性迁移所有库，迁移触发清单见 AGENTS.md 的 Critical Principles。资料未提供具体收费、价格、平台支持范围与效果数据。