# 結構化節點：描述、角色與對白

> 開啟類型選單、數字鍵選型、Enter 如何接續，以及賦形為什麼可以放心試。

Source: https://loomworld.ai/zh-tw/docs/editor-nodes

## 開啟類型選單

兩種開法，任選一種順手的：在任意正文行按 `Tab`；或在空白行行首輸入 `/`。選單是一排橫向的類型膠囊，從目前行的位置浮現。

選單開啟期間這一行會被設為唯讀——這是有意的設計：它確保你按下的數字落在選單裡，而不是掉進正文。不想選了按 `Esc`，或者接著打字即可收合。

## 選類型：數字鍵或滑鼠

選單順序固定，數字鍵 `1`–`9` 一一對應：1 描述、2 角色、3 對白、4 註解、5 動作、6 旁白、7 轉場、8 時空、9 場次。`↑``↓`（或 `Tab`）移動反白，`Enter` 確認。用滑鼠點擊也可以，只是數字鍵能維持在寫作節奏中。

九種語意裡最容易誤用的是「角色」：它只宣告「下一句台詞是誰說的」，不是「這個人在這一場出現過」。人物走進來、看著窗外、一句話不說——那是描述行。把角色行當成出場標記來用，出場統計就會失真。

## Enter 與上下鍵怎麼替你接續

- 角色行按 Enter → 自動新建一條屬於他的對白行；對白行按 Enter → 還是對白（台詞連著說不用重選）。
- 其餘任何類型按 Enter → 回到描述行。
- 動作是對白的插入語：合法的結構是「角色 →（若干動作）→ 一條以上對白」，動作行不能自己設立說話者。
- 註解會結束目前說話者——它是你寫給自己的話，不屬於對白結構。
- 純文字行在首行／末行時用 ↑ ↓ 跨到上一／下一個節點；場次與時空是多欄位節點，按 Enter 先在欄位之間前進，最後一個欄位按 Enter 才會新起一行。
- 場次內遇到空白行按 Enter 退出場次歸屬，之後的行不再計入這場；空白行按 Backspace 刪除並把焦點交回上一行。

## 每種節點帶著哪些可填欄位

賦形之後，不同節點能填寫的內容不同，搞清楚能填什麼，比反覆嘗試更有用：

- 內容區塊（描述／角色／對白／註解／動作／旁白／轉場）：正文本身、一句「本行意圖說明」；角色區塊還會關聯到具體人物，正文裡用方括號寫出的道具會被記錄在這一行上。
- 場次：地點（從地點庫選，或新寫一個名稱建卡）、時間（自由文字）、短標題、場次梗概，以及分條節拍——節拍是給後續擴寫散文用的依據。梗概分兩種來源：自動維護產生的可以重新整理，你手寫的內容不會被覆蓋。
- 時空：地點與時間、一句描述，以及劇內時間軸索引、標籤與備忘（把這場的位置掛到時間軸上）。時空的地點只能是本場主地點本身或其任意層級後代。
- 章節：標題、章節意圖和一個顏色。章號依章節目前順序衍生，不寫進標題裡，所以新增章節時標題留空、介面顯示「第 N 章」是正常的。

場次與時空是多欄位節點：按 Enter 先在欄位之間前進，最後一個欄位按 Enter 才會新起一行，所以你不用拿滑鼠點來點去。

## 賦形不改你的文字，也不覆蓋手動內容

更換類型只是給這一行換一個語意標記，寫下的字一個不動，所以可以隨手嘗試。真正會被更動的是結構歸屬：把某一行改成「場次」，之後的行就預設歸入這場戲；刪掉這個場次節點，這一場就會從結構中消失，其餘場次重新編號。

誤操作有兩條退路：復原走全應用程式統一的專案復原堆疊（`Cmd`/`Ctrl` + `Z`，最多 30 步，一秒內的連續輸入算作一步）；正文與結構在儲存時先寫本機再排隊同步，不會因為網路中斷而遺失已經寫下的字。

## 限制與排錯

- 選單只在正文行有效：在輸入框（角色卡、地點描述等）裡按 Tab 是原生行為，不會開啟類型選單。
- 舊的「評論」「括注」「字幕」三種類型已淘汰，讀取舊專案時也不做向下相容——這類內容現在只用註解、動作與旁白三種寫法表達。
- 多行選取後複製只會取得純文字，不會帶走節點類型與樣式；單個節點內的複製會保留你的精確選取範圍。
- 找不到某個類型：它可能在選單更右側，用 ← → 或繼續按數字鍵。

九種節點的完整語意與介面版面配置見 [劇本編輯器概覽](https://loomworld.ai/zh-tw/docs/editor-overview)。