@dimina-kit/devtools 0.4.0-dev.20260612025610 → 0.4.0-dev.20260612152115

package/README.md

@@ -1,6 +1,6 @@
 # Dimina DevTools
 
-基于 Electron 的小程序开发者工具。提供模拟器、Chrome DevTools 面板、WXML/AppData/Storage 面板、编译配置等功能。
+基于 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)）。
 
@@ -147,7 +147,7 @@ src/
         main.tsx                         # 主窗口 React 根
         features/                        # 主窗口内的业务区域
           project-runtime/               # 项目视图 + 工具栏 + 右侧面板切换
-          right-panel/                   # WXML / AppData / Storage 面板
+          right-panel/                   # WXML / AppData / Storage / 编译 面板
       popover/ settings/ workbench-settings/
     shared/
       components/                        # UI 组件（ui / layout / json-viewer / ...）
@@ -177,7 +177,7 @@ src/
 | ------------------ | -------------------- | ------------------- | ---------------------------------- |
 | `appName`          | `string`             | `'Dimina DevTools'` | 窗口标题                           |
 | `adapter`          | `CompilationAdapter` | 内置                | 项目编译适配器                     |
-| `panels`           | `BuiltinPanelId[]`   | —                   | **已废弃，运行时忽略**：界面恒显示全部四个内置面板；保留字段仅为兼容仍传它的 host |
+| `panels`           | `BuiltinPanelId[]`   | —                   | **已废弃，运行时忽略**：界面恒显示全部内置面板（WXML / AppData / Storage / Console / 编译）；保留字段仅为兼容仍传它的 host |
 | `preloadPath`      | `string`             | 内置                | 统一的 host 级 preload 入口；native-host simulator（WCV）自动跑其 `.cjs` sibling（`cjsSiblingPreloadPath`） |
 | `apiNamespaces`    | `string[]`           | `[]`                | 自定义 API 命名空间（如 `['qd']`） |
 | `brandingProvider` | `() => { appName }`  | —                   | 品牌信息 provider                  |
@@ -483,7 +483,7 @@ launch({
 
 ## Host Toolbar（宿主自定义工具栏）
 
-下游通过 `instance.context.views.hostToolbar` 拥有 devtools 头部下方的工具栏条（一个 WebContentsView）：`loadURL` / `loadFile` 加载自己的内容，`setPreloadPath` 注入自己的 preload，`setHeightMode` 钉死或自动跟随内容高度（自动模式要求内容自带 shrink-to-fit 的 `[data-host-toolbar-root]` 包裹元素；`{ fixed }` 校验入参——非有限数或负数同步抛 `TypeError` 且不污染既有模式）。
+下游通过 `instance.context.views.hostToolbar` 拥有 devtools 头部下方的工具栏条（一个 WebContentsView）：`loadURL` / `loadFile` 加载自己的内容，`setPreloadPath` 注入自己的 preload，`setHeightMode` 钉死或自动跟随内容高度（自动模式要求内容自带 shrink-to-fit 的 `[data-host-toolbar-root]` 包裹元素；`{ fixed }` 校验入参——非有限数或负数同步抛 `TypeError` 且不污染既有模式）。主进程保留最后一次下发的高度（`views.getHostToolbarHeight()`），项目视图的占位条挂载时会主动拉取并回放——广播器对已上报的高度去重不再重发，没有这一步，冷启动在项目列表期间的上报、以及关闭项目再打开后的高度都会永久丢失（工具栏条塌缩为 0）。
 
 ### 双向消息：onMessage / send
 

package/dist/main/index.bundle.js

@@ -374,6 +374,10 @@ var ProjectChannel = {
   GetCompileConfig: "project:getCompileConfig",
   SaveCompileConfig: "project:saveCompileConfig",
   Status: "project:status",
+  // Main → renderer push of per-line dmcc compile logs (devkit `onLog`).
+  // Dedicated channel: `project:status` keeps its one-event-per-payload
+  // contract (compileEvents), this one carries the line stream (compileLogs).
+  CompileLog: "project:compileLog",
   CaptureThumbnail: "project:captureThumbnail",
   GetThumbnail: "project:getThumbnail"
 };
@@ -440,7 +444,17 @@ var ViewChannel = {
    * main → main-window renderer: push the reserved host-toolbar height so the
    * renderer placeholder div resizes (closing the dynamic-height loop).
    */
-  HostToolbarHeightChanged: "view:host-toolbar:height-changed"
+  HostToolbarHeightChanged: "view:host-toolbar:height-changed",
+  /**
+   * main ← main-window renderer (invoke): pull the last NOTIFIED toolbar
+   * height retained in main. Mount-time replay companion to
+   * `HostToolbarHeightChanged`: the push listener mounts with the project
+   * view and the toolbar's size-advertiser deduplicates (never re-reports),
+   * so a height pushed while no project view was mounted would otherwise be
+   * lost forever (cold start on the project list races it; close-project →
+   * reopen hits it deterministically). No payload; resolves a number.
+   */
+  HostToolbarGetHeight: "view:host-toolbar:get-height"
 };
 var PopoverChannel = {
   Show: "popover:show",
@@ -966,6 +980,9 @@ function createRendererNotifier(ctx) {
     projectStatus(payload) {
       sendToMain(ProjectChannel.Status, payload);
     },
+    compileLog(payload) {
+      sendToMain(ProjectChannel.CompileLog, payload);
+    },
     windowNavigateBack() {
       sendToMain(WindowChannel.NavigateBack);
     },
@@ -1841,6 +1858,7 @@ function createViewManager(ctx) {
   let hostToolbarViewAdded = false;
   let hostToolbarRuntimeAcquired = false;
   let hostToolbarHeightMode = "auto";
+  let hostToolbarLastHeight = 0;
   const hostToolbarPort = createHostToolbarPortChannel({
     isCurrent: (wc) => liveHostToolbarWebContents() === wc
   });
@@ -1943,9 +1961,13 @@ function createViewManager(ctx) {
     }
     view.setBounds(bounds);
   }
+  function notifyHostToolbarHeight(height) {
+    hostToolbarLastHeight = height;
+    ctx.notify.hostToolbarHeightChanged(height);
+  }
   function setHostToolbarHeight(extent) {
     if (hostToolbarHeightMode !== "auto") return;
-    ctx.notify.hostToolbarHeightChanged(extent);
+    notifyHostToolbarHeight(extent);
   }
   function hideHostToolbar() {
     if (hostToolbarView && hostToolbarViewAdded && !ctx.windows.mainWindow.isDestroyed()) {
@@ -1955,7 +1977,7 @@ function createViewManager(ctx) {
       }
     }
     hostToolbarViewAdded = false;
-    ctx.notify.hostToolbarHeightChanged(0);
+    notifyHostToolbarHeight(0);
   }
   const hostToolbar = {
     async loadURL(url) {
@@ -1985,7 +2007,7 @@ function createViewManager(ctx) {
       }
       hostToolbarHeightMode = mode;
       if (mode !== "auto") {
-        ctx.notify.hostToolbarHeightChanged(mode.fixed);
+        notifyHostToolbarHeight(mode.fixed);
       }
     },
     onMessage(channel, handler) {
@@ -2546,6 +2568,7 @@ function createViewManager(ctx) {
       return popoverView.webContents.id;
     },
     getHostToolbarWebContentsId: () => liveHostToolbarWebContents()?.id ?? null,
+    getHostToolbarHeight: () => hostToolbarLastHeight,
     setNativeSimulatorViewBounds,
     resize,
     setSimulatorDevtoolsBounds,
@@ -2823,6 +2846,7 @@ function createWorkspaceService(ctx) {
   let currentSession = null;
   let currentProjectPath = "";
   let lastClosedProjectPath = "";
+  let logGeneration = 0;
   function sendStatus(status2, message, hotReload) {
     ctx.notify.projectStatus(hotReload ? { status: status2, message, hotReload: true } : { status: status2, message });
   }
@@ -2871,6 +2895,7 @@ function createWorkspaceService(ctx) {
     validateProjectDir: async (dirPath) => provider.validateProjectDir ? provider.validateProjectDir(dirPath) : null,
     async openProject(projectPath) {
       clearSimulatorServicewechatReferer();
+      logGeneration++;
       await disposeSession();
       currentProjectPath = "";
       lastClosedProjectPath = "";
@@ -2881,6 +2906,7 @@ function createWorkspaceService(ctx) {
       }
       sendStatus("compiling", "\u6B63\u5728\u7F16\u8BD1...");
       const { compile } = loadWorkbenchSettings();
+      const sessionGeneration = ++logGeneration;
       let session5;
       try {
         session5 = await ctx.adapter.openProject({
@@ -2888,7 +2914,21 @@ function createWorkspaceService(ctx) {
           sourcemap: true,
           watch: compile.watch,
           onRebuild: () => sendStatus("ready", "\u7F16\u8BD1\u5B8C\u6210\uFF0C\u5DF2\u70ED\u66F4\u65B0", true),
-          onBuildError: (err) => sendStatus("error", String(err))
+          onBuildError: (err) => sendStatus("error", String(err)),
+          // Per-line dmcc log (already filtered in devkit). Stamp the
+          // wall-clock capture time here and push verbatim on the dedicated
+          // compile-log channel — never through projectStatus, whose
+          // one-event-per-payload contract feeds compileEvents. Stale lines
+          // (a closed/replaced session's worker flushing its buffers) are
+          // dropped via the generation check.
+          onLog: (entry) => {
+            if (sessionGeneration !== logGeneration) return;
+            ctx.notify.compileLog({
+              stream: entry.stream,
+              text: entry.text,
+              at: Date.now()
+            });
+          }
         });
       } catch (err) {
         clearSimulatorServicewechatReferer();
@@ -2922,6 +2962,7 @@ function createWorkspaceService(ctx) {
       };
     },
     async closeProject() {
+      logGeneration++;
       clearSimulatorServicewechatReferer();
       await disposeSession();
       if (currentProjectPath !== "") lastClosedProjectPath = currentProjectPath;
@@ -4756,12 +4797,16 @@ function summarizeBridgeMsg(payload) {
 var API_CALL_TIMEOUT_MS = 5e3;
 function resolveCurrentApp(state, ctx, appId) {
   if (appId) {
-    for (const ap of state.appSessions.values()) if (ap.appId === appId) return ap;
+    let match;
+    for (const ap of state.appSessions.values()) if (ap.appId === appId) match = ap;
+    if (match) return match;
   }
   const appInfo = ctx.workspace?.getSession?.()?.appInfo;
   const activeAppId = appInfo?.appId;
   if (activeAppId) {
-    for (const ap of state.appSessions.values()) if (ap.appId === activeAppId) return ap;
+    let match;
+    for (const ap of state.appSessions.values()) if (ap.appId === activeAppId) match = ap;
+    if (match) return match;
   }
   let last;
   for (const ap of state.appSessions.values()) last = ap;
@@ -4778,7 +4823,11 @@ function installBridgeRouter(ctx) {
     emitRenderEvent: () => {
     },
     connections: ctx.connections,
-    debugTap: createDebugTap({ enabled: resolveDebugTapEnabled() })
+    debugTap: createDebugTap({ enabled: resolveDebugTapEnabled() }),
+    evictAppDataBridges: (ap) => {
+      if (!ctx.appData) return;
+      for (const page of ap.pages.values()) ctx.appData.evictBridge(ap.appId, page.bridgeId);
+    }
   };
   const prewarmPoolSize = resolvePrewarmPoolSize();
   if (prewarmPoolSize > 0) {
@@ -4950,9 +4999,6 @@ function installBridgeRouter(ctx) {
       console.warn(`[bridge-router] DISPOSE rejected: sender belongs to ${senderApp.appSessionId}, target ${target.appSessionId}`);
       return;
     }
-    if (ctx.appData) {
-      for (const page of target.pages.values()) ctx.appData.evictBridge(target.appId, page.bridgeId);
-    }
     void disposeAppSession(state, target.appSessionId);
   };
   ipcMain3.on(BRIDGE_CHANNELS.DISPOSE, onDispose);
@@ -5135,6 +5181,10 @@ async function handleSpawn(state, ctx, event, opts) {
   };
   appSession.onServiceClosed = onServiceClosed;
   serviceWindow.once("closed", onServiceClosed);
+  const onSimulatorDestroyed = () => {
+    void disposeAppSession(state, appSessionId);
+  };
+  simulatorWc.once("destroyed", onSimulatorDestroyed);
   if (usedPool) {
     const bootOnServiceLoad = () => {
       if (serviceWindow.isDestroyed()) return;
@@ -5639,6 +5689,7 @@ async function disposeAppSession(state, appSessionId, opts = {}) {
   const ap = state.appSessions.get(appSessionId);
   if (!ap) return;
   state.appSessions.delete(appSessionId);
+  state.evictAppDataBridges(ap);
   for (const [requestId, pending] of state.pendingApiCalls) {
     if (pending.appSessionId !== appSessionId) continue;
     clearTimeout(pending.timer);
@@ -5804,7 +5855,7 @@ function registerViewsIpc(ctx) {
       args
     );
     ctx.views.setHostToolbarBounds(bounds);
-  });
+  }).handle(ViewChannel.HostToolbarGetHeight, () => ctx.views.getHostToolbarHeight());
   const onAdvertiseHeight = (event, ...args) => {
     if (event.sender.id !== ctx.views.getHostToolbarWebContentsId()) return;
     let extent;

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

@@ -58,17 +58,26 @@ const API_CALL_TIMEOUT_MS = 5_000;
  * rather than assuming a single session.
  */
 function resolveCurrentApp(state, ctx, appId) {
+    // Same-appId matches prefer the MOST RECENT spawn (Maps preserve insertion
+    // order): after a respawn/reopen the newest session is the live one — the
+    // first match could be a just-superseded session mid-teardown.
     if (appId) {
+        let match;
         for (const ap of state.appSessions.values())
             if (ap.appId === appId)
-                return ap;
+                match = ap;
+        if (match)
+            return match;
     }
     const appInfo = ctx.workspace?.getSession?.()?.appInfo;
     const activeAppId = appInfo?.appId;
     if (activeAppId) {
+        let match;
         for (const ap of state.appSessions.values())
             if (ap.appId === activeAppId)
-                return ap;
+                match = ap;
+        if (match)
+            return match;
     }
     // Maps preserve insertion order; the last entry is the most recent spawn.
     let last;
@@ -87,6 +96,12 @@ export function installBridgeRouter(ctx) {
         emitRenderEvent: () => { },
         connections: ctx.connections,
         debugTap: createDebugTap({ enabled: resolveDebugTapEnabled() }),
+        evictAppDataBridges: (ap) => {
+            if (!ctx.appData)
+                return;
+            for (const page of ap.pages.values())
+                ctx.appData.evictBridge(ap.appId, page.bridgeId);
+        },
     };
     // Opt-in (default OFF) pre-warm pool for service-host windows. When enabled,
     // handleSpawn acquires a warm window instead of constructing one per spawn.
@@ -298,12 +313,8 @@ export function installBridgeRouter(ctx) {
             console.warn(`[bridge-router] DISPOSE rejected: sender belongs to ${senderApp.appSessionId}, target ${target.appSessionId}`);
             return;
         }
-        // Native-host AppData: clear the app's accumulated bridges so a re-opened
-        // project doesn't show ghost tabs from the prior session.
-        if (ctx.appData) {
-            for (const page of target.pages.values())
-                ctx.appData.evictBridge(target.appId, page.bridgeId);
-        }
+        // AppData bridge eviction happens inside disposeAppSession (single
+        // chokepoint shared with the simulator-WCV 'destroyed' path).
         void disposeAppSession(state, target.appSessionId);
     };
     ipcMain.on(C.DISPOSE, onDispose);
@@ -517,6 +528,19 @@ async function handleSpawn(state, ctx, event, opts) {
     };
     appSession.onServiceClosed = onServiceClosed;
     serviceWindow.once('closed', onServiceClosed);
+    // The simulator WCV owns the app's UI lifetime. When it is destroyed —
+    // project close (`views.disposeAll`/detach) or a DeviceShell respawn
+    // (`attachNativeSimulator`, e.g. watcher hot reload) — the guest never gets
+    // to send its graceful `C.DISPOSE`, so without this hook the app session and
+    // its hidden service-host window leak, and `resolveCurrentApp` keeps
+    // resolving the STALE session for the same appId: `getActiveRenderWc` then
+    // dereferences dead pages and every panel pull (WXML/elements) returns null
+    // for the whole next session. Disposing here is idempotent with the graceful
+    // path (`disposeAppSession` early-returns once the session is gone).
+    const onSimulatorDestroyed = () => {
+        void disposeAppSession(state, appSessionId);
+    };
+    simulatorWc.once('destroyed', onSimulatorDestroyed);
     if (usedPool) {
         // A pooled/fallback window passes through about:blank (warm load or the
         // fallback's initial load). Boot only once the REAL service.html navigation
@@ -1144,6 +1168,9 @@ async function disposeAppSession(state, appSessionId, opts = {}) {
     if (!ap)
         return;
     state.appSessions.delete(appSessionId);
+    // Evict AppData bridges FIRST — eviction enumerates `ap.pages`, which the
+    // page teardown below progressively empties (and finally clears).
+    state.evictAppDataBridges(ap);
     // Drain any pending API calls owned by this app session. One-shot calls
     // normally self-clean on response/timeout, but persistent (`keep: true`)
     // subscriptions (e.g. audioListen) live with their timer cleared until

package/dist/main/ipc/views.js

@@ -30,7 +30,16 @@ export function registerViewsIpc(ctx) {
         .handle(ViewChannel.HostToolbarBounds, (_event, ...args) => {
         const [bounds] = validate(ViewChannel.HostToolbarBounds, ViewBoundsSchema, args);
         ctx.views.setHostToolbarBounds(bounds);
-    });
+    })
+        // Height replay pull: a freshly-mounted main-renderer placeholder asks for
+        // the last NOTIFIED toolbar height (main retains it — the toolbar's
+        // size-advertiser deduplicates and never re-pushes, so a push that fired
+        // while no project view was mounted is otherwise lost: cold start races
+        // it, close-project → reopen hits it always). Rides the SAME
+        // senderPolicy-gated registry as HostToolbarBounds: the toolbar WCV's
+        // arbitrary host content must not reach this — only the trusted main
+        // renderer pulls. Live delegation, not a registration-time snapshot.
+        .handle(ViewChannel.HostToolbarGetHeight, () => ctx.views.getHostToolbarHeight());
     // Reverse size-advertiser: the toolbar WCV's OWN renderer sends this, and the
     // host loads ARBITRARY content into that WCV. We DELIBERATELY do NOT add the
     // toolbar wc to the global sender policy — that would trust it for ALL ~72

package/dist/main/services/notifications/renderer-notifier.d.ts

@@ -12,6 +12,15 @@ export interface ProjectStatusPayload {
     /** True when the status update is emitted by the file-watcher rebuild loop. */
     hotReload?: boolean;
 }
+/**
+ * Payload for the `project:compileLog` push — one filtered dmcc log line.
+ * `at` is stamped in the main process when the line is captured.
+ */
+export interface CompileLogPayload {
+    at: number;
+    stream: 'stdout' | 'stderr';
+    text: string;
+}
 /**
  * Payload for the `settings:init` event sent into the embedded settings overlay
  * right after it is shown.
@@ -43,6 +52,8 @@ export interface WorkbenchSettingsInitPayload {
 export interface RendererNotifier {
     /** Broadcast project compile status transitions to the main renderer. */
     projectStatus(payload: ProjectStatusPayload): void;
+    /** Push one per-line dmcc compile-log entry to the main renderer. */
+    compileLog(payload: CompileLogPayload): void;
     /** Ask the main renderer to navigate back to its landing screen. */
     windowNavigateBack(): void;
     /** Tell the main renderer the compile popover has been closed. */

package/dist/main/services/notifications/renderer-notifier.js

@@ -24,6 +24,9 @@ export function createRendererNotifier(ctx) {
         projectStatus(payload) {
             sendToMain(ProjectChannel.Status, payload);
         },
+        compileLog(payload) {
+            sendToMain(ProjectChannel.CompileLog, payload);
+        },
         windowNavigateBack() {
             sendToMain(WindowChannel.NavigateBack);
         },

package/dist/main/services/views/view-manager.d.ts

@@ -112,6 +112,16 @@ export interface ViewManager {
      * must trust its id — see `createWorkbenchSenderPolicy`.
      */
     getHostToolbarWebContentsId(): number | null;
+    /**
+     * Return the last host-toolbar height NOTIFIED to the main-window renderer
+     * (an advertiser report in `'auto'` mode, a `setHeightMode({ fixed })` pin,
+     * or 0 after `hostToolbar.hide()`); 0 before any notify. The renderer pulls
+     * this on project-view mount to REPLAY a height whose push it missed — the
+     * toolbar's size-advertiser deduplicates and never re-reports, so a notify
+     * fired while no project view is mounted (cold start on the project list;
+     * always on close-project → reopen) would otherwise be lost forever.
+     */
+    getHostToolbarHeight(): number;
     /**
      * NATIVE-HOST ONLY. Position the simulator content WebContentsView over the
      * renderer-measured simulator panel REGION rect (the flex:1 placeholder slot,
@@ -168,10 +178,12 @@ export interface ViewManager {
     }): void;
     /**
      * Reverse size-advertiser sink: the toolbar WCV's own renderer advertises
-     * its intrinsic content height (block-axis extent); we store it and push it
-     * to the main-window renderer so the placeholder div resizes (closing the
-     * dynamic-height loop). Ignored while a `{ fixed }` height mode is pinned
-     * via `hostToolbar.setHeightMode` (the session-resident advertiser always
+     * its intrinsic content height (block-axis extent); we retain it as the
+     * last-notified height (`getHostToolbarHeight`) and push it to the
+     * main-window renderer so the placeholder div resizes (closing the
+     * dynamic-height loop). Ignored ENTIRELY while a `{ fixed }` height mode is
+     * pinned via `hostToolbar.setHeightMode` — dropped reports neither notify
+     * nor touch the retained value (the session-resident advertiser always
      * runs, so its reports must not fight a host-pinned height).
      */
     setHostToolbarHeight(extent: number): void;

package/dist/main/services/views/view-manager.js

@@ -95,6 +95,13 @@ export function createViewManager(ctx) {
     // Placeholder height authority: 'auto' = advertiser reports forward to the
     // renderer; { fixed } = host-pinned, advertiser reports are dropped.
     let hostToolbarHeightMode = 'auto';
+    // Last toolbar height NOTIFIED to the main-window renderer — the replay
+    // source behind `getHostToolbarHeight()`. Updated ONLY inside
+    // `notifyHostToolbarHeight` so the retained value can never diverge from
+    // what the renderer was told (an advertiser report dropped by a `{ fixed }`
+    // pin must not pollute it, and a setHeightMode validation reject leaves it
+    // untouched).
+    let hostToolbarLastHeight = 0;
     // Gated narrow channel to the toolbar PAGE (per-load MessagePort handshake;
     // see host-toolbar-port-channel.ts). Control-level registry — created with
     // the manager so onMessage() works before any toolbar view exists.
@@ -248,18 +255,30 @@ export function createViewManager(ctx) {
         }
         view.setBounds(bounds);
     }
+    // Single funnel for the height notify: retain-then-push, so the retained
+    // value is exactly the last value the renderer was told. Every height
+    // notify site MUST go through here — the renderer pulls the retained value
+    // on project-view mount to replay a push it missed (the toolbar's
+    // size-advertiser deduplicates and never re-reports).
+    function notifyHostToolbarHeight(height) {
+        hostToolbarLastHeight = height;
+        ctx.notify.hostToolbarHeightChanged(height);
+    }
     function setHostToolbarHeight(extent) {
         // While the host pins a fixed height, drop advertiser reports entirely —
         // the session-resident advertiser is always installed, so forwarding its
         // reports would make the strip oscillate between the pinned and measured
-        // heights on every content resize.
+        // heights on every content resize. Dropped reports must not touch the
+        // retained value either: retention records what was NOTIFIED, not what
+        // was reported.
         if (hostToolbarHeightMode !== 'auto')
             return;
         // Push the reserved height back to the main-window renderer so its
-        // placeholder div resizes (closing the dynamic-height loop). The height is
-        // not retained in main — the renderer placeholder is the single source of
-        // truth, and the forward anchor re-reports bounds from it.
-        ctx.notify.hostToolbarHeightChanged(extent);
+        // placeholder div resizes (closing the dynamic-height loop). The notified
+        // height IS retained in main (`getHostToolbarHeight`) so a renderer that
+        // mounts later can pull/replay it; the renderer placeholder remains the
+        // geometry authority — the forward anchor re-reports bounds from it.
+        notifyHostToolbarHeight(extent);
     }
     function hideHostToolbar() {
         if (hostToolbarView && hostToolbarViewAdded && !ctx.windows.mainWindow.isDestroyed()) {
@@ -273,7 +292,9 @@ export function createViewManager(ctx) {
         // non-zero reserved height and re-publishes bounds on the next window
         // resize, silently re-adding the view we just hid (unstable hide). Zeroing
         // the height flips the anchor to `present:false` so it stops re-publishing.
-        ctx.notify.hostToolbarHeightChanged(0);
+        // Through the funnel so the retained value follows to 0 — a renderer
+        // mounting after the hide must replay 0, not the stale pre-hide height.
+        notifyHostToolbarHeight(0);
     }
     const hostToolbar = {
         async loadURL(url) {
@@ -317,11 +338,13 @@ export function createViewManager(ctx) {
             if (mode !== 'auto') {
                 // Pin immediately: a preload-less/static toolbar never advertises, so
                 // waiting for the next report would leave the strip at height 0.
-                ctx.notify.hostToolbarHeightChanged(mode.fixed);
+                notifyHostToolbarHeight(mode.fixed);
             }
             // Switching back to 'auto' deliberately does NOT synthesize a notify —
             // replaying a stale cached height would flash the old size; the NEXT
-            // advertiser report drives the placeholder again.
+            // advertiser report drives the placeholder again. The RETAINED value
+            // survives the switch though: a freshly-mounting renderer still needs
+            // the pinned height until that next report lands.
         },
         onMessage(channel, handler) {
             return hostToolbarPort.onMessage(channel, handler);
@@ -1146,6 +1169,7 @@ export function createViewManager(ctx) {
             return popoverView.webContents.id;
         },
         getHostToolbarWebContentsId: () => liveHostToolbarWebContents()?.id ?? null,
+        getHostToolbarHeight: () => hostToolbarLastHeight,
         setNativeSimulatorViewBounds,
         resize,
         setSimulatorDevtoolsBounds,

package/dist/main/services/workspace/workspace-service.js

@@ -18,6 +18,16 @@ export function createWorkspaceService(ctx) {
     // accept an in-flight write that targets the just-closed project. Reset at
     // the start of every `openProject` so it never accumulates a stale root.
     let lastClosedProjectPath = '';
+    // Session generation for the onLog closure handed to the adapter: a closed
+    // (or switched-away-from) session's compile worker dies asynchronously, so
+    // buffered log lines can still arrive through the OLD closure after
+    // closeProject/openProject. Each openProject claims a new generation and
+    // closeProject invalidates the current one; a stale closure sees the
+    // mismatch and drops the line instead of polluting the next project's
+    // compile panel. (Deliberately NOT a `currentSession !== null` check: the
+    // first compile's log lines arrive while the adapter promise is still
+    // pending, before currentSession is assigned.)
+    let logGeneration = 0;
     function sendStatus(status, message, hotReload) {
         ctx.notify.projectStatus(hotReload ? { status, message, hotReload: true } : { status, message });
     }
@@ -71,6 +81,14 @@ export function createWorkspaceService(ctx) {
             : null,
         async openProject(projectPath) {
             clearSimulatorServicewechatReferer();
+            // Invalidate the outgoing session's onLog BEFORE teardown starts (same
+            // order as closeProject below): the dying compile worker flushes
+            // buffered lines DURING disposeSession(), and with the old generation
+            // still current they would pass the staleness guard and pollute the
+            // incoming project's compile-log timeline. The new session claims its
+            // own fresh generation further down (after dispose), so its onLog
+            // forwards normally.
+            logGeneration++;
             await disposeSession();
             currentProjectPath = '';
             // A fresh open starts a clean sandbox window — drop any previously
@@ -92,6 +110,9 @@ export function createWorkspaceService(ctx) {
             }
             sendStatus('compiling', '正在编译...');
             const { compile } = loadWorkbenchSettings();
+            // This open owns the log channel until the next open/close bumps the
+            // generation — the onLog closure below checks it per line.
+            const sessionGeneration = ++logGeneration;
             let session;
             try {
                 session = await ctx.adapter.openProject({
@@ -100,6 +121,21 @@ export function createWorkspaceService(ctx) {
                     watch: compile.watch,
                     onRebuild: () => sendStatus('ready', '编译完成，已热更新', true),
                     onBuildError: (err) => sendStatus('error', String(err)),
+                    // Per-line dmcc log (already filtered in devkit). Stamp the
+                    // wall-clock capture time here and push verbatim on the dedicated
+                    // compile-log channel — never through projectStatus, whose
+                    // one-event-per-payload contract feeds compileEvents. Stale lines
+                    // (a closed/replaced session's worker flushing its buffers) are
+                    // dropped via the generation check.
+                    onLog: (entry) => {
+                        if (sessionGeneration !== logGeneration)
+                            return;
+                        ctx.notify.compileLog({
+                            stream: entry.stream,
+                            text: entry.text,
+                            at: Date.now(),
+                        });
+                    },
                 });
             }
             catch (err) {
@@ -141,6 +177,9 @@ export function createWorkspaceService(ctx) {
             };
         },
         async closeProject() {
+            // Invalidate the active session's onLog BEFORE teardown starts — lines
+            // flushed by the dying compile worker must not reach the panel.
+            logGeneration++;
             clearSimulatorServicewechatReferer();
             await disposeSession();
             // Record the root being torn down BEFORE clearing it, so a teardown/

package/dist/preload/index.d.ts

@@ -13,7 +13,7 @@ export { installConsoleInstrumentation } from './instrumentation/console.js';
 export { createAppDataSource } from './instrumentation/app-data.js';
 export type { AppDataSnapshot } from './instrumentation/app-data.js';
 /**
- * @deprecated Will be removed in the next minor. Under the native-host (sole)
+ * @deprecated Will be removed in 0.5.0. Under the native-host (sole)
  * runtime the simulator top frame is a top-level WebContentsView — the page DOM
  * lives in child render-host `<webview>` guests, so this top-frame DOM observer
  * only ever publishes `null`. Panel WXML flows over the main-process
@@ -21,7 +21,7 @@ export type { AppDataSnapshot } from './instrumentation/app-data.js';
  */
 export { createWxmlSource } from './instrumentation/wxml.js';
 /**
- * @deprecated Will be removed in the next minor. The host's
+ * @deprecated Will be removed in 0.5.0. The host's
  * `miniapp-snapshot:push/pull` IPC has no receiving end under the native-host
  * (sole) runtime: the simulator is a top-level WebContentsView without an
  * embedder (its `sendToHost` fires into the void) and the renderer-side puller

package/dist/preload/index.js

@@ -12,7 +12,7 @@
 export { installConsoleInstrumentation } from './instrumentation/console.js';
 export { createAppDataSource } from './instrumentation/app-data.js';
 /**
- * @deprecated Will be removed in the next minor. Under the native-host (sole)
+ * @deprecated Will be removed in 0.5.0. Under the native-host (sole)
  * runtime the simulator top frame is a top-level WebContentsView — the page DOM
  * lives in child render-host `<webview>` guests, so this top-frame DOM observer
  * only ever publishes `null`. Panel WXML flows over the main-process
@@ -20,7 +20,7 @@ export { createAppDataSource } from './instrumentation/app-data.js';
  */
 export { createWxmlSource } from './instrumentation/wxml.js';
 /**
- * @deprecated Will be removed in the next minor. The host's
+ * @deprecated Will be removed in 0.5.0. The host's
  * `miniapp-snapshot:push/pull` IPC has no receiving end under the native-host
  * (sole) runtime: the simulator is a top-level WebContentsView without an
  * embedder (its `sendToHost` fires into the void) and the renderer-side puller

package/dist/preload/windows/host-toolbar-runtime.cjs

@@ -134,7 +134,17 @@ var ViewChannel = {
    * main → main-window renderer: push the reserved host-toolbar height so the
    * renderer placeholder div resizes (closing the dynamic-height loop).
    */
-  HostToolbarHeightChanged: "view:host-toolbar:height-changed"
+  HostToolbarHeightChanged: "view:host-toolbar:height-changed",
+  /**
+   * main ← main-window renderer (invoke): pull the last NOTIFIED toolbar
+   * height retained in main. Mount-time replay companion to
+   * `HostToolbarHeightChanged`: the push listener mounts with the project
+   * view and the toolbar's size-advertiser deduplicates (never re-reports),
+   * so a height pushed while no project view was mounted would otherwise be
+   * lost forever (cold start on the project list races it; close-project →
+   * reopen hits it deterministically). No payload; resolves a number.
+   */
+  HostToolbarGetHeight: "view:host-toolbar:get-height"
 };
 
 // src/preload/runtime/host-toolbar-advertiser.ts