@dimina-kit/devtools 0.4.0-dev.20260616102751 → 0.4.0-dev.20260618090552

package/README.md

@@ -2,7 +2,7 @@
 
 基于 Electron 的小程序开发者工具。提供模拟器、Chrome DevTools 面板、WXML/AppData/Storage/编译 面板、编译配置等功能。
 
-下游 host 通过 `launch(config)` 集成并定制 devtools（零配置直接 `launch()`，配置驱动 `launch({...})`；见下方「两种用法」）。两种用法都经领域中立的 [`@dimina-kit/electron-deck`](../electron-deck) 框架编排——框架接管 Electron 进程生命周期（whenReady / will-quit）、wire/trust 原语，devtools 作为 `RuntimeBackend` 注入完整运行时（见 [`framework-extraction-v2.md`](../electron-deck/docs/framework-extraction-v2.md)）。
+下游 host 通过 `launch(config)` 集成并定制 devtools（零配置直接 `launch()`，配置驱动 `launch({...})`；见下方「两种用法」）。两种用法都经领域中立的 [`@dimina-kit/electron-deck`](../electron-deck) 框架编排——框架接管 Electron 进程生命周期（whenReady / will-quit）、wire/trust 原语，devtools 作为 `RuntimeBackend` 注入完整运行时（见 [`electron-deck 架构`](../electron-deck/docs/architecture.md)）。
 
 ---
 
@@ -195,7 +195,8 @@ src/
 | `menuBuilder`   | `(mainWindow, menuContext: MenuContext) => void` | 内置菜单 | 自定义菜单构建器；`menuContext` 为手写窄契约 `MenuContext`（`appName` + workspace 窄集 + `openSettings` + `notify.{projectStatus, windowNavigateBack}`），不含内部管线 |
 | `onSetup`       | `(instance) => void`                        | —           | 窗口和 context 创建后的回调，用于注册 Contribution（见下文）|
 | `onBeforeClose` | `(instance) => void`                        | —           | 窗口关闭前的回调，session 关闭由框架自动处理      |
-| `window`        | `WorkbenchWindowConfig`                     | —           | 窗口尺寸覆盖                                      |
+| `onBeforeOpenProject` | `(projectPath: string) => void \| Promise<void>` | — | 打开项目前、任何副作用（旧会话拆除 / 编译 / dev-server）之前运行的声明式权限门控。抛错即否决：`openProject` 返回 `{ success: false, error }`，当前活动会话保持不动、适配器不被调用，且框架自动把 error 透到状态条（`notify.projectStatus`）。覆盖 IPC / 菜单 / 内部直调三个打开入口 |
+| `window`        | `WorkbenchWindowConfig`（`width`/`height`/`autoShow?`） | — | 主窗口尺寸覆盖；`autoShow`（默认 `true`）控制 `ready-to-show` 是否自动显示窗口。`autoShow: false` 时窗口创建即隐藏（test / 非 test 一致），由 host 在登录通过后自行 `instance.mainWindow.show()` |
 | `updateChecker` | `UpdateChecker`                             | —           | 自定义更新检查器；提供后启用"检查更新"功能        |
 | `updateOptions` | `{ checkInterval?, initialDelay?, getCurrentVersion? }` | —  | 仅当 `updateChecker` 提供时生效，默认 1h / 5s     |
 
@@ -221,11 +222,11 @@ src/
 
 ## Embedding & Extending the Project Panel
 
-宿主（如 qdmp）通过 `launch({...})` 嵌入 devtools 时，可对项目面板做三个正交扩展：
+下游宿主通过 `launch({...})` 嵌入 devtools 时，可对项目面板做三个正交扩展：
 
 | 扩展点 | 用途 |
 | --- | --- |
-| `projectsProvider` | 接管项目列表存储 —— 替换默认 `<userData>/dimina-projects.json`，对接 qdmp 后台 / IDE workspace / 远端工程库 |
+| `projectsProvider` | 接管项目列表存储 —— 替换默认 `<userData>/dimina-projects.json`，对接下游宿主后台 / IDE workspace / 远端工程库 |
 | `projectTemplates` + `builtinTemplates` | 注入/覆盖/裁剪"新建项目"模板列表（同 id 覆盖内置；`builtinTemplates` 控制内置策略） |
 | `customCreateProjectDialog` | 用宿主自家页面替换内置"新建项目"对话框（main 进程 hook，可 `new BrowserWindow` 加载任意 URL，通过 IPC/postMessage 回传结果） |
 
@@ -233,8 +234,8 @@ src/
 
 | 场景 | 需要的扩展点 |
 | --- | --- |
-| 项目列表来自 qdmp 后台 / 团队工程库 | `projectsProvider` |
-| 仅替换可选模板（e.g. 只提供 taro / qdmp 自家脚手架） | `projectTemplates` + `builtinTemplates` |
+| 项目列表来自下游宿主后台 / 团队工程库 | `projectsProvider` |
+| 仅替换可选模板（e.g. 只提供 taro / 宿主自家脚手架） | `projectTemplates` + `builtinTemplates` |
 | 创建项目流程要走宿主自己的 wizard / 登录态 | `customCreateProjectDialog` |
 
 ### 最小示例
@@ -246,51 +247,51 @@ import { BrowserWindow } from 'electron'
 
 const provider: ProjectsProvider = {
   async listProjects() {
-    return await qdmp.api.listProjects()
+    return await host.api.listProjects()
   },
   async validateProjectDir(dirPath) {
-    return (await qdmp.api.isMiniApp(dirPath)) ? null : '不是合法的小程序工程'
+    return (await host.api.isMiniApp(dirPath)) ? null : '不是合法的小程序工程'
   },
   async addProject(dirPath) {
-    return await qdmp.api.addProject(dirPath)
+    return await host.api.addProject(dirPath)
   },
   async removeProject(dirPath) {
-    await qdmp.api.removeProject(dirPath)
+    await host.api.removeProject(dirPath)
   },
   async updateLastOpened(dirPath) {
-    await qdmp.api.touchLastOpened(dirPath)
+    await host.api.touchLastOpened(dirPath)
   },
   async getCompileConfig(dirPath) {
-    return await qdmp.api.getCompileConfig(dirPath)
+    return await host.api.getCompileConfig(dirPath)
   },
   async saveCompileConfig(dirPath, cfg) {
-    await qdmp.api.saveCompileConfig(dirPath, cfg)
+    await host.api.saveCompileConfig(dirPath, cfg)
   },
   // 缩略图走云端存储——dataUrl 形如 'data:image/png;base64,...'
   async saveThumbnail(dirPath, imageDataUrl) {
-    await qdmp.api.uploadThumbnail(dirPath, imageDataUrl)
+    await host.api.uploadThumbnail(dirPath, imageDataUrl)
   },
   async getThumbnail(dirPath) {
-    return await qdmp.api.fetchThumbnail(dirPath)
+    return await host.api.fetchThumbnail(dirPath)
   },
 }
 
-const qdmpBlank: ProjectTemplate = {
+const hostBlank: ProjectTemplate = {
   id: 'blank', // 同 id 覆盖内置 blank
-  name: 'qdmp 空白工程',
-  description: '由 qdmp 维护的官方空白模板',
+  name: '宿主空白工程',
+  description: '由下游宿主维护的官方空白模板',
   source: { type: 'directory', path: '/abs/path/to/template' },
 }
 
 launch({
   projectsProvider: provider,
-  projectTemplates: [qdmpBlank],
+  projectTemplates: [hostBlank],
   builtinTemplates: ['taro-todo'], // 只保留 taro-todo，干掉默认 blank
   customCreateProjectDialog: async ({ parentWindow }) => {
     const win = new BrowserWindow({ parent: parentWindow, modal: true, width: 720, height: 520 })
-    await win.loadURL('https://qdmp.example.com/devtools/new-project')
+    await win.loadURL('https://host.example.com/devtools/new-project')
     return await new Promise((resolve) => {
-      win.webContents.ipc.once('qdmp:create-project:done', (_e, payload) => {
+      win.webContents.ipc.once('host:create-project:done', (_e, payload) => {
         win.close()
         // payload 三选一（CustomCreateProjectDialogResult）：
         //   null                  → 用户取消
@@ -323,7 +324,7 @@ devtools 自带两个 `source`-style 模板，位于 `packages/devtools/template
 - `blank` — 最小空白小程序骨架（pages/index + app.js/json/wxss + project.config.json，约 8 个文件）
 - `taro-todo` — 复制自 `dimina/fe/example/taro-todo`，作为 Taro 编译产物的端到端演示工程
 
-`builtinTemplates: 'none'` 排除全部内置；`builtinTemplates: ['taro-todo']` 仅保留指定 id；`projectTemplates` 同 id 注入会覆盖（例如上文 `qdmpBlank` 覆盖了内置 `blank`）。
+`builtinTemplates: 'none'` 排除全部内置；`builtinTemplates: ['taro-todo']` 仅保留指定 id；`projectTemplates` 同 id 注入会覆盖（例如上文 `hostBlank` 覆盖了内置 `blank`）。
 
 ### Provider 部分实现 / fallback 行为
 
@@ -547,7 +548,7 @@ instance.context.views.hostToolbar.send('host:cmd', { theme: 'dark' }) // false
 
 ## MiniappRuntime（宿主集成推荐契约）
 
-下游宿主（如 qdmp）集成时，推荐依赖手写的稳定契约 `MiniappRuntime`，而不是整个 `WorkbenchContext`——后者携带全部内部 service 类型，内部重构会直接破坏下游编译。`asMiniappRuntime(ctx)` 恒等返回（typed view，非拷贝），宿主对 `runtime.workspace.openProject` 的 monkey-patch 会落在真实对象上：
+下游宿主集成时，推荐依赖手写的稳定契约 `MiniappRuntime`，而不是整个 `WorkbenchContext`——后者携带全部内部 service 类型，内部重构会直接破坏下游编译。`asMiniappRuntime(ctx)` 恒等返回（typed view，非拷贝），宿主对 `runtime.workspace.openProject` 的 monkey-patch 会落在真实对象上：
 
 ```typescript
 import { asMiniappRuntime, type MiniappRuntime } from '@dimina-kit/devtools'
@@ -679,7 +680,7 @@ pnpm test               # 运行测试
 本工具仅用于本地开发调试。当前的安全配置：
 
 - **Workbench 窗口**（main / settings / popover overlay）均启用 `contextIsolation` 并禁用 `nodeIntegration`；renderer 通过 main preload 经 `contextBridge` 拿到 `window.devtools.ipc`，每个 IPC handler 经 sender whitelist 校验调用方
-- **Simulator 本体** 是主进程顶层 `WebContentsView`（`nativeSimulatorView`，`partition='persist:simulator'`、`nodeIntegration=false`），其 preload 由 `webPreferences.preload = cjsSiblingPreloadPath(ctx.preloadPath)` 在创建时（`attachNativeSimulator`）固定；session 层的 `configureSimulatorSession()` 只设 Referer/CORS 头，不注册 frame preload。**小程序的每页代码** 运行在该 WCV 内部 DeviceShell 托管的 render-host `<webview>` guest 里（同 `persist:simulator` partition、`nodeIntegration=false`），承载逐页沙箱；guest 的 contextIsolation/sandbox 由主进程 `will-attach-webview` 钉死，渲染进程无法替换
+- **Simulator 本体** 是主进程顶层 `WebContentsView`（`nativeSimulatorView`，per-project `persist:miniapp-<key>` partition、无 appId 时回落共享 `persist:simulator`、`nodeIntegration=false`），其 preload 由 `webPreferences.preload = cjsSiblingPreloadPath(ctx.preloadPath)` 在创建时（`attachNativeSimulator`）固定。**小程序的每页代码** 运行在该 WCV 内部 DeviceShell 托管的 render-host `<webview>` guest 里（`nodeIntegration=false`），承载逐页沙箱；guest 不带静态 `partition` 属性，由主进程 `will-attach-webview` 钉到同一 per-project partition，并钉死 contextIsolation/sandbox，渲染进程无法替换
 - **renderer 入口** 启用了保守 CSP；`will-navigate` / `setWindowOpenHandler` 屏蔽外部跳转
 
 仍然不要在 devtools 窗口中加载不受信任的远程内容；本工具不打算在非本地环境部署。

package/dist/main/index.bundle.js

@@ -1276,7 +1276,7 @@ function buildDocumentUpdatedScript() {
   return buildDispatchScript(msg);
 }
 var DRAIN_INTERVAL_MS = 150;
-var INSTALL_POLL_TRIES = 80;
+var INSTALL_POLL_TRIES = 200;
 var INSTALL_POLL_INTERVAL_MS = 50;
 function installElementsForward(deps) {
   const { devtoolsWc, bridge } = deps;
@@ -1503,6 +1503,14 @@ function installElementsForward(deps) {
   const unsubscribeRenderEvents = bridge.onRenderEvent(onRenderEvent);
   const onReady = () => {
     if (disposed) return;
+    if (installTimer) {
+      clearInterval(installTimer);
+      installTimer = null;
+    }
+    if (drainTimer) {
+      clearInterval(drainTimer);
+      drainTimer = null;
+    }
     let tries = 0;
     installTimer = setInterval(() => {
       tries++;
@@ -1537,11 +1545,8 @@ function installElementsForward(deps) {
       });
     }, DRAIN_INTERVAL_MS);
   };
-  if (devtoolsWc.isLoading()) {
-    devtoolsWc.once("dom-ready", onReady);
-  } else {
-    onReady();
-  }
+  devtoolsWc.on("dom-ready", onReady);
+  onReady();
   let devtoolsClosedSub;
   try {
     if (deps.connections) devtoolsClosedSub = deps.connections.acquire(devtoolsWc).on("closed", stop);
@@ -1557,10 +1562,160 @@ function installElementsForward(deps) {
       devtoolsClosedSub?.dispose();
     } catch {
     }
+    try {
+      devtoolsWc.removeListener("dom-ready", onReady);
+    } catch {
+    }
     stop();
   };
 }
 
+// src/main/services/service-console/console-api.ts
+var RENDER_FORWARD_SOURCE_URL = "dimina://render-console-forward";
+var KNOWN_LEVELS = /* @__PURE__ */ new Set(["log", "warn", "error", "info", "debug"]);
+function mapConsoleApiType(type) {
+  if (type === "warning") return "warn";
+  if (type && KNOWN_LEVELS.has(type)) return type;
+  return "log";
+}
+var BIGINT_LITERAL = /^-?\d+n$/;
+function remoteObjectToValue(ro) {
+  if (!ro) return ro;
+  if ("value" in ro) return ro.value;
+  if (typeof ro.unserializableValue === "string") {
+    const u = ro.unserializableValue;
+    if (u === "Infinity") return Infinity;
+    if (u === "-Infinity") return -Infinity;
+    if (u === "NaN") return NaN;
+    if (u === "-0") return -0;
+    if (BIGINT_LITERAL.test(u)) return u;
+    return u;
+  }
+  switch (ro.type) {
+    case "undefined":
+      return void 0;
+    case "function":
+      return ro.description ?? "[Function]";
+    case "symbol":
+      return ro.description ?? "[Symbol]";
+    case "object":
+      if (ro.subtype === "null") return null;
+      return ro.description ?? "[Object]";
+    default:
+      return ro.description ?? "[Unknown]";
+  }
+}
+function needsDeepFetch(ro) {
+  if (!ro) return false;
+  if ("value" in ro) return false;
+  return ro.type === "object" && ro.subtype !== "null" && typeof ro.objectId === "string";
+}
+function isRenderForwardEvent(params, sentinelUrl) {
+  const top = params?.stackTrace?.callFrames?.[0]?.url;
+  return typeof top === "string" && top === sentinelUrl;
+}
+
+// src/main/services/service-console/index.ts
+function installServiceConsoleForward(deps) {
+  const { serviceWc, emit, connections } = deps;
+  let disposed = false;
+  let selfAttached = false;
+  let tail = Promise.resolve();
+  let closedSub;
+  function usableDebugger() {
+    try {
+      if (serviceWc.isDestroyed()) return false;
+      if (serviceWc.debugger.isAttached()) return true;
+    } catch {
+      return false;
+    }
+    try {
+      serviceWc.debugger.attach("1.3");
+      selfAttached = true;
+      return true;
+    } catch {
+      try {
+        return serviceWc.debugger.isAttached();
+      } catch {
+        return false;
+      }
+    }
+  }
+  async function resolveArg(ro) {
+    if (!needsDeepFetch(ro)) return remoteObjectToValue(ro);
+    try {
+      const res = await serviceWc.debugger.sendCommand("Runtime.callFunctionOn", {
+        objectId: ro.objectId,
+        functionDeclaration: "function () { return this }",
+        returnByValue: true
+      });
+      if (res && res.result && "value" in res.result) return res.result.value;
+    } catch {
+    }
+    return remoteObjectToValue(ro);
+  }
+  async function handleConsoleApi(params) {
+    if (disposed) return;
+    if (isRenderForwardEvent(params, RENDER_FORWARD_SOURCE_URL)) return;
+    const level = mapConsoleApiType(params.type);
+    const rawArgs = Array.isArray(params.args) ? params.args : [];
+    let args;
+    try {
+      args = await Promise.all(rawArgs.map((a) => resolveArg(a)));
+    } catch {
+      args = rawArgs.map((a) => remoteObjectToValue(a));
+    }
+    if (disposed) return;
+    emit({ source: "service", level, args, ts: Date.now() });
+  }
+  const onMessage = (_event, method, params) => {
+    if (disposed) return;
+    if (method !== "Runtime.consoleAPICalled") return;
+    const p = params;
+    tail = tail.then(() => handleConsoleApi(p)).catch(() => {
+    });
+  };
+  function stop() {
+    if (disposed) return;
+    disposed = true;
+    try {
+      closedSub?.dispose();
+    } catch {
+    }
+    try {
+      serviceWc.debugger.removeListener("message", onMessage);
+    } catch {
+    }
+    if (selfAttached) {
+      try {
+        if (!serviceWc.isDestroyed() && serviceWc.debugger.isAttached()) serviceWc.debugger.detach();
+      } catch {
+      }
+      selfAttached = false;
+    }
+  }
+  if (!usableDebugger()) {
+    disposed = true;
+    return { stop() {
+    } };
+  }
+  try {
+    serviceWc.debugger.on("message", onMessage);
+  } catch {
+    stop();
+    return { stop() {
+    } };
+  }
+  serviceWc.debugger.sendCommand("Runtime.enable").catch(() => {
+  });
+  try {
+    if (connections) closedSub = connections.acquire(serviceWc).on("closed", stop);
+    else serviceWc.once("destroyed", stop);
+  } catch {
+  }
+  return { stop };
+}
+
 // src/main/services/layout/index.ts
 function computeNativeSimulatorViewParams(rect, zoomPercent) {
   const zoomFactor = zoomPercent / 100;
@@ -1574,12 +1729,11 @@ function computeNativeSimulatorViewParams(rect, zoomPercent) {
     zoomFactor
   };
 }
-var SETTINGS_W = 320;
 function computeSettingsBounds(contentWidth, contentHeight, headerHeight) {
   return {
-    x: Math.max(0, contentWidth - SETTINGS_W),
+    x: 0,
     y: headerHeight,
-    width: Math.min(SETTINGS_W, Math.max(1, contentWidth)),
+    width: Math.max(1, contentWidth),
     height: Math.max(1, contentHeight - headerHeight)
   };
 }
@@ -1884,6 +2038,7 @@ function createViewManager(ctx) {
   let nativeDevtoolsSourceWc = null;
   let unsubscribeNativeRenderEvents = null;
   let stopElementsForward = null;
+  let stopServiceConsole = null;
   let nativeDevtoolsRetryTimer = null;
   let nativeDevtoolsRetryToken = 0;
   let simulatorBoundsOverride = null;
@@ -1931,6 +2086,7 @@ function createViewManager(ctx) {
     if (!simulatorViewAdded) {
       ctx.windows.mainWindow.contentView.addChildView(simulatorView);
       simulatorViewAdded = true;
+      raiseTopOverlays();
     }
     simulatorView.setBounds(bounds);
   }
@@ -2079,6 +2235,11 @@ function createViewManager(ctx) {
   function closeNativeDevtoolsSource() {
     const source = nativeDevtoolsSourceWc;
     nativeDevtoolsSourceWc = null;
+    try {
+      stopServiceConsole?.();
+    } catch {
+    }
+    stopServiceConsole = null;
     if (!source || source.isDestroyed()) return;
     try {
       if (source.isDevToolsOpened()) {
@@ -2192,6 +2353,15 @@ function createViewManager(ctx) {
       next.openDevTools({ mode: "detach", activate: false });
       wireOpenInEditor(next, simulatorView.webContents);
       customizeDevtoolsTabs(simulatorView.webContents);
+      try {
+        stopServiceConsole?.();
+      } catch {
+      }
+      stopServiceConsole = installServiceConsoleForward({
+        serviceWc: next,
+        connections: ctx.connections,
+        emit: (entry) => ctx.consoleForwarder?.emit(entry)
+      }).stop;
       return true;
     } catch {
       if (nativeDevtoolsSourceWc?.id === next.id) {
@@ -2488,6 +2658,7 @@ function createViewManager(ctx) {
         }
       });
       applyNavigationHardening(settingsView.webContents, ctx.rendererDir);
+      settingsView.setBackgroundColor("#00000000");
       await settingsView.webContents.loadFile(
         path7.join(ctx.rendererDir, "entries/settings/index.html")
       );
@@ -2507,6 +2678,12 @@ function createViewManager(ctx) {
       settingsViewAdded = false;
     }
   }
+  function raiseTopOverlays() {
+    if (ctx.windows.mainWindow.isDestroyed()) return;
+    const cv = ctx.windows.mainWindow.contentView;
+    if (settingsView && settingsViewAdded) cv.addChildView(settingsView);
+    if (popoverView) cv.addChildView(popoverView);
+  }
   function showPopover(data) {
     hidePopover();
     const popover = new WebContentsView2({
@@ -2572,6 +2749,7 @@ function createViewManager(ctx) {
     if (!nativeSimulatorViewAdded) {
       ctx.windows.mainWindow.contentView.addChildView(nativeSimulatorView);
       nativeSimulatorViewAdded = true;
+      raiseTopOverlays();
     }
     nativeSimulatorView.setBounds(p.bounds);
     const simWc = nativeSimulatorView.webContents;
@@ -4301,7 +4479,8 @@ var FORWARDABLE_LEVELS = /* @__PURE__ */ new Set(["log", "warn", "error", "info"
 function buildForwardScript(level, args) {
   const method = FORWARDABLE_LEVELS.has(level) ? level : "log";
   const argsJson = JSON.stringify(args ?? []);
-  return `(()=>{try{const a=JSON.parse(${JSON.stringify(argsJson)});console[${JSON.stringify(method)}]('[\u89C6\u56FE]',...a)}catch(_){}})()`;
+  return `(()=>{try{const a=JSON.parse(${JSON.stringify(argsJson)});console[${JSON.stringify(method)}]('[\u89C6\u56FE]',...a)}catch(_){}})()
+//# sourceURL=${RENDER_FORWARD_SOURCE_URL}`;
 }
 function createConsoleForwarder(bridge) {
   const sinks = /* @__PURE__ */ new Set();
@@ -4836,6 +5015,27 @@ function findSimulatorWebContents() {
 }
 
 // src/main/ipc/bridge-router.ts
+function rewriteSourceMappingUrl(source, scriptUrl) {
+  if (typeof source !== "string" || !source) return source;
+  const re = /(^|\n)[ \t]*\/\/[#@][ \t]*sourceMappingURL=([^\n]*)/g;
+  let lastIndex = -1;
+  let lastValue = "";
+  let m;
+  while ((m = re.exec(source)) !== null) {
+    lastIndex = m.index + m[1].length;
+    lastValue = (m[2] || "").trim();
+  }
+  if (lastIndex < 0 || !lastValue) return source;
+  if (/^(?:[a-z][a-z0-9+.-]*:)?\/\//i.test(lastValue) || /^data:/i.test(lastValue)) return source;
+  let absolute;
+  try {
+    absolute = new URL(lastValue, scriptUrl).toString();
+  } catch {
+    return source;
+  }
+  return `${source.slice(0, lastIndex)}
+//# sourceMappingURL=${absolute}`;
+}
 var STACK_ID = "stack_0";
 var PREWARM_MAX_POOL_SIZE = 4;
 function resolvePrewarmPoolSize() {
@@ -5365,7 +5565,7 @@ async function injectLogicBundle(ap) {
   try {
     const res = await fetch(logicUrl);
     if (!res.ok) throw new Error(`logic.js fetch ${res.status} at ${logicUrl}`);
-    const logicContent = await res.text();
+    const logicContent = rewriteSourceMappingUrl(await res.text(), logicUrl);
     await ap.serviceWc.executeJavaScript(`${logicContent}
 //# sourceURL=${logicUrl}`, true);
   } catch (error) {
@@ -8702,7 +8902,7 @@ var UpdateManager = class {
   downloadedPath = null;
   /**
    * Whether this instance has already emitted `Available` once. The periodic
-   * check fires forever (interval default 1h), and downstream UI (qdmp shell
+   * check fires forever (interval default 1h), and downstream UI (a downstream host shell
    * renders a native toast / Notification) is not idempotent — every event
    * stacks. We dedupe at the source: at most one Available per instance
    * lifetime, regardless of how the upstream `info.version` shifts. The user

package/dist/main/ipc/bridge-router.js

@@ -11,6 +11,46 @@ import { ServiceHostPool } from '../services/service-host-pool/pool.js';
 import { registerMiniappSessionConfigurator, SHARED_MINIAPP_PARTITION, } from '../services/views/miniapp-partition.js';
 import { createConsoleForwarder } from '../services/console-forward/index.js';
 import { STORAGE_API_NAMES } from '../services/simulator-storage/index.js';
+// The compiled `logic.js` ships a RELATIVE `//# sourceMappingURL=logic.js.map`.
+// `injectLogicBundle` loads it via `executeJavaScript`, which gives the injected
+// script no base URL of its own — so DevTools resolves that relative map against
+// the service-host DOCUMENT and 404s, leaving console frames / Sources links
+// pointing at the compiled bundle instead of the developer's source. This rewrite
+// turns the directive absolute.
+//
+// Inlined (not imported from `service-host/sourcemap-rewrite.cjs`) ON PURPOSE:
+// the shipped main entry is the FLAT esbuild bundle (`dist/main/index.bundle.js`,
+// see electron-builder.yml `extraMetadata.main`). A runtime `createRequire(...)`
+// of the relative `.cjs` resolved against `import.meta.url`, which is the bundle
+// at `dist/main/` (one level shallower than the tsc tree `dist/main/ipc/`), so
+// the path 404'd and the PACKAGED app crashed on load. Bundling the logic inline
+// is bundler-proof. KEEP IN SYNC with `service-host/sourcemap-rewrite.cjs` (the
+// copied-not-bundled service-host preload still requires that one).
+function rewriteSourceMappingUrl(source, scriptUrl) {
+    if (typeof source !== 'string' || !source)
+        return source;
+    const re = /(^|\n)[ \t]*\/\/[#@][ \t]*sourceMappingURL=([^\n]*)/g;
+    let lastIndex = -1;
+    let lastValue = '';
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        lastIndex = m.index + m[1].length;
+        lastValue = (m[2] || '').trim();
+    }
+    if (lastIndex < 0 || !lastValue)
+        return source;
+    // Already absolute (scheme://, protocol-relative //host, or data:)? Leave it.
+    if (/^(?:[a-z][a-z0-9+.-]*:)?\/\//i.test(lastValue) || /^data:/i.test(lastValue))
+        return source;
+    let absolute;
+    try {
+        absolute = new URL(lastValue, scriptUrl).toString();
+    }
+    catch {
+        return source;
+    }
+    return `${source.slice(0, lastIndex)}\n//# sourceMappingURL=${absolute}`;
+}
 const STACK_ID = 'stack_0';
 /** Hard ceiling on the pre-warm pool, mirroring ServiceHostPool/doc §3.3. */
 const PREWARM_MAX_POOL_SIZE = 4;
@@ -690,7 +730,10 @@ async function injectLogicBundle(ap) {
         const res = await fetch(logicUrl);
         if (!res.ok)
             throw new Error(`logic.js fetch ${res.status} at ${logicUrl}`);
-        const logicContent = await res.text();
+        // Rewrite the relative `sourceMappingURL` to an absolute dev-server URL
+        // BEFORE injecting — `executeJavaScript` gives the script no base URL, so a
+        // relative map would 404 and break sourcemapped console frames / Sources.
+        const logicContent = rewriteSourceMappingUrl(await res.text(), logicUrl);
         await ap.serviceWc.executeJavaScript(`${logicContent}\n//# sourceURL=${logicUrl}`, true);
     }
     catch (error) {

package/dist/main/runtime/devtools-backend.d.ts

@@ -11,7 +11,7 @@ import type { WorkbenchAppConfig } from '../../shared/types.js';
  * v2 scope: the backend owns window creation (the framework skips its own when a
  * backend is present), so `assemble` ignores the framework `runtime` and builds
  * the real devtools main window itself. Trust/frame unification and surfacing
- * the runtime facade are deferred (see framework-extraction-v2.md §7).
+ * the runtime facade are deferred.
  *
  * NOT migrating onto deck's high-level host API (Window facade / runtime.view /
  * DeckSession / grants) is a DELIBERATE, reviewed decision — not a backlog item.

package/dist/main/runtime/devtools-backend.js

@@ -11,7 +11,7 @@ import { registerAppLifecycle } from '../app/lifecycle.js';
  * v2 scope: the backend owns window creation (the framework skips its own when a
  * backend is present), so `assemble` ignores the framework `runtime` and builds
  * the real devtools main window itself. Trust/frame unification and surfacing
- * the runtime facade are deferred (see framework-extraction-v2.md §7).
+ * the runtime facade are deferred.
  *
  * NOT migrating onto deck's high-level host API (Window facade / runtime.view /
  * DeckSession / grants) is a DELIBERATE, reviewed decision — not a backlog item.

package/dist/main/runtime/miniapp-runtime.d.ts

@@ -6,7 +6,7 @@
  * would drag every nested internal service type (ViewManager,
  * BridgeRouterHandle, SimulatorApiRegistry, Electron WebContents…) onto the
  * public semver face, so any internal refactor of those services becomes an
- * unreviewed breaking change for downstream hosts (qdmp). Instead this module
+ * unreviewed breaking change for downstream hosts. Instead this module
  * names ONLY the audited downstream consumption surface, with structural DTOs
  * and zero Electron types — non-Electron consumers can compile against it.
  *
@@ -171,7 +171,7 @@ export interface MiniappWorkspace {
     } | null;
 }
 /**
- * The stable miniapp-kernel surface a downstream host (qdmp) consumes.
+ * The stable miniapp-kernel surface a downstream host consumes.
  * Compiler-enforced and versionable: widening it back toward internal
  * plumbing is a deliberate semver decision, not an accident of projection.
  */

package/dist/main/services/console-forward/index.js

@@ -1,4 +1,5 @@
 import { DisposableRegistry, toDisposable } from '@dimina-kit/electron-deck/main';
+import { RENDER_FORWARD_SOURCE_URL } from '../service-console/console-api.js';
 /** Console levels we re-emit into the service host. Anything else maps to 'log'. */
 const FORWARDABLE_LEVELS = new Set(['log', 'warn', 'error', 'info', 'debug']);
 /**
@@ -16,7 +17,13 @@ function buildForwardScript(level, args) {
     const argsJson = JSON.stringify(args ?? []);
     // `console[method]` (not `console.log`) preserves the original level so the
     // DevTools severity filter still works on the forwarded line.
-    return `(()=>{try{const a=JSON.parse(${JSON.stringify(argsJson)});console[${JSON.stringify(method)}]('[视图]',...a)}catch(_){}})()`;
+    //
+    // The trailing `//# sourceURL` stamps this injected line with a sentinel URL.
+    // The service-console CDP capture (services/service-console) attached to THIS
+    // service host would otherwise re-capture this `console[...]` call as a fresh
+    // service entry and re-broadcast it to automation (duplicate). It skips any
+    // `consoleAPICalled` whose top frame URL === RENDER_FORWARD_SOURCE_URL.
+    return `(()=>{try{const a=JSON.parse(${JSON.stringify(argsJson)});console[${JSON.stringify(method)}]('[视图]',...a)}catch(_){}})()\n//# sourceURL=${RENDER_FORWARD_SOURCE_URL}`;
 }
 export function createConsoleForwarder(bridge) {
     const sinks = new Set();

package/dist/main/services/elements-forward/index.js

@@ -173,7 +173,11 @@ function buildDocumentUpdatedScript() {
 }
 const DRAIN_INTERVAL_MS = 150;
 /** Bounded retry for the front-end hook install (front-end boots asynchronously). */
-const INSTALL_POLL_TRIES = 80;
+// Per-load install poll window. Must outlast the gap between a devtools
+// front-end `dom-ready` and `InspectorFrontendHost` becoming available on a
+// cold/slow open (pool cold-start). 200×50ms = 10s — generous, and each future
+// front-end load re-arms a fresh window anyway (see the `dom-ready` listener).
+const INSTALL_POLL_TRIES = 200;
 const INSTALL_POLL_INTERVAL_MS = 50;
 /**
  * Install Elements forwarding on a DevTools front-end host wc. Returns a disposer
@@ -504,6 +508,17 @@ export function installElementsForward(deps) {
     const onReady = () => {
         if (disposed)
             return;
+        // Re-arm safe: a devtools front-end (re)load re-runs this, so clear any
+        // in-flight timers from a prior attempt before starting fresh ones — without
+        // this a reload would stack intervals (leak) and double-drain.
+        if (installTimer) {
+            clearInterval(installTimer);
+            installTimer = null;
+        }
+        if (drainTimer) {
+            clearInterval(drainTimer);
+            drainTimer = null;
+        }
         let tries = 0;
         installTimer = setInterval(() => {
             tries++;
@@ -550,12 +565,17 @@ export function installElementsForward(deps) {
                 .catch(() => { });
         }, DRAIN_INTERVAL_MS);
     };
-    if (devtoolsWc.isLoading()) {
-        devtoolsWc.once('dom-ready', onReady);
-    }
-    else {
-        onReady();
-    }
+    // Re-install on EVERY devtools front-end load, not once. The hook lives in the
+    // front-end's `globalThis` (`__diminaElementsHookInstalled`), so any front-end
+    // (re)load wipes it — most importantly a service-host pool SWAP, which re-opens
+    // DevTools (`pointNativeDevtoolsAtServiceWc`) and re-bootstraps the front-end.
+    // A single-shot `once('dom-ready')` left the hook uninstalled after such a
+    // reload, so Elements silently fell back to the native service-host DOM. A
+    // PERSISTENT listener re-runs the (idempotent — the sentinel returns 'already')
+    // install on each load; the immediate call covers an already-loaded wc and the
+    // first `openDevTools` whose `dom-ready` may have fired before this ran.
+    devtoolsWc.on('dom-ready', onReady);
+    onReady();
     let devtoolsClosedSub;
     try {
         // Devtools front-end wc is never pool-reset → use `'closed'` (fires only on
@@ -577,6 +597,10 @@ export function installElementsForward(deps) {
             devtoolsClosedSub?.dispose();
         }
         catch { /* already gone */ }
+        try {
+            devtoolsWc.removeListener('dom-ready', onReady);
+        }
+        catch { /* already gone */ }
         stop();
     };
 }