@dimina-kit/devtools 0.3.1-dev.20260515105504 → 0.3.1-dev.20260518054451

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())
@@ -197,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 面板
@@ -261,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
 
@@ -298,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`。
+
+### 必装：桥接
+
+| 函数 | 作用 | 不装会怎样 |
+| --- | --- | --- |
+| `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                           | 捕获内容                                        |
-| ----------------------------------------- | ----------------------------------------------- |
-| Console (`installConsoleInstrumentation`) | `console.*`、`window.onerror`、未捕获 rejection |
-| Storage (`installStorageInstrumentation`) | `localStorage.setItem/removeItem`、全量快照     |
-| AppData (`installAppDataInstrumentation`) | Worker `type='u'` 消息、setData 调用            |
-| WXML (`installWxmlInstrumentation`)       | Vue 组件树提取、MutationObserver 自动更新       |
+### 按需：instrumentation
 
-所有 install\* 函数从 `@dimina-kit/devtools/preload` 统一导出，调用后通过 `installSimulatorBridge` 暴露的内部桥接通道把数据推到宿主。面板打开时调用 `panel:eval` 通过 `executeJavaScript` 拉取当前状态。
+| 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)
 })
@@ -346,26 +377,39 @@ launch({ preloadPath: '/absolute/path/to/my-preload.js' })
 
 下游可以通过 `registerSimulatorApi` 把业务 API 注入到模拟器内运行的小程序。Handler 在 Electron **主进程**执行，能用任何 Node 能力（fs、net、原生模块、持久状态）；模拟器侧拿到 `wx.<name>(params)` 调用后通过 IPC 转发到主进程，await 返回结果，handler 抛错则原型回传给小程序。
 
+> ⚠️ 使用本功能要求模拟器 preload 调用 `installCustomApisBridge()`（详见上方 "Preload Instrumentation"）。内置 preload 已包含此调用；若你用了自定义 preload 又忘记调用，注册的 API 在小程序运行时**没有任何反应**，且不会报错。
+
+### 命名约定
+
+`name` 是 dimina service 层 `invokeAPI(name, opts)` 用的**裸名**，不带 `wx.` 前缀。注册之后小程序里通过 `wx.<name>(...)`（以及你在 `apiNamespaces` 配的其它命名空间）调用都会命中：
+
+| 小程序里写 | `registerSimulatorApi` 的 name |
+| --- | --- |
+| `wx.login(...)` | `'login'` |
+| `wx.request(...)` | `'request'` |
+| `wx.getStorage(...)` 覆盖内置 | `'getStorage'`（小心：这会**屏蔽** dimina 容器的实现） |
+
 ```typescript
 import { registerSimulatorApi } from '@dimina-kit/devtools/simulator-apis'
 
-const dispose = registerSimulatorApi('myCompany.login', async ({ username }) => {
+// 提供 wx.login 的实现（dimina 容器默认未实现，注册后才能用）
+const dispose = registerSimulatorApi('login', async ({ success }) => {
   // 主进程上下文：可调用内部 HTTP、读取凭证文件、访问原生模块
-  return await callInternalAuth(username)
+  const code = await callInternalAuth()
+  return { code }
 })
 
 // 不再需要时取消注册（不传也行，进程退出会一起清理）
 dispose()
 ```
 
-几点行为约定：
+### 行为约定
 
+- **命中顺序**：小程序运行时按 `apiRegistry[name] → MiniApp 实例方法 → 扩展模块兜底` 查找，所以 `registerSimulatorApi` 注册的 name **优先于内置实现**——既能给"未实现"的 wx.* 补功能（如 `wx.login`），也能覆盖默认的 wx.* 行为（如 `wx.request`，dimina-kit 本身就在用这条路把 `request` 接到主进程 fetch）。
 - 同名重复注册：后注册的覆盖前者，静默替换。
 - `dispose()` 只会移除自己创建的那次注册——如果之后被别人覆盖了，旧的 disposer 是 no-op。
-- 调用未注册的 name：小程序侧拿到 reject，错误信息里带 name。
-- Handler 可同步或异步返回；返回值需可 JSON 序列化（IPC 限制）。
-
-对小程序侧来说，这些 name 和内置 API（`wx.getStorage` 等）走同一个 `AppManager.apiRegistry`，没有区别。
+- 调用未注册且容器内也没有的 name：小程序侧拿到 reject，错误信息里带 name。
+- Handler 可同步或异步返回；**返回值需可 JSON 序列化**（IPC 限制）。函数、Symbol、Map/Set、循环引用都会丢失。
 
 ---
 
@@ -392,12 +436,14 @@ dispose()
                                        getRendererDir, getPreloadDir, getRendererHtml
 @dimina-kit/devtools/simulator-apis         registerSimulatorApi(name, handler) →
                                        注入由主进程托管的小程序 API（详见上方"Simulator 自定义 API"）
-@dimina-kit/devtools/preload                installConsoleInstrumentation,
-                                       installStorageInstrumentation,
+@dimina-kit/devtools/preload                installSimulatorBridge,
+                                       installCustomApisBridge,
+                                       installConsoleInstrumentation,
                                        installAppDataInstrumentation, sendAllAppData,
                                        installWxmlInstrumentation, sendWxmlTree,
-                                       setupWxmlObserver, installSimulatorBridge,
+                                       setupWxmlObserver,
                                        setupApiCompatHook
+                                       （storage 面板数据由主进程 CDP 抓取，无 preload 侧 hook）
 ```
 
 ### Experimental exports (v0.x — signatures may change in minor versions)
@@ -414,18 +460,10 @@ dispose()
 @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/ipc-session            registerSessionIpc(ctx), sessionModule
 @dimina-kit/devtools/workbench-settings     loadWorkbenchSettings(), saveWorkbenchSettings(), applyTheme()
 ```
 
-> 注：以下子路径在过去版本曾被导出，已收敛到根 barrel 或内部实现，请改从 `@dimina-kit/devtools` 根入口导入（`createViewManager`、`registerAppIpc`、`simulatorDir`、`Project` 等类型）：
->
-> - `@dimina-kit/devtools/view-manager` → `import { createViewManager, type ViewManager } from '@dimina-kit/devtools'`
-> - `@dimina-kit/devtools/ipc-app` → `import { registerAppIpc } from '@dimina-kit/devtools'`
-> - `@dimina-kit/devtools/projects` → 通过 `ctx.workspace.listProjects()` 等服务方法访问；`Project` 类型从 `@dimina-kit/devtools` 根入口导入
-> - `@dimina-kit/devtools/layout` → `import { setHeaderHeight } from '@dimina-kit/devtools'`（其余布局细节回归内部实现）
-> - `@dimina-kit/devtools/simulator-dir` → `import { simulatorDir } from '@dimina-kit/devtools/paths'`
-
 ---
 
 ## WorkbenchContext
@@ -452,15 +490,10 @@ interface WorkbenchContext {
   // ── Internal lifecycle / security (host 不直接消费) ──
   registry: DisposableRegistry // 框架在创建时统一聚合 dispose
   senderPolicy: SenderPolicy   // IpcRegistry 自动校验 sender 白名单
-
-  /** @deprecated 用 ctx.windows.mainWindow */
-  mainWindow: BrowserWindow
-  /** @deprecated 用 ctx.windows.settingsWindow / setSettingsWindow */
-  workbenchSettingsWindow: BrowserWindow | null
 }
 ```
 
-会话和视图状态不再作为 ctx 的直接字段暴露，而是封装在对应 service 的私有闭包中：
+会话和视图状态封装在对应 service 的私有闭包中，通过方法访问：
 
 | 旧写法                       | 新写法                                                            |
 | ---------------------------- | ----------------------------------------------------------------- |
@@ -500,28 +533,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 不消费它。
 
 ---
 

package/dist/main/index.bundle.js

@@ -73,9 +73,9 @@ function setupCdpPort() {
 }
 
 // src/main/app/app.ts
-import { app as app11, BrowserWindow as BrowserWindow3, nativeImage } from "electron";
-import fs5 from "fs";
-import path8 from "path";
+import { app as app12, BrowserWindow as BrowserWindow3, nativeImage } from "electron";
+import fs6 from "fs";
+import path9 from "path";
 
 // src/main/utils/paths.ts
 import fs2 from "fs";
@@ -441,7 +441,9 @@ var ProjectChannel = {
   GetPages: "project:getPages",
   GetCompileConfig: "project:getCompileConfig",
   SaveCompileConfig: "project:saveCompileConfig",
-  Status: "project:status"
+  Status: "project:status",
+  CaptureThumbnail: "project:captureThumbnail",
+  GetThumbnail: "project:getThumbnail"
 };
 var ProjectsChannel = {
   List: "projects:list",
@@ -867,6 +869,9 @@ function createWindowService(mainWindow) {
   };
 }
 
+// src/main/services/workspace/workspace-service.ts
+import { webContents as webContents2 } from "electron";
+
 // src/main/services/projects/project-repository.ts
 import { app as app6 } from "electron";
 import path7 from "path";
@@ -1054,6 +1059,38 @@ function updateProjectSettings(projectPath, patch) {
   );
 }
 
+// src/main/services/projects/thumbnail.ts
+import { createHash } from "crypto";
+import fs4 from "fs";
+import path8 from "path";
+import { app as app7 } from "electron";
+function getThumbnailDir() {
+  return path8.join(app7.getPath("userData"), "thumbnails");
+}
+function hashProjectPath(projectPath) {
+  return createHash("sha256").update(projectPath).digest("hex").slice(0, 16);
+}
+function getThumbnailPath(projectPath) {
+  return path8.join(getThumbnailDir(), `${hashProjectPath(projectPath)}.png`);
+}
+function saveThumbnail(projectPath, image) {
+  const png = image.toPNG();
+  const dir = getThumbnailDir();
+  fs4.mkdirSync(dir, { recursive: true });
+  const filePath = getThumbnailPath(projectPath);
+  fs4.writeFileSync(filePath, png);
+  return `data:image/png;base64,${png.toString("base64")}`;
+}
+function loadThumbnail(projectPath) {
+  const filePath = getThumbnailPath(projectPath);
+  try {
+    const buf = fs4.readFileSync(filePath);
+    return `data:image/png;base64,${buf.toString("base64")}`;
+  } catch {
+    return null;
+  }
+}
+
 // src/main/services/workspace/workspace-service.ts
 function createWorkspaceService(ctx) {
   let currentSession = null;
@@ -1143,6 +1180,21 @@ function createWorkspaceService(ctx) {
     getSession: () => currentSession,
     getProjectPath: () => currentProjectPath,
     hasActiveSession: () => currentSession !== null,
+    async captureThumbnail(projectPath) {
+      const simWcId = ctx.views.getSimulatorWebContentsId();
+      if (!simWcId) return null;
+      const wc = webContents2.fromId(simWcId);
+      if (!wc || wc.isDestroyed()) return null;
+      try {
+        const image = await wc.capturePage();
+        return saveThumbnail(projectPath, image);
+      } catch {
+        return null;
+      }
+    },
+    getThumbnail(projectPath) {
+      return loadThumbnail(projectPath);
+    },
     getProjectPages: (projectPath) => getProjectPages(projectPath),
     getCompileConfig: (projectPath) => getCompileConfig(projectPath),
     saveCompileConfig: (projectPath, config) => saveCompileConfig(projectPath, config),
@@ -1208,6 +1260,17 @@ function installAppMenu(ctx) {
         { role: "quit" }
       ]
     },
+    {
+      label: "\u9879\u76EE",
+      submenu: [
+        {
+          label: "\u6253\u5F00\u9879\u76EE",
+          click: () => {
+            ctx.notify.windowNavigateBack();
+          }
+        }
+      ]
+    },
     {
       label: "\u7F16\u8F91",
       submenu: [
@@ -1249,7 +1312,7 @@ function installAppMenu(ctx) {
 }
 
 // src/main/ipc/app.ts
-import fs4 from "fs";
+import fs5 from "fs";
 
 // src/main/utils/ipc-registry.ts
 import { ipcMain } from "electron";
@@ -1355,7 +1418,7 @@ var IpcRegistry = class {
 // src/main/ipc/app.ts
 function registerAppIpc(ctx) {
   return new IpcRegistry(ctx.senderPolicy).handle(AppChannel.GetPreloadPath, () => {
-    return `file://${fs4.realpathSync(ctx.preloadPath)}`;
+    return `file://${fs5.realpathSync(ctx.preloadPath)}`;
   }).handle(AppChannel.GetBranding, async () => {
     if (ctx.brandingProvider) return ctx.brandingProvider();
     return { appName: ctx.appName };
@@ -1424,6 +1487,8 @@ var SettingsProjectSettingsChangedSchema = z.tuple([
   })
 ]);
 var PanelSelectSchema = z.tuple([z.string().min(1).max(200)]);
+var ProjectCaptureThumbnailSchema = z.tuple([AbsolutePath]);
+var ProjectGetThumbnailSchema = z.tuple([AbsolutePath]);
 
 // src/main/services/simulator/custom-apis.ts
 function createSimulatorApiRegistry() {
@@ -1478,7 +1543,7 @@ function registerSimulatorIpc(ctx) {
 }
 
 // src/main/ipc/panels.ts
-import { webContents as webContents2 } from "electron";
+import { webContents as webContents3 } from "electron";
 var BUILTIN_PANELS = [
   { id: "wxml", label: "WXML" },
   { id: "appdata", label: "AppData" },
@@ -1491,7 +1556,7 @@ function registerPanelsIpc(ctx) {
     const [expression] = validate(PanelChannel.Eval, PanelEvalSchema, args);
     const simWcId = ctx.views.getSimulatorWebContentsId();
     if (!ctx.workspace.hasActiveSession() || simWcId == null) return void 0;
-    const sim = webContents2.fromId(simWcId);
+    const sim = webContents3.fromId(simWcId);
     if (!sim || sim.isDestroyed()) return void 0;
     try {
       return await sim.executeJavaScript(expression);
@@ -1596,6 +1661,20 @@ function registerSessionIpc(ctx) {
     return ctx.workspace.saveCompileConfig(projectPath, config);
   }).handle(ProjectChannel.Close, () => {
     return ctx.workspace.closeProject();
+  }).handle(ProjectChannel.CaptureThumbnail, (_, ...args) => {
+    const [projectPath] = validate(
+      ProjectChannel.CaptureThumbnail,
+      ProjectCaptureThumbnailSchema,
+      args
+    );
+    return ctx.workspace.captureThumbnail(projectPath);
+  }).handle(ProjectChannel.GetThumbnail, (_, ...args) => {
+    const [projectPath] = validate(
+      ProjectChannel.GetThumbnail,
+      ProjectGetThumbnailSchema,
+      args
+    );
+    return ctx.workspace.getThumbnail(projectPath);
   });
 }
 var sessionModule = {
@@ -1603,7 +1682,7 @@ var sessionModule = {
 };
 
 // src/main/ipc/settings.ts
-import { app as app7 } from "electron";
+import { app as app8 } from "electron";
 function registerSettingsIpc(ctx) {
   return new IpcRegistry(ctx.senderPolicy).handle(WorkbenchSettingsChannel.Get, () => {
     return loadWorkbenchSettings();
@@ -1625,8 +1704,8 @@ function registerSettingsIpc(ctx) {
     applyTheme(theme);
   }).handle(WorkbenchSettingsChannel.GetCdpStatus, () => {
     const settings = loadWorkbenchSettings();
-    const switchValue = app7.commandLine.getSwitchValue("remote-debugging-port");
-    const implicitDevDefault = !app7.isPackaged && !settings.cdp.enabled && switchValue === "9222";
+    const switchValue = app8.commandLine.getSwitchValue("remote-debugging-port");
+    const implicitDevDefault = !app8.isPackaged && !settings.cdp.enabled && switchValue === "9222";
     return {
       configured: settings.cdp.enabled,
       port: settings.cdp.port,
@@ -1710,11 +1789,11 @@ var simulatorModule = {
 import { WebSocketServer } from "ws";
 
 // src/main/services/automation/exec.ts
-import { webContents as webContents3 } from "electron";
+import { webContents as webContents4 } from "electron";
 function getSimulator(ctx) {
   const simWcId = ctx.views.getSimulatorWebContentsId();
   if (!ctx.workspace.hasActiveSession() || simWcId == null) return null;
-  const sim = webContents3.fromId(simWcId);
+  const sim = webContents4.fromId(simWcId);
   if (!sim || sim.isDestroyed()) return null;
   return sim;
 }
@@ -2880,7 +2959,7 @@ function startMcpServer(resolvedCdpPort, mcpPort) {
 }
 
 // src/main/services/simulator-storage/index.ts
-import { app as app8, webContents as wcStatic } from "electron";
+import { app as app9, webContents as wcStatic } from "electron";
 function isSimulatorWebview(wc) {
   if (wc.isDestroyed()) return false;
   if (wc.getType() !== "webview") return false;
@@ -3130,9 +3209,9 @@ function setupSimulatorStorage(host, options) {
       wcSubs.delete(wc);
     });
   };
-  app8.on("web-contents-created", onWcCreated);
+  app9.on("web-contents-created", onWcCreated);
   registry.add(() => {
-    app8.removeListener("web-contents-created", onWcCreated);
+    app9.removeListener("web-contents-created", onWcCreated);
   });
   registry.add(async () => {
     const subs = Array.from(wcSubs.values());
@@ -3193,7 +3272,7 @@ async function clearElementInspection() {
 }
 
 // src/main/services/update/update-manager.ts
-import { app as app9, shell as shell3 } from "electron";
+import { app as app10, shell as shell3 } from "electron";
 var UpdateManager = class {
   checker;
   mainWindow;
@@ -3206,7 +3285,7 @@ var UpdateManager = class {
   constructor(opts) {
     this.checker = opts.checker;
     this.mainWindow = opts.mainWindow;
-    this.getCurrentVersion = opts.getCurrentVersion ?? (() => app9.getVersion());
+    this.getCurrentVersion = opts.getCurrentVersion ?? (() => app10.getVersion());
     this.ipc = new IpcRegistry(opts.senderPolicy);
     this.registerIpc();
     this.startPeriodicCheck(opts.checkInterval ?? 60 * 60 * 1e3, opts.initialDelay ?? 5e3);
@@ -3247,7 +3326,7 @@ var UpdateManager = class {
   install() {
     if (this.downloadedPath) {
       shell3.openPath(this.downloadedPath);
-      app9.quit();
+      app10.quit();
     }
   }
   /**
@@ -3280,7 +3359,7 @@ var UpdateManager = class {
 };
 
 // src/main/services/update/github-release-checker.ts
-import { app as app10 } from "electron";
+import { app as app11 } from "electron";
 
 // src/main/app/app.ts
 var DEFAULT_MODULES = {
@@ -3329,7 +3408,7 @@ async function disposeContext(ctx) {
 function createConfiguredMainWindow(config, rendererDir2) {
   const mainWindow = createMainWindow({
     title: config.appName ?? "Dimina DevTools",
-    indexHtml: path8.join(rendererDir2, "entries/main/index.html"),
+    indexHtml: path9.join(rendererDir2, "entries/main/index.html"),
     width: config.window?.width,
     height: config.window?.height,
     minWidth: config.window?.minWidth,
@@ -3384,7 +3463,7 @@ async function setupAutomation(instance) {
 function setupMcp() {
   const settings = loadWorkbenchSettings();
   if (!settings.mcp.enabled) return null;
-  const cdpPortSwitch = app11.commandLine.getSwitchValue("remote-debugging-port");
+  const cdpPortSwitch = app12.commandLine.getSwitchValue("remote-debugging-port");
   const cdpPort2 = cdpPortSwitch ? parseInt(cdpPortSwitch, 10) : settings.cdp.port;
   return startMcpServer(cdpPort2, settings.mcp.port);
 }
@@ -3405,12 +3484,12 @@ function wireAppWindowEvents(config, instance) {
   });
 }
 function enableDevRendererAutoReload(rendererDir2) {
-  if (app11.isPackaged) {
+  if (app12.isPackaged) {
     return toDisposable(() => {
     });
   }
   let reloadTimer = null;
-  const watcher = fs5.watch(rendererDir2, { recursive: true }, () => {
+  const watcher = fs6.watch(rendererDir2, { recursive: true }, () => {
     if (reloadTimer) clearTimeout(reloadTimer);
     reloadTimer = setTimeout(() => {
       for (const win of BrowserWindow3.getAllWindows()) {
@@ -3432,7 +3511,7 @@ function createWorkbenchApp(config = {}) {
   setupCdpPort();
   async function setup() {
     if (setupPromise) return setupPromise;
-    setupPromise = app11.whenReady().then(async () => {
+    setupPromise = app12.whenReady().then(async () => {
       applyTheme(loadWorkbenchSettings().theme);
       const rendererDir2 = config.rendererDir ?? rendererDir;
       const mainWindow = createConfiguredMainWindow(config, rendererDir2);
@@ -3496,7 +3575,7 @@ function createWorkbenchApp(config = {}) {
 
 // src/main/windows/settings-window/create.ts
 import { BrowserWindow as BrowserWindow4 } from "electron";
-import path9 from "path";
+import path10 from "path";
 async function createSettingsWindow(parent, rendererDir2) {
   const win = new BrowserWindow4({
     width: 420,
@@ -3514,7 +3593,7 @@ async function createSettingsWindow(parent, rendererDir2) {
     }
   });
   applyNavigationHardening(win.webContents, rendererDir2);
-  await win.loadFile(path9.join(rendererDir2, "entries/workbench-settings/index.html"));
+  await win.loadFile(path10.join(rendererDir2, "entries/workbench-settings/index.html"));
   return win;
 }
 

package/dist/main/ipc/session.js

@@ -1,5 +1,5 @@
 import { ProjectChannel } from '../../shared/ipc-channels.js';
-import { ProjectGetCompileConfigSchema, ProjectGetPagesSchema, ProjectOpenSchema, ProjectSaveCompileConfigSchema, } from '../../shared/ipc-schemas.js';
+import { ProjectCaptureThumbnailSchema, ProjectGetCompileConfigSchema, ProjectGetPagesSchema, ProjectGetThumbnailSchema, ProjectOpenSchema, ProjectSaveCompileConfigSchema, } from '../../shared/ipc-schemas.js';
 import { validate } from '../utils/ipc-schema.js';
 import { IpcRegistry } from '../utils/ipc-registry.js';
 export function registerSessionIpc(ctx) {
@@ -22,6 +22,14 @@ export function registerSessionIpc(ctx) {
     })
         .handle(ProjectChannel.Close, () => {
         return ctx.workspace.closeProject();
+    })
+        .handle(ProjectChannel.CaptureThumbnail, (_, ...args) => {
+        const [projectPath] = validate(ProjectChannel.CaptureThumbnail, ProjectCaptureThumbnailSchema, args);
+        return ctx.workspace.captureThumbnail(projectPath);
+    })
+        .handle(ProjectChannel.GetThumbnail, (_, ...args) => {
+        const [projectPath] = validate(ProjectChannel.GetThumbnail, ProjectGetThumbnailSchema, args);
+        return ctx.workspace.getThumbnail(projectPath);
     });
 }
 export const sessionModule = {

package/dist/main/menu/index.js

@@ -23,6 +23,17 @@ export function installAppMenu(ctx) {
                 { role: 'quit' },
             ],
         },
+        {
+            label: '项目',
+            submenu: [
+                {
+                    label: '打开项目',
+                    click: () => {
+                        ctx.notify.windowNavigateBack();
+                    },
+                },
+            ],
+        },
         {
             label: '编辑',
             submenu: [

package/dist/main/services/projects/thumbnail.d.ts

@@ -0,0 +1,4 @@
+import { type NativeImage } from 'electron';
+export declare function saveThumbnail(projectPath: string, image: NativeImage): string | null;
+export declare function loadThumbnail(projectPath: string): string | null;
+//# sourceMappingURL=thumbnail.d.ts.map