# 剧本编辑器概览

> 九种带语义的行、Tab 与数字键赋形、四层结构、统一撤销，以及正文如何沉淀资料。

Source: https://loomworld.cn/docs/editor-overview

## 编辑器在织境中的位置

左侧导航「剧本」进入剧本页，这里是织境的主系统：资料模块、节奏页、时间线、伏笔与 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` 都会关闭菜单。

- **让回车替你接续**角色行回车后自动新建该角色的对话行；其余任何类型回车后回到描述行。场次内空行回车退出场次归属，空行退格删除并回退焦点。

赋形只改这一行的类型标记，不动你写下的文字，所以试错成本为零。跨行时纯文本节点的 `↑``↓` 会在首末行跳到上一 / 下一节点；场次与时空这类多字段节点，回车在字段间前进，最后字段回车才新起一行。

没有「+ 写一行」按钮：点底部空白新增基础内容行，空文档点纸面起首行。章节还空时编辑器挂一条只供输入的基础正文行，你开始输入才写进项目并形成隐式首场——不会出现页面上看得见、重开就丢的假保存。

## 四层结构与场次锚点

剧本自上而下是章节 → 场次 → 时空 → 内容块。场次节点填派生编号、地点、时间、短标题，渲染成一行大号粗体；编号不写进标题，只用于显示与定位。时空是场次内的小一号切换，只带可选的地点与时间，没有人物字段。章节意图挂在章节上，是这一章要推进什么的备忘。细节见 [章节、场次与时空](https://loomworld.cn/docs/editor-scenes)。

## 正文与资料的联动

三条通路是写作时自然发生的：「角色」行提交时按名字绑定或新建人物档案；正文里写 `[旧怀表]` 会把道具收进库里并把这行变成可点链接；场次与时空的地点输入提交后，会在本场主地点的子树里找同名地点，找到就复用、没找到就建一张子地点卡。反过来，描述行里提到一个名字不会自动连上档案——那是给读者的信息，不是你的认定。

选中一段文字后右键，菜单上半是改写 / 扩写 / 缩写 / 润色加一句补充要求，下半是「连接到…」，可搜索全项目的人物、地点、道具、设定、章节、场次、时空、正文行、时间线与伏笔。引用与联动的完整边界见 [实体引用与 @](https://loomworld.cn/docs/references) 与 [跨模块联动](https://loomworld.cn/docs/cross-sync)。

## 旧稿进来会发生什么

从项目大厅把 TXT / DOCX 选为「作为正式正文导入」时，正文按原文顺序本地解析成内容行，不调用模型改写，也不会替你建人物、地点或道具；中断后可以从游标继续，不重复插入。想让旧稿长出资料，就在写完之后再逐行赋形、逐段连接。

## 限制与排错

- 不是完整的排版引擎：织境不做字号、页边距、纸张规格那类终稿排版。交付时走「设置 → 项目数据 → 交付导出」的 Word / PDF / Quilldown 三种格式。
- 复制走纯文本：在剧本里拖选多行复制，剪贴板只有文字，不会带走节点类型和样式。
- 场次编号按剧本里的场次节点顺序重排；手动建的场次与剧本派生场次混排时，以剧本派生为准。
- 空字段在渲染态不占位；旁白是唯一的叙述类节点，不再有第二套相近的写法要维护。
