游戏叙事与剧情 / 系统课时

管理脚本变更与内容协作

管理脚本变更与内容协作

多人同时修改 Yarn 脚本时,真正危险的不是 Git 出现冲突提示,而是冲突被“顺手解决”后节点丢失、跳转指错或行 ID 被改坏。本节建立一套以小变更、可审查差异和合并后验证为核心的协作方式。

学习目标

  • 设计适合 Yarn 脚本的分支、提交和审查粒度,降低多人修改冲突。
  • 能在代码审查中识别节点、跳转、变量和 #line 相关的高风险改动。
  • 建立合并后的编译、分支走查与本地化更新检查。

让一次提交只表达一个内容意图

剧情脚本适合和代码一样进入版本控制,但提交粒度要比“今天写了很多对话”更清楚。一次提交最好只完成一个节点改写、一段分支新增或一次命名调整,避免把结构重构、本地化 ID 变化和大量文案润色混在一起。

文件也应按稳定边界拆分,例如按角色、场景或任务组织,而不是所有对话塞进单个巨大 .yarn 文件。拆分的目的不是追求文件数量,而是减少两个人频繁编辑同一片文本的概率。

下面的 Git 命令可用于提交前检查补丁是否包含空白错误;它不会验证 Yarn 语法,因此只能作为版本控制层的第一道检查。

bash
git diff --check

预期输出:补丁没有空白错误时命令不输出内容,并返回成功状态。

text
<无输出>

审查时优先看结构变化

对话脚本的审查不能只读台词是否顺畅。结构性修改会直接改变运行路径,因此应先看“图怎么变了”,再看“句子怎么写”。

审查时重点确认:节点 title 是否被重命名、所有跳转目标是否同步更新、条件分支是否仍覆盖预期路径、变量名称和类型是否被误改、用于本地化的 #line 是否被重复或无故替换。纯措辞修改则应尽量避免顺带改这些结构元素。

Yarn Spinner 脚本协作审查流程

解决冲突时不要只追求“能合并”

Yarn 文件是纯文本,Git 能指出同一段被多人修改,却不知道哪一条剧情逻辑才正确。出现冲突时,应先理解双方意图,再重建最终节点,不能简单选择“保留当前”或“保留传入”。

尤其要防止三类静默错误:一方新增的选项被删掉;节点标题保留了新名字但跳转仍指向旧名字;同一句话在冲突处理中被复制两次并带着相同 #line。这些问题未必在文本合并阶段暴露,却会在运行或本地化时造成异常。

合并后做两层验证

第一层是项目级验证:让 Yarn Project 重新导入或编译,处理所有语法错误、未解析引用和项目集成报错。第二层是内容级走查:从受影响节点的入口实际运行主要分支,至少覆盖新增选择、条件路径和跳转终点。

如果项目已经进入多语言阶段,源文改动合并后还要更新 strings 或对应字符串表,并检查哪些译文需要重新处理。不要等版本发布前才一次性同步,因为那会把“脚本变更”和“翻译变更”堆成难以审查的大批量差异。

用协作约定降低未来冲突

最有效的规则通常很少:节点和文件有明确负责人;重命名节点前先搜索所有引用;不要手工复用别人的 #line;结构重构与大规模润色分开提交;合并前看 diff,合并后跑受影响路径。

当这些规则成为固定流程后,Git 冲突只是可见的文本冲突,真正难发现的“丢节点、错跳转、错译文映射”才会显著减少。版本管理的目标不是留下更多提交,而是让每一次内容变化都能被理解、审查和验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理脚本变更与内容协作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通