用途：帮助写作者把外部素材带入现有 .scriv 项目，例如已写好的章节、研究资料文件夹、需要按章拆分的长 Markdown 文件，或合并另一个 Scrivener 项目。导入是增量操作，只创建新的 binder 条目，不会覆盖已有文档。
主要能力：规划中的导入命令族包括 import（导入外部文件，txt/md/rtf/html/opml 及 PDF/图片/音视频作为研究/媒体条目直通复制）、import-split（按标题、md-atx 或分隔符把长文件一次拆成多个条目）、import-project（导入或合并另一个 Scrivener 项目的 binder 子树）。docx/odt 转换及 PDF/fdx 文本提取需 pandoc/textutil，缺失时优雅降级。
当前可用：上述导入命令尚未进入 CLI。目前可用 scrivener-edit 的 add 作为替代，仅支持纯文本/Markdown，可内联文本或指定文件。示例：python3 ${CLAUDE_PLUGIN_ROOT}/tools/scrivener/cli.py add <parent-id> --type text --title "Chapter 3" --text-file ./chapter-3.md --project "<path.scriv>"。拆分需先在 Scrivener 外按 # 标题切分，再建文件夹并逐个 add。
使用方式：先关闭 Scrivener 并等待云同步完成，再用 outline/find 解析目标父级 UUID（标题不唯一时用 UUID 并核对父级 Type）。Draft/Manuscript 文件夹只接受文本和文件夹，媒体应导入 Research 文件夹。写入前自动 zip 备份。导入后用 outline 和 stats 核对。
限制：add 仅支持 txt/md，不支持 rtf/html/opml 解析、docx/odt/pdf 转换和媒体直通；无自动拆分；无项目合并替代方案；媒体导入目前需在 Scrivener UI 中手动添加或等待 import 发布。