@dimina-kit/devtools 0.3.1-dev.20260513123738 → 0.3.1-dev.20260517100756

package/README.md

@@ -83,6 +83,7 @@ import { app, globalShortcut } from 'electron'
 import path from 'path'
 import { createMainWindow } from '@dimina-kit/devtools/create-window'
 import { createWorkbenchContext } from '@dimina-kit/devtools/context'
+import { registerAppIpc } from '@dimina-kit/devtools'
 import { registerSimulatorIpc } from '@dimina-kit/devtools/ipc-simulator'
 import { registerPanelsIpc } from '@dimina-kit/devtools/ipc-panels'
 import { registerToolbarIpc } from '@dimina-kit/devtools/ipc-toolbar'
@@ -95,7 +96,7 @@ import { rendererDir, defaultPreloadPath } from '@dimina-kit/devtools/paths'
 app.whenReady().then(() => {
   const mainWindow = createMainWindow({
     title: 'My DevTools',
-    indexHtml: path.join(rendererDir, 'index.html'),
+    indexHtml: path.join(rendererDir, 'entries/main/index.html'),
   })
 
   const ctx = createWorkbenchContext({
@@ -105,6 +106,9 @@ app.whenReady().then(() => {
     rendererDir,
   })
 
+  // registerAppIpc 必装：renderer 启动时调用 app:getPreloadPath / app:getBranding，
+  // 缺它会卡在加载阶段。
+  registerAppIpc(ctx)
   registerProjectsIpc(ctx)
   registerSessionIpc(ctx)
   registerSimulatorIpc(ctx)
@@ -112,6 +116,11 @@ app.whenReady().then(() => {
   registerToolbarIpc(ctx)
   registerPopoverIpc(ctx)
 
+  // Storage / 元素选区面板的后端 handler 由 setupSimulatorStorage 单独装。
+  // 该函数当前**未列入稳定公共 API**（在 `@dimina-kit/devtools` 之外）。
+  // 若需要这两个面板，建议改用上方的 `createWorkbenchApp({ onSetup })` 路线，
+  // 框架会自动注册；模块组装路线下你只能用不依赖它们的精简面板集。
+
   // 添加自定义 IPC — 通过 ctx.workspace 访问会话状态
   ipcMain.handle('my:action', () => {
     console.log('current project:', ctx.workspace.getProjectPath())
@@ -150,9 +159,6 @@ src/
       app.ts                             # createWorkbenchApp 工厂
       bootstrap.ts                       # suppressEpipe / setupCdpPort
       lifecycle.ts                       # Electron app 生命周期注册
-    windows/
-      main-window/                       # 主窗口创建 + 事件接线
-      settings-window/                   # 独立设置窗口
     ipc/                                 # 只做 handler 注册，不写业务
       index.ts                           # 聚合 register 函数导出
       simulator.ts                       # simulator attach/detach/resize
@@ -166,17 +172,33 @@ src/
       settings/                          # 用户级 workbench 设置读写 + 主题应用
       projects/                          # 项目列表 CRUD（持久化）
       layout/                            # 布局常量 + bounds 计算
+      views/                             # ViewManager（settings / popover overlay 等）
+      workspace/                         # 项目会话生命周期
+      notifications/                     # 主进程 → renderer 的事件通知
       mcp/                               # MCP server
       automation/                        # 自动化 WebSocket 服务
       simulator/                         # simulator dir / referer
+      simulator-storage/                 # CDP DOMStorage + 元素 inspect 桥接
+      update/                            # UpdateManager + GitHubReleaseChecker
       workbench-context.ts               # 共享状态类型 + 工厂 + 辅助函数
+      window-service.ts                  # main / settings 窗口聚合访问
+      module.ts                          # WorkbenchModule 协议
       default-adapter.ts                 # 默认 CompilationAdapter
     menu/                                # 应用菜单
-    utils/paths.ts                       # rendererDir / defaultPreloadPath
+    utils/
+      paths.ts                           # rendererDir / defaultPreloadPath / simulatorDir
+      disposable.ts                      # DisposableRegistry + AggregateError 聚合
+      ipc-registry.ts                    # ipcMain.handle 包装 + SenderPolicy 闸门
+      sender-policy.ts                   # sender webContents id 白名单
+      ipc-schema.ts                      # zod schema 校验工具
+    windows/
+      main-window/                       # 主窗口创建 + 事件接线
+      settings-window/                   # 独立设置窗口
+      navigation-hardening.ts            # will-navigate / setWindowOpenHandler 限流
 
   preload/                               # 按注入目标分
     windows/                             # contextBridge 类型 preload
-      main.ts                            # 主窗口 preload，可组合导出 install*Instrumentation
+      main.ts                            # workbench 三窗口 preload，仅暴露 window.devtools.ipc
       simulator.ts                       # simulator webview 的默认 preload
     shared/                              # preload 之间共享
       api-compat.ts                      # setupApiCompatHook
@@ -184,19 +206,20 @@ src/
       types.ts
     instrumentation/                     # 注入到小程序 runtime 的探针
       console.ts                         # 控制台拦截
-      storage.ts                         # localStorage 拦截
       app-data.ts                        # Worker setData 拦截
-      wxml.ts                            # Vue 组件树提取
+      wxml.ts                            # Vue 组件树提取 + WXML 高亮 overlay
+      disposable.ts                      # instrumentation 共用的清理工具
     runtime/
-      bridge.ts                          # installSimulatorBridge
-      host.ts
+      bridge.ts                          # installSimulatorBridge → window.__simulatorData
+      custom-apis.ts                     # installCustomApisBridge → window.__diminaCustomApis
+      host.ts                            # sendToHost 推送封装
 
   renderer/
     entries/                             # 各窗口 HTML + React 挂载点
       main/ popover/ settings/ workbench-settings/
     modules/                             # 先按窗口分，再按区域
       main/
-        app/                             # 主窗口 App 根
+        main.tsx                         # 主窗口 React 根
         features/                        # 主窗口内的业务区域
           project-runtime/               # 项目视图 + 工具栏 + 右侧面板切换
           right-panel/                   # WXML / AppData / Storage 面板
@@ -248,6 +271,8 @@ src/
 | `onSetup`       | `(instance) => void`                        | —           | 窗口和 context 创建后的回调，用于注册自定义 IPC   |
 | `onBeforeClose` | `(instance) => void`                        | —           | 窗口关闭前的回调，session 关闭由框架自动处理      |
 | `window`        | `WorkbenchWindowConfig`                     | —           | 窗口尺寸覆盖                                      |
+| `updateChecker` | `UpdateChecker`                             | —           | 自定义更新检查器；提供后启用"检查更新"功能        |
+| `updateOptions` | `{ checkInterval?, initialDelay?, getCurrentVersion? }` | —  | 仅当 `updateChecker` 提供时生效，默认 1h / 5s     |
 
 ### 内置面板 ID
 
@@ -285,37 +310,56 @@ const myAdapter: CompilationAdapter = {
 
 ## Preload Instrumentation
 
-模拟器 webview 注入 preload 脚本在全局安装 instrumentation。内置 preload（`preload/windows/simulator.ts`）组装了以下模块：
+模拟器 webview 注入 preload 脚本，在 webview 全局上安装两类东西：**桥接**（把数据通道暴露到 webview）+ **instrumentation**（监听运行时事件并写入桥接）。内置 preload 见 `src/preload/windows/simulator.ts`。
 
-| Instrumentation                           | 捕获内容                                        |
-| ----------------------------------------- | ----------------------------------------------- |
-| Console (`installConsoleInstrumentation`) | `console.*`、`window.onerror`、未捕获 rejection |
-| Storage (`installStorageInstrumentation`) | `localStorage.setItem/removeItem`、全量快照     |
-| AppData (`installAppDataInstrumentation`) | Worker `type='u'` 消息、setData 调用            |
-| WXML (`installWxmlInstrumentation`)       | Vue 组件树提取、MutationObserver 自动更新       |
+### 必装：桥接
 
-所有 install\* 函数从 `@dimina-kit/devtools/preload` 统一导出，调用后通过 `installSimulatorBridge` 暴露的内部桥接通道把数据推到宿主。面板打开时调用 `panel:eval` 通过 `executeJavaScript` 拉取当前状态。
+| 函数 | 作用 | 不装会怎样 |
+| --- | --- | --- |
+| `installSimulatorBridge()` | 暴露 `window.__simulatorData`，承载 `highlightElement` / `unhighlightElement` / `getAppdata` / `getWxml` / `getStorageSnapshot` 等只读 API（供主进程 `executeJavaScript` 拉取） | 元素选区 overlay 不显示；automation `Page.getData` 返回空对象；MCP `simulator_get_overview` 在 hints 中追加 `simulator bridge not ready (window.__simulatorData missing)`。注：Storage 面板走主进程 CDP，不受影响；Console/AppData/WXML 推送走 `sendToHost`，也不受影响 |
+| `installCustomApisBridge()` | 暴露 `window.__diminaCustomApis`，承载 `list` / `invoke`，让模拟器侧把主进程注册的 API 代理回小程序 runtime | `registerSimulatorApi` 注册的业务 API 在小程序里调用全部 no-op（参见下方 "Simulator 自定义 API"） |
+| `setupApiCompatHook()` | 兼容上游 API 名称变更 | 部分 API 调用兼容性问题 |
+
+下游写自定义 preload 时，这三项原则上都要装。若不需要 `registerSimulatorApi`，`installCustomApisBridge` 可省略。
+
+### 按需：instrumentation
+
+| Instrumentation | 捕获内容 | 数据通道 |
+| --- | --- | --- |
+| `installConsoleInstrumentation` | `console.*`、`window.onerror`、未捕获 rejection | IPC sendToHost |
+| `installAppDataInstrumentation` | Worker `type='u'` 消息、setData 调用 | IPC sendToHost + 写入 bridge state |
+| `installWxmlInstrumentation` | Vue 组件树提取、MutationObserver 自动更新 | IPC sendToHost + 写入 bridge state |
+
+> Storage 面板的数据由主进程通过 CDP `DOMStorage` 域抓取（`src/main/services/simulator-storage`），**不需要 preload 侧 instrumentation**。
+
+各面板的数据流详见下方 "数据流" 章节。
 
 ### 自定义 Preload
 
-按需组合或追加自定义逻辑（`src/preload/windows/simulator.ts` 作为参考）：
+参考 `src/preload/windows/simulator.ts`：
 
 ```typescript
 // my-preload.ts
 import {
   installSimulatorBridge,
+  installCustomApisBridge,
   installConsoleInstrumentation,
-  installStorageInstrumentation,
+  installAppDataInstrumentation,
+  installWxmlInstrumentation,
   setupApiCompatHook,
 } from '@dimina-kit/devtools/preload'
-// 不需要 WXML/AppData，不导入
 
+// 1. 兼容 hook + 桥接（必装，且应在 instrumentation 之前）
 setupApiCompatHook()
 installSimulatorBridge()
+installCustomApisBridge()   // 若用到 registerSimulatorApi，必装
+
+// 2. instrumentation（按需）
 installConsoleInstrumentation()
-installStorageInstrumentation()
+installAppDataInstrumentation()
+installWxmlInstrumentation()
 
-// 自定义 hook
+// 3. 自定义 hook
 window.addEventListener('error', (e) => {
   console.error('[my-preload]', e.message)
 })
@@ -329,49 +373,84 @@ launch({ preloadPath: '/absolute/path/to/my-preload.js' })
 
 ---
 
+## Simulator 自定义 API
+
+下游可以通过 `registerSimulatorApi` 把业务 API 注入到模拟器内运行的小程序。Handler 在 Electron **主进程**执行，能用任何 Node 能力（fs、net、原生模块、持久状态）；模拟器侧拿到 `wx.<name>(params)` 调用后通过 IPC 转发到主进程，await 返回结果，handler 抛错则原型回传给小程序。
+
+> ⚠️ 使用本功能要求模拟器 preload 调用 `installCustomApisBridge()`（详见上方 "Preload Instrumentation"）。内置 preload 已包含此调用；若你用了自定义 preload 又忘记调用，注册的 API 在小程序运行时**没有任何反应**，且不会报错。
+
+```typescript
+import { registerSimulatorApi } from '@dimina-kit/devtools/simulator-apis'
+
+const dispose = registerSimulatorApi('myCompany.login', async ({ username }) => {
+  // 主进程上下文：可调用内部 HTTP、读取凭证文件、访问原生模块
+  return await callInternalAuth(username)
+})
+
+// 不再需要时取消注册（不传也行，进程退出会一起清理）
+dispose()
+```
+
+几点行为约定：
+
+- 同名重复注册：后注册的覆盖前者，静默替换。
+- `dispose()` 只会移除自己创建的那次注册——如果之后被别人覆盖了，旧的 disposer 是 no-op。
+- 调用未注册的 name：小程序侧拿到 reject，错误信息里带 name。
+- Handler 可同步或异步返回；返回值需可 JSON 序列化（IPC 限制）。
+
+对小程序侧来说，这些 name 和内置 API（`wx.getStorage` 等）走同一个 `AppManager.apiRegistry`，没有区别。
+
+---
+
 ## 模块导出一览
 
+### Stable public exports
+
+`@dimina-kit/devtools` 的稳定入口，签名遵循 semver；新版本不会做破坏性改动（除非 major bump）。
+
 ```
 @dimina-kit/devtools                        launch, createWorkbenchApp, buildDefaultMenu,
                                        openSettingsWindow, suppressEpipe, setupCdpPort,
-                                       createWorkbenchContext, createMainWindow, ...
-                                       （api.ts 聚合了下方全部入口）
+                                       createWorkbenchContext, createMainWindow,
+                                       createViewManager, register*Ipc,
+                                       registerSimulatorApi,
+                                       setHeaderHeight, UpdateManager,
+                                       createGitHubReleaseChecker, ...
+                                       （api.ts 聚合了所有公共 API；优先从根入口导入）
 @dimina-kit/devtools/launch                 launch(config?), buildDefaultMenu, openSettingsWindow
 @dimina-kit/devtools/app                    createWorkbenchApp(config?)
 @dimina-kit/devtools/types                  TypeScript 类型定义
+@dimina-kit/devtools/bootstrap              suppressEpipe(), setupCdpPort()
+@dimina-kit/devtools/paths                  rendererDir, defaultPreloadPath, simulatorDir,
+                                       getRendererDir, getPreloadDir, getRendererHtml
+@dimina-kit/devtools/simulator-apis         registerSimulatorApi(name, handler) →
+                                       注入由主进程托管的小程序 API（详见上方"Simulator 自定义 API"）
+@dimina-kit/devtools/preload                installSimulatorBridge,
+                                       installCustomApisBridge,
+                                       installConsoleInstrumentation,
+                                       installAppDataInstrumentation, sendAllAppData,
+                                       installWxmlInstrumentation, sendWxmlTree,
+                                       setupWxmlObserver,
+                                       setupApiCompatHook
+                                       （storage 面板数据由主进程 CDP 抓取，无 preload 侧 hook）
+```
+
+### Experimental exports (v0.x — signatures may change in minor versions)
+
+下列子路径主要用于"模块组装"等深度定制场景。在 0.x 阶段，函数签名和模块边界可能在 minor 版本之间调整；如果你不需要逐模块组装，请优先使用上方的 stable 入口或根 barrel。
+
+```
 @dimina-kit/devtools/context                createWorkbenchContext(opts),
                                        hasBuiltinPanel(ctx, panelId), getDefaultTab(ctx)
 @dimina-kit/devtools/create-window          createMainWindow(opts)
-@dimina-kit/devtools/view-manager           createViewManager(ctx) → ViewManager
-                                       (attachSimulator, detachSimulator, showSimulator,
-                                        hideSimulator, showSettings, hideSettings,
-                                        showPopover, hidePopover, resize,
-                                        setVisible, repositionAll, disposeAll)
-@dimina-kit/devtools/layout                 computeRightPanelBounds, computeSimulatorBounds,
-                                       computeSettingsBounds, computePopoverBounds,
-                                       setHeaderHeight, getRightX,
-                                       HEADER_H, SPLITTER_W, SETTINGS_W
-@dimina-kit/devtools/projects               listProjects, addProject, removeProject,
-                                       getCompileConfig, saveCompileConfig,
-                                       updateLastOpened
-@dimina-kit/devtools/paths                  rendererDir, defaultPreloadPath,
-                                       getRendererDir, getPreloadDir, getRendererHtml
 @dimina-kit/devtools/ipc-simulator          registerSimulatorIpc(ctx)
 @dimina-kit/devtools/ipc-panels             registerPanelsIpc(ctx)
 @dimina-kit/devtools/ipc-toolbar            registerToolbarIpc(ctx)
 @dimina-kit/devtools/ipc-popover            registerPopoverIpc(ctx)
 @dimina-kit/devtools/ipc-settings           registerSettingsIpc(ctx)
 @dimina-kit/devtools/ipc-projects           registerProjectsIpc(ctx)
-@dimina-kit/devtools/ipc-session            registerSessionIpc(ctx), sendStatus(ctx, status, msg)
-@dimina-kit/devtools/bootstrap              suppressEpipe(), setupCdpPort()
+@dimina-kit/devtools/ipc-session            registerSessionIpc(ctx), sessionModule
 @dimina-kit/devtools/workbench-settings     loadWorkbenchSettings(), saveWorkbenchSettings(), applyTheme()
-@dimina-kit/devtools/preload                installConsoleInstrumentation,
-                                       installStorageInstrumentation,
-                                       installAppDataInstrumentation, sendAllAppData,
-                                       installWxmlInstrumentation, sendWxmlTree,
-                                       setupWxmlObserver, installSimulatorBridge,
-                                       setupApiCompatHook
-@dimina-kit/devtools/simulator-dir          simulatorDir
 ```
 
 ---
@@ -382,7 +461,6 @@ launch({ preloadPath: '/absolute/path/to/my-preload.js' })
 
 ```typescript
 interface WorkbenchContext {
-  mainWindow: BrowserWindow
   adapter: CompilationAdapter
   preloadPath: string
   rendererDir: string
@@ -391,16 +469,20 @@ interface WorkbenchContext {
   appName: string
   toolbarActions?: () => Promise<ToolbarAction[]> | ToolbarAction[]
   brandingProvider?: () => Promise<{ appName: string }> | { appName: string }
-  workbenchSettingsWindow: BrowserWindow | null
 
   // ── Services（运行时状态封装在内部，通过方法访问）──
+  windows: WindowService // ctx.windows.mainWindow, ctx.windows.settingsWindow, ...
   views: ViewManager // ctx.views.repositionAll(), ctx.views.getSimulatorWebContentsId(), ...
   notify: RendererNotifier // ctx.notify.projectStatus(), ctx.notify.windowNavigateBack(), ...
   workspace: WorkspaceService // ctx.workspace.getProjectPath(), ctx.workspace.hasActiveSession(), ...
+
+  // ── Internal lifecycle / security (host 不直接消费) ──
+  registry: DisposableRegistry // 框架在创建时统一聚合 dispose
+  senderPolicy: SenderPolicy   // IpcRegistry 自动校验 sender 白名单
 }
 ```
 
-会话和视图状态不再作为 ctx 的直接字段暴露，而是封装在对应 service 的私有闭包中：
+会话和视图状态封装在对应 service 的私有闭包中，通过方法访问：
 
 | 旧写法                       | 新写法                                                            |
 | ---------------------------- | ----------------------------------------------------------------- |
@@ -409,6 +491,8 @@ interface WorkbenchContext {
 | `ctx.simulatorWebContentsId` | `ctx.views.getSimulatorWebContentsId()`                           |
 | `ctx.devToolsViewAdded`      | `ctx.views.isSimulatorAdded()`                                    |
 | `ctx.lastSimWidth`           | `ctx.views.getLastSimWidth()`                                     |
+| `ctx.mainWindow`             | `ctx.windows.mainWindow`                                          |
+| `ctx.workbenchSettingsWindow`| `ctx.windows.settingsWindow`                                      |
 
 ---
 
@@ -438,28 +522,15 @@ flowchart TB
 
 ### 数据流
 
-内置面板采用**拉取式**数据流，避免长期订阅：
+按面板拆分，分**三条独立路径**：
 
-```mermaid
-sequenceDiagram
-    autonumber
-    actor User as 用户
-    participant UI as 面板 UI (React)
-    participant R as renderer
-    participant M as main<br/>ipc/panels.ts
-    participant P as preload<br/>instrumentation
-
-    User->>UI: 打开面板 / 刷新
-    UI->>R: invokeMain('panel:eval', expression)
-    R->>M: IPC: panel:eval
-    M->>P: webContents.executeJavaScript(expression)
-    Note over P: window 上已挂好取值函数
-    P-->>M: 结构化数据
-    M-->>R: 返回结果
-    R-->>UI: 渲染
-```
+| 面板 / 场景 | 模式 | 路径 |
+| --- | --- | --- |
+| Console / AppData / WXML 树 | 推送 | preload instrumentation 通过 `runtime/host.ts:sendToHost` 经 webview `ipcRenderer.sendToHost` 推到宿主 → renderer 监听 `ipc-message` 分发 |
+| Storage | 拉取 + 推送 | renderer `ipcInvoke(SimulatorStorageChannel.GetSnapshot)` → 主进程 CDP `DOMStorage` 域；变更事件由主进程通过 `SimulatorStorageChannel.Event` 推回 renderer |
+| 元素选区 / `Page.getData` / MCP overview | 拉取 | 主进程 `webContents.executeJavaScript(...)` 或 `Runtime.evaluate(...)` 读 `window.__simulatorData.*`（由 `installSimulatorBridge` 暴露） |
 
-Console 输出等推送场景仍由 preload 通过 `installSimulatorBridge()` 经由 webview ipcRenderer 送至宿主，再由 renderer 分发到相应面板。
+> `src/main/ipc/panels.ts` 暴露 `panel:eval` handler 供外部 host 自定义面板复用，内置 renderer 不消费它。
 
 ---
 
@@ -545,18 +616,18 @@ pnpm test               # 运行测试
 
 ## 安全说明
 
-- 本工具仅用于本地开发调试，不应部署到生产环境
-- 为方便开发调试，BrowserWindow 启用了 `nodeIntegration` 并禁用了 `contextIsolation`，这在生产环境中存在安全风险
-- 仅在受信任的本地开发环境中使用本工具
-- 不要在 devtools 窗口中加载不受信任的远程内容
-- 如需在非本地环境使用，请自行评估并加固安全配置
+本工具仅用于本地开发调试。当前的安全配置：
 
-### MCP Server 风险
+- **Workbench 窗口**（main / settings / popover overlay）均启用 `contextIsolation` 并禁用 `nodeIntegration`；renderer 通过 main preload 经 `contextBridge` 拿到 `window.devtools.ipc`，每个 IPC handler 经 sender whitelist 校验调用方
+- **Simulator 加载的小程序代码** 运行在独立 `<webview>` 中（`partition='persist:simulator'`、`nodeIntegration=false`），preload 由 `session.registerPreloadScript` 在 session 层固定，渲染进程无法替换
+- **renderer 入口** 启用了保守 CSP；`will-navigate` / `setWindowOpenHandler` 屏蔽外部跳转
+
+仍然不要在 devtools 窗口中加载不受信任的远程内容；本工具不打算在非本地环境部署。
 
-内置的 MCP server 默认关闭，由 `startMcpServer` 入口显式启动，或通过 workbench 设置中的 `mcp.enabled` 开启。开启后会在本机监听 SSE 端点，向任何可以连接到该端点的 MCP 客户端暴露一组工具，能力包括：在页面上下文执行任意 JS（`evaluate`）、读取 DOM 结构、截屏、拉取网络日志、触发导航等。
+### MCP Server 风险
 
-由于 workbench 主窗口出于调试需要启用了 `nodeIntegration` 并关闭了 `contextIsolation`，通过 MCP 客户端执行的 `evaluate` 实际拥有 Node API 访问权限。换言之，开启 MCP 等同于允许已连接的本机 MCP 客户端在 DevTools 进程中执行 Node 代码，读写本机文件和启动子进程均在其能力范围内。
+内置的 MCP server 默认关闭，由 `startMcpServer` 入口显式启动，或通过 workbench 设置中的 `mcp.enabled` 开启。开启后会在本机监听 SSE 端点，向任何可以连接到该端点的 MCP 客户端暴露一组工具，能力包括：读取 DOM 结构、截屏、拉取网络日志、触发导航等。
 
-因此仅在连接到可信的本机 MCP 客户端或被信任的 AI 工具时启用该功能；不要在公共 WiFi、共享机器或存在远程 SSH 端口转发的场景下开启，以免监听端口被非预期的客户端访问。
+`workbench_evaluate` 已从 MCP 工具集中移除，workbench 只暴露只读诊断工具（截屏、console 日志、DOM、网络日志等）。`simulator_evaluate` 仍然保留，但 simulator 使用 `<webview>`、`nodeIntegration=false`，其 `evaluate` 仅在页面 JS 上下文执行，不具备 Node API 访问能力。
 
-作为收窄 RCE 面的默认策略，`workbench_evaluate` 已从 MCP 工具集中移除，workbench 只暴露只读诊断工具（截屏、console 日志、DOM、网络日志等）。`simulator_evaluate` 仍然保留，因为 simulator 使用 `<webview>`，默认 `nodeIntegration=false`，其 `evaluate` 仅在页面 JS 上下文执行，不具备 Node API 访问能力。
+仅在连接到可信的本机 MCP 客户端或被信任的 AI 工具时启用该功能；不要在公共 WiFi、共享机器或存在远程 SSH 端口转发的场景下开启，以免监听端口被非预期的客户端访问。

package/dist/main/api.d.ts

@@ -7,6 +7,10 @@ export type { WorkbenchContext, CreateContextOptions } from './services/workbenc
 export { createMainWindow } from './windows/main-window/index.js';
 export { createViewManager } from './services/views/view-manager.js';
 export type { ViewManager } from './services/views/view-manager.js';
+export type { WorkspaceService } from './services/workspace/workspace-service.js';
+export type { Project, ProjectPages, ProjectSettings } from './services/projects/project-repository.js';
+export { registerSimulatorApi } from './simulator-apis.js';
+export type { SimulatorApiHandler } from './simulator-apis.js';
 export { registerAppIpc } from './ipc/app.js';
 export { registerSimulatorIpc } from './ipc/simulator.js';
 export { registerPanelsIpc } from './ipc/panels.js';
@@ -15,8 +19,8 @@ export { registerSettingsIpc } from './ipc/settings.js';
 export { registerProjectsIpc } from './ipc/projects.js';
 export { registerSessionIpc } from './ipc/session.js';
 export { registerToolbarIpc } from './ipc/toolbar.js';
-export { rendererDir, defaultPreloadPath, getRendererDir, getPreloadDir, getRendererHtml } from './utils/paths.js';
-export { simulatorDir } from './services/simulator/dir.js';
+export { rendererDir, defaultPreloadPath, simulatorDir, getRendererDir, getPreloadDir, getRendererHtml, } from './utils/paths.js';
+export { setHeaderHeight } from './services/layout/index.js';
 export { UpdateManager, createGitHubReleaseChecker } from './services/update/index.js';
 export type { UpdateManagerOptions, GitHubReleaseCheckerOptions, PickAssetContext, VersionScheme, } from './services/update/index.js';
 export type { WorkbenchConfig, WorkbenchAppConfig, CompilationAdapter, ProjectSession, ToolbarAction, BuiltinPanelId, BuiltinModuleId, UpdateChecker, UpdateInfo, } from '../shared/types.js';

package/dist/main/api.js

@@ -7,6 +7,8 @@ export { suppressEpipe, setupCdpPort } from './app/bootstrap.js';
 export { createWorkbenchContext, hasBuiltinPanel, getDefaultTab } from './services/workbench-context.js';
 export { createMainWindow } from './windows/main-window/index.js';
 export { createViewManager } from './services/views/view-manager.js';
+// ── Simulator extension surface ──────────────────────────────────────────
+export { registerSimulatorApi } from './simulator-apis.js';
 // ── IPC module registration ──────────────────────────────────────────────
 export { registerAppIpc } from './ipc/app.js';
 export { registerSimulatorIpc } from './ipc/simulator.js';
@@ -17,8 +19,9 @@ export { registerProjectsIpc } from './ipc/projects.js';
 export { registerSessionIpc } from './ipc/session.js';
 export { registerToolbarIpc } from './ipc/toolbar.js';
 // ── Paths ────────────────────────────────────────────────────────────────
-export { rendererDir, defaultPreloadPath, getRendererDir, getPreloadDir, getRendererHtml } from './utils/paths.js';
-export { simulatorDir } from './services/simulator/dir.js';
+export { rendererDir, defaultPreloadPath, simulatorDir, getRendererDir, getPreloadDir, getRendererHtml, } from './utils/paths.js';
+// ── Layout ───────────────────────────────────────────────────────────────
+export { setHeaderHeight } from './services/layout/index.js';
 // ── Update checker ───────────────────────────────────────────────────────
 export { UpdateManager, createGitHubReleaseChecker } from './services/update/index.js';
 //# sourceMappingURL=api.js.map

package/dist/main/app/app.d.ts

@@ -12,6 +12,6 @@ export interface WorkbenchAppInstance {
 }
 export declare function createWorkbenchApp(config?: WorkbenchAppConfig): {
     setup: () => Promise<WorkbenchAppInstance>;
-    start: () => void;
+    start: () => Promise<void>;
 };
 //# sourceMappingURL=app.d.ts.map