SuperAPI AI 工具集

backup-library

办公与效率

查看项目

更新于 10-15 17:24

技能介绍

用途:备份 ButterCut 用户库及其全部内容,外部视频不包含在内;该技能也可用于恢复库。

存放方式:备份默认写入 ~/Documents/buttercut-video-editor-backups,每个库一个子目录,每次运行为该库生成带时间戳的归档,因此向一个库新增片段只写该库的归档,不会重复备份全部内容。

使用步骤一,确定目标目录:从 libraries/settings.yaml 读取 backups_dir;若缺少该键,用 AskUserQuestion 询问是使用默认目录(推荐)还是自定义文件夹,并写入 settings.yaml 的 backups_dir;若 settings.yaml 不存在,先用 templates/settings_template.yaml 创建。当被要求保持非交互的其他技能(如 process-library 自动备份)调用且未设置 backups_dir 时,跳过询问直接使用默认值。

步骤二,执行备份:默认只备份当前处理的库。

备份单个库: ruby lib/buttercut/backup_libraries.rb --library <library-name>

备份全部库(仅当用户明确要求): ruby lib/buttercut/backup_libraries.rb

脚本从 libraries/settings.yaml 读取 backups_dir,未设置时回退到默认;可用 --backups-dir <path> 单次覆盖。

归档格式:macOS 上 aa CLI 可用时使用 Apple Archive(.aar),Apple Silicon 上硬件加速,Finder 可双击解压;否则回退为 .zip,Windows 上使用内置 System32 tar.exe 或 PowerShell 生成 zip,输出均为可双击的普通 .zip。

清理:backup_all 成功运行后,若旧的项目内 backups/ 目录仍存在且解析出的 backups_dir 在别处,脚本会将其删除;按库的单独运行不会动它。

恢复库:将按库归档解压回 libraries/。Apple Archive(macOS):aa extract -i ~/Documents/buttercut-video-editor-backups/<library>/<library><timestamp>.aar -d libraries/<library>;macOS/Linux 的 zip:unzip ~/Documents/buttercut-video-editor-backups/<library>/<library><timestamp>.zip -d libraries/;Windows(Git Bash):/c/Windows/System32/tar.exe -xf ~/Documents/buttercut-video-editor-backups/<library>/<library>_<timestamp>.zip -C libraries/。限制:不备份外部视频;具体价格与平台支持范围暂未提供。