角色：對白長出來的演員表，加上你寫的角色檔

一句話：這篇說明劇本裡的角色現在住在哪裡——演員表是從你打的對白自己長出來的，角色設定則是你自己寫的 .md 檔，兩邊靠名字對上。

角色聖經沒有了，那個工作換了兩個地方做

以前劇本工作室有一個「角色聖經」分頁：一份角色清單、一個出場矩陣、五種角色定位、四種範圍篩選。這些東西在 .script 檔裡都不存在。舊的劇本工作室作品要是還開得起來，那個「角色聖經」分頁與出場矩陣還是原樣——它們只是不會跟著轉換過來而已。

它原本承擔的其實是兩件不同的事，4.0 把它們分開：

差別不只是搬家。舊模型裡「角色」是一筆你要先建立的資料，打對白之前得先去建檔（雖然它會偷偷幫你建）；新模型裡你打進劇本的名字就是角色，不存在「還沒建檔的角色」這種狀態。

演員表：你打了誰，誰就在上面

Slima 會掃這本書裡所有 .script 檔的角色行，把名字收成一份全書演員表，按對白行數排序，同分的看出場場次。你改一句台詞、加一個人名，下一秒名單就跟著變——它沒有另一份快照要跟你的稿子對帳。

這份名單會在四個地方出現：

1. 打角色行時的自動完成下拉。 這一場已經出現過的人排在前面，分隔線之後才是其他人，每個名字後面標「N 行 M 場」。查無完全相符時最後一項是「建立新角色「阿棠」」——按下去只是把名字寫進劇本，不會建立任何檔案。兩段都按對白行數多的排前面，而後面標的數字是全書的，不是這一場的。
2. 斜線指令面板（空行打 /）。分三組：先是五種元素型別與它們的快捷鍵（台式只有四種，因為台式沒有表演指示），接著是快速插入——這本書用得最多的五個角色與五個地點，最後是「新場景」與 /note。選一個地點就等於改場景標題。角色那半用的是同一份名單。
3. 大綱面板（Ctrl + Shift + O）。打開 .script 時它有三個模式：場景 / 角色 / 地點。切到「角色」會把這一集的場景按角色分組，展開就看到某個人出現在哪幾場。
4. 配音 →「角色配音」：切到預覽之後，工具列上才會有這顆鈕——它只在預覽裡出現，而要幫每個角色配一個聲音，本來也是在預覽時才會想做的事。清單也是這一份。

每一場的出場名單

.script 的看板檢視（工具列的「看板」）是一列可拖曳的場次卡。每張卡上有一排角色膠囊，那就是這一場的出場名單：

• 實心的是從這場戲的文字自動偵測出來的——滑過去會寫「從這場戲的文字自動偵測（改台詞會自動更新）」。
• 虛線的是你手動加的：文字沒提到但人在場（在旁邊聽、在門外、屍體）。按「角色」那顆鈕加。
• 每一顆右邊都有一個 ×。按下去是「從名單剔除」，不會動到你的台詞——它只記下「這個名字在這一場別算」。誤判的自動偵測就是這樣修掉的；之後再手動加回來，剔除就解除了。

所以名單是「偵測 ∪ 手動加入 − 手動剔除」。偵測那一半永遠跟著你的文字走，你手動下的判斷則不會因為改字而過期。

角色檔：什麼值得寫進去

演員表只知道名字、行數、場次。想寫「他要什麼、他缺什麼」，就自己開一個檔：建一個 角色/ 資料夾，在它上面按右鍵 →「新增檔案」，檔名就是角色的名字（沈硯.md）。示範書《墨潮（劇本）》裡這個資料夾本來就在：那本書繼承了小說版整個資料架，所以 角色/ 一開始就有八個檔，一個角色一個，旁邊還有 地點/ 與 世界觀/。小說版《墨潮》是同樣那八個。

檔名跟劇本裡的名字對上之後，劇本裡那個名字底下會出現虛線，Ctrl（macOS 是 ⌘）+ 點一下就直接開那個檔。地點也是同一套：場景標題的地點欄位命中同名 .md 就掛虛線。查不到同名檔就不掛，不會給你一顆按了沒反應的死連結。

至於檔案裡寫什麼，這是舊角色聖經留下來最值得帶走的部分——它的欄位設計本身是好的編劇提示：

寫這個	因為
想要（外在目標）	他自己以為在追的東西。台詞會為它服務。
需要（內在缺口）	他真正缺的。通常他講不出來，而故事會逼他面對。
能力 / 缺陷	主角的缺陷通常就是「需要」的根源，也是他會失敗的原因。
背景	過去、家族、那件把他變成今天這樣的事。不必一次寫完。
代表台詞	幾句最像他的話。要對白聽起來是同一個人，這一段比任何形容詞有用。

小說版《墨潮》的 角色/沈硯.md 就是這個形狀：**想要（Want）**是「查清父親流放後的下落」，**需要（Need）**是「承認自己就是喚字人，不再替父親的罪道歉」——底下還有外貌、性格、缺陷、能力與十二章的弧線。

改名、刪除，跟以前不一樣

改名沒有全域連動。 舊角色聖經改一個名字，劇本裡的對白會跟著換，像 wikilink 一樣。新模型裡名字就是身分，改一行只改那一行。要換掉整本書的一個名字，用尋找與取代。

刪除也不再有連鎖反應。 舊的刪角色是硬刪除，會把劇本裡引用它的地方一起解開；現在角色檔就是一個檔案，丟進垃圾桶就好（垃圾桶與還原），劇本一個字都不會變。要讓一個角色從演員表上消失，只有一條路：把他的台詞從劇本裡拿掉。

「角色範本」已經沒有入口了。 它是一組自訂欄位的模板，用來一鍵套到別的角色；在既有的 .character 檔裡它其實還能用，只是現在已經建不出新的 .character 檔，所以實際上不會再遇到它。現在角色檔是 .md，要重複同一套結構就複製一份既有的檔案改寫。

出場矩陣：誠實地說，它沒有替代品

舊的出場矩陣是一張「角色 × 集數」的格子表，一眼看得出主角哪一集消失了、反派從第幾集才出現。.script 檔沒有這張表——它在舊的劇本工作室裡，舊作品打開來還看得到。.script 這邊有的是它的碎片：

• 角色行左邊那顆放大鏡（「查看角色資料」）開出來的小卡：寫著「出場 N 場 · 對白 N 行」，底下是逐集分佈的長條——最接近矩陣的那一列。
• 全書演員表按對白行數排序，誰是主角、誰只有兩句，順序上看得出來。
• 大綱面板的「角色」模式：單一集內的角色 → 場景分組。它不跨集。

真的需要那張表的話，目前只能自己維護——譬如在 .beats 節拍表上一集一張檔案卡，或在企劃資料夾裡放一份表格 .md。我們知道這是退步，寫在這裡是為了讓你不必花時間找一個不存在的分頁。

相關

• Docs：對白與角色自動補完
• Docs：場景標題：內景 / 外景與地點
• Docs：打開一個劇本檔會看到什麼
• Docs：AI 怎麼幫你改劇本
• Docs：檔案樹總覽
• Docs：稿件與參考資料
• Docs：關係圖：把角色關係畫出來
• Docs：舊的劇本工作室：現在還能做什麼