长篇小说创作者从传统桌面工具转向 AI 辅助创作平台时，Scrivener 往往是最难割舍的一站。二十多年来，由 Literature & Latte 开发的 Scrivener 一直是长篇虚构创作的行业标杆，其无限层级的活页夹（Binder）树形目录、软木板大纲与分段组织能力，陪伴无数作家完成了百万字手稿。然而，当创作者希望将大语言模型（如 Claude 或 GPT-4）深度融入日常构思与扩写流程时，Scrivener 的局限性迅速暴露：它没有原生 AI 支持，也无法将角色背景、势力关系和魔法设定实时转化为 AI 的上下文提示词。
Novelcrafter 正是为解决这一创作断层而生的专业平台。它将无干扰的文本编辑器、结构化大纲矩阵与关系型故事圣经——**Codex（法典）**融为一体。在创作者写作时，Novelcrafter 能够实时识别文中的角色名称与专有名词，并将对应的世界观背景精准注入 AI 提示词中。
面对这一迁移，绝大多数作家最核心的担忧集中在两点：
- 活页夹层级会否崩溃？ 多年梳理的“卷/幕 $\rightarrow$ 章节 $\rightarrow$ 场景”嵌套结构，是否会在导入后退化为一整块难以拆分的扁平长文？
- 人物小传与设定资料如何处置？ 沉淀在 Scrivener“研究（Research）”与“角色（Characters）”活页夹中的海量资料卡片，是否只能依靠耗时费力的人工逐条复制粘贴？
Novelcrafter 虽然不能直接解压读取专有的 .scriv 工程包，但借助标准化的编译映射与导入机制，创作者可以实现手稿结构零损耗平移。同时，借助 Novelcrafter 原生的 Snippets（便签片段） 与 AI “提取至法典（Extract to Codex）” 功能，原本死板的静态文字资料可在数分钟内升级为具备别名追踪与提示词感知的动态世界观数据库。
架构映射：Scrivener 活页夹与 Novelcrafter 数据模型
在动手导出前，首先需要理清 Scrivener 的非结构化活页夹与 Novelcrafter 专有结构之间的映射关系。
| 组织维度 | Scrivener 活页夹（Binder） | Novelcrafter 架构 | 迁移对应方式 |
|---|---|---|---|
| 顶层结构 | 顶级文件夹（分部 / 分幕） | 幕（Acts） | 一级标题（Heading 1 / #） |
| 中层结构 | 二级文件夹或文档（章节） | 章节（Chapters） | 二级标题（Heading 2 / ##） |
| 最小正文单元 | 文本文件（场景） | 场景（Scenes） | 场景分隔符（如 ***）分割 |
| 故事设定库 | Characters / Places / Research 文件夹 | Codex 法典（人物、地点、物品、传说） | Snippets 粘贴 + AI 提取，或批量新建 |
| 上下文机制 | 静态纯文本，需人工双屏比对参考 | 关系型标签、别名（Aliases）与实时提及识别 | Codex 词条中的 Aliases 别名列表 |
| 草稿与便签 | Notes / Document Bookmarks | Snippets（代码/笔记片段） | 导出文本至 Novelcrafter Snippets |
在 Scrivener 中，活页夹将所有内容都视作通用的文件或文件夹，你可以把角色卡混在某一章内，也可以无限嵌套目录。而 Novelcrafter 遵循专为小说工业化创作设计的标准层级：幕（Act） $\rightarrow$ 章节（Chapter） $\rightarrow$ 场景（Scene）。所有不属于正文的世界观与人物设定，则必须进入独立的 Codex 系统，以便 AI 在生成时随时调用。
第一部分：从 Scrivener 规范导出正文手稿
许多创作者在迁移时踩到的第一个大坑，就是直接将整个 Scrivener 工程全量导出。这会导致角色卡片、大纲摘要甚至废弃草稿全部混入正文，造成灾难性的排版混乱。
通过以下四个步骤，可以生成一份层级分明且带有规范标记的手稿文件。
步骤 1：整理活页夹边界（目录卫生）
确保你的 Scrivener 活页夹严格区分“手稿”与“资料”：
- 检查根目录下的 Draft（手稿）文件夹，确保其中只包含小说正文。
- 规范手稿内部层级：
- 第一层文件夹：分幕 / 分卷（Acts / Parts）
- 第二层文件夹：章节（Chapters）
- 第三层文本：场景（Scenes）
- 注：若作品不划分幕/卷，则第一层为章节，子文档为场景。
- 确保所有人物卡、地理设定、设定集全部存放在 Draft 外侧的 Characters 与 Research 文件夹中，切勿混杂。
步骤 2：配置 Scrivener 编译输出
在 Scrivener 中打开编译面板（菜单栏选择 文件 > 编译...，或快捷键 Ctrl+Alt+E / Cmd+Option+E）。
- 在顶部“编译为（Compile For）”下拉菜单中，选择 Microsoft Word (.docx) 或 MultiMarkdown (.md)。二者均受 Novelcrafter 完美支持；Markdown 格式能提供极为精准的标题层级，而
.docx则利于保留特殊的斜体与富文本格式。 - 在左侧预设列表中选择基础预设（如 Manuscript (Times) 或 Default）。
- 右键点击该预设，选择 复制并编辑格式...（Duplicate & Edit Format...），进入格式设计器。
步骤 3：分配版面类型与标题层级（Section Layouts）
在格式设计器窗口中：
- 切换至 Section Layouts（章节版面） 标签页。
- 将 分部/分幕文件夹 映射为输出 Heading 1（一级标题）。
- 将 章节文件夹 映射为输出 Heading 2（二级标题）。
- 将 场景文本 映射为仅输出文本内容的版面（如 Text Section），取消勾选其文档标题输出，防止出现多余的场景名称干扰正文。
步骤 4：设置场景分隔标记（Separators）
Novelcrafter 依赖明确的标记来识别场景切分：
- 在格式设计器中切换至 Separators（分隔符） 标签页。
- 找到文本与文本之间（即场景与场景接续）的规则，将默认的空行改为自定义符号：
***。 - 勾选跳过末尾场景分隔符，避免在每章结尾生成多余标记。
- 保存格式并执行编译，将导出的文件保存为
manuscript.docx或manuscript.md。
第二部分：将手稿结构完整导入 Novelcrafter
获得带有明确层级标记的手稿文件后，即可交由 Novelcrafter 的导入解析器重构树形目录。
步骤 1：启动导入向导
- 登录 Novelcrafter，在控制台点击 Create Novel（新建小说）（或在已有项目左侧导航栏底端进入 Import）。
- 在导入格式中选择对应的
.docx或.md。 - 点击 Choose File 上传刚刚导出的手稿文件。
步骤 2：设置解析选项
在导入参数配置面板中进行以下关键设置：
- 导入类型（Import As）： 务必勾选 Prose（小说正文）。切勿选择 Scene Summaries，后者专用于导入无正文的大纲梗概。
- 场景识别规则（Scene Breaks）： 选择以特定符号识别场景，并输入刚刚在 Scrivener 中设置的
***（或选择对应空行规则）。 - 标题识别机制： Novelcrafter 会默认将一级标题解析为幕（Acts）、二级标题解析为章节（Chapters）。若手稿仅含章节未设分卷，系统会自动将场景直接归入章节下。
步骤 3：检查导入预览（Preview Import）
在最终点击确认前，Novelcrafter 会展示 Preview Import 界面。这一步是校验层级是否完整的关键屏障。
在此界面务必核对三项数据：
- 分幕与章节总数： 检测到的章节数量是否与 Scrivener 活页夹中的章节数完全一致？
- 总字数统计： 统计字数是否与 Scrivener 纯手稿字数相符（排除了 Research 后的净字数）？
- 场景切分情况： 展开各章节，检查内部的场景是否被精准划分为独立的卡片，而非合并为大段文本。
若发现章节遗漏或场景未断开，通常是 Scrivener 编译时的标题样式未对齐。此时应取消预览，微调文档标记后重新上传。核对无误后，点击 Confirm Import。系统将瞬间在 Plan（大纲） 与 Write（写作） 视图中完整呈现由卷、章、场景构成的树状导航栏。
第三部分：将人物设定与资料库迁移至 Codex
手稿正文落地后，下一步是迁移 Scrivener 活页夹中的 Characters 与 Research 资料。
在 Scrivener 中，人物小传通常是松散的富文本卡片；而在 Novelcrafter 中，人物和世界观沉淀在具备关系属性的 Codex（法典） 中。Codex 拥有高度专业化的字段结构：
- 条目名称（Name）： 角色的标准全名或实体的官方名称。
- 别名（Aliases）： 昵称、头衔、缩写或角色在正文中可能出现的各种称谓（这是触发 AI 上下文联动的核心）。
- 标签（Tags）： 如
主角、反派、北方领主、魔法师等分类。 - 简短描述（Short Description）： 1–2 句话概括其核心身份与动机，系统会在检测到别名时直接将此字段注入 AI 系统提示词。
- 详细背景（Details）： 外貌特征、复杂过往、心理矛盾、关系图谱及剧情发展轨迹。
针对资料迁移，推荐以下两种高效路径：
路径 A：便签片段 + AI 对话一键提取（推荐，适合批量迁移）
这是将数十个 Scrivener 角色卡无痛转入 Codex 的最高效方式：
- 从 Scrivener 批量导出资料：
- 在 Scrivener 活页夹中选中
Characters文件夹。 - 选择
文件 > 导出 > 文件...，批量导出为文本文件；或单独将该文件夹编译为一个包含全部角色资料的 Word/Markdown 文档。
- 在 Scrivener 活页夹中选中
- 在 Novelcrafter 中建立 Snippet：
- 点击 Novelcrafter 左侧导航栏的 Snippets（便签片段）。
- 新建一个名为
Scrivener 导入资料草稿的片段，将导出的所有角色文本粘贴进去。
- 调用 Workshop AI 进行格式化梳理：
- 打开 Novelcrafter 的 Workshop Chat（工坊对话）。
- 在对话框中通过
@Scrivener 导入资料草稿引用该便签。 - 发送如下提示词指令（推荐使用 Claude 3.5 Sonnet 或 GPT-4o）：
“请阅读引用的便签中的原始角色资料，将其整理为格式统一的结构化档案。每个角色严格按照以下模版输出：
姓名： [官方全名]
别名： [正文中可能出现的昵称、尊称或简称，用逗号分隔]
标签： [阵营、身份标签]
简要描述： [1至2句话，概括核心性格、当前动机与外貌显著特征]
详细资料： [背景故事、详细外貌、人际关系与关键伏笔]”
- 一键生成 Codex 词条：
- 当 AI 生成结构化列表后，将鼠标悬停在回答卡片下方，点击 Extract to Codex（提取至法典） 功能按钮。
- Novelcrafter 会智能解析 AI 生成的实体，创作者只需快速勾选确认实体类别（Character / Location / Lore），即可一键在 Codex 中批量建档。
路径 B：从已导入的手稿正文中自动提取
如果 Scrivener 中的角色卡年久失修，许多设定直接写在正文中，可以使用正文扫描功能：
- 打开 Novelcrafter 的 Codex 界面。
- 使用提取工具直接扫描手稿章节。
- AI 会遍历正文，自动识别出反复出场的人物姓名、高频地名及专有法宝道具，并生成待确认的词条卡片。
- 创作者逐一确认后，再从 Scrivener 中复制补充详细说明。
第四部分：迁移后的优化配置与避坑指南
完成手稿与 Codex 的录入后，还需要进行以下四项关键微调，以彻底释放 Novelcrafter 的 AI 辅助潜能：
1. 完善别名（Aliases）以激活实时提及识别
Novelcrafter 最具竞争力的能力是正文提及监控。只有完善别名，AI 才能在写作时“认识”人物：
- 打开每个主角的 Codex 卡片。
- 在 Aliases 字段中补全所有可能的文本变体。例如主角名为“亚历山大·格林”，应添加别名：
亚历山大、格林、艾利克斯、团长。 - 在 Write 界面撰写正文时，每当出现这些字样，Novelcrafter 都会自动高亮并显示词条浮窗。
2. 区分长短描述，严控 Token 预算
新手最容易犯的错误是把 Scrivener 里长达数千字的人物小传全堆进提示词中，这会导致上下文窗口迅速臃肿，且干扰 AI 的输出专注度。
- Short Description（简短描述）： 严格控制在 30–80 字以内。这是每当人物出场时自动注入提示词的黄金核心。
- 详细正文（Body）： 存放完整的万字背景与剧情演变，平时不随提及自动发送，仅在创作者手动引用或在 Workshop 对话中深入推演情节时调用。
3. 系列世界观法典（Series Codex）配置
若迁移的作品是多卷本长篇史诗、玄幻修仙或科幻三部曲：
- 避免将人物设定单独绑定在某一本书的 Codex 内。
- 在 Novelcrafter 中创建 Series（系列），并将 Codex 关联至整个系列。
- 编写后续卷册时，新建小说可直接共享该法典，无需再次重复迁移。
4. 数据反向回迁：随时重返 Scrivener
许多作者希望在 Novelcrafter 中利用 AI 进行初稿创作与头脑风暴，但在终稿校对、排版与离线归档时依然偏好 Scrivener。这一闭环完全可行：
- 在 Novelcrafter 左侧边栏点击 Export（导出）。
- 导出为 Markdown 或 Word 格式，确保勾选保留章节标题标记。
- 在 Scrivener 中，选中活页夹目标文件夹，点击
文件 > 导入 > 导入并拆分...（Import and Split...）。 - Scrivener 会根据标题自动完成切分，手稿将无缝恢复为原汁原味的活页夹树形目录。
迁移执行清单
| 阶段 | 核心任务 | 验收标准 |
|---|---|---|
| 导出前准备 | 在 Scrivener 中隔离手稿与 Research 资料 | 编译时不含任何多余设定文本 |
| 格式编译 | 映射分部为 H1、章节为 H2、场景分隔为 *** | 导出文件带有标准层级标记 |
| 手稿导入 | 勾选 Prose，在 Preview 界面校验幕与章数量 | 章节与场景数量与 Binder 完全一致 |
| 资料平移 | 经由 Snippets + AI 对话使用 Extract to Codex | 角色具备独立条目、简短描述与别名列表 |
| 功能联调 | 在 Write 写作界面输入角色别名 | 文本自动高亮并可一键呼出法典卡片 |
只要坚持“正文走层级编译、资料走便签与法典提取”的双轨原则，原本庞大复杂的 Scrivener 史诗工程便能在不到一小时内平稳进驻 Novelcrafter，在完整保留创作心血的同时，全面开启现代化 AI 驱动的写作体验。