# 匯出與匯入專案包

> 交付匯出與專案備份是兩件事：.quill.json、純文字 TXT、快照與封存箱各管什麼。

Source: https://loomworld.ai/zh-tw/docs/export-quill

## 兩類匯出，別混用

織境有兩種匯出，目的完全不同：交付匯出給合作方的讀者看（劇本稿），專案備份給自己留底（可重新匯入的完整專案包）。前者是成品文件，後者是資料。

交付匯出

Word 文件（.docx）／ PDF（走系統列印 → 存為 PDF）／ 純文字（.txt）。範圍可選全劇或單章，Word／PDF 可選包含註解行，TXT 不含註解。

專案備份

完整專案打包成 .quill.json：正文、結構、資料與隨包資產一起帶走，用於換機遷移與獨立還原。

## 怎麼匯出

設定 → 專案資料裡兩件事並排：上半是「交付匯出」，選格式與範圍後匯出劇本；下半是「專案備份」，按「匯出完整專案」下載 JSON 專案包。專案書架裡卡片右下角的選單也有「匯出專案」，不開啟專案就能帶走一份。

- Word／PDF 可用「包含註解行」開關決定是否帶作者註解；純文字固定不含註解。
- PDF 走系統列印面板，在裡頭的「存為 PDF」落地，所以紙張與頁首由系統列印設定決定。
- 包裡的圖片隨包攜帶；匯入時會還原通過校驗的資產，個別損壞項目會在匯入摘要裡說明，不會拿假內容頂替。

## 三種交付格式怎麼選

- Word（.docx）：要給演員、導演或責任編輯在辦公軟體裡讀、要他們在文件裡批註時選它。場次抬頭、說話者與台詞層級都會保留成可辨認的排版。
- PDF：要定稿分發、不希望對方改動時選它。它走系統列印面板，所以紙張、頁面邊界與頁首在你確認前可以自己調整。
- 純文字（.txt）：需要發布連載章節、複製到其他平台或用普通文字編輯器閱讀時選它。只保留章標題和正文，單章匯出保留原章號。

範圍先想清楚：整劇給外圍看，多半只需要全劇正文；單章給協作方評審時選「第 N 章」，Word／PDF 另需留意「包含註解行」開關——你寫給自己的備忘一般不該出現在交付稿裡。

## 匯入與還原

在書架選擇「匯入專案」，選擇 `.quill.json` 檔案。匯入永遠建立新的本機複本，不覆蓋同名專案；正文、結構、資料與通過校驗的資產一起還原。首次開啟不依賴雲端權限；有有效訂閱或已登記的 Global 歷史權益時，匯入並開啟的目前專案會自動開啟雲端同步，本機複本保留。

還原舊狀態還有更細緻的工具：版本快照（專案資料裡，手動存檔與一鍵還原）和封存箱（被刪掉的場次與時空先進入這裡，還原時追加回原所屬章末）。快照與封存是專案內的安全網，專案包是跨裝置的冷備份。

## 純文字 TXT 包含什麼

純文字保留原章號、章標題和可讀正文，適合每天按章發布網文，或複製到其他寫作平台。人物台詞、動作、旁白和轉場文字按正文順序保留。

TXT 不帶場次／時空資訊、作者註解、關聯原始碼或 Quilldown 標記。要保留完整結構並在織境還原，請另存完整專案包。

## 限制與排錯

- 專案包主要供織境重新匯入，不建議手動修改其中的資料結構；手動改過的包不保證能匯入。
- 專案包會帶上專案自己的對話與歷史紀錄，換裝置後聊天歷史跟著走；雲端帳號裡的點數明細與任務紀錄屬於帳號，不隨專案包遷移。
- 匯出失敗時會給出原因，按提示重開專案再試一次；不要在被中斷後反覆按匯出。
- 定期備份的建議很樸素：長篇專案每完成一章匯出一次，成本只有點擊一下。