用途：帮助写作者或代理把 Scrivener 草稿当作普通文件夹中的纯文本编辑，再把修改带回 .scriv，即 Scrivener 的“与外部文件夹同步”往返流程。适合改写文字类稿件，不适合以表格、复杂样式或图片为主的文档。
主要能力：导出时把每个草稿文档写成同步文件夹中的文件，文件名带 [number] 前缀以关联回 binder 条目；外部编辑后按修改日期与 binder 比对，只更新真正变化的文档；新增文件在导入时成为新 binder 条目。同步只移动内容文本，不包含简介、笔记、标签、状态、关键词、自定义元数据和快照，会剥离内嵌图片，内联注释与脚注用纯文本标记包裹，.txt 与 Fountain 不保留富格式，.rtf 仅保留基本字符与段落格式。
使用方式：目前 CLI 尚无专用 sync-folder 命令，需用现有命令手动往返。示例： SCRIV="<path.scriv>" CLI="python3 ${CLAUDE_PLUGIN_ROOT}/tools/scrivener/cli.py" $CLI extract <uuid> --to txt --project "$SCRIV" $CLI compile --to md --project "$SCRIV" $CLI set-text <uuid> --text-file edited.txt --project "$SCRIV" $CLI set-text <uuid> --text-file addition.txt --append --project "$SCRIV" 需自行跟踪文件与 UUID 的映射及哪些文件已改动。set-text 默认保留 token，除非加 --allow-destructive，否则拒绝重建富文档；富文档应追加或先做快照。
限制与安全：操作前须在 Scrivener 中关闭项目并等待云同步完成，否则可能损坏或冲突；外部同步文件夹应放在稳定位置，避免与 .scriv 同处云同步目录。写入前会自动备份 zip 并快照，--no-backup / --no-snapshot 可跳过。标题不唯一时用 UUID 定位。冲突检测可转 scrivener-integrity。sync-folder 导出、状态、导入及 Draft/Notes/Trashed 子目录布局、.fdx/Fountain 格式均为计划中功能，暂未提供。