叙事地图以流程图显示项目中的章节、Fragment、分支、条件和变量关系。
界面布局
叙事地图分为左右两栏：
- 左栏：数据面板，包含「变量管理」和「分支选项」两个子页签
- 右栏：流程图，始终可见，展示整个项目的叙事结构
流程图
流程图先显示线性章节主干，再按引用关系展开 Fragment 和逻辑节点：
| 优先级 | 节点类型 | 说明 |
|---|
| 主干 | 章节 | 项目中的每个章节始终按剧本顺序在同一条水平轴上展开，不再折叠换行 |
| 骨架 | Fragment | 章节内被跳转、调用或条件引用的片段 |
| 细节 | 分支 / 条件 | 附着在它所在的章节或 Fragment 下，并连接目标 Fragment |
- 主干线：连接章节之间的顺序关系
- 结构线 / 章节归属：章节或 Fragment 与内部逻辑节点、未引用 Fragment 的归属关系
- 选项跳转 / 条件跳转：分支和条件指向目标 Fragment 的跳转
- 调用片段：调用 Fragment 后返回原执行位置的关系
- 变量读写：变量在不同位置的写入和读取之间的因果关系
操作方式：
- 拖动鼠标平移，滚轮缩放
- 按 F 使全部节点适应视图
- 点击右下角「默认」清除手动布局
- 将鼠标移到节点上，点击打开图标跳转到对应剧本位置
- 使用右上角图例查看连线含义
因果追踪
在左栏选中变量或分支选项后，流程图会高亮相关节点和连线，并标注变量的写入与读取位置。
例如，选择变量 好感度 后会显示：
- 所有写入
好感度 的节点（哪些分支选项会改变好感度）
- 所有读取
好感度 的节点（哪些条件判断依赖好感度）
- 它们之间的因果连线
可据此检查变量的影响范围、未连接分支和无出口路径。
变量管理
左栏的「变量管理」页签是项目中所有变量的管理中心。
变量类型
| 类型 | 说明 |
|---|
| 布尔 | true / false，适合开关类状态（是否触发过某事件） |
| 数值 | 整数或小数，适合计数类数据（好感度、金币） |
| 文本 | 字符串，适合存储名字、称呼等文本信息 |
变量作用域
| 作用域 | 说明 |
|---|
| 项目变量 | 你自己定义的变量，用于剧情逻辑 |
| 系统变量 | 引擎自动注入的变量，比如当前章节名、游戏时长等 |
变量持久化
变量的持久化方式决定了它在存档中的行为：
- 存档绑定（Slot）：变量的值跟随存档，读档后恢复到存档时的状态。大部分剧情变量应该用这种模式
- 全局共享（Shared）：变量的值在所有存档之间共享，不会因为读档而回滚。适合跨周目的解锁状态、成就等
管理功能
变量管理表格显示每个变量的名称、显示名、用途说明、默认值和引用计数（被多少个块使用）。你可以直接在表格中编辑变量信息、新增变量，也可以展开引用详情查看某个变量在哪些块中被使用。
显示名与变量名
- 变量名是表达式、剧本和扩展代码使用的稳定键。
- 显示名用于 Studio 界面中展示更容易理解的中文或业务名称，不改变运行时键。
自建变量支持重命名变量名。确认后，Studio 会扫描并迁移剧本 Block、分支条件、可视化界面绑定、角色显示名和其它已知引用，并创建项目历史快照。
重命名前可以展开引用详情检查影响范围。系统变量只读，不能重命名；扩展代码中自行拼接的字符串引用无法可靠识别，需要手动检查。
变量重命名会影响整个项目。迁移完成后，从主要分支入口运行预览，并检查自定义扩展代码和通过字符串路径读取变量的位置。
分支选项
左栏的「分支选项」页签以树形结构展示项目中所有的 分支块。
- 按章节视图：分支按所属章节分组，展开后显示每个分支的选项（标记为 A、B、C…）
- 平铺视图：所有分支不分组，直接列出
选中分支或选项后，流程图会高亮对应节点、跳转关系和目标 Fragment。 
