webgal-parser 4.6.3-beta.2 → 4.6.5-beta.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # WebGAL Parser Changelog
 
+## [4.6.3] - 2026-08-01
+
+正式发布 4.6.3-beta.1 / beta.2 的多行语句支持，另含以下改动。
+
+### Added
+- 新增 `return` 命令，用于从被 `callScene` 调用的场景提前返回
+- `sceneEntry` 新增 `locals` / `writeReturnTo`，承载 `callScene` 传入的局部变量与返回值写回目标
+- 语音参数识别 `.opus` 扩展名
+
 ## [4.6.3-beta.2] - 2026-07-31
 
 ### Fixed

package/build/cjs/index.cjs

@@ -40,12 +40,14 @@ var commandType;
     commandType[commandType["wait"] = 33] = "wait";
     commandType[commandType["callSteam"] = 34] = "callSteam";
     commandType[commandType["return"] = 35] = "return";
+    commandType[commandType["changeFigureDiff"] = 36] = "changeFigureDiff";
 })(commandType || (commandType = {}));
 
 const SCRIPT_CONFIG = [
     { scriptString: 'say', scriptType: commandType.say },
     { scriptString: 'changeBg', scriptType: commandType.changeBg },
     { scriptString: 'changeFigure', scriptType: commandType.changeFigure },
+    { scriptString: 'changeFigureDiff', scriptType: commandType.changeFigureDiff },
     { scriptString: 'bgm', scriptType: commandType.bgm },
     { scriptString: 'playVideo', scriptType: commandType.video },
     { scriptString: 'pixiPerform', scriptType: commandType.pixi },
@@ -297,6 +299,7 @@ const contentParser = (contentRaw, type, assetSetter) => {
         case commandType.changeBg:
             return assetSetter(contentRaw, fileType.background);
         case commandType.changeFigure:
+        case commandType.changeFigureDiff:
             return assetSetter(contentRaw, fileType.figure);
         case commandType.bgm:
             return assetSetter(contentRaw, fileType.bgm);
@@ -377,7 +380,7 @@ const assetsScanner = (command, content, args, lineNumber) => {
             type: fileType.background,
         });
     }
-    if (command === commandType.changeFigure) {
+    if (command === commandType.changeFigure || command === commandType.changeFigureDiff) {
         returnAssetsList.push({
             name: content,
             url: content,
@@ -441,8 +444,10 @@ const subSceneScanner = (command, content) => {
  * @param assetSetter
  * @param ADD_NEXT_ARG_LIST
  * @param SCRIPT_CONFIG_MAP
+ * @param lineNumber 语句所在行号
+ * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
  */
-const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, lineNumber = 0) => {
+const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, lineNumber = 0, collectAssets = true) => {
     let command; // 默认为对话
     let content; // 语句内容
     let subScene; // 语句携带的子场景（可能没有）
@@ -510,8 +515,8 @@ const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG
         }
     }
     content = contentParser(newSentenceRaw.trim(), command, assetSetter); // 将语句内容里的文件名转为相对或绝对路径
-    sentenceAssets = assetsScanner(command, content, args, lineNumber); // 扫描语句携带资源
-    subScene = subSceneScanner(command, content); // 扫描语句携带子场景
+    sentenceAssets = collectAssets ? assetsScanner(command, content, args, lineNumber) : []; // 扫描语句携带资源
+    subScene = collectAssets ? subSceneScanner(command, content) : []; // 扫描语句携带子场景
     return {
         command: command,
         commandRaw: commandRaw.trim(),
@@ -688,6 +693,8 @@ function placeholderLine(content = "") {
  * @return {IScene} 解析后的场景
  */
 const sceneParser = (rawScene, sceneName, sceneUrl, assetsPrefetcher, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP) => {
+    // 没有预取回调时不需要场景级资源列表，连同每条语句的资源扫描一起跳过
+    const collectAssets = assetsPrefetcher !== undefined;
     // 预处理把多行语句折叠进它的首行，并用占位行补齐被折叠掉的行，
     // 因此这里的行数与原始场景严格一致，「语句 index == 文件行号」始终成立。
     const rawSentenceList = sceneTextPreProcess(rawScene).split('\n'); // 原始句子列表
@@ -698,16 +705,28 @@ const sceneParser = (rawScene, sceneName, sceneUrl, assetsPrefetcher, assetSette
     let assetsList = []; // 场景资源列表
     let subSceneList = []; // 子场景列表
     const sentenceList = rawSentenceListWithoutEmpty.map((sentence, index) => {
-        const returnSentence = scriptParser(sentence, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, index);
-        // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList
-        assetsList = [...assetsList, ...returnSentence.sentenceAssets];
-        subSceneList = [...subSceneList, ...returnSentence.subScene];
+        const returnSentence = scriptParser(sentence, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, index, collectAssets);
+        if (!collectAssets) {
+            return returnSentence;
+        }
+        // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList。
+        // 必须就地追加：如果写成 [...assetsList, ...sentenceAssets]，每条语句都要复制
+        // 一次已累积的列表，整体退化成 Θ(资源数²)——资源密集的场景脚本（几乎每条语句
+        // 都带 bg / figure / vocal）在数千条语句规模下会明显变慢。
+        for (const asset of returnSentence.sentenceAssets) {
+            assetsList.push(asset);
+        }
+        for (const subScene of returnSentence.subScene) {
+            subSceneList.push(subScene);
+        }
         return returnSentence;
     });
     markMultilineRanges(sentenceList, rawSentenceList);
-    // 开始资源的预加载
-    assetsList = deduplicateAssets(assetsList);
-    assetsPrefetcher(assetsList);
+    if (collectAssets) {
+        // 开始资源的预加载
+        assetsList = deduplicateAssets(assetsList);
+        assetsPrefetcher(assetsList);
+    }
     return {
         sceneName: sceneName,
         sceneUrl: sceneUrl,
@@ -789,6 +808,10 @@ class SceneParser {
     assetSetter;
     ADD_NEXT_ARG_LIST;
     SCRIPT_CONFIG_MAP;
+    /**
+     * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+     * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+     */
     constructor(assetsPrefetcher, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_INPUT) {
         this.assetsPrefetcher = assetsPrefetcher;
         this.assetSetter = assetSetter;

package/build/cjs/index.d.ts

@@ -9,7 +9,11 @@ export default class SceneParser {
     private readonly assetSetter;
     private readonly ADD_NEXT_ARG_LIST;
     private readonly SCRIPT_CONFIG_MAP;
-    constructor(assetsPrefetcher: (assetList: IAsset[]) => void, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: number[], SCRIPT_CONFIG_INPUT: ConfigItem[] | ConfigMap);
+    /**
+     * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+     * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+     */
+    constructor(assetsPrefetcher: ((assetList: IAsset[]) => void) | undefined, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: number[], SCRIPT_CONFIG_INPUT: ConfigItem[] | ConfigMap);
     /**
      * 解析场景
      * @param rawScene 原始场景

package/build/cjs/interface/sceneInterface.d.ts

@@ -39,7 +39,8 @@ export declare enum commandType {
     applyStyle = 32,
     wait = 33,
     callSteam = 34,
-    return = 35
+    return = 35,
+    changeFigureDiff = 36
 }
 /**
  * 单个参数接口

package/build/cjs/sceneParser.d.ts

@@ -12,4 +12,4 @@ import { ConfigMap } from './config/scriptConfig';
  * @param SCRIPT_CONFIG_MAP
  * @return {IScene} 解析后的场景
  */
-export declare const sceneParser: (rawScene: string, sceneName: string, sceneUrl: string, assetsPrefetcher: (assetList: Array<IAsset>) => void, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap) => IScene;
+export declare const sceneParser: (rawScene: string, sceneName: string, sceneUrl: string, assetsPrefetcher: ((assetList: Array<IAsset>) => void) | undefined, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap) => IScene;

package/build/cjs/scriptParser/scriptParser.d.ts

@@ -6,5 +6,7 @@ import { ConfigMap } from '../config/scriptConfig';
  * @param assetSetter
  * @param ADD_NEXT_ARG_LIST
  * @param SCRIPT_CONFIG_MAP
+ * @param lineNumber 语句所在行号
+ * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
  */
-export declare const scriptParser: (sentenceRaw: string, assetSetter: any, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap, lineNumber?: number) => ISentence;
+export declare const scriptParser: (sentenceRaw: string, assetSetter: any, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap, lineNumber?: number, collectAssets?: boolean) => ISentence;

package/build/es/index.d.ts

@@ -9,7 +9,11 @@ export default class SceneParser {
     private readonly assetSetter;
     private readonly ADD_NEXT_ARG_LIST;
     private readonly SCRIPT_CONFIG_MAP;
-    constructor(assetsPrefetcher: (assetList: IAsset[]) => void, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: number[], SCRIPT_CONFIG_INPUT: ConfigItem[] | ConfigMap);
+    /**
+     * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+     * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+     */
+    constructor(assetsPrefetcher: ((assetList: IAsset[]) => void) | undefined, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: number[], SCRIPT_CONFIG_INPUT: ConfigItem[] | ConfigMap);
     /**
      * 解析场景
      * @param rawScene 原始场景

package/build/es/index.js

@@ -36,12 +36,14 @@ var commandType;
     commandType[commandType["wait"] = 33] = "wait";
     commandType[commandType["callSteam"] = 34] = "callSteam";
     commandType[commandType["return"] = 35] = "return";
+    commandType[commandType["changeFigureDiff"] = 36] = "changeFigureDiff";
 })(commandType || (commandType = {}));
 
 const SCRIPT_CONFIG = [
     { scriptString: 'say', scriptType: commandType.say },
     { scriptString: 'changeBg', scriptType: commandType.changeBg },
     { scriptString: 'changeFigure', scriptType: commandType.changeFigure },
+    { scriptString: 'changeFigureDiff', scriptType: commandType.changeFigureDiff },
     { scriptString: 'bgm', scriptType: commandType.bgm },
     { scriptString: 'playVideo', scriptType: commandType.video },
     { scriptString: 'pixiPerform', scriptType: commandType.pixi },
@@ -293,6 +295,7 @@ const contentParser = (contentRaw, type, assetSetter) => {
         case commandType.changeBg:
             return assetSetter(contentRaw, fileType.background);
         case commandType.changeFigure:
+        case commandType.changeFigureDiff:
             return assetSetter(contentRaw, fileType.figure);
         case commandType.bgm:
             return assetSetter(contentRaw, fileType.bgm);
@@ -373,7 +376,7 @@ const assetsScanner = (command, content, args, lineNumber) => {
             type: fileType.background,
         });
     }
-    if (command === commandType.changeFigure) {
+    if (command === commandType.changeFigure || command === commandType.changeFigureDiff) {
         returnAssetsList.push({
             name: content,
             url: content,
@@ -437,8 +440,10 @@ const subSceneScanner = (command, content) => {
  * @param assetSetter
  * @param ADD_NEXT_ARG_LIST
  * @param SCRIPT_CONFIG_MAP
+ * @param lineNumber 语句所在行号
+ * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
  */
-const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, lineNumber = 0) => {
+const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, lineNumber = 0, collectAssets = true) => {
     let command; // 默认为对话
     let content; // 语句内容
     let subScene; // 语句携带的子场景（可能没有）
@@ -506,8 +511,8 @@ const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG
         }
     }
     content = contentParser(newSentenceRaw.trim(), command, assetSetter); // 将语句内容里的文件名转为相对或绝对路径
-    sentenceAssets = assetsScanner(command, content, args, lineNumber); // 扫描语句携带资源
-    subScene = subSceneScanner(command, content); // 扫描语句携带子场景
+    sentenceAssets = collectAssets ? assetsScanner(command, content, args, lineNumber) : []; // 扫描语句携带资源
+    subScene = collectAssets ? subSceneScanner(command, content) : []; // 扫描语句携带子场景
     return {
         command: command,
         commandRaw: commandRaw.trim(),
@@ -684,6 +689,8 @@ function placeholderLine(content = "") {
  * @return {IScene} 解析后的场景
  */
 const sceneParser = (rawScene, sceneName, sceneUrl, assetsPrefetcher, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP) => {
+    // 没有预取回调时不需要场景级资源列表，连同每条语句的资源扫描一起跳过
+    const collectAssets = assetsPrefetcher !== undefined;
     // 预处理把多行语句折叠进它的首行，并用占位行补齐被折叠掉的行，
     // 因此这里的行数与原始场景严格一致，「语句 index == 文件行号」始终成立。
     const rawSentenceList = sceneTextPreProcess(rawScene).split('\n'); // 原始句子列表
@@ -694,16 +701,28 @@ const sceneParser = (rawScene, sceneName, sceneUrl, assetsPrefetcher, assetSette
     let assetsList = []; // 场景资源列表
     let subSceneList = []; // 子场景列表
     const sentenceList = rawSentenceListWithoutEmpty.map((sentence, index) => {
-        const returnSentence = scriptParser(sentence, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, index);
-        // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList
-        assetsList = [...assetsList, ...returnSentence.sentenceAssets];
-        subSceneList = [...subSceneList, ...returnSentence.subScene];
+        const returnSentence = scriptParser(sentence, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, index, collectAssets);
+        if (!collectAssets) {
+            return returnSentence;
+        }
+        // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList。
+        // 必须就地追加：如果写成 [...assetsList, ...sentenceAssets]，每条语句都要复制
+        // 一次已累积的列表，整体退化成 Θ(资源数²)——资源密集的场景脚本（几乎每条语句
+        // 都带 bg / figure / vocal）在数千条语句规模下会明显变慢。
+        for (const asset of returnSentence.sentenceAssets) {
+            assetsList.push(asset);
+        }
+        for (const subScene of returnSentence.subScene) {
+            subSceneList.push(subScene);
+        }
         return returnSentence;
     });
     markMultilineRanges(sentenceList, rawSentenceList);
-    // 开始资源的预加载
-    assetsList = deduplicateAssets(assetsList);
-    assetsPrefetcher(assetsList);
+    if (collectAssets) {
+        // 开始资源的预加载
+        assetsList = deduplicateAssets(assetsList);
+        assetsPrefetcher(assetsList);
+    }
     return {
         sceneName: sceneName,
         sceneUrl: sceneUrl,
@@ -785,6 +804,10 @@ class SceneParser {
     assetSetter;
     ADD_NEXT_ARG_LIST;
     SCRIPT_CONFIG_MAP;
+    /**
+     * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+     * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+     */
     constructor(assetsPrefetcher, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_INPUT) {
         this.assetsPrefetcher = assetsPrefetcher;
         this.assetSetter = assetSetter;

package/build/es/interface/sceneInterface.d.ts

@@ -39,7 +39,8 @@ export declare enum commandType {
     applyStyle = 32,
     wait = 33,
     callSteam = 34,
-    return = 35
+    return = 35,
+    changeFigureDiff = 36
 }
 /**
  * 单个参数接口

package/build/es/sceneParser.d.ts

@@ -12,4 +12,4 @@ import { ConfigMap } from './config/scriptConfig';
  * @param SCRIPT_CONFIG_MAP
  * @return {IScene} 解析后的场景
  */
-export declare const sceneParser: (rawScene: string, sceneName: string, sceneUrl: string, assetsPrefetcher: (assetList: Array<IAsset>) => void, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap) => IScene;
+export declare const sceneParser: (rawScene: string, sceneName: string, sceneUrl: string, assetsPrefetcher: ((assetList: Array<IAsset>) => void) | undefined, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap) => IScene;

package/build/es/scriptParser/scriptParser.d.ts

@@ -6,5 +6,7 @@ import { ConfigMap } from '../config/scriptConfig';
  * @param assetSetter
  * @param ADD_NEXT_ARG_LIST
  * @param SCRIPT_CONFIG_MAP
+ * @param lineNumber 语句所在行号
+ * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
  */
-export declare const scriptParser: (sentenceRaw: string, assetSetter: any, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap, lineNumber?: number) => ISentence;
+export declare const scriptParser: (sentenceRaw: string, assetSetter: any, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap, lineNumber?: number, collectAssets?: boolean) => ISentence;

package/build/types/index.d.ts

@@ -9,7 +9,11 @@ export default class SceneParser {
     private readonly assetSetter;
     private readonly ADD_NEXT_ARG_LIST;
     private readonly SCRIPT_CONFIG_MAP;
-    constructor(assetsPrefetcher: (assetList: IAsset[]) => void, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: number[], SCRIPT_CONFIG_INPUT: ConfigItem[] | ConfigMap);
+    /**
+     * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+     * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+     */
+    constructor(assetsPrefetcher: ((assetList: IAsset[]) => void) | undefined, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: number[], SCRIPT_CONFIG_INPUT: ConfigItem[] | ConfigMap);
     /**
      * 解析场景
      * @param rawScene 原始场景

package/build/types/interface/sceneInterface.d.ts

@@ -39,7 +39,8 @@ export declare enum commandType {
     applyStyle = 32,
     wait = 33,
     callSteam = 34,
-    return = 35
+    return = 35,
+    changeFigureDiff = 36
 }
 /**
  * 单个参数接口

package/build/types/sceneParser.d.ts

@@ -12,4 +12,4 @@ import { ConfigMap } from './config/scriptConfig';
  * @param SCRIPT_CONFIG_MAP
  * @return {IScene} 解析后的场景
  */
-export declare const sceneParser: (rawScene: string, sceneName: string, sceneUrl: string, assetsPrefetcher: (assetList: Array<IAsset>) => void, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap) => IScene;
+export declare const sceneParser: (rawScene: string, sceneName: string, sceneUrl: string, assetsPrefetcher: ((assetList: Array<IAsset>) => void) | undefined, assetSetter: (fileName: string, assetType: fileType) => string, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap) => IScene;

package/build/types/scriptParser/scriptParser.d.ts

@@ -6,5 +6,7 @@ import { ConfigMap } from '../config/scriptConfig';
  * @param assetSetter
  * @param ADD_NEXT_ARG_LIST
  * @param SCRIPT_CONFIG_MAP
+ * @param lineNumber 语句所在行号
+ * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
  */
-export declare const scriptParser: (sentenceRaw: string, assetSetter: any, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap, lineNumber?: number) => ISentence;
+export declare const scriptParser: (sentenceRaw: string, assetSetter: any, ADD_NEXT_ARG_LIST: commandType[], SCRIPT_CONFIG_MAP: ConfigMap, lineNumber?: number, collectAssets?: boolean) => ISentence;

package/build/umd/index.global.js

@@ -39,12 +39,14 @@ var webgalParser = (function (exports) {
       commandType[commandType["wait"] = 33] = "wait";
       commandType[commandType["callSteam"] = 34] = "callSteam";
       commandType[commandType["return"] = 35] = "return";
+      commandType[commandType["changeFigureDiff"] = 36] = "changeFigureDiff";
   })(commandType || (commandType = {}));
 
   const SCRIPT_CONFIG = [
       { scriptString: 'say', scriptType: commandType.say },
       { scriptString: 'changeBg', scriptType: commandType.changeBg },
       { scriptString: 'changeFigure', scriptType: commandType.changeFigure },
+      { scriptString: 'changeFigureDiff', scriptType: commandType.changeFigureDiff },
       { scriptString: 'bgm', scriptType: commandType.bgm },
       { scriptString: 'playVideo', scriptType: commandType.video },
       { scriptString: 'pixiPerform', scriptType: commandType.pixi },
@@ -296,6 +298,7 @@ var webgalParser = (function (exports) {
           case commandType.changeBg:
               return assetSetter(contentRaw, fileType.background);
           case commandType.changeFigure:
+          case commandType.changeFigureDiff:
               return assetSetter(contentRaw, fileType.figure);
           case commandType.bgm:
               return assetSetter(contentRaw, fileType.bgm);
@@ -376,7 +379,7 @@ var webgalParser = (function (exports) {
               type: fileType.background,
           });
       }
-      if (command === commandType.changeFigure) {
+      if (command === commandType.changeFigure || command === commandType.changeFigureDiff) {
           returnAssetsList.push({
               name: content,
               url: content,
@@ -440,8 +443,10 @@ var webgalParser = (function (exports) {
    * @param assetSetter
    * @param ADD_NEXT_ARG_LIST
    * @param SCRIPT_CONFIG_MAP
+   * @param lineNumber 语句所在行号
+   * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
    */
-  const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, lineNumber = 0) => {
+  const scriptParser = (sentenceRaw, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, lineNumber = 0, collectAssets = true) => {
       let command; // 默认为对话
       let content; // 语句内容
       let subScene; // 语句携带的子场景（可能没有）
@@ -509,8 +514,8 @@ var webgalParser = (function (exports) {
           }
       }
       content = contentParser(newSentenceRaw.trim(), command, assetSetter); // 将语句内容里的文件名转为相对或绝对路径
-      sentenceAssets = assetsScanner(command, content, args, lineNumber); // 扫描语句携带资源
-      subScene = subSceneScanner(command, content); // 扫描语句携带子场景
+      sentenceAssets = collectAssets ? assetsScanner(command, content, args, lineNumber) : []; // 扫描语句携带资源
+      subScene = collectAssets ? subSceneScanner(command, content) : []; // 扫描语句携带子场景
       return {
           command: command,
           commandRaw: commandRaw.trim(),
@@ -687,6 +692,8 @@ var webgalParser = (function (exports) {
    * @return {IScene} 解析后的场景
    */
   const sceneParser = (rawScene, sceneName, sceneUrl, assetsPrefetcher, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP) => {
+      // 没有预取回调时不需要场景级资源列表，连同每条语句的资源扫描一起跳过
+      const collectAssets = assetsPrefetcher !== undefined;
       // 预处理把多行语句折叠进它的首行，并用占位行补齐被折叠掉的行，
       // 因此这里的行数与原始场景严格一致，「语句 index == 文件行号」始终成立。
       const rawSentenceList = sceneTextPreProcess(rawScene).split('\n'); // 原始句子列表
@@ -697,16 +704,28 @@ var webgalParser = (function (exports) {
       let assetsList = []; // 场景资源列表
       let subSceneList = []; // 子场景列表
       const sentenceList = rawSentenceListWithoutEmpty.map((sentence, index) => {
-          const returnSentence = scriptParser(sentence, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, index);
-          // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList
-          assetsList = [...assetsList, ...returnSentence.sentenceAssets];
-          subSceneList = [...subSceneList, ...returnSentence.subScene];
+          const returnSentence = scriptParser(sentence, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_MAP, index, collectAssets);
+          if (!collectAssets) {
+              return returnSentence;
+          }
+          // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList。
+          // 必须就地追加：如果写成 [...assetsList, ...sentenceAssets]，每条语句都要复制
+          // 一次已累积的列表，整体退化成 Θ(资源数²)——资源密集的场景脚本（几乎每条语句
+          // 都带 bg / figure / vocal）在数千条语句规模下会明显变慢。
+          for (const asset of returnSentence.sentenceAssets) {
+              assetsList.push(asset);
+          }
+          for (const subScene of returnSentence.subScene) {
+              subSceneList.push(subScene);
+          }
           return returnSentence;
       });
       markMultilineRanges(sentenceList, rawSentenceList);
-      // 开始资源的预加载
-      assetsList = deduplicateAssets(assetsList);
-      assetsPrefetcher(assetsList);
+      if (collectAssets) {
+          // 开始资源的预加载
+          assetsList = deduplicateAssets(assetsList);
+          assetsPrefetcher(assetsList);
+      }
       return {
           sceneName: sceneName,
           sceneUrl: sceneUrl,
@@ -788,6 +807,10 @@ var webgalParser = (function (exports) {
       assetSetter;
       ADD_NEXT_ARG_LIST;
       SCRIPT_CONFIG_MAP;
+      /**
+       * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+       * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+       */
       constructor(assetsPrefetcher, assetSetter, ADD_NEXT_ARG_LIST, SCRIPT_CONFIG_INPUT) {
           this.assetsPrefetcher = assetsPrefetcher;
           this.assetSetter = assetSetter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webgal-parser",
-  "version": "4.6.3-beta.2",
+  "version": "4.6.5-beta.1",
   "description": "WebGAL script parser",
   "scripts": {
     "test": "vitest",

package/src/config/scriptConfig.ts

@@ -4,6 +4,7 @@ export const SCRIPT_CONFIG = [
   { scriptString: 'say', scriptType: commandType.say },
   { scriptString: 'changeBg', scriptType: commandType.changeBg },
   { scriptString: 'changeFigure', scriptType: commandType.changeFigure },
+  { scriptString: 'changeFigureDiff', scriptType: commandType.changeFigureDiff },
   { scriptString: 'bgm', scriptType: commandType.bgm },
   { scriptString: 'playVideo', scriptType: commandType.video },
   { scriptString: 'pixiPerform', scriptType: commandType.pixi },

package/src/index.ts

@@ -17,8 +17,12 @@ import {
 
 export default class SceneParser {
   private readonly SCRIPT_CONFIG_MAP: ConfigMap;
+  /**
+   * @param assetsPrefetcher 资源预取回调。省略时不收集资源：`sentenceAssets`、`subScene`、
+   * `assetsList`、`subSceneList` 均为空数组，适用于只需要语句结构的调用方（编辑器语法解析等）。
+   */
   constructor(
-    private readonly assetsPrefetcher: (assetList: IAsset[]) => void,
+    private readonly assetsPrefetcher: ((assetList: IAsset[]) => void) | undefined,
     private readonly assetSetter: (
       fileName: string,
       assetType: fileType,

package/src/interface/sceneInterface.ts

@@ -41,6 +41,7 @@ export enum commandType {
   wait,
   callSteam, // 调用Steam功能
   return, // 从被调用的场景返回
+  changeFigureDiff, // 切换等尺寸静态立绘差分；追加以保持旧指令编号
 }
 
 /**
@@ -72,8 +73,8 @@ export interface ISentence {
   commandRaw: string; // 命令的原始内容，方便调试
   content: string; // 语句内容
   args: Array<arg>; // 参数列表
-  sentenceAssets: Array<IAsset>; // 语句携带的资源列表
-  subScene: Array<string>; // 语句包含子场景列表
+  sentenceAssets: Array<IAsset>; // 语句携带的资源列表；SceneParser 未提供 assetsPrefetcher 时为空
+  subScene: Array<string>; // 语句包含子场景列表；未提供 assetsPrefetcher 时为空
   inlineComment: string; // 行内注释
   /**
    * 本语句在原始场景文件中占据的行范围（0-based，含首尾）。
@@ -94,8 +95,8 @@ export interface IScene {
   sceneName: string; // 场景名称
   sceneUrl: string; // 场景url
   sentenceList: Array<ISentence>; // 语句列表
-  assetsList: Array<IAsset>; // 资源列表
-  subSceneList: Array<string>; // 子场景的url列表
+  assetsList: Array<IAsset>; // 资源列表；未提供 assetsPrefetcher 时为空
+  subSceneList: Array<string>; // 子场景的url列表；未提供 assetsPrefetcher 时为空
 }
 
 /**

package/src/sceneParser.ts

@@ -27,11 +27,14 @@ export const sceneParser = (
   rawScene: string,
   sceneName: string,
   sceneUrl: string,
-  assetsPrefetcher: (assetList: Array<IAsset>) => void,
+  assetsPrefetcher: ((assetList: Array<IAsset>) => void) | undefined,
   assetSetter: (fileName: string, assetType: fileType) => string,
   ADD_NEXT_ARG_LIST: commandType[],
   SCRIPT_CONFIG_MAP: ConfigMap,
 ): IScene => {
+  // 没有预取回调时不需要场景级资源列表，连同每条语句的资源扫描一起跳过
+  const collectAssets = assetsPrefetcher !== undefined;
+
   // 预处理把多行语句折叠进它的首行，并用占位行补齐被折叠掉的行，
   // 因此这里的行数与原始场景严格一致，「语句 index == 文件行号」始终成立。
   const rawSentenceList = sceneTextPreProcess(rawScene).split('\n'); // 原始句子列表
@@ -50,19 +53,32 @@ export const sceneParser = (
         ADD_NEXT_ARG_LIST,
         SCRIPT_CONFIG_MAP,
         index,
+        collectAssets,
       );
-      // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList
-      assetsList = [...assetsList, ...returnSentence.sentenceAssets];
-      subSceneList = [...subSceneList, ...returnSentence.subScene];
+      if (!collectAssets) {
+        return returnSentence;
+      }
+      // 在这里解析出语句可能携带的资源和场景，合并到 assetsList 和 subSceneList。
+      // 必须就地追加：如果写成 [...assetsList, ...sentenceAssets]，每条语句都要复制
+      // 一次已累积的列表，整体退化成 Θ(资源数²)——资源密集的场景脚本（几乎每条语句
+      // 都带 bg / figure / vocal）在数千条语句规模下会明显变慢。
+      for (const asset of returnSentence.sentenceAssets) {
+        assetsList.push(asset);
+      }
+      for (const subScene of returnSentence.subScene) {
+        subSceneList.push(subScene);
+      }
       return returnSentence;
     },
   );
 
   markMultilineRanges(sentenceList, rawSentenceList);
 
-  // 开始资源的预加载
-  assetsList = deduplicateAssets(assetsList);
-  assetsPrefetcher(assetsList);
+  if (collectAssets) {
+    // 开始资源的预加载
+    assetsList = deduplicateAssets(assetsList);
+    assetsPrefetcher(assetsList);
+  }
 
   return {
     sceneName: sceneName, // 场景名称

package/src/scriptParser/assetsScanner.ts

@@ -41,7 +41,7 @@ export const assetsScanner = (
       type: fileType.background,
     });
   }
-  if (command === commandType.changeFigure) {
+  if (command === commandType.changeFigure || command === commandType.changeFigureDiff) {
     returnAssetsList.push({
       name: content,
       url: content,

package/src/scriptParser/contentParser.ts

@@ -22,6 +22,7 @@ export const contentParser = (
     case commandType.changeBg:
       return assetSetter(contentRaw, fileType.background);
     case commandType.changeFigure:
+    case commandType.changeFigureDiff:
       return assetSetter(contentRaw, fileType.figure);
     case commandType.bgm:
       return assetSetter(contentRaw, fileType.bgm);

package/src/scriptParser/scriptParser.ts

@@ -18,6 +18,8 @@ import { ConfigMap } from '../config/scriptConfig';
  * @param assetSetter
  * @param ADD_NEXT_ARG_LIST
  * @param SCRIPT_CONFIG_MAP
+ * @param lineNumber 语句所在行号
+ * @param collectAssets 是否扫描语句携带的资源与子场景；为 false 时两者都返回空数组
  */
 export const scriptParser = (
   sentenceRaw: string,
@@ -25,6 +27,7 @@ export const scriptParser = (
   ADD_NEXT_ARG_LIST: commandType[],
   SCRIPT_CONFIG_MAP: ConfigMap,
   lineNumber = 0,
+  collectAssets = true,
 ): ISentence => {
   let command: commandType; // 默认为对话
   let content: string; // 语句内容
@@ -109,8 +112,8 @@ export const scriptParser = (
   }
 
   content = contentParser(newSentenceRaw.trim(), command, assetSetter); // 将语句内容里的文件名转为相对或绝对路径
-  sentenceAssets = assetsScanner(command, content, args, lineNumber); // 扫描语句携带资源
-  subScene = subSceneScanner(command, content); // 扫描语句携带子场景
+  sentenceAssets = collectAssets ? assetsScanner(command, content, args, lineNumber) : []; // 扫描语句携带资源
+  subScene = collectAssets ? subSceneScanner(command, content) : []; // 扫描语句携带子场景
   return {
     command: command, // 语句类型
     commandRaw: commandRaw.trim(), // 命令原始内容，方便调试