# 时间线

> 多条剧情线：卡片流排先后，刻度轴管年份时长，事件可挂在剧本的某一处并跳回去。

Source: https://loomworld.cn/docs/module-timeline

## 时间线是什么，在哪进入

时间线是剧本前期的手工整理板：帮你检查叙事先后、真实时间和相关对象，不会从剧本自动生成事件，也不会覆盖你排好的顺序。入口在左侧导航「时间线」，标题旁是事件总数，下面一行给出「剧情线 N」「已关联剧本 N」「时间点 / 时间段 N / N」。

一个项目可以有多条时间线，各自独立：剧情线、女主线、幕后线各排各的。每条线在首页就能直接编辑，没有单独的"专注编辑"分叉。

## 新增一条线：建的时候就把模式定了

点右上角「+ 新增剧情线」，弹窗里填名称（占位提示"例如：主线剧情"）并选渲染模式：

- 「卡片流 (顺序排布，可拖拽)」——只排先后。
- 「时间轴 (物理刻度，双轨道)」——管年份与时长；这条线落到卡片上会标成「刻度轴」。

一开始就在整理纪年，就直接建成时间轴，别建完再去设置里切。已有线也能在「设置 → 剧情线设置」里改名称、渲染模式、坐标轴起点与终点（留空即「自动」），以及删除剧情线。

一条线还没有内容时显示「暂无卡片。」或「暂无时间点或时间段。」；整个项目一条线都没有时，页面直接告诉你「目前还没有任何剧情线 / 点击右上角 + 新增剧情线 开始建立你的第一条线索。」

## 卡片流：只管先后

卡片按从左到右、从上到下的阅读顺序排列，宽度自适应、放不下就换行；拖卡片改顺序，顺序就是叙事先后。它不表达真实时间比例——"初遇"和"结盟"之间隔三个月还是三年，这里看不出来，也不该看出来。

新增入口按模式给：卡片流上是「+ 添加卡片」，不让你再在弹窗里二次选择类型。

## 刻度轴：管年份、时长和挤不挤

刻度轴用物理坐标：时间点落在轴上（圆点加胶囊），时间段落在轴下，左侧起始、中央名称、右侧结束，长度就是它的持续范围，刻度数字贴着主轴。

- 默认 100% 全览。有横向可看范围时：普通滚轮或触控板横移即前后平移，Shift + 滚轮围绕指针在 100%–600% 之间缩放，底部滑条同步显示位置。轴内滚到边缘或全览时，纵向滚轮交给页面继续往下滚，不会被轴吞掉。
- 拖动即调整：时间点吸附到整数坐标；时间段拖中间整体平移，拖左右两端分别改起止，最短保留 1 个整数单位。拖动过程中不落库，松手才保存最终位置——轻点仍然是打开事件详情。
- 时间段默认不是一段占一行：互不重叠的会尽量共用一行，只有横向真的重叠才往下分。你也可以把某段上下拖到别的行，落点仍会做避让校正，所以同一行里不会出现横向重叠。
- 双击轴上的空白直接新增：刻度轴上分「双击添加时间点」和「双击添加时间段」，新建的默认起止会被压回当前可视范围，避免出现「创建了但看不见」。

卡片高度按内容自适应，节点多时整张线往下长，不会被压在固定高度里。

## 挂在剧本的哪一处

卡片、时间点、时间段都可以选一个「发生位置」：章节、场次、时空或某个内容块（也可以「不关联剧本位置」）。时间线只保存引用，不复制剧本文字，事件详情里的「跳到剧本」会带你回到那一处继续写。

相关对象（人物、地点、道具、设定）单独记：选择器把已选对象置顶显示、带分类小标，四类默认折叠并在标题上给「已选 / 总数」，上方搜索框按名称和别称过滤——一多也不会把弹窗撑到看不完。描述里还可以用 @ 提及实体。

两者用途不同：相关对象是你确认过的关联，用于筛选、汇总和给 AI 当上下文；@ 只负责阅读时跳转。它们都不推断因果，也不替你算"谁在场"。

## 让智能体整理时间线

对话里说"把结盟排在第 3 章之后""给女主线补一条从流亡到重逢的骨架"，智能体会走确认卡：新建或修改剧情线（名称、颜色、模式、轴范围）、新建 / 修改 / 删除事件（所属线、标题、说明、发生位置、相关与关联对象、点段时间、关联场次地点）。

校验在 Runtime 里做硬：发生位置必须指向真实存在且层级一致的章 / 场 / 时空 / 内容块；时间段必须结束坐标大于起始坐标；删除一条线会级联删掉其中事件，确认卡上会写出将要删掉几个。整卡一次确认生效，确认后一次撤销撤回全部。「AI 自动整理整段时间线」不在这套能力里。

## 限制与排错

新增与编辑都会原地校验，不会静默失败：

- 「请先填写事件标题。」／「请先填写起始坐标。」／「请先填写结束坐标。」／「时间段的结束坐标需要大于起始坐标。」
- 在同一张确认卡里「新建一条剧情线 + 把新事件挂到这条新线上」目前不支持：线的标识要落库后才生成，请分两步走。
- 卡片流与刻度轴是同一批内容的两种视角，但两者几何互不换算：切换模式不会替你生成时间点，也不会把顺序变成时长。
- 时间线取消过专注编辑分叉，所有操作都在首页完成；不要去别处找编辑入口。
