# 中文短剧 Markdown 剧本格式

## 目录

1. 设计目标与事实所有权
2. 文件、集与场景结构
3. 动作、对白与生产标签
4. 注释与未知内容
5. 完整格式示例
6. 稳定 ID、临时索引与修订
7. 现有文本的规范化入口
8. 剧本中不应出现的内容
9. 完成前检查

## 1. 设计目标与事实所有权

`剧本.md` 要能在普通 Markdown 编辑器中直接阅读，同时让下游准确引用场景、动作、对白与生产要求。

- 它是场景边界、动作、对白和生产指令的**唯一可编辑剧本源**。
- 需要时生成的临时索引只帮助识别场景、标签和时长，不得反向改写正文，也不作为项目交付。
- 单集契约和节拍只在上下文中帮助写作，不另建卡片或节拍文件。
- 资产、分镜、图片/视频提示词与审查结论引用剧本，不在剧本中取得所有权。

规则权限：

- **`structural_invariant`**：标题语法、稳定 ID、受支持标签、来源范围与显式矛盾；校验器可阻断。
- **`reviewed_invariant`**：动作是否可表演、语义是否被规范化过程改变；审查者引用证据判断。
- **`craft_default`**：现在时、经济动作、可执行表演提示；可由创作者说明理由覆盖。
- **`taste_option`**：对白口语度、旁白、沉默、动作段落长短与风格化形式；只记录选择。

## 2. 文件、集与场景结构

### 2.1 集标题

```md
# EP001 【集名】
```

`EP001` 是稳定集 ID。修改集名不改 ID。

### 2.2 场景标题

```text
## <场景ID> <内|外|内外> · <地点> · <时间/天气>
```

示例：

```md
## EP001-SC003 内 · 渡口售票室 · 雨夜
```

- 场景 ID 在同一项目中唯一且稳定；
- “内/外/内外”说明主要行动空间；
- 地点使用创作者可识别名称，不写资产内部编号；
- 时间/天气只保留对表演、光线、行动或连续性有用的事实；
- 修改显示名称不改 ID；真正新建场景才分配新 ID；
- 拆分/合并后无法明确映射时，展示映射选择，不能静默猜测。

**`structural_invariant`**：生产场景必须有可解析的稳定场景 ID、空间性质、地点和时间/天气字段。

## 3. 动作、对白与生产标签

### 3.1 动作段落

普通段落表示现在发生、可见或可表演的行动：

```md
游森把湿透的末班票压在玻璃下，手指仍挡着日期。
```

写作要点：

- **`craft_default`**：使用现在时与可执行动词；焦点行动、信息或空间关系变化时另起段落。
- **`reviewed_invariant · SCR-03`**：关键心理/认知变化要有行为、证据、空间后果或有意声音作为载体。
- **`taste_option`**：完整动作链、氛围或推理可以保留较长段落，不按统一长度切分。
- **`craft_default · SCR-18`**：动作段落**不要以「短语＋全角冒号」开头**。
  `第二格：一只手把杯子推过去。` 与 `屏幕上正在放的东西：一段没有声音的录像。` 这样的写法
  和 3.2 的对白语法（`角色名：台词`）在字面上完全一样，索引器只能报
  `ambiguous_dialogue_or_action`，交回写作阶段判断。
  改法是把冒号换成破折号、逗号或一个动词：`第二格换成一只手把杯子推过去。`
  `屏幕上正在放的是一段没有声音的录像。` 句中冒号不受影响，需避免的是**行首短语后的冒号**。

不要在动作段落里写镜号、景别、镜头运动、焦段、生成参数或素材位。

### 3.2 对白

```text
角色名（可选的表演/策略提示）：台词
```

示例：

```md
葛晴（不让门外的人听见）：你卖的是明天的票。

游森：你先说，今天那班船去了哪里。
```

- 角色名与说话者必须明确；
- 建索引前由写作所有者确认本集说话者清单；工具只核对清单，不从冒号前缀猜人物；
- 提示描述一个可执行策略或变化，不堆叠同义情绪词；
- 台词跨段确有必要时保持说话者清楚；
- 现场不可见说话者使用 `[OS]`，非现场主观/叙述声音使用 `[VO]`。

**`reviewed_invariant · SCR-04`**：对白质量由议程、关系、潜台词与造成的变化判断，不由长度或比例判断。

### 3.3 生产标签

只在事实对故事不可省略时使用：

```md
[VO] 葛晴：我那时还不知道，票背面的孔不是验票留下的。
[OS] 船员：关窗，水进来了！
[SFX] 远处传来一声短促汽笛。
[画面文字] 票面日期：11月6日
[连续性] 游森把黄铜钥匙交到葛晴左手；下一场仍由葛晴持有。
[转场] 汽笛声延续到清晨的空码头。
```

标签含义：

| 标签 | 用途 | 不应用来做什么 |
|---|---|---|
| `[VO]` | 非现场主观/叙述声音 | 隐藏普通可见行动 |
| `[OS]` | 同一场景中的画外对白 | 代替明确说话者 |
| `[SFX]` | 改变注意、行动或信息的声音 | 罗列全部环境声 |
| `[画面文字]` | 观众必须读清的载体与精确内容 | 复制一般道具说明 |
| `[连续性]` | 易丢失且影响后续的状态变化 | 把整套人物设定贴入每场 |
| `[转场]` | 有叙事意义的转场要求 | 编写剪辑方案全集 |

**`structural_invariant · SCR-05`**：已存在的生产标签必须使用受支持、可闭合的语法，
来源引用可解析，标签类型与内容一致。校验器只证明已写标签的结构合法。

**`reviewed_invariant · SCR-07`**：审查者要对照剧情意义，检查必读文字、
VO/OS、改变行动/信息的关键声音、有叙事意义的转场与易丢连续性事实有没有
被遗漏。这是语义判断，不能由关键词扫描代替。

## 4. 注释与未知内容

Markdown 注释可以保存创作者的非生产备注：

```md
<!-- 待确认：渡口停运年份是否影响下一集时间线。 -->
```

- 注释原样保留；
- 临时索引把注释标记为非生产内容；
- 分镜覆盖不把注释当成必拍动作；
- 生产关键事实不能只藏在注释中；
- 未识别的 Markdown 原样保留并发出警告，不要擅自删除或“修复”。

**`structural_invariant`**：规范化映射必须报告每个未映射的原文范围，不能静默丢字节。
未映射内容是否影响生产，仍由审查者根据 `SCR-07` 判断。

## 5. 完整格式示例

以下为新写的格式示意，只展示语法与可见动作：

```md
# EP001 明天的末班票

## EP001-SC003 内 · 渡口售票室 · 雨夜

售票窗已经落锁。游森从退票口塞进一张湿透的船票，手指压住日期。

葛晴没有接票。她先把窗口旁的时刻牌翻到背面。

葛晴（不让门外的人听见）：末班船半小时前就停了。

游森：所以这张票不是今晚的。

葛晴抽出票角。票背面有两个新打的圆孔。

[画面文字] 票面日期：11月6日

[SFX] 河面传来一声汽笛。

游森回头看向已经熄灯的码头，把黄铜钥匙留在退票口。

游森：你要答案，就替我开那道门。

[连续性] 黄铜钥匙留在售票窗内侧，由葛晴取得。
```

它遵循：

- 压力在开场前已经发生；
- 信息通过票、日期、时刻牌与人物行动出现；
- 台词各自有议程；
- 关键文字、声音与持物交接有明确边界；
- 没有把摄影或提示词写进故事源。

## 6. 稳定 ID、临时索引与修订

需要机器辅助检查时，临时索引应记录：

- 块 ID 与类型（场景标题、动作、对白、生产标签、注释等）；
- 源文件范围与内容哈希；
- 所属集/场景；
- 上一版本映射与置信状态；
- 生产标签类型；
- 未映射或歧义说明。

临时索引不得：

- 自动润色或规范化创作者文字；
- 把显示名称变成另一份权威角色/资产事实；
- 在拆分/合并歧义时重用错误块 ID；
- 把注释当成生产动作；
- 反向覆盖当前 `剧本.md`。

邻近文字修改且语义块映射明确时保留块身份。段落拆分、合并或整场重写无法确定时，提出显式重映射选择。

## 7. 现有文本的规范化入口

创作者提供其他格式时：

1. 将原始字节保存为 `输入/original-script.<ext>`；
2. 记录原编码与来源说明；
3. 只提议场景标题、动作/对白边界、支持标签与索引所需的最小变化；
4. 展示原文和规范化预览；
5. 分开报告语义新增、删除、改写、未映射范围与低置信映射；
6. 让创作者选择接受、修订或取消；
7. 确认后才更新 `剧本.md`；索引若用于检查，只写临时目录。

**`structural_invariant`**：取消或拒绝不改变规范剧本；接受前不得把预览当成权威源。

**`reviewed_invariant`**：改变说话者、行动先后、事实、因果、态度或未说内容都属于语义变化，即使句子看似只被“整理”。

规范化入口不需要创作简报、故事引擎或新增节拍，也不得为了字段完整补造剧情。

## 8. 剧本中不应出现的内容

- 人物、场景、道具的完整资产说明；
- 镜头表、景别、镜头运动或关键帧构图；
- 图片/视频提示词和生成参数；
- 模型、任务或接口字段；
- 审查结论和内部流程状态；
- 原始参考材料位置；
- 用统一数量、比例或篇幅冒充创作规律的说明。

故事真相留在剧本，其他所有者通过场景 ID、支持标签和必要短引文引用。

## 9. 完成前检查

### 可机械确认

- **`structural_invariant`**：集/场景 ID 唯一、标题可解析、受支持标签闭合、可见引用可解析；
- **`structural_invariant`**：明示的进入、退出与连续性事实不存在可机械证明的矛盾；
- **`structural_invariant`**：未知 Markdown 和注释被保留，未映射范围已报告；
- **`structural_invariant`**：`剧本.md` 仍是唯一可编辑剧本源。

### 需要审查

- **`reviewed_invariant`**：关键心理意义有可表演载体；
- **`reviewed_invariant`**：剧本交接与已确认分集规划或上下文中的单集契约一致；
- **`reviewed_invariant · SCR-01`**：冲突场景有议程、反对、转向与退出，其他场景完成必要的知识、关系、压力、节奏或生产状态变化；
- **`reviewed_invariant`**：规范化没有隐藏语义变化。

### 创作者选择

- **`craft_default`**：动作经济、现在时、生产事实不过度标记；可说明理由覆盖；
- **`taste_option`**：旁白、沉默、语言风格、场景疏密和动作段落长度被保留。

写作所有者可做以上检查与修订；需要 verdict 时另起审查动作。未参与写作的 reviewer 更能
减少自证偏差，但诚实标注的自检也可记录任何有证据支持的结论。