SuperAPI AI 工具集

scrivener-edit

办公与效率

查看项目

更新于 10-15 21:11

技能介绍

用途:帮助作者修改 Scrivener 项目的内容与结构,包括增删 Binder 条目、移动与重排、重命名,以及编辑文档正文、梗概(synopsis)和笔记,同时尽量不破坏 RTF 中隐藏的批注、脚注、链接、样式和图片。

主要能力:outline 读取 Binder 树获取 UUID、父级与顺序;find 按标题或类型解析 UUID;add 新建 text/folder 条目;rename 重命名;move 通过 --to/--index 改父级或排序;delete 移入废纸篓;set-synopsis、set-notes 设置梗概与笔记;set-text 编辑正文,支持 --append 追加,默认保留标记,富文档需 --allow-destructive 才能整体重写;snapshot 在风险操作前保存版本。所有变更命令支持 --no-backup、--no-snapshot、--dry-run。

使用方式:入口为 python3 ${CLAUDE_PLUGIN_ROOT}/tools/scrivener/cli.py <command> --project "<path.scriv>" [args],默认输出 JSON,--format text 便于阅读。写入前先在 Scrivener 中关闭项目并等待云同步完成;标题不唯一,变更前先用 find/outline 解析为 UUID;先 --dry-run 预览,再执行;完成后重跑 outline 确认结构。

适用场景:非线性写作中常见的移动场景、重排章节、重命名、调整层级、追加正文、设置梗概与笔记等。

限制:docs.checksum 不匹配仅为提示,不应阻止编辑;删除只进废纸篓;Draft/Manuscript 文件夹只允许 Text 与 Folder;富文档不可由纯文本重新生成,破坏性重写会丢失批注、脚注、样式、嵌入图片和内部链接。拆分、合并、升降级、复制、folder↔text 转换、自动填充标题等为规划中功能,当前 CLI 尚未提供。