预览与调试

用实时预览、快进、上一步、随机种子和问题面板,快速走查故事分支并定位错误。

编辑器右边的预览用的就是 Kiny 播放层。你在这里看到的正文、选项、主题和演出效果,和读者在阅读器、网页书库或独立网页里看到的是同一套规则。

预览面板及快进、上一步、重开预览工具

修改后为什么会立即变化

每次改动 .kin 文件,编辑器都会重新分析项目,并用当前编辑缓冲重算预览。你不必先保存文件,也不用手动点“运行”。

下面这个短故事很适合练习调试工具:

=== 栈桥 ===
雾把栈桥尽头的路灯藏了起来。
* [去酒馆] -> 酒馆
* [留在码头] -> 码头

=== 酒馆 ===
门后传来杯子碰撞的声音。
-> END

=== 码头 ===
远处响起一声汽笛。
-> END

把它放进编辑器,先选一个方向,再改一行正文。预览会按新源码重新计算,不会把过期的运行结果误当成最新作品。

快进:直奔下一个决定点

打开 ⏩ 快进 后:

  • 正文不再逐字出现;
  • <pause>@sleep 不等待;
  • 逐行模式自动往下走;
  • 音效不播放;
  • 选完一项后直接跑到下一个选项、输入框、结局或错误。

工具栏会一直显示“快进中”,避免你忘了自己正在看调试模式。它只影响编辑器预览,不改作品设置,也不改变读者端的节奏。

上一步:换一个选择再走

← 上一步会撤销预览里最近一次选择或输入,回到上一个决定点。它不撤销源码,也不会动编辑器的文字历史。

这很适合比较相邻分支:选择左边,看到结果后退一步,再选择右边。按钮变灰表示当前还没有可撤销的选择或输入;要清空整条试玩路径,用重开预览

随机种子:复现随机结果

预览工具栏会显示当前种子,例如 #5eed。作品用了随机文本或随机跳转时,同一种子会得到同一串结果,方便你复现问题。需要换一轮随机结果,可在设置里调整“预览随机种子”后重开预览。

三种问题,三种看法

语法或语义错误

错误与警告列在编辑区底部的问题面板,点一条即可定位。常见错误包括括号未闭合、跳转目标不存在、变量名或节点参数不匹配。有错误时导出会被禁用。

基于上一个有效版本

你正在输入一条还没写完的语句时,新源码可能暂时无法运行。预览不会突然清空,而是冻结在上一份有效结果,并显示“基于上一个有效版本”。先修底部错误;角标消失后,预览才代表当前源码。

运行时错误

有些问题只有走到特定分支才会发生,例如表达式在当前状态下求值失败。预览会停在出错点,显示“运行时错误”和文件、行号;回到对应源码修正,再重走这一条路径。

一套省时间的走查顺序

先修完静态错误,再打开快进走主线;每到选项就分别走一遍,用“上一步”切换相邻分支;最后关掉快进,从头按正常节奏读一遍。这样既能很快覆盖结构,也不会漏掉停顿、音效和逐字显示的实际体验。

下一篇继续讲搜索与大纲,用项目级工具在长篇里找内容和跳节点。