M4: 通用网页容器 + SettingsProxy + NavProvider + 子游戏切换

T-M4-01/02/03 GenericWebContainer（§11.3 第二套机制，不挂桥）：
  - javaScriptProxy 注入 settings 对象 6 方法（SettingsProxy，函数回调避开 ArkTS 对象字面量限制）
  - 首次 100% runJavaScript 直调 getWebdata('<data>')；返回键 isbackfinishweb→gamebackkeydown /
    isexitdialogeshow→退出确认→backgameData()；关闭 pop({data}) 101 语义回上层
  - orientation "1"竖/其他横（window.setPreferredOrientation）；browser 隐式 want
T-M3-06 NavProvider：OpenurlTitleData(开通用容器,onPop→callHandler getWebdata)、
  SwitchOverGameData(同容器 loadUrl 切子游戏+重注入 app_data(launchtype'1')+方向+复位首屏标志)、
  getGameinstall(同步 1/0 查 <解压根>/<dir>/index.html)、backgameData(重载大厅+待加载后 getWebdata)
导航解耦：common NavEvents(名+具名 payload interface)；NavProvider 发 EventBus → BridgeGameContainer 执行
  （容器持 pathStack/controller）。EventBus payload 放宽为 Object（ArkTS 禁 Record 字面量），用 GenericEventData
domain AppDataInjector.buildValues 复用（StartupOrchestrator + 子游戏切换共用，去重）
组装根装配 NavProvider

devecocli build 通过。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

feature_capabilities/Index.ets

@@ -22,6 +22,7 @@ export { ScanProvider } from './src/main/ets/providers/ScanProvider';
 export { CameraProvider } from './src/main/ets/providers/CameraProvider';
 export { LocationProvider } from './src/main/ets/providers/LocationProvider';
 export { AudioProvider } from './src/main/ets/providers/AudioProvider';
+export { NavProvider } from './src/main/ets/providers/NavProvider';
 
 // 微信 SDK 封装（EntryAbility 处理回调 want 需用）
 export { WeChatApi, WX_APP_ID } from './src/main/ets/wx/WeChatApi';

feature_capabilities/src/main/ets/providers/NavProvider.ets

@@ -0,0 +1,77 @@
+/**
+ * 导航能力（契约 §8.8/§8.9/§8.10/§11，T-M3-06）。
+ *  - OpenurlTitleData：打开通用网页容器（路径 B，§11.2），关闭回传 → 上层 getWebdata。
+ *  - SwitchOverGameData：容器内切换子游戏（路径 A，§11.1），同容器 loadUrl。
+ *  - getGameinstall：同步返回子游戏资源是否就绪（"1"/"0"）。
+ *  - backgameData：子游戏带数据返回大厅。
+ *
+ * 容器持 pathStack/WebviewController，本 Provider 经 EventBus 发导航事件，由 BridgeGameContainer 执行。
+ */
+import { common } from '@kit.AbilityKit';
+import { FileSystem } from 'platform';
+import { ResourceManager, ConfigManager } from 'domain_resource';
+import { BridgeController } from 'feature_bridge';
+import { InboundHandlers, OpenUrlTitleDataReq, SwitchOverGameReq } from 'contracts';
+import { EventBus, NavEvents, OpenGenericWebPayload, SwitchGamePayload, BackGamePayload, Logger } from 'common';
+import { CapabilityContext, CapabilityProvider } from '../core/CapabilityProvider';
+
+export class NavProvider implements CapabilityProvider {
+  readonly name: string = 'nav';
+  private readonly log: Logger = Logger.tag('NavProvider');
+  private context: common.UIAbilityContext | undefined = undefined;
+  private config: ConfigManager | undefined = undefined;
+
+  register(bridge: BridgeController, ctx: CapabilityContext): void {
+    this.context = ctx.uiAbilityContext;
+    this.config = ctx.config;
+
+    bridge.registerHandler(InboundHandlers.OpenUrlTitleData, (data: string, _cb: (resp: string) => void) => {
+      this.openUrl(data);
+    });
+    bridge.registerHandler(InboundHandlers.SwitchOverGameData, (data: string, _cb: (resp: string) => void) => {
+      this.switchGame(data);
+    });
+    bridge.registerHandler(InboundHandlers.GetGameInstall, (data: string, cb: (resp: string) => void) => {
+      cb(this.isGameInstalled(data) ? '1' : '0');
+    });
+    bridge.registerHandler(InboundHandlers.BackGameData, (data: string, _cb: (resp: string) => void) => {
+      const payload: BackGamePayload = { data };
+      EventBus.emit(NavEvents.BACK_GAME, payload);
+    });
+  }
+
+  private openUrl(data: string): void {
+    let req: OpenUrlTitleDataReq;
+    try {
+      req = JSON.parse(data) as OpenUrlTitleDataReq;
+    } catch (e) {
+      this.log.w(`OpenurlTitleData bad json: ${(e as Error).message}`);
+      return;
+    }
+    const payload: OpenGenericWebPayload = { url: req.url, title: req.title, data: req.data, orientation: '' };
+    EventBus.emit(NavEvents.OPEN_GENERIC_WEB, payload);
+  }
+
+  private switchGame(data: string): void {
+    let req: SwitchOverGameReq;
+    try {
+      req = JSON.parse(data) as SwitchOverGameReq;
+    } catch (e) {
+      this.log.w(`SwitchOverGameData bad json: ${(e as Error).message}`);
+      return;
+    }
+    const payload: SwitchGamePayload = { webtype: req.webtype, dir: req.Gamedirectory, data: req.data };
+    EventBus.emit(NavEvents.SWITCH_GAME, payload);
+  }
+
+  /** 子游戏资源是否就绪：<解压根>/<dir>/index.html 存在。 */
+  private isGameInstalled(dir: string): boolean {
+    const ctx = this.context;
+    const cfg = this.config;
+    if (ctx === undefined || cfg === undefined || dir === '') {
+      return false;
+    }
+    const urlpath: string = `${ResourceManager.resourceRoot(ctx)}/${cfg.getLocal().gamedir}`;
+    return FileSystem.exists(`${urlpath}/${dir}/index.html`);
+  }
+}