测试与调试 » 自动化校验
March 13, 2026

自动化校验

进行中

本指南仍在扩展和完善中。功能、截图和说明可能会在 Talescape 正式发布前发生变化。若有疑问或需要帮助,请在 官方 Talescape Discord 提问。我们会根据需要澄清或更新页面。

编辑器校验系统 帮助你确认故事是否完整、一致并准备好发布。它会自动扫描故事中常见的问题(从缺失资源到不完整的元数据),并提供详细的修复建议。

这些相同的校验也会在发布前运行的自动审核中使用。在编辑器内运行它们可以让你及早解决问题,避免在发布阶段被拒。

1. 运行校验

你可以通过两种方式触发校验:

范围 描述
全局校验(概览) 运行针对整个故事的所有可用验证。在侧边栏的 校验 面板中可访问。
局部校验(针对元素) 仅运行当前正在编辑的元素的验证,例如特定章节、场景或对话。

结果会立即显示并按类别分组(例如:市场、章节、场景、角色)。你可以随时点击 运行校验 重新执行。

图库图片

2. 严重等级

每个问题都会被分配一个严重等级来表示其重要性:

严重等级 描述 操作建议
信息 提示性说明或建议。 无需操作,但有助于提升质量。
警告 可能在特定上下文中引发问题的项。 视情况检查并修复。
失败 阻止故事发布的关键错误。 在创建发布前必须修复。

失败项会被明显标注。只要存在任何失败,故事就无法发布,直到这些问题被解决。

3. 常见校验项

系统包含技术性结构性的验证,例如:

类别 示例校验
市场 描述长度、截图警告和标签要求。
章节 每个章节都有起始场景并至少有一个出口。
场景 场景能被到达,且发布前所需的背景图已存在。
对话 无不可达分支或缺失目标。
媒体 所有引用的资源存在且符合要求的格式。
物品 / 制作 配方、物品引用和面向玩家的必需视觉元素有效。

每项校验都会显示结果、时间戳和详细信息,方便你准确知道需要调整什么。

图库图片

4. 编辑时的局部校验

你也可以在 场景对话章节 等编辑器内直接运行局部校验
这些聚焦校验只验证你当前正在编辑的内容,适合在继续开发前做快速确认。

示例: 在编辑场景时,局部校验会确认出口有效、使用情况以及发布前的任何缺失项(例如发布前必须存在的背景)。

5. 与发布的集成

相同的验证系统也会在发布工作流的自动审核阶段使用。如果你已经修复了编辑器校验系统中显示的所有问题,故事将在自动审核阶段自动通过。

这能确保从开发到发布的平滑过渡。

6. 最佳实践

  • 定期运行整篇故事的完整校验,尤其是在提交前。
  • 修复所有失败项并复查警告,以避免审核时出现意外。
  • 在编辑时经常使用局部校验,尽早发现问题。
  • 查看时间戳以跟踪每项校验的最后执行时间。

编辑器校验系统是你的内部质量闸门,确保在 Talescape 上发布的每个故事都稳定、完整并准备好让 Dreamers 探索。

下一步: 常见问题