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

自动化校验

进行中

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

编辑器检查系统 帮助你确认故事是否完整、一致并准备好发布。它会自动扫描你的故事以查找常见问题(从缺失资源到不完整的元数据),并详细反馈需要修复的内容。

相同的检查也会在发布前运行的自动审核中使用。在编辑器内运行它们可以让你尽早解决问题,避免在发布时被拒绝。

1. 运行检查

你可以通过两种方式触发检查:

Scope Description
全局检查(概览) 对整个故事运行所有可用的验证。可通过侧栏的 检查 面板访问。
本地检查(针对元素) 对你当前正在编辑的元素运行验证,例如特定章节、场景或对话。

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

2. 严重性等级

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

Severity Description Action
信息 提示性说明或建议。 无需操作,但可提升质量。
警告 可能会根据上下文导致问题的潜在问题。 如相关请审查并修复。
失败 阻止故事发布的关键错误。 必须在创建发布之前修复。

失败会被明显标记。包含任何失败的故事在解决之前无法发布。

3. 常见检查项

系统涵盖了技术性结构性的验证,例如:

Category Example Checks
市场 描述长度、截图和标签要求。
章节 每个章节都有起始场景和至少一个出口。
场景 每个场景都有背景并在故事中被使用。
对话 无不可到达的分支或缺失的目标。
媒体 所有引用的资源存在并匹配所需的格式。
物品 / 制造 配方和物品引用有效。

每个检查都会显示其结果、时间戳和详细信息,让你确切知道需要调整什么。

4. 编辑时的本地检查

你也可以在像 场景对话章节 这样的编辑器内直接运行本地检查
这些针对性的检查只验证你当前正在处理的内容,非常适合在继续开发前做快速校验。

示例: 在编辑场景时,本地检查会确认它有背景、有效的出口并且在故事中有被使用。

5. 与发布流程的集成

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

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

6. 最佳实践

  • 定期运行完整故事检查,尤其在提交前。
  • 修复所有 失败 并审查 警告,以避免审核时出现意外。
  • 在编辑时频繁使用 本地检查,以便及早发现问题。
  • 查看时间戳以追踪每次检查的执行时间。

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

下一步: 常见问题