# 註解、動作、轉場與旁白

> 四類輔助節點分別在管什麼，以及每行的意圖說明給誰看。

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

## 四類輔助節點在分什麼

動作、轉場、旁白與註解都不是台詞，它們各自管一件事：舞台上發生了什麼、場景怎麼切換、誰在敘述、以及哪句話是寫給自己看的。釐清之後，編輯器能依類型呈現，AI 能把「台詞」和「動作」分開處理，匯出或回顧時也不用再靠縮排去猜。

## 動作：與台詞並行，或在描述裡寫

動作行（數字鍵 5）用於台詞進行中同時發生的舞台動作：角色一邊說一邊起身、把信推過桌面。它依附在對話結構裡，不能自己設立說話者——先有角色行，動作行才有歸屬。

如果這一段只有動作沒有台詞，用描述行更清楚：那是整場戲的敘述，不是某句話的插入語。

## 轉場：把場景之間的切換寫出來

轉場行（數字鍵 7）標記場景之間的切換——淡入、黑畫面、跳切、時間過去三年。它是結構提示，不是排版裝飾：寫在兩個場次之間，讀者（和 AI）就知道這裡要停頓切換，而不是上一場還沒結束。

## 旁白：敘述者的聲音

旁白（數字鍵 6）屬於敘述者或畫外音，與角色台詞分開。產品裡只有這一種敘述節點：舊的「字幕」類型已經淘汰，讀取舊專案時也不會自動當成旁白，所以你不必維護兩套相近的寫法。

## 註解：只給自己看

註解（數字鍵 4）是寫給自己的備忘：「這裡的動機後文要解釋」「等設定確認後再改」。它不屬於對白結構，會讓目前說話者結束——這一點比「是個便條紙」更重要，別把台詞拆進註解裡。

註解屬於正文內容的一部分，會跟著專案一起儲存與匯出。交付前要不要保留，由你決定。

## 行內意圖：給 AI 的一句話

除類型之外，每一行還能記一句本行意圖說明——它不是給讀者看的正文，而是告訴後續的協作方「這一行要幹什麼」。續寫、節拍擴寫和巡檢都會讀取它，所以給關鍵節點留一句，比事後在對話中重新解釋更省事。

章節、場次、時空三層也各自有自己的說明文字（章節意圖／場次梗概／時空描述），它們與行內意圖互不替代。三層同顯與「待寫／待整理」的提示見 [章節隨航](https://loomworld.ai/zh-tw/docs/chapter-companion)。

## 四類怎麼選：四個判斷題

- 只有動作、沒有台詞？用描述行。動作行是給某句話做插入語的，沒有說話人就無所謂插入。
- 場景之間中斷，還是在同一場裡切換時間地點？中斷用轉場，場內切換用時空節點。
- 這句話是角色說的，還是敘述者說的？角色說的上方必須有一條角色行認領說話人；敘述者或畫外音用旁白。
- 這句話是給誰看的？寫給自己的備忘用註解；寫給協作者和 AI 的「這一行要幹什麼」用行內意圖說明。

判定清楚了，後續的效益是自動的：依類型呈現、依類型統計出場、AI 依類型區分台詞與舞台指示，匯出時也各得其所。

## 限制與排錯

- 輔助節點不會被自動辨識或自動補齊：織境不猜哪一句是動作，也不替你寫轉場。
- 台詞沒掛上說話者時，先檢查它上方是否有角色行——對白必須屬於一個明確的說話者。
- 類型只改語意，不改變文字；改錯了重新按一次 Tab 選回描述即可。