長篇虛構作家在從傳統單機寫作工具邁向 AI 輔助創作平台時，Scrivener 往往是最難以割捨的基石。二十多年來，由 Literature & Latte 開發的 Scrivener 一直是長篇小說架構組織的業界標竿，其無限制層級的活頁夾（Binder）樹狀目錄、軟木板大綱與靈活的分段管理，陪伴無數作者完成了數十萬乃至百萬字的手稿。然而，當小說家渴望將大型語言模型（如 Claude 或 GPT-4）融入日常的對話發想、情節擴寫與風格潤飾時，Scrivener 的架構瓶頸便顯露無遺：它缺乏原生 AI 整合，更無法將角色檔案、陣營關係或世界觀設定自動轉化為精確的 AI 提示詞脈絡。
Novelcrafter 正是為填補這一鴻溝而設計的現代化平台。它將無干擾的手稿編輯器、結構化大綱矩陣與關聯型故事聖經——**Codex（法典）**深度整合。在作者撰寫內文時，系統能即時偵測文本中出現的角色名稱與專有名詞，並將對應的設定背景精準注入 AI 提示詞中。
面對系統轉移，多數作家最大的顧慮集中在兩點：
- 活頁夾階層是否會錯亂？ 長年精心梳理的「部/幕 $\rightarrow$ 章節 $\rightarrow$ 場景」樹狀結構，是否會在匯入後被壓平成難以拆解的單一長文？
- 角色檔案與世界觀資料如何處置？ 累積在 Scrivener「研究（Research）」與「角色（Characters）」活頁夾中的海量資料卡，是否只能仰賴耗時耗力的人工手動重新輸入？
Novelcrafter 雖然無法直接開啟或讀取封閉的 .scriv 專案包，但只要透過標準化的編譯輸出設定與 Novelcrafter 的解析機制，作者便能實現手稿結構 100% 無損平移。同時，利用 Novelcrafter 原生的 Snippets（便簽片段） 與 AI 「擷取至法典（Extract to Codex）」 功能，原本靜態的文字設定可在數分鐘內蛻變為具備別名追蹤與提示詞連動動態資料庫。
架構映射：Scrivener 活頁夾 vs. 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 中開啟編譯面板（選擇選單 File > Compile...，或按下快捷鍵 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 後的淨手稿字數一致？
- 場景切分狀況： 展開各章節，確認內部的場景是否皆被正確拆分為獨立卡片，而非黏合成整段長文。
若發現有章節遺漏或場景未正確切分，通常是編譯時的標題樣式未正確對應。此時請取消預覽，修正檔案標記後重新上傳。確認無誤後，點選 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資料夾。 - 選擇
File > Export > Files...，批次匯出為純文字或 Markdown 檔案；或將該資料夾單獨編譯為一份包含所有角色資料的 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 會遍歷內文，自動辨識頻繁登場的人名、重要地名與關鍵道具，並列出待建立的詞條建議卡片。
- 作者逐一確認並建檔後，再行補充詳細設定。
第四部分：遷移後的最佳化設定與避坑重點
完成手稿與 Codex 的匯入後，建議完成以下四項細節調校，以完整釋放 Novelcrafter 的 AI 輔助潛力：
1. 完善別名（Aliases）以啟動即時提及追蹤
Novelcrafter 最具價值的核心特色在於內文即時提及偵測。唯有設好別名，AI 才能在寫作當下理解角色：
- 開啟各個主要角色的 Codex 卡片。
- 在 Aliases 欄位中加入所有可能在正文中出現的稱呼。例如主角名為「亞歷山大·格林」，應補上別名：
亞歷山大、格林、艾力克斯、團長。 - 在 Write 介面撰寫手稿時，每當出現這些字樣，系統都會自動高亮並呈現設定卡片浮窗。
2. 嚴格區分長短描述，控管 Token 預算
初學者最常見的誤區是把 Scrivener 裡長達數千字的人物生平完整塞入提示詞中，這會迅速耗盡上下文視窗的 Token，並分散 AI 的生成專注度。
- Short Description（簡短描述）： 嚴格控制在 30–80 字以內。這是角色每次於場景登場時，系統自動送入提示詞的精華內容。
- 詳細正文（Body）： 存放完整的萬字長篇背景與心路歷程，平時不會隨提及自動發送，僅在作者手動標記引用或在 Workshop 對話中深入推演情節時調用。
3. 系列世界觀法典（Series Codex）配置
若遷移的專案屬於長篇多卷奇幻、科幻三部曲或系列連載：
- 避免將角色設定單獨鎖死在單一本書的 Codex 中。
- 在 Novelcrafter 中建立 Series（系列） 專案，並將 Codex 關聯至該系列。
- 未來建立續集時，新作品可直接共用該法典，無需重新經歷遷移流程。
4. 資料反向回遷：隨時重返 Scrivener
許多作者希望在 Novelcrafter 中運用 AI 完成初稿衝刺與靈感激盪，但最終校對、排版與離線封存仍偏好 Scrivener。這套雙向工作流完全可行：
- 在 Novelcrafter 左側選單底部點選 Export（匯出）。
- 匯出為 Markdown 或 Word 格式，確保勾選保留章節標題。
- 在 Scrivener 中，於活頁夾指定目標資料夾，點選
File > Import > Import and Split...。 - Scrivener 會根據標題自動完成拆分，手稿將無縫還原為原汁原味的活頁夾樹狀結構。
遷移執行檢核表
| 階段 | 核心任務 | 驗收標準 |
|---|---|---|
| 匯出前準備 | 在 Scrivener 中嚴格隔離 Draft 與 Research 資料 | 編譯檔案不含任何多餘設定雜訊 |
| 格式編譯 | 映射分部為 H1、章節為 H2、場景分隔為 *** | 匯出檔案帶有標準標題與分隔標記 |
| 手稿匯入 | 選擇 Prose，於 Preview 畫面核對幕與章節數 | 章節與場景數量與 Binder 完全一致 |
| 資料平移 | 透過 Snippets + AI 對話使用 Extract to Codex | 角色擁有獨立條目、簡短描述與別名清單 |
| 功能連動 | 在 Write 介面輸入角色別名 | 文字自動高亮並能即時呼出法典資訊 |
只要掌握「正文走標題階層編譯、資料走便簽與法典擷取」的雙軌原則，原本龐大繁複的 Scrivener 專案便能在一個小時內平穩轉移至 Novelcrafter，在完整守護寫作心血的同時，全面解鎖現代化 AI 輔助創作的強大戰力。