# 匯入角色

> 把 SillyTavern 或 CharacterHub 的角色卡帶進 Reverie。

Source: https://reverie.im/zh-TW/docs/characters/import-characters
Language: zh-TW

Reverie 可以讀取 V1、V2 和 V3 格式的角色卡——也就是 SillyTavern、CharacterHub 和大多數角色卡網站匯出的格式。匯入工具會填入一份可編輯的草稿；在你自己按下儲存之前，什麼都不會被儲存。

## 匯入角色卡 \[#import-a-card]

### 開啟新角色 \[#open-a-new-character]

前往 `/app/characters/create`，按下頂端的**匯入角色卡**。這個按鈕只會在建立角色時出現——你無法把角色卡匯入已經存在的角色。

### 拖放檔案 \[#drop-the-file]

**PNG 或 JSON，最大 10 MB。** 角色卡會在你的瀏覽器中解析，而不是先上傳再讀取。PNG 角色卡把 JSON 藏在圖片裡；JSON 角色卡則直接讀取。

聊天紀錄和獨立的世界書檔案是不同的格式，各有自己的工具——請參閱[匯入你的歷史紀錄](https://reverie.im/zh-TW/docs/getting-started/importing-your-history)和[世界書](https://reverie.im/zh-TW/docs/writing/world-books)。

### 確認要填入的內容 \[#review-what-it-will-fill]

對話框會顯示偵測到的角色卡版本、頭像，以及一份**準備填入**清單，列出它即將寫入的每個欄位和對應的值。在你確認之前，什麼都不會變更。

如果你已經在表單中輸入了內容，還需要在**只填入空白欄位**（保留你的編輯，只補上缺少的部分）和**取代對應欄位**（只要角色卡有值，就以角色卡為準）之間做選擇。

### 也可以讓 AI 整理一下 \[#optionally-let-ai-tidy-it-up]

**使用 AI 整理並充實匯入的草稿**會對結果再做一次整理。大多數角色卡會把所有內容都塞進一段很長的描述，所以這次整理會把描述、場景和指示拆成一段一段，再把每一段一字不改地移到它該放的欄位：外貌放進**外觀描述**，你對角色來說是誰放進**與玩家的關係**，長期適用的規則放進**系統提示詞**。超出描述長度上限的文字會保留在這張角色卡的世界書裡。接著它只補寫角色卡缺少的部分，例如簡介、建議回覆，以及兩三個額外的場景。系統會先套用單純的匯入結果，即使這次整理失敗，匯入的內容也會保留，所以你不會因為多要求這一步而失去角色卡的內容。這可能會消耗點數。

### 檢查並儲存 \[#check-and-save]

你會回到編輯器，草稿已經填好。補上角色卡沒有的必填項目——**角色分類**是必填的，而任何角色卡格式都沒有這一項——然後儲存。

## 欄位對應 \[#what-maps-to-what]

| 角色卡中的欄位                                                                          | 對應到                                                                        |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| `nickname`，若沒有則用 `name`                                                          | **角色名稱**，截斷至 50 個字元                                                        |
| `description`，若沒有則用 `char_persona`                                               | **詳細描述**，截斷至 10,000 個字元                                                    |
| `tagline`，若沒有則取描述或個性                                                             | **角色簡介**，擷取至 500 個字元                                                       |
| `personality`                                                                    | **角色個性**                                                                   |
| `appearance`                                                                     | **外觀描述**                                                                   |
| `player_relationship`                                                            | **與玩家的關係**                                                                 |
| `first_mes` / `char_greeting`，接著是 `alternate_greetings` 和 `group_only_greetings` | 每則問候語各成為一組**開場對話**，依序排列，不含建議回覆                                             |
| `mes_example` / `example_dialogue`                                               | **示例對話**，解析成使用者／角色的成對內容                                                    |
| `scenario` / `world_scenario`                                                    | 加在**詳細描述**的結尾，接在「Scenario:」後面。這張角色卡的聊天都從那個情境開場，而 Reverie 的場景只會套用到從該場景開始的聊天 |
| `system_prompt`、`post_history_instructions` 和 `depth_prompt`                     | **系統提示詞**，依這個順序合併。它們大多是角色設定和長期適用的規則，而**回覆格式提示詞**會取代 Reverie 自己的格式規則        |
| `nsfw_prompt`                                                                    | **NSFW 提示詞**                                                               |
| `tags`                                                                           | **標籤**，去除重複後保留前 20 個                                                       |
| `gender`、`age`                                                                   | **角色性別**、**角色年齡**                                                          |
| NSFW 標記                                                                          | **NSFW 內容**開關                                                              |
| `creator_notes`                                                                  | **創作者筆記**                                                                  |
| `character_book` 條目                                                              | 一本獨立的**世界書**，以角色命名並掛載到該角色                                                  |

內嵌和外部連結的圖片會複製到 Reverie 的儲存空間。無法取得的圖片會繼續指向原始網站，對話框會告訴你有幾張圖片屬於這種情況。

**不會帶過來的內容：** 聊天紀錄、個別使用者的記憶，以及上述欄位以外任何平台專屬的擴充資料。

## 匯入文字中的巨集 \[#macros-in-imported-text]

* `{{char}}` 會在解析角色卡時替換成角色名稱。
* `{{original}}` 會從提示詞欄位中移除。
* `{{user}}` 會原樣保留——Reverie 支援將它當作即時巨集使用。請參閱[巨集清單](https://reverie.im/zh-TW/docs/characters/advanced-settings#macros)。

## 你可能看到的訊息 \[#messages-you-might-see]

| 訊息                                | 發生了什麼事                            |
| --------------------------------- | --------------------------------- |
| 來源名稱超過 Reverie 的 50 字元上限，已被縮短     | 角色卡的名稱超過 Reverie 允許的長度            |
| 來源描述超過 Reverie 的 10,000 字元上限，已被縮短 | 同上，只是換成描述。原始角色卡不會被更動              |
| 來源年齡超出 Reverie 支援的範圍，因此未匯入        | Reverie 只接受 18 歲以上的年齡             |
| 角色卡中含有無法辨識格式的示例對話                 | 範例解析器無法拆分它。開啟 AI 整理即可還原，或在匯入後重新輸入 |
| 這個檔案是空的／角色卡大小不得超過 10 MB           | 檔案在解析之前就被拒絕了                      |

## 從其他地方匯入 \[#importing-from-anywhere-else]

角色卡格式是一回事；Character.AI 的匯出檔、一張截圖或一段純文字描述則是另一回事。這些要透過實驗室裡的**角色匯入 Skill**（`/app/labs/character-importer`）處理，它會在你自己的 Claude 用戶端中執行，並透過 Reverie 的 API 上傳完成的角色。

這個頁面會提供一段現成的訊息，讓你貼到 Claude Code、Claude Desktop 或其他任何用戶端：它會安裝這個 skill 並儲存你的 Reverie API 金鑰。之後，在同一個對話中放入檔案、截圖或描述，然後說「把這個角色匯入 Reverie」。新角色會出現在**我的角色**中。

> 那段準備好的訊息包含個人 API 金鑰。請把它當作密碼看待，一旦外洩，就到**設定 → API 金鑰**輪替或撤銷它。請參閱 [API 金鑰](https://reverie.im/zh-TW/docs/integrations/api-keys)。

## 相關內容 \[#related]

* [角色快速入門](https://reverie.im/zh-TW/docs/characters/quick-start)
* [世界書](https://reverie.im/zh-TW/docs/writing/world-books)
* [進階設定](https://reverie.im/zh-TW/docs/characters/advanced-settings)
* [發布角色](https://reverie.im/zh-TW/docs/characters/publishing)
* [把你的角色一起帶過來 →](https://reverie.im/zh-TW/blog/bring-your-characters)