WebGAL 剧本编写助手

解决的问题

WebGAL 视觉小说脚本会把背景切换、立绘站位、分支选择、变量状态、音频淡入都压缩成半角 :、; 组成的行内指令。手写时容易在参数顺序、-next / -concat / -notend、条件选项 (显示条件)[启用条件]、全局变量与运行时变量之间出错，导致演出跳帧、音频不淡出、分支不回退。例如 changeScene 不会自动清除舞台，而 callScene 执行完会返回，二者混用会造成状态残留；bgm:none -enter=3000; 这类淡出写法也需要放在正确的对话或演出节点。

技能如何工作

这个技能把 WebGAL 命令拆成基础、对话、背景立绘、场景分支、变量、音频、视频、动画、特效等参考模块，并按需求定位：

• 语法约束：优先检查指令是否以 ; 结束、是否使用半角冒号/分号，以及 指令:值 -参数=值; 的结构。
• 演出串联：围绕 changeBg、changeFigure、setTextbox、setAnimation、setTransition 组织镜头、背景与角色进出场。
• 逻辑分支：使用 choose、label / jumpLabel、setVar 与 -when 处理选项、跳转和状态判断。
• 多媒体接入：按 bgm、-V、playEffect、playVideo 的素材参数给出播放、淡入淡出和停止方式。
• 输出规范：生成 ws 代码块，并在代码外解释参数含义、可优化点和潜在副作用。

适用边界

适合已经准备图片、音频、视频素材，并且主要使用 WebGAL 内置命令做剧本编排的场景。它不负责制作美术资源，也不替代引擎运行环境；对于自定义 JSON 动画、Pixi 特效叠加、存档变量 $userData，需要项目里已有对应配置或文件结构。