# 劇本編輯器概覽

> 九種帶語意的行、Tab 與數字鍵賦形、四層結構、統一復原，以及正文如何沉澱資料。

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

## 編輯器在織境中的位置

左側導覽「劇本」進入劇本頁，這裡是織境的主系統：資料模組、節奏頁、時間軸、伏筆與 AI 協作都圍繞正文運轉。正文記錄實際寫下的戲，資料庫記錄你明確維護的設定；兩邊靠引用和結構關係連接，但不會彼此擅自改寫。

畫面分三塊：中間是正文紙面，頂部一條章節橫條顯示目前章節名稱、左右翻頁和全域統計（場次／人物／地點／道具）；右側常駐「隨航」面板，是章節—場次—時空的進度地圖；最左側是可收合的應用程式導覽。AI 不常駐右欄，需要時從右鍵選單或左側 AI 代理聊天框進入。

## 九種結構化節點

正文不是一整塊純文字，而是九種帶語意的行。類型選單按順序編號，用數字鍵 `1`–`9` 直接選取：

- 1 描述：場景敘述與普通正文，也是沒有任何屬性時的基礎內容行。
- 2 角色：緊接著的台詞的說話者。它只回答「這句話是誰說的」，不是人物出場標記——人只是走進來、觀察、沉默或被描述時，請寫描述行。
- 3 對白：角色的台詞。合法結構是角色行 →（可選若干動作行）→ 一條或多條對白行。
- 4 註解：只給自己看的備忘，會結束目前說話者，不屬於對白結構。
- 5 動作：與台詞並行發生的舞台動作，不能自己建立說話者。
- 6 旁白：敘述者的聲音。
- 7 轉場：場景之間的切換標記。
- 8 時空：場次內的地點或時間切換，可只填時間。
- 9 場次：一場戲的錨點，開啟後後續行預設歸屬它。

渲染與編輯的切換很安靜：每行依屬性渲染成樣式文字（無表單框），點一下才進入編輯狀態，失焦回到渲染。復原與重做走全應用程式統一的專案復原堆疊（`Cmd`/`Ctrl` + `Z` 復原、加 `Shift` 或 `Ctrl` + `Y` 重做，最多 30 步整份專案快照）；連續打字在一秒內算一步，停頓即斷步，所以誤刪一段通常按一次就找回來。

## 快速賦形：Tab、斜線與數字鍵

寫作節奏不該被排版打斷，織境把賦形做成肌肉記憶：

- **開啟類型選單**在正文行按 `Tab`；空行行首輸入 `/` 也可以。選單開啟期間編輯器唯讀，數字不會漏進正文。

- **選類型**用 `↑``↓` 移動醒目標示，或直接按 `1`–`9`；`Enter`、`Tab`、`Esc` 都會關閉選單。

- **讓 Enter 替你接續**角色行按 Enter 後自動新建該角色的對白行；其餘任何類型按 Enter 後回到描述行。場次內空行按 Enter 退出場次歸屬，空行退格刪除並退回焦點。

賦形只改這一行的類型標記，不動你寫下的文字，所以試錯成本為零。跨行時純文字節點的 `↑``↓` 會在首末行跳到上一／下一節點；場次與時空這類多欄位節點，按 Enter 在欄位間前進，最後欄位按 Enter 才另起一行。

沒有「+ 寫一行」按鈕：點擊底部空白新增基礎內容行，空文件點擊紙面起首行。章節尚空時編輯器保留一條只供輸入的基礎正文行，你開始輸入才寫進專案並形成隱式首場——不會出現頁面上看得見、重新開啟就遺失的假儲存。

## 四層結構與場次錨點

劇本自上而下是章節 → 場次 → 時空 → 內容區塊。場次節點填寫衍生編號、地點、時間、短標題，渲染成一行大號粗體；編號不寫進標題，只用於顯示與定位。時空是場次內的小一號切換，只帶可選的地點與時間，沒有人物欄位。章節意圖掛在章節上，是這一章要推進什麼的備忘。細節見 [章節、場次與時空](https://loomworld.ai/zh-tw/docs/editor-scenes)。

## 正文與資料的連動

三條途徑是寫作時自然發生的：「角色」行送出時依名字綁定或建立人物檔案；正文裡寫 `[舊懷錶]` 會把道具收進資料庫裡並把這行變成可點擊連結；場次與時空的地點輸入送出後，會在本場主地點的子樹裡找同名地點，找到就沿用、沒找到就建一張子地點卡。反過來，描述行裡提到一個名字不會自動連上檔案——那是給讀者的資訊，不是你的認定。

選取一段文字後按右鍵，選單上半部是改寫／擴寫／縮寫／潤飾加一句補充要求，下半部是「連接到…」，可搜尋全專案的人物、地點、道具、設定、章節、場次、時空、正文行、時間軸與伏筆。引用與連動的完整邊界見 [實體引用與 @](https://loomworld.ai/zh-tw/docs/references) 與 [跨模組連動](https://loomworld.ai/zh-tw/docs/cross-sync)。

## 舊稿進來會發生什麼

從專案大廳把 TXT / DOCX 選為「作為正式正文匯入」時，正文依原文順序在本機解析成內容行，不呼叫模型改寫，也不會替你建立人物、地點或道具；中斷後可以從游標繼續，不重複插入。想讓舊稿長出資料，就在寫完之後再逐行賦形、逐段連接。

## 限制與排錯

- 不是完整的排版引擎：織境不做字級、頁面邊距、紙張規格那類完稿排版。交付時走「設定 → 專案資料 → 交付匯出」的 Word / PDF / 純文字 TXT 三種格式。
- 複製走純文字：在劇本裡選取多行複製，剪貼簿只有文字，不會帶走節點類型和樣式。
- 場次編號依劇本裡的場次節點順序重排；手動建立的場次與劇本衍生場次混排時，以劇本衍生為準。
- 空欄位在渲染狀態不佔位；旁白是唯一的敘述類節點，不再有第二套相近的寫法要維護。