> For the complete documentation index, see [llms.txt](https://rplaylive.gitbook.io/creatorguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rplaylive.gitbook.io/creatorguide/zh-tw/storychat/storychat/export-import.md).

# 匯出與匯入

可以將整個畫布儲存成**一個 JSON 檔案**，並利用該檔案還原，供備份與復原使用。

在畫布選單使用 **`匯出畫布`**、**`匯入畫布`**。

將其他平台的角色與故事移入故事聊天的步驟，請參閱[移植既有角色與故事](/creatorguide/zh-tw/storychat/storychat/character-migration.md)。

按下`匯入畫布`後，會先出現以下確認視窗。

> 匯入畫布會刪除先前的編譯資料，因此開始新對話之前，必須重新編譯。若透過編輯檔案修改作品 ID 或節點資料，可能導致既有資料接續錯誤。此為測試版功能，可能無法如預期運作。是否繼續？

{% hint style="warning" %}
**這確實是測試版功能，請遵守本文件的注意事項。** 匯入後，**先前的編譯資料會被刪除，必須重新編譯**才會套用到新對話。
{% endhint %}

## 匯出

按下`匯出畫布`會立即下載 `canvas-export-...json` 檔案。成功後會顯示`已匯出畫布`。

{% hint style="success" %}
**這個檔案實際上是唯一的備份方式。**

進行大型修改前、刪除語言前，以及**匯入前**，都請先匯出一次。檔名含有日期，即使儲存多份也不易混淆。
{% endhint %}

## 匯入

檔案語言與目前畫布語言不同時，系統會先讓您選擇套用到目前語言，或套用到檔案語言的畫布。所選目標畫布的內容會被取代，因此請確認檔案語言及要覆寫的目標語言，並先匯出目標畫布備份。

{% hint style="warning" %}
若自行翻譯 JSON 檔案，請確認檔案中的 `canvasLanguage` 已改為目標語言。
{% endhint %}

<figure><img src="https://1741559059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu4JV3Z8NMVQjuocIEUl6%2Fuploads%2Fgit-blob-263427dfa0f68f63aa326009eb75fd32c6e4d729%2Fsc-canvas-import-language-mismatch.png?alt=media" alt=""><figcaption><p>確認畫布語言的彈出視窗。若檔案語言與畫布語言不同，例如 한국어(KO) 與 日本語(JP)，可選擇匯入至目前畫布語言，或匯入至 JSON 檔案語言的畫布（也可取消）</p></figcaption></figure>

選擇檔案後，會出現以下確認。

> 目前畫布的所有資料都將被匯入的資料取代。此操作無法復原。

{% hint style="danger" %}
**確實會全部取代，不會合併。**

目前畫布中的節點、圖片連接與設定，**全部會改成檔案內容**。檔案中沒有的內容會消失。

**沒有復原方式。** 匯入之前，**務必先匯出目前狀態**。
{% endhint %}

確認後會上傳檔案（`正在上傳匯入檔案...`），接著顯示`正在匯入畫布...`的進度。完成後會顯示`已匯入畫布`。

### 聊天進階設定也會一併變更

{% hint style="danger" %}
**匯入不只會改變畫布。**

作品的**全部進階設定**都會被檔案中的值取代。只有製作模式（畫布／簡易）維持原樣，其餘都會覆寫。

匯入很久以前匯出的檔案，可能使期間修改的進階設定**在沒有提示的情況下回到舊值**。匯入後請檢查一次[進階設定](/creatorguide/zh-tw/storychat/storychat/limits.md)。
{% endhint %}

### 途中失敗時

{% hint style="danger" %}
**即使匯入失敗，也不會回復原狀。**

系統會停在已完成部分處理的狀態。此時唯一的復原方法，就是**重新匯入預先匯出的檔案**。

若出現`畫布匯入失敗`，請使用備份檔再次匯入。
{% endhint %}

### 多人共同使用時

{% hint style="warning" %}
**匯入進行中，其他人再次嘗試匯入時會因錯誤而遭到拒絕。** 完成前無法開始新操作，請稍候再試。

但**若一人正在編輯，另一人進行匯入，編輯內容會被整批覆寫。** 共同製作時，請在其他人沒有編輯的時段操作。
{% endhint %}

## 適用情境

| 情境         | 方法                    |
| ---------- | --------------------- |
| **工作前備份**  | 大幅修改前先匯出              |
| **還原**     | 匯入備份檔案                |
| **移至其他畫布** | 在來源畫布匯出，再於目標畫布匯入      |
| **外部編輯**   | 以文字編輯器開啟 JSON，批次修改後匯入 |

{% hint style="info" %}
自行修改 JSON 時，請注意**不要破壞格式**。格式錯誤時，匯入甚至無法開始。

**請勿修改作品 ID 或節點資料。** 修改後可能在接續既有資料時發生錯誤。

從他人作品匯出的檔案，**沒有存取權限就無法匯入**。
{% endhint %}

## 匯入後的工作

1. 確認節點已正確匯入
2. 檢查\*\*[進階設定](/creatorguide/zh-tw/storychat/storychat/limits.md)\*\* — 如前述，可能已被覆寫
3. **重新執行**[**編譯**](/creatorguide/zh-tw/storychat/storychat/compile.md) — 單純匯入不會套用到對話。由於先前的編譯資料已刪除，請務必在**開始新對話前**編譯

{% hint style="info" %}
即使匯入到已公開或已編譯的作品，**語言標籤也不會消失**。用於排行與搜尋曝光的語言標籤，不會因匯入而遺失。
{% endhint %}

***