用途:帮助作者确认 Scrivener 3(.scriv)项目是否完好,修复其派生数据,并在进行高风险操作前做完整备份。写入类技能会在每次修改前自动调用它。
主要能力:preflight 检查项目是否在 Scrivener 中打开或处于云同步中,发现锁定文件、未下载的 iCloud 占位文件或同步冲突文件时拒绝写入(退出码 3,可用 --force 覆盖);verify 解析 .scrivx 并遍历 binder 树,仅对无法解析的 .scrivx 或明确引用却缺失的文件报错,其余为警告或提示;repair 仅重算 Scrivener 可自行再生的数据(docs.checksum 的 SHA-1、search.indexes),不触碰正文、快照、注释或元数据;backup 将整个 .scriv 打包为带时间戳的 zip;snapshots 列出某文档的快照。
使用方式:命令默认输出 JSON,加 --format text 输出可读报告,始终用 --project 指向 .scriv 包或其 .scrivx。例如:python3 ${CLAUDE_PLUGIN_ROOT}/tools/scrivener/cli.py verify --project "<path.scriv>";repair --what checksums|search-index|all;backup --out "<dir>";snapshots <uuid-or-title>。
适用场景:编辑前安全检查、校验项目、修复校验和或搜索索引、备份、查看快照、排查同步冲突。
限制:校验和状态仅作提示,陈旧或不匹配不算损坏;缺失正文内容属正常。标题不唯一,歧义时传 UUID。restore、backups list、conflicts 为计划中功能,暂未提供。检查只是后备手段,仍应关闭 Scrivener 并等待云同步完成。