用途:这是一个纯知识/参考型技能,帮助写作者理解 Scrivener 3 项目在磁盘上的组织方式,从而选用正确的工具与技能。它只做高层讲解并指向深入参考,没有修改命令;实际读取用 scrivener-inspect,写入用编辑类技能,校验用 scrivener-integrity。
主要能力:回答“这是什么文件”“X 存在哪里”“这是正常还是损坏”等问题,并作为其他 16 个技能共享的术语基础。
格式要点:Scrivener 3 项目不是单个文件,而是一个包(macOS 显示为 bundle,Windows 与云同步副本显示为普通文件夹),工具包始终按文件夹操作。仅针对 Scrivener 3(跨平台 Mac/Windows/iOS,以 Mac 为参考);1/2 版布局不同,只检测报告不编辑。识别 v3 的两点:Files/version.txt 保存格式版本;<Project>.scrivx 根节点带 Version="2.0"。
结构:<Project>.scrivx 是绑定器 XML 树加项目级设置(脊柱);Files/ 下有 version.txt、styles.xml、search.indexes、writing.history、binder.autosave/backup 及 Data/;Data/ 含 docs.checksum 与按 UUID 命名的每文档目录(content.rtf、synopsis.txt、notes.rtf、content.styles、content.comments、snapshots/、媒体 content.<ext>);另有 Settings/ 与 QuickLook/。
关键限制:并非每个绑定器条目都有 Data/<UUID> 目录,也并非每个目录都有 content.rtf,缺失属正常而非损坏;只有被显式引用的载荷丢失才算损坏。标题不唯一,需按 UUID 定位。docs.checksum 仅含 content.rtf、notes.rtf、synopsis.txt 的 SHA-1,属提示性,陈旧条目常见,不表示损坏。content.rtf 内嵌链接注释/脚注、命名样式标记、图片与内部链接,因此写入需保持 token 不丢失。
用法:本技能无自身命令,仅提供格式事实与参考文档(package-layout.md、binder-and-metadata.md)。