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

编辑器里怎样阻止坏数据保存

编辑器里怎样阻止坏数据保存

剧情编辑器真正危险的不是“填错一个字段”,而是错误数据成功进入资源库,直到运行时才暴露。本课把必填、类型、引用和范围校验放到保存入口前,建立一套能明确指出错误位置、并且真正阻止落盘的数据门禁。

学习目标

  • 区分必填、类型、引用和范围四类编辑期校验
  • 实现一个可复用的保存前验证器,并输出可定位的错误信息
  • 理解为什么校验失败必须阻断保存,而不能只弹出警告

保存动作应该先经过数据门禁

编辑器里的“保存”不应直接把当前表单序列化到磁盘或数据库。更稳妥的路径是:先把编辑状态整理成结构化对象,再依次执行字段规则、跨对象引用和业务范围检查;只要存在错误,就返回错误列表并终止写入。

剧情数据保存前校验流程

四类检查承担的职责不同。必填检查回答字段是否缺失;类型检查确认数据形态是否符合节点定义;引用检查确认目标节点、任务或角色确实存在;范围检查处理持续时间、概率、优先级等虽然类型正确但数值不合法的情况。

用统一验证器收集所有错误

下面的示例使用普通 JavaScript 表示一份剧情资源。验证器不会遇到第一个错误就立即退出,而是尽量收集本次数据中的全部问题,让策划一次修改完成。

js
function validateStory(story) {
  const errors = [];

  if (!story || typeof story !== "object") {
    return ["story: 必须是对象"];
  }

  if (!Array.isArray(story.nodes)) {
    return ["nodes: 必须是数组"];
  }

  const nodeIds = new Set();
  for (const [index, node] of story.nodes.entries()) {
    if (!node.id || typeof node.id !== "string") {
      errors.push(`nodes[${index}].id: 必填且必须为字符串`);
      continue;
    }
    if (nodeIds.has(node.id)) {
      errors.push(`nodes[${index}].id: 重复节点 ${node.id}`);
    }
    nodeIds.add(node.id);
  }

  for (const [index, node] of story.nodes.entries()) {
    if (node.type === "dialogue") {
      if (!node.speaker || typeof node.speaker !== "string") {
        errors.push(`nodes[${index}].speaker: dialogue 节点必须填写说话人`);
      }
      if (!node.text || typeof node.text !== "string") {
        errors.push(`nodes[${index}].text: dialogue 节点必须填写文本`);
      }
    }

    if (node.type === "choice" && !Array.isArray(node.options)) {
      errors.push(`nodes[${index}].options: choice 节点必须使用数组`);
    }

    if (node.next && !nodeIds.has(node.next)) {
      errors.push(`nodes[${index}].next: 引用不存在的节点 ${node.next}`);
    }

    if (node.duration !== undefined &&
        (!Number.isFinite(node.duration) || node.duration < 1 || node.duration > 30)) {
      errors.push(`nodes[${index}].duration: 应为 1 到 30 之间的数字`);
    }
  }

  if (story.entry && !nodeIds.has(story.entry)) {
    errors.push(`entry: 引用不存在的入口节点 ${story.entry}`);
  }

  return errors;
}

const story = {
  entry: "start",
  nodes: [
    {
      id: "start",
      type: "dialogue",
      speaker: "",
      text: "进入港口。",
      next: "missing-node",
      duration: 0
    },
    {
      id: "choice-1",
      type: "choice",
      options: "go-left"
    }
  ]
};

const errors = validateStory(story);
if (errors.length > 0) {
  console.log("保存被阻止:");
  for (const error of errors) console.log(`- ${error}`);
} else {
  console.log("校验通过,可以保存");
}

保存为 validate-story.js 后执行 node validate-story.js,预期输出如下:

text
保存被阻止:
- nodes[0].speaker: dialogue 节点必须填写说话人
- nodes[0].next: 引用不存在的节点 missing-node
- nodes[0].duration: 应为 1 到 30 之间的数字
- nodes[1].options: choice 节点必须使用数组

这里先建立全部节点 ID 的集合,再检查 next,可以避免“目标节点写在文件后面就误报不存在”的问题。实际项目中角色 ID、任务 ID、道具 ID 也应采用类似的索引方式,而不是依赖编辑器当前打开了哪些对象。

保存入口必须只接受已通过的数据

验证函数负责发现问题,保存入口负责执行策略。两者最好分开:验证器可以被表单即时提示、批量检查和 CI 工具复用;真正写资源的函数则坚持一个规则——错误列表非空就不写入。

片段示例,下面的 persistStory 代表项目已有的存储实现:

js
async function saveStory(story, persistStory) {
  const errors = validateStory(story);
  if (errors.length > 0) {
    return { saved: false, errors };
  }

  await persistStory(story);
  return { saved: true, errors: [] };
}

这段代码依赖前面的 validateStory 和项目提供的 persistStory,因此属于片段示例。生效行为是:验证失败时 persistStory 永远不会被调用;验证通过后才进入真实写入流程。验证时可以给 persistStory 注入一个记录调用次数的测试替身,确认坏数据下调用次数保持为 0。

错误信息要能直接定位到编辑位置

“数据不合法”这样的提示对内容生产几乎没有帮助。错误至少要携带字段路径,例如 nodes[3].next,编辑器才能进一步把它映射到节点和输入控件。大型项目还可以给规则配置稳定的错误码,但不要牺牲给策划看的自然语言说明。

引用校验还要区分“允许暂时为空”和“填写后必须存在”。例如可选的后继节点为空可能完全合法,但一旦填写了 next,保存时就必须确认目标存在。类似地,范围规则应来自真实业务约束,而不是随意给每个数字字段设置上下限。

哪些问题应该阻断保存

会导致运行时无法解析、跳转到不存在内容、数据类型不匹配或违反明确业务约束的问题,应作为错误阻断保存。命名风格、文本长度建议、未填写备注等不影响运行正确性的规则,更适合做警告,否则编辑器会因为过度严格而妨碍正常生产。

最终应形成两层体验:输入过程中尽早提示,保存入口再次执行完整校验。前者帮助策划快速修改,后者保证任何进入资源库的数据都满足最低运行条件,这才是真正可靠的编辑阶段数据门禁。

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

目录与阅读设置

阅读设置

17

记录一个想法

编辑器里怎样阻止坏数据保存

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

登录哪都通