# 注释、动作、转场与旁白

> 四类辅助节点分别在管什么，以及每行的意图说明给谁看。

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

## 四类辅助节点在分什么

动作、转场、旁白与注释都不是台词，它们各管一件事：舞台上发生了什么、场景怎么切、谁在叙述、以及哪句话是说给你自己看的。分清之后，编辑器能按类型渲染，AI 能把"台词"和"动作"分开处理，导出或回看时也不用再靠缩进猜。

## 动作：与台词并行，或在描述里写

动作行（数字键 5）用于台词进行中同时发生的舞台动作：角色一边说一边起身、把信推过桌面。它依附在对话结构里，不能自己立一个说话者——先有角色行，动作行才有归属。

如果这一段只有动作没有台词，用描述行更清楚：那是一场戏的叙述，不是某句话的插入语。

## 转场：把场景之间的切换写出来

转场行（数字键 7）标记场景之间的切换——淡入、黑场、跳切、时间过去三年。它是结构提示，不是排版装饰：写在两个场次之间，读者（和 AI）就知道这里要断一下，而不是上一场还没完。

## 旁白：叙述者的声音

旁白（数字键 6）属于叙述者或画外音，与角色台词分开。产品里只有这一种叙述节点：旧的「字幕」类型已经退出，读取旧项目时也不会自动当成旁白，所以你不必维护两套相近的写法。

## 注释：只给你自己看

注释（数字键 4）是写给自己的备忘："这里的动机后文要解释""等设定确认后再改"。它不属于对白结构，会让当前说话者结束——这点比"是个便签"更重要，别把台词拆进注释里。

注释属于正文内容的一部分，会跟着项目一起保存与导出。交付前要不要留，由你决定。

## 行内意图：给 AI 的一句话

除类型之外，每一行还能记一句本行意图说明——它不是给读者看的正文，是告诉后面的协作方"这一行要干什么"。续写、节拍扩写和巡检都会读它，所以给关键节点留一句，比事后在对话里重新解释省事。

章节、场次、时空三层也各有自己的说明文字（章节意图 / 场次梗概 / 时空描述），它们与行内意图互不替代。三层同显与"待写 / 待整理"的提示见 [章节随航](https://loomworld.cn/docs/chapter-companion)。

## 四类怎么选：四个判断题

- 只有动作、没有台词？用描述行。动作行是给某句话做插入语的，没有说话人就无所谓插入。
- 场景之间断开，还是同一场里换了时间地点？断开用转场，场内切换用时空节点。
- 这句话是角色说的，还是叙述者说的？角色说的必须上面有一条角色行认领说话人；叙述者或画外音用旁白。
- 这句话是给谁看的？写给自己的备忘用注释；写给协作者和 AI 的「这一行要干什么」用行内意图说明。

判别清楚了，后面的收益是自动的：按类型渲染、按类型统计出场、AI 按类型区分台词与舞台说明，导出时也各归各处。

## 限制与排错

- 辅助节点不会被自动识别或自动补齐：织境不猜哪一句是动作，也不替你写转场。
- 台词没挂上说话者时，先检查它上面是否有角色行——对话必须属于一个明确的说话者。
- 类型只改语义，不改变文字；改错了重新按一次 Tab 选回描述即可。