@nebulaaa/launcher 1.0.0 → 1.0.1

package/dist/launcher.cjs

@@ -49,14 +49,16 @@ const LAUNCHER_RESERVED_KEYS = ['App', 'Version', 'Build', 'Language'];
 class Launcher extends plugin.Plugin {
     constructor(deps, cfg) {
         var _a;
-        dict.Override(cfg !== null && cfg !== void 0 ? cfg : {}, {
-            app: 'nebulaaa',
-            version: '1.0.0',
-            build: exports.Build.Dev,
-            language: [cc.sys.Language.CHINESE, cc.sys.Language.ENGLISH],
-            env: 'default',
+        // Override 为原地合并：在副本上操作避免变异调用方对象；返回值必须接住，
+        // 否则 cfg=null 时兜底写在临时对象上，后续 cfg.Build 读取仍然崩溃
+        cfg = dict.Override(Object.assign({}, (cfg !== null && cfg !== void 0 ? cfg : {})), {
+            App: 'nebulaaa',
+            Version: '1.0.0',
+            Build: exports.Build.Dev,
+            Language: [cc.sys.Language.CHINESE, cc.sys.Language.ENGLISH],
+            Workspace: 'default',
         });
-        if ((env.MISC.BROWSER && cfg.Build === exports.Build.Dev) || cfg.Build === exports.Build.Alpha) {
+        if (env.MISC.BROWSER && (cfg.Build === exports.Build.Dev || cfg.Build === exports.Build.Alpha)) {
             const qs = web.GetQueryString();
             const whitelist = [...LAUNCHER_URL_OVERRIDABLE_KEYS, ...((_a = cfg.AllowedUrlKeys) !== null && _a !== void 0 ? _a : [])];
             dict.Each(qs, (key, value) => {
@@ -131,14 +133,13 @@ class Launcher extends plugin.Plugin {
         if (!ctx.Mnt) {
             ctx.Mnt = new cc.Node('mnt');
             ctx.Mnt.layer = 0;
-            ctx.Scene.insertChild(this.Mnt, 0);
+            ctx.Scene.insertChild(ctx.Mnt, 0);
         }
         // Root
         ctx.Root = scene.getChildByName('Canvas');
-        if (!this.Root) {
-            // Canvas 是舞台的挂载前提，缺失时中止装配；仅记录日志，不向引擎事件派发抛出异常
-            this.Logger.Error(`启动错误：场景 ${scene.name} 缺少名为 Canvas 的根节点，舞台装配中止`);
-            return;
+        if (!ctx.Root) {
+            // Canvas 是舞台的挂载前提，缺失时中止装配
+            throw new Error(`启动错误：场景 ${scene.name} 缺少名为 Canvas 的根节点，舞台装配中止`);
         }
         // Stage
         ctx.Stage = ctx.Root.getChildByName('Stage');
@@ -151,14 +152,17 @@ class Launcher extends plugin.Plugin {
             wid.alignMode = cc.Widget.AlignMode.ON_WINDOW_RESIZE;
             wid.updateAlignment();
             ctx.Stage = node;
-            this.Root.insertChild(this.Stage, 1);
+            ctx.Root.insertChild(ctx.Stage, 1);
         }
         // Canvas
         ctx.Canvas = ctx.Root.getComponent(cc.Canvas);
+        if (!ctx.Canvas) {
+            throw new Error('Root 缺少 Canvas 组件');
+        }
         // CameraUi
         ctx.CameraUi = (_b = (_a = ctx.Root.getChildByName('Camera')) === null || _a === void 0 ? void 0 : _a.getComponent(cc.Camera)) !== null && _b !== void 0 ? _b : null;
-        if (!this.CameraUi) {
-            this.Logger.Warn('启动警告：Canvas 缺少名为 Camera 的子节点，UI 相机不可用');
+        if (!ctx.CameraUi) {
+            throw new Error('Canvas 缺少名为 Camera 的子节点，UI 相机不可用');
         }
         this.Deps.EventBus.Sys.Notify(eventBus.EventMessage.Void(LAUNCHER_EVENT.STAGE_READY));
     }

package/dist/launcher.min.cjs

@@ -1 +1 @@
-"use strict";var e,t=require("cc"),i=require("@nebulaaa/dict"),s=require("@nebulaaa/env"),n=require("@nebulaaa/event-bus"),a=require("@nebulaaa/ms"),r=require("@nebulaaa/plugin"),o=require("@nebulaaa/web");exports.Build=void 0,(e=exports.Build||(exports.Build={})).Dev="dev",e.Alpha="alpha",e.Beta="beta",e.Candidate="candidate",e.Release="release";const u={ENTER_BACKGROUND:"app@enter-background",ENTER_FOREGROUND:"app@enter-foreground",QUIT:"app@quit",LOW_MEMORY:"app@low-memory",STAGE_READY:"app@stage-ready"},l=["Workspace"],g=["App","Version","Build","Language"];class h extends r.Plugin{constructor(e,n){var a;if(i.Override(null!=n?n:{},{app:"nebulaaa",version:"1.0.0",build:exports.Build.Dev,language:[t.sys.Language.CHINESE,t.sys.Language.ENGLISH],env:"default"}),s.MISC.BROWSER&&n.Build===exports.Build.Dev||n.Build===exports.Build.Alpha){const e=o.GetQueryString(),t=[...l,...null!==(a=n.AllowedUrlKeys)&&void 0!==a?a:[]];i.Each(e,(e,i)=>{if(!g.includes(e)&&t.includes(e))try{n[e]=decodeURIComponent(i)}catch(t){n[e]=i}})}super(e,n),this.App=this.Cfg.App,this.Version=this.Cfg.Version,this.Build=this.Cfg.Build,this.IsDev=this.Cfg.Build===exports.Build.Dev,this.IsAlpha=this.Cfg.Build===exports.Build.Alpha,this.IsBeta=this.Cfg.Build===exports.Build.Beta,this.IsCandidate=this.Cfg.Build===exports.Build.Candidate,this.IsRelease=this.Cfg.Build===exports.Build.Release,this.Workspace=this.Cfg.Workspace,this.SupportedLanguages=this.Cfg.Language,this._runningLogic=!0,this._runningInternal=!0,this._timingPause=0,this._elapsed=0,t.director.once(t.Director.EVENT_BEFORE_SCENE_LAUNCH,this.onSceneLaunch,this),t.game.on(t.Game.EVENT_SHOW,this.internalResume,this),t.game.on(t.Game.EVENT_HIDE,this.internalPause,this),t.game.on(t.Game.EVENT_CLOSE,this.internalClose,this),t.game.on(t.Game.EVENT_LOW_MEMORY,this.internalLowMemory,this),this.Logger.Info(`🔥 ${this.App} ${this.Version}_${this.Build}`)}internalPause(){this._runningInternal=!1,this._timingPause=a.Now(),this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.ENTER_BACKGROUND))}internalResume(){this._runningInternal=!0,this._timingPause>0&&(this._elapsed=a.Now()-this._timingPause,this._timingPause=0),this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.ENTER_FOREGROUND))}internalClose(){this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.QUIT)),t.game.targetOff(this),t.director.targetOff(this)}internalLowMemory(){this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.LOW_MEMORY))}onSceneLaunch(e){var i,s;const a=this;if(a.Scene=e,a.Mnt=e.getChildByName("mnt"),a.Mnt||(a.Mnt=new t.Node("mnt"),a.Mnt.layer=0,a.Scene.insertChild(this.Mnt,0)),a.Root=e.getChildByName("Canvas"),this.Root){if(a.Stage=a.Root.getChildByName("Stage"),!a.Stage){const e=new t.Node("Stage");e.layer=t.Layers.BitMask.UI_2D;const i=e.addComponent(t.Widget);i.left=i.top=i.right=i.bottom=0,i.isAlignLeft=i.isAlignTop=i.isAlignBottom=i.isAlignRight=!0,i.alignMode=t.Widget.AlignMode.ON_WINDOW_RESIZE,i.updateAlignment(),a.Stage=e,this.Root.insertChild(this.Stage,1)}a.Canvas=a.Root.getComponent(t.Canvas),a.CameraUi=null!==(s=null===(i=a.Root.getChildByName("Camera"))||void 0===i?void 0:i.getComponent(t.Camera))&&void 0!==s?s:null,this.CameraUi||this.Logger.Warn("启动警告：Canvas 缺少名为 Camera 的子节点，UI 相机不可用"),this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.STAGE_READY))}else this.Logger.Error(`启动错误：场景 ${e.name} 缺少名为 Canvas 的根节点，舞台装配中止`)}IsBuildOf(e){return this.Build===e}IsLanguageSupported(e){return this.Cfg.Language.includes(e)}Pause(){this._runningLogic=!1}Resume(){this._runningLogic=!0}get Elapsed(){return this._elapsed}get Running(){return this._runningInternal&&this._runningLogic}}exports.LAUNCHER_EVENT=u,exports.LAUNCHER_RESERVED_KEYS=g,exports.LAUNCHER_URL_OVERRIDABLE_KEYS=l,exports.Launcher=h;
+"use strict";var e,t=require("cc"),i=require("@nebulaaa/dict"),s=require("@nebulaaa/env"),n=require("@nebulaaa/event-bus"),a=require("@nebulaaa/ms"),r=require("@nebulaaa/plugin"),o=require("@nebulaaa/web");exports.Build=void 0,(e=exports.Build||(exports.Build={})).Dev="dev",e.Alpha="alpha",e.Beta="beta",e.Candidate="candidate",e.Release="release";const u={ENTER_BACKGROUND:"app@enter-background",ENTER_FOREGROUND:"app@enter-foreground",QUIT:"app@quit",LOW_MEMORY:"app@low-memory",STAGE_READY:"app@stage-ready"},l=["Workspace"],g=["App","Version","Build","Language"];class h extends r.Plugin{constructor(e,n){var a;if(n=i.Override(Object.assign({},null!=n?n:{}),{App:"nebulaaa",Version:"1.0.0",Build:exports.Build.Dev,Language:[t.sys.Language.CHINESE,t.sys.Language.ENGLISH],Workspace:"default"}),s.MISC.BROWSER&&(n.Build===exports.Build.Dev||n.Build===exports.Build.Alpha)){const e=o.GetQueryString(),t=[...l,...null!==(a=n.AllowedUrlKeys)&&void 0!==a?a:[]];i.Each(e,(e,i)=>{if(!g.includes(e)&&t.includes(e))try{n[e]=decodeURIComponent(i)}catch(t){n[e]=i}})}super(e,n),this.App=this.Cfg.App,this.Version=this.Cfg.Version,this.Build=this.Cfg.Build,this.IsDev=this.Cfg.Build===exports.Build.Dev,this.IsAlpha=this.Cfg.Build===exports.Build.Alpha,this.IsBeta=this.Cfg.Build===exports.Build.Beta,this.IsCandidate=this.Cfg.Build===exports.Build.Candidate,this.IsRelease=this.Cfg.Build===exports.Build.Release,this.Workspace=this.Cfg.Workspace,this.SupportedLanguages=this.Cfg.Language,this._runningLogic=!0,this._runningInternal=!0,this._timingPause=0,this._elapsed=0,t.director.once(t.Director.EVENT_BEFORE_SCENE_LAUNCH,this.onSceneLaunch,this),t.game.on(t.Game.EVENT_SHOW,this.internalResume,this),t.game.on(t.Game.EVENT_HIDE,this.internalPause,this),t.game.on(t.Game.EVENT_CLOSE,this.internalClose,this),t.game.on(t.Game.EVENT_LOW_MEMORY,this.internalLowMemory,this),this.Logger.Info(`🔥 ${this.App} ${this.Version}_${this.Build}`)}internalPause(){this._runningInternal=!1,this._timingPause=a.Now(),this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.ENTER_BACKGROUND))}internalResume(){this._runningInternal=!0,this._timingPause>0&&(this._elapsed=a.Now()-this._timingPause,this._timingPause=0),this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.ENTER_FOREGROUND))}internalClose(){this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.QUIT)),t.game.targetOff(this),t.director.targetOff(this)}internalLowMemory(){this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.LOW_MEMORY))}onSceneLaunch(e){var i,s;const a=this;if(a.Scene=e,a.Mnt=e.getChildByName("mnt"),a.Mnt||(a.Mnt=new t.Node("mnt"),a.Mnt.layer=0,a.Scene.insertChild(a.Mnt,0)),a.Root=e.getChildByName("Canvas"),!a.Root)throw new Error(`启动错误：场景 ${e.name} 缺少名为 Canvas 的根节点，舞台装配中止`);if(a.Stage=a.Root.getChildByName("Stage"),!a.Stage){const e=new t.Node("Stage");e.layer=t.Layers.BitMask.UI_2D;const i=e.addComponent(t.Widget);i.left=i.top=i.right=i.bottom=0,i.isAlignLeft=i.isAlignTop=i.isAlignBottom=i.isAlignRight=!0,i.alignMode=t.Widget.AlignMode.ON_WINDOW_RESIZE,i.updateAlignment(),a.Stage=e,a.Root.insertChild(a.Stage,1)}if(a.Canvas=a.Root.getComponent(t.Canvas),!a.Canvas)throw new Error("Root 缺少 Canvas 组件");if(a.CameraUi=null!==(s=null===(i=a.Root.getChildByName("Camera"))||void 0===i?void 0:i.getComponent(t.Camera))&&void 0!==s?s:null,!a.CameraUi)throw new Error("Canvas 缺少名为 Camera 的子节点，UI 相机不可用");this.Deps.EventBus.Sys.Notify(n.EventMessage.Void(u.STAGE_READY))}IsBuildOf(e){return this.Build===e}IsLanguageSupported(e){return this.Cfg.Language.includes(e)}Pause(){this._runningLogic=!1}Resume(){this._runningLogic=!0}get Elapsed(){return this._elapsed}get Running(){return this._runningInternal&&this._runningLogic}}exports.LAUNCHER_EVENT=u,exports.LAUNCHER_RESERVED_KEYS=g,exports.LAUNCHER_URL_OVERRIDABLE_KEYS=l,exports.Launcher=h;

package/dist/launcher.min.mjs

@@ -1 +1 @@
-import{sys as t,director as e,Director as i,game as n,Game as s,Node as a,Layers as o,Widget as r,Canvas as l,Camera as h}from"cc";import{Override as g,Each as u}from"@nebulaaa/dict";import{MISC as d}from"@nebulaaa/env";import{EventMessage as p}from"@nebulaaa/event-bus";import{Now as E}from"@nebulaaa/ms";import{Plugin as m}from"@nebulaaa/plugin";import{GetQueryString as C}from"@nebulaaa/web";var f;!function(t){t.Dev="dev",t.Alpha="alpha",t.Beta="beta",t.Candidate="candidate",t.Release="release"}(f||(f={}));const _={ENTER_BACKGROUND:"app@enter-background",ENTER_FOREGROUND:"app@enter-foreground",QUIT:"app@quit",LOW_MEMORY:"app@low-memory",STAGE_READY:"app@stage-ready"},c=["Workspace"],R=["App","Version","Build","Language"];class B extends m{constructor(a,o){var r;if(g(null!=o?o:{},{app:"nebulaaa",version:"1.0.0",build:f.Dev,language:[t.Language.CHINESE,t.Language.ENGLISH],env:"default"}),d.BROWSER&&o.Build===f.Dev||o.Build===f.Alpha){const t=C(),e=[...c,...null!==(r=o.AllowedUrlKeys)&&void 0!==r?r:[]];u(t,(t,i)=>{if(!R.includes(t)&&e.includes(t))try{o[t]=decodeURIComponent(i)}catch(e){o[t]=i}})}super(a,o),this.App=this.Cfg.App,this.Version=this.Cfg.Version,this.Build=this.Cfg.Build,this.IsDev=this.Cfg.Build===f.Dev,this.IsAlpha=this.Cfg.Build===f.Alpha,this.IsBeta=this.Cfg.Build===f.Beta,this.IsCandidate=this.Cfg.Build===f.Candidate,this.IsRelease=this.Cfg.Build===f.Release,this.Workspace=this.Cfg.Workspace,this.SupportedLanguages=this.Cfg.Language,this._runningLogic=!0,this._runningInternal=!0,this._timingPause=0,this._elapsed=0,e.once(i.EVENT_BEFORE_SCENE_LAUNCH,this.onSceneLaunch,this),n.on(s.EVENT_SHOW,this.internalResume,this),n.on(s.EVENT_HIDE,this.internalPause,this),n.on(s.EVENT_CLOSE,this.internalClose,this),n.on(s.EVENT_LOW_MEMORY,this.internalLowMemory,this),this.Logger.Info(`🔥 ${this.App} ${this.Version}_${this.Build}`)}internalPause(){this._runningInternal=!1,this._timingPause=E(),this.Deps.EventBus.Sys.Notify(p.Void(_.ENTER_BACKGROUND))}internalResume(){this._runningInternal=!0,this._timingPause>0&&(this._elapsed=E()-this._timingPause,this._timingPause=0),this.Deps.EventBus.Sys.Notify(p.Void(_.ENTER_FOREGROUND))}internalClose(){this.Deps.EventBus.Sys.Notify(p.Void(_.QUIT)),n.targetOff(this),e.targetOff(this)}internalLowMemory(){this.Deps.EventBus.Sys.Notify(p.Void(_.LOW_MEMORY))}onSceneLaunch(t){var e,i;const n=this;if(n.Scene=t,n.Mnt=t.getChildByName("mnt"),n.Mnt||(n.Mnt=new a("mnt"),n.Mnt.layer=0,n.Scene.insertChild(this.Mnt,0)),n.Root=t.getChildByName("Canvas"),this.Root){if(n.Stage=n.Root.getChildByName("Stage"),!n.Stage){const t=new a("Stage");t.layer=o.BitMask.UI_2D;const e=t.addComponent(r);e.left=e.top=e.right=e.bottom=0,e.isAlignLeft=e.isAlignTop=e.isAlignBottom=e.isAlignRight=!0,e.alignMode=r.AlignMode.ON_WINDOW_RESIZE,e.updateAlignment(),n.Stage=t,this.Root.insertChild(this.Stage,1)}n.Canvas=n.Root.getComponent(l),n.CameraUi=null!==(i=null===(e=n.Root.getChildByName("Camera"))||void 0===e?void 0:e.getComponent(h))&&void 0!==i?i:null,this.CameraUi||this.Logger.Warn("启动警告：Canvas 缺少名为 Camera 的子节点，UI 相机不可用"),this.Deps.EventBus.Sys.Notify(p.Void(_.STAGE_READY))}else this.Logger.Error(`启动错误：场景 ${t.name} 缺少名为 Canvas 的根节点，舞台装配中止`)}IsBuildOf(t){return this.Build===t}IsLanguageSupported(t){return this.Cfg.Language.includes(t)}Pause(){this._runningLogic=!1}Resume(){this._runningLogic=!0}get Elapsed(){return this._elapsed}get Running(){return this._runningInternal&&this._runningLogic}}export{f as Build,_ as LAUNCHER_EVENT,R as LAUNCHER_RESERVED_KEYS,c as LAUNCHER_URL_OVERRIDABLE_KEYS,B as Launcher};
+import{sys as e,director as t,Director as i,game as n,Game as s,Node as a,Layers as o,Widget as r,Canvas as l,Camera as u}from"cc";import{Override as h,Each as g}from"@nebulaaa/dict";import{MISC as d}from"@nebulaaa/env";import{EventMessage as p}from"@nebulaaa/event-bus";import{Now as E}from"@nebulaaa/ms";import{Plugin as m}from"@nebulaaa/plugin";import{GetQueryString as C}from"@nebulaaa/web";var f;!function(e){e.Dev="dev",e.Alpha="alpha",e.Beta="beta",e.Candidate="candidate",e.Release="release"}(f||(f={}));const c={ENTER_BACKGROUND:"app@enter-background",ENTER_FOREGROUND:"app@enter-foreground",QUIT:"app@quit",LOW_MEMORY:"app@low-memory",STAGE_READY:"app@stage-ready"},_=["Workspace"],R=["App","Version","Build","Language"];class B extends m{constructor(a,o){var r;if(o=h(Object.assign({},null!=o?o:{}),{App:"nebulaaa",Version:"1.0.0",Build:f.Dev,Language:[e.Language.CHINESE,e.Language.ENGLISH],Workspace:"default"}),d.BROWSER&&(o.Build===f.Dev||o.Build===f.Alpha)){const e=C(),t=[..._,...null!==(r=o.AllowedUrlKeys)&&void 0!==r?r:[]];g(e,(e,i)=>{if(!R.includes(e)&&t.includes(e))try{o[e]=decodeURIComponent(i)}catch(t){o[e]=i}})}super(a,o),this.App=this.Cfg.App,this.Version=this.Cfg.Version,this.Build=this.Cfg.Build,this.IsDev=this.Cfg.Build===f.Dev,this.IsAlpha=this.Cfg.Build===f.Alpha,this.IsBeta=this.Cfg.Build===f.Beta,this.IsCandidate=this.Cfg.Build===f.Candidate,this.IsRelease=this.Cfg.Build===f.Release,this.Workspace=this.Cfg.Workspace,this.SupportedLanguages=this.Cfg.Language,this._runningLogic=!0,this._runningInternal=!0,this._timingPause=0,this._elapsed=0,t.once(i.EVENT_BEFORE_SCENE_LAUNCH,this.onSceneLaunch,this),n.on(s.EVENT_SHOW,this.internalResume,this),n.on(s.EVENT_HIDE,this.internalPause,this),n.on(s.EVENT_CLOSE,this.internalClose,this),n.on(s.EVENT_LOW_MEMORY,this.internalLowMemory,this),this.Logger.Info(`🔥 ${this.App} ${this.Version}_${this.Build}`)}internalPause(){this._runningInternal=!1,this._timingPause=E(),this.Deps.EventBus.Sys.Notify(p.Void(c.ENTER_BACKGROUND))}internalResume(){this._runningInternal=!0,this._timingPause>0&&(this._elapsed=E()-this._timingPause,this._timingPause=0),this.Deps.EventBus.Sys.Notify(p.Void(c.ENTER_FOREGROUND))}internalClose(){this.Deps.EventBus.Sys.Notify(p.Void(c.QUIT)),n.targetOff(this),t.targetOff(this)}internalLowMemory(){this.Deps.EventBus.Sys.Notify(p.Void(c.LOW_MEMORY))}onSceneLaunch(e){var t,i;const n=this;if(n.Scene=e,n.Mnt=e.getChildByName("mnt"),n.Mnt||(n.Mnt=new a("mnt"),n.Mnt.layer=0,n.Scene.insertChild(n.Mnt,0)),n.Root=e.getChildByName("Canvas"),!n.Root)throw new Error(`启动错误：场景 ${e.name} 缺少名为 Canvas 的根节点，舞台装配中止`);if(n.Stage=n.Root.getChildByName("Stage"),!n.Stage){const e=new a("Stage");e.layer=o.BitMask.UI_2D;const t=e.addComponent(r);t.left=t.top=t.right=t.bottom=0,t.isAlignLeft=t.isAlignTop=t.isAlignBottom=t.isAlignRight=!0,t.alignMode=r.AlignMode.ON_WINDOW_RESIZE,t.updateAlignment(),n.Stage=e,n.Root.insertChild(n.Stage,1)}if(n.Canvas=n.Root.getComponent(l),!n.Canvas)throw new Error("Root 缺少 Canvas 组件");if(n.CameraUi=null!==(i=null===(t=n.Root.getChildByName("Camera"))||void 0===t?void 0:t.getComponent(u))&&void 0!==i?i:null,!n.CameraUi)throw new Error("Canvas 缺少名为 Camera 的子节点，UI 相机不可用");this.Deps.EventBus.Sys.Notify(p.Void(c.STAGE_READY))}IsBuildOf(e){return this.Build===e}IsLanguageSupported(e){return this.Cfg.Language.includes(e)}Pause(){this._runningLogic=!1}Resume(){this._runningLogic=!0}get Elapsed(){return this._elapsed}get Running(){return this._runningInternal&&this._runningLogic}}export{f as Build,c as LAUNCHER_EVENT,R as LAUNCHER_RESERVED_KEYS,_ as LAUNCHER_URL_OVERRIDABLE_KEYS,B as Launcher};

package/dist/launcher.mjs

@@ -47,14 +47,16 @@ const LAUNCHER_RESERVED_KEYS = ['App', 'Version', 'Build', 'Language'];
 class Launcher extends Plugin {
     constructor(deps, cfg) {
         var _a;
-        Override(cfg !== null && cfg !== void 0 ? cfg : {}, {
-            app: 'nebulaaa',
-            version: '1.0.0',
-            build: Build.Dev,
-            language: [sys.Language.CHINESE, sys.Language.ENGLISH],
-            env: 'default',
+        // Override 为原地合并：在副本上操作避免变异调用方对象；返回值必须接住，
+        // 否则 cfg=null 时兜底写在临时对象上，后续 cfg.Build 读取仍然崩溃
+        cfg = Override(Object.assign({}, (cfg !== null && cfg !== void 0 ? cfg : {})), {
+            App: 'nebulaaa',
+            Version: '1.0.0',
+            Build: Build.Dev,
+            Language: [sys.Language.CHINESE, sys.Language.ENGLISH],
+            Workspace: 'default',
         });
-        if ((MISC.BROWSER && cfg.Build === Build.Dev) || cfg.Build === Build.Alpha) {
+        if (MISC.BROWSER && (cfg.Build === Build.Dev || cfg.Build === Build.Alpha)) {
             const qs = GetQueryString();
             const whitelist = [...LAUNCHER_URL_OVERRIDABLE_KEYS, ...((_a = cfg.AllowedUrlKeys) !== null && _a !== void 0 ? _a : [])];
             Each(qs, (key, value) => {
@@ -129,14 +131,13 @@ class Launcher extends Plugin {
         if (!ctx.Mnt) {
             ctx.Mnt = new Node('mnt');
             ctx.Mnt.layer = 0;
-            ctx.Scene.insertChild(this.Mnt, 0);
+            ctx.Scene.insertChild(ctx.Mnt, 0);
         }
         // Root
         ctx.Root = scene.getChildByName('Canvas');
-        if (!this.Root) {
-            // Canvas 是舞台的挂载前提，缺失时中止装配；仅记录日志，不向引擎事件派发抛出异常
-            this.Logger.Error(`启动错误：场景 ${scene.name} 缺少名为 Canvas 的根节点，舞台装配中止`);
-            return;
+        if (!ctx.Root) {
+            // Canvas 是舞台的挂载前提，缺失时中止装配
+            throw new Error(`启动错误：场景 ${scene.name} 缺少名为 Canvas 的根节点，舞台装配中止`);
         }
         // Stage
         ctx.Stage = ctx.Root.getChildByName('Stage');
@@ -149,14 +150,17 @@ class Launcher extends Plugin {
             wid.alignMode = Widget.AlignMode.ON_WINDOW_RESIZE;
             wid.updateAlignment();
             ctx.Stage = node;
-            this.Root.insertChild(this.Stage, 1);
+            ctx.Root.insertChild(ctx.Stage, 1);
         }
         // Canvas
         ctx.Canvas = ctx.Root.getComponent(Canvas);
+        if (!ctx.Canvas) {
+            throw new Error('Root 缺少 Canvas 组件');
+        }
         // CameraUi
         ctx.CameraUi = (_b = (_a = ctx.Root.getChildByName('Camera')) === null || _a === void 0 ? void 0 : _a.getComponent(Camera)) !== null && _b !== void 0 ? _b : null;
-        if (!this.CameraUi) {
-            this.Logger.Warn('启动警告：Canvas 缺少名为 Camera 的子节点，UI 相机不可用');
+        if (!ctx.CameraUi) {
+            throw new Error('Canvas 缺少名为 Camera 的子节点，UI 相机不可用');
         }
         this.Deps.EventBus.Sys.Notify(EventMessage.Void(LAUNCHER_EVENT.STAGE_READY));
     }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulaaa/launcher",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "启动器插件",
   "author": "doooreyn",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulaaa/launcher",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "启动器插件",
   "main": "./dist/launcher.cjs",
   "module": "./dist/launcher.mjs",