用途:帮助写作者对 Scrivener 3 项目中正在编辑的文本应用直接格式化,即 Format 菜单中的各项设置,包括字体族与字号、粗体/斜体/下划线/删除线、文字与高亮颜色、段落对齐、行距与段距、缩进与制表位、列表、表格和超链接。这些格式内联保存在各文档的 content.rtf 中,独立于命名样式。
使用前需先确认两点:一是用户指的是编辑字体还是编译字体。编辑字体是写作时屏幕上看到的字体,修改它会重写各 content.rtf 中的直接格式;编译字体是导出或打印稿的字体,属于 scrivener-compile 的 Format 覆盖,不归本技能。许多编译 Format 会覆盖编辑格式,因此改编辑字体可能对输出无影响。二是作用范围:单文档(--scope docs:<id>)、子树(--scope subtree:<id>)或整个项目(--scope project)。项目级操作会批量重写所有 content.rtf,需确认并提示影响面。
直接格式化适合一次性修改和项目级规范化;若需要可复用、可统一重定义的外观,应改用命名样式(scrivener-styles)。
关键限制:批量重写必须保持 RTF 令牌结构,不能从纯文本重新生成,否则会破坏注释/脚注锚点、样式标记、嵌入图片和内部链接。脚本模式文档的剧本元素依赖段落格式识别,批量格式化会破坏剧本,默认应检测、警告并排除,剧本格式归 scrivener-scriptwriting。
当前状态:format 系列命令属于规划中(v0.1.0 路线图),尚未进入 CLI。现有可用的是 read <id> 检查文档的样式/注释/图片/表格/链接/列表等构造标志,以及 set-text <id> 的令牌保持式写入。规划命令包括 format set-font、set-size、bold/italic/underline/strike、color/highlight、align、spacing/indent、list 和 convert-default,均支持 --scope 与 --dry-run、--no-backup、--no-snapshot 等变更标志。
安全要求:写入前关闭 Scrivener 并等待云同步完成;写入会自动备份和快照;标题不唯一时用 UUID;不得从纯文本重建富文档,除非快照后传 --allow-destructive。相关技能:scrivener-styles、scrivener-compile、scrivener-scriptwriting、scrivener-format、scrivener-edit。