Skip to content

Commit 01e759b

Browse files
committed
feat(desktop): implement onboarding wizard (anomalyco#180)
Squash merge of feature branch issue-180-desktop-implement-onboarding-wizard. Implements the full Desktop onboarding wizard: 10-step GUI flow with system check, CLI bootstrap, engine install, GitHub auth, AI provider, ontology setup, runtime preparation, space creation, memory config, and star guide. Done step uses in-process transition to Workbench instead of app.relaunch(). Key components: - Onboarding state module with atomic persistence and corruption recovery - Main startup gate routing onboarding vs workbench mode - IPC channels with mutex serialization for concurrent operations - Bootstrap installer with dev-mode --no-modify-path guard - Setup machine client consuming wopal-cli machine capability - Shell env probe for WOPAL_HOME at cold start - Version compatibility check on every launch - 10 step components with unified progress, error, and log drawer - In-process onboarding-to-workbench transition (forkDetach sidecar) - Memory config with real LLM/Embedding form and probe flow - Ontology source selection (official / custom GitHub URL) - Plugin dep install hardening (atomic write, per-dir lock, corruption recovery) Also includes workbench fixes from main branch: - CLI health check cached permanently to avoid polling - Session lifecycle, pty 404, and dropSessionState fixes
1 parent 19668db commit 01e759b

72 files changed

Lines changed: 9773 additions & 495 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.ci/versions.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"minWopalCli": "0.3.4"
3+
}

‎docs/DESKTOP-ONBOARDING.md‎

Lines changed: 333 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/DESKTOP.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -416,3 +416,82 @@ Desktop 的选择键保持稳定别名 `sidecar`,不能用于判断 sidecar
416416
### 16.4 不自动恢复
417417

418418
PTY 清理后不自动创建 Session 或 PTY 伪装恢复。用户点击 TUI/Terminal 后按正常 Action 创建新 PTY。Session 绑定和草稿保留。
419+
420+
## 17. Onboarding 模式启动行为
421+
422+
### 17.1 模式判定
423+
424+
Desktop Main Process 在 `app.whenReady()` 之后,创建窗口之前,必须完成模式判定:
425+
426+
```
427+
读 $WOPAL_HOME/ellamaka/state/onboarding.json
428+
├── 文件不存在 或 completed !== true → Onboarding 模式
429+
│ ├── 跳过 SidecarSupervisor 启动
430+
│ ├── 跳过 migrate()
431+
│ ├── 创建 Onboarding 窗口(OnboardingRoot)
432+
│ └── 等待用户完成 8 步流程
433+
│
434+
└── completed === true → Workbench 模式
435+
├── 执行版本兼容检查(§17.7)
436+
│ ├── 通过 → 继续
437+
│ └── 阻断 → 展示兼容错误页面 / 触发升级流程
438+
├── 正常启动 SidecarSupervisor
439+
├── 执行 migrate()
440+
├── 创建 Workbench 窗口
441+
└── 加载 ellamaka-app Workbench
442+
```
443+
444+
### 17.2 与正常启动的关键差异
445+
446+
| 行为 | Workbench 模式 | Onboarding 模式 |
447+
|------|---------------|----------------|
448+
| Sidecar 启动 | 立即启动 | 不启动 |
449+
| migrate() | 执行 | 跳过 |
450+
| 窗口类型 | Workbench 窗口 | Onboarding 窗口(无 sidecar 依赖) |
451+
| PTY 连接 | 建立 sidecar PTY | 无 PTY |
452+
| 完成后 | — | 写入 `onboarding.json` 的 `completed: true`,relaunch |
453+
| 重启策略 | SidecarSupervisor 退避重试 | 不适用(无 sidecar) |
454+
455+
### 17.3 开发模式快速跳过
456+
457+
`WOPAL_DEV=1` + `WOPAL_DEV_SKIP_ONBOARDING=1` 时,即使 onboarding 未完成,也跳过 Onboarding 模式直接进入 Workbench。
458+
459+
### 17.4 Onboarding 完成后的 relaunch
460+
461+
Onboarding 最后一步 `done` 的行为:
462+
463+
1. Desktop Main 写 `onboarding.json`:`{ completed: true, completedAt: <ISO timestamp> }`
464+
2. Desktop Main 调用 `app.relaunch()`
465+
3. Desktop Main 调用 `app.quit()`
466+
4. 新进程启动 → 读 `onboarding.json` → `completed === true` → Workbench 模式
467+
468+
relaunch 必须成功;若失败(如 `app.relaunch()` 不可用),须提示用户手动重启应用并提供清晰指引。
469+
470+
### 17.5 失败回退
471+
472+
Onboarding 过程中若 Desktop 意外退出(崩溃或被 kill),下次启动仍读 `onboarding.json`,`completed !== true` 则重新进入 Onboarding 模式。已完成步骤不丢失(状态文件独立持久化),但当前步骤执行中产生的副作用不保证回滚。
473+
474+
### 17.6 相关文档
475+
476+
- 完整 Onboarding 架构与步骤行为:`DESIGN-onboarding.md`(产品层)
477+
- 错误处理矩阵与组件 props:`DESKTOP-ONBOARDING.md`(本目录)
478+
- Machine capability 契约:`DESIGN-onboarding.md` §3.2
479+
480+
### 17.7 启动时版本兼容检查
481+
482+
Workbench 模式下,Desktop 在 sidecar 启动前须执行版本兼容检查。检查基于本地已安装组件版本,不需要网络请求。(详细逻辑见 `DESIGN-onboarding.md` §7.3。)
483+
484+
**检查流程**:
485+
486+
1. 执行 `ellamaka --version`、`wopal --version`
487+
2. 提取 ellamaka CLI 版本 `X.Y.Z` 前缀 → 与 Desktop 自身版本号 `X.Y.Z` 前缀精确匹配
488+
3. wopal-cli 版本 → 与 ellamaka binary 内置的 `MIN_WOPAL_CLI_VERSION`(构建注入)做 semver 比较
489+
490+
**失败处理**:
491+
492+
| 严重度 | 行为 |
493+
|--------|------|
494+
| 🔴 阻断(基线不一致) | 不启动 sidecar。从 R2 manifest 读取本基线最新完整版本号,调用 `wopal ellamaka install --version <完整版本号>`。安装后 relaunch |
495+
| 🔴 阻断(wopal-cli 版本过低) | 弹窗提示升级指引,提供"立即升级"按钮 |
496+
497+
**与自动更新的协作**:自动更新检测到新版本后,在下载应用前先执行 `DESIGN-onboarding.md` §7.4 的更新前兼容检查。检查通过才下载和安装。

‎docs/DISTRIBUTION.md‎

Lines changed: 37 additions & 137 deletions
Original file line numberDiff line numberDiff line change
@@ -281,24 +281,36 @@ Contract:
281281

282282
## 6. Install Contract
283283

284-
P1 使用固定安装路径。
285-
286284
所有用户级路径都解析到 `WOPAL_HOME`。默认值:macOS / Linux 为 `~/.wopal`,Windows 为 `%USERPROFILE%\.wopal`。
287285

288286
| Platform | Binary path | Runtime roots |
289287
|---|---|---|
290288
| macOS / Linux | `$WOPAL_HOME/bin/ellamaka` | `$WOPAL_HOME/ellamaka/{config,data,cache,state}` |
291289
| Windows | `$WOPAL_HOME/bin/ellamaka.exe` | `$WOPAL_HOME/ellamaka/{config,data,cache,state}` |
292290

293-
Install contract:
291+
### 分发渠道
292+
293+
ellamaka CLI 通过以下渠道分发到用户本地:
294+
295+
- **主路径**:Desktop onboarding(step 3),Desktop 自行从 R2 下载并放置到固定路径。
296+
- **辅助入口**:`wopal ellamaka install`,供终端用户和 `wopal setup` 编排使用。
297+
- **手动下载**:用户从 GitHub/Gitee Release 页面点击 R2 链接下载。
298+
299+
### 安装契约
300+
301+
consumer(wopal-cli 或 Desktop)在安装 ellamaka 时须遵循以下契约:
302+
303+
- 从 R2 读取 manifest(`https://download.coursedao.com/ellamaka/latest/manifest.json`),不深入其内部构建。
304+
- 默认安装 stable release 的 latest 版本;显式传参允许指定版本。
305+
- 根据平台和稳定 artifact naming 计算目标文件名,不依赖 GitHub API 解析 release 页面。
306+
- 安装目标固定为上述 binary path。
307+
- 放置前必须校验 SHA-256。
308+
- 安装后执行 `ellamaka --version` 作为健康验证。
294309

295-
1. `wopal ellamaka install` 是 P1 唯一的自动安装入口。
296-
2. 不指定版本时,consumer 安装 stable release 的 latest 版本。
297-
3. 显式指定版本时,consumer 安装对应 `v<version>` release。
298-
4. consumer 根据 OS / arch / libc 与稳定 artifact naming 计算目标文件名。
299-
5. consumer 在放置 binary 前必须校验 SHA-256。
300-
6. 安装成功的标志是 `ellamaka --version` 正常输出。
301-
7. P1 使用固定安装路径;自定义目录、后台更新和二级包管理器适配属于后续阶段。
310+
### 职责边界
311+
312+
- consumer 负责下载、校验、放置和状态报告;ellamaka 的运行目录(`$WOPAL_HOME/ellamaka/`)由 ellamaka 自身管理。
313+
- `ellamaka-main` 保持本地开发语义,走手动 build/rebuild 路径。
302314

303315
---
304316

@@ -324,92 +336,20 @@ ellamaka 安装完成后,运行时加载链路按 WopalSpace mode 工作:
324336

325337
## 8. R2 CDN Distribution
326338

327-
Cloudflare R2 是 ellamaka P1 的唯一 binary 分发源。R2 bucket `wopal-release` 与 wopal-cli 共享,通过 Cloudflare 自定义域名 `download.coursedao.com` 暴露给公网,由 Cloudflare 全球 CDN(含中国大陆节点)提供低延迟下载。
328-
329-
### 存储结构
330-
331-
```
332-
s3://wopal-release/
333-
├── wopal-cli/ ← wopal-cli
334-
│ └── ...
335-
├── ellamaka/ ← ellamaka CLI 二进制
336-
│ ├── v0.1.0/
337-
│ │ ├── ellamaka-darwin-arm64.tar.gz
338-
│ │ ├── ellamaka-darwin-x64.tar.gz
339-
│ │ ├── ellamaka-darwin-x64-baseline.tar.gz
340-
│ │ ├── ellamaka-linux-x64.tar.gz
341-
│ │ ├── ellamaka-linux-x64-baseline.tar.gz
342-
│ │ ├── ellamaka-windows-x64.zip
343-
│ │ ├── ellamaka-windows-x64-baseline.zip
344-
│ │ ├── manifest.json
345-
│ │ ├── checksums.txt
346-
│ │ └── release-notes.md
347-
│ ├── v0.2.0/
348-
│ │ └── ...
349-
│ └── latest/
350-
│ └── manifest.json
351-
└── ellamaka-desktop/ ← 桌面安装包(见 §9)
352-
├── v0.1.0/
353-
│ ├── ellamaka-desktop-mac-arm64.dmg
354-
│ ├── ellamaka-desktop-mac-arm64.zip
355-
│ ├── ellamaka-desktop-mac-x64.dmg
356-
│ ├── ellamaka-desktop-mac-x64.zip
357-
│ ├── ellamaka-desktop-win-x64.exe
358-
│ ├── ellamaka-desktop-linux-x64.AppImage
359-
│ ├── ellamaka-desktop-linux-x64.deb
360-
│ ├── ellamaka-desktop-linux-x64.rpm
361-
│ ├── manifest.json
362-
│ ├── latest-mac.yml
363-
│ ├── latest.yml
364-
│ ├── latest-linux.yml
365-
│ ├── checksums.txt
366-
│ └── release-notes.md
367-
├── v0.2.0/
368-
│ └── ...
369-
├── latest/ ← prod updater payload、blockmap 与 latest-*.yml
370-
│ ├── latest-mac.yml
371-
│ ├── latest.yml
372-
│ ├── latest-linux.yml
373-
│ └── ellamaka-desktop-*
374-
└── beta/ ← beta channel(见 §9.5)
375-
```
376-
377-
### URL 结构
378-
379-
CLI:
380-
381-
- 版本化:`https://download.coursedao.com/ellamaka/v$VERSION/<file>`
382-
- Latest 别名:`https://download.coursedao.com/ellamaka/latest/manifest.json`
383-
384-
Desktop:
385-
386-
- Prod 版本化:`https://download.coursedao.com/ellamaka-desktop/v$VERSION/<file>`
387-
- Prod Latest(updater feed):`https://download.coursedao.com/ellamaka-desktop/latest/<feed>`
388-
- Beta 版本化:`https://download.coursedao.com/ellamaka-desktop/beta/v$VERSION/<file>`
389-
- Beta Latest:`https://download.coursedao.com/ellamaka-desktop/beta/latest/<feed>`
390-
391-
### 缓存策略(P2 对齐)
392-
393-
| 路径 | Cache-Control | 含义 |
394-
|------|---------------|------|
395-
| `v$VERSION/*` | `public, max-age=2592000` | 30 天,文件不可变 |
396-
| `latest/*` | `public, max-age=60` | 60 秒,发版时主动 purge |
397-
398-
缓存策略对 CLI 与 Desktop 一致。Desktop 的 `latest/*` 同时承载 `manifest.json` 与 `latest-*.yml` 自动更新 feed,TTL 一致。
399-
400-
**实现契约**(所有 release workflow 必须遵守):
401-
402-
1. 上传前先 `delete-object` 清掉旧内容(R2 自定义域名不主动 invalidate)—— `publish-ellamaka.yml:142-144` 和 `publish-ellamaka-desktop.yml:195-196` 已实现
403-
2. `put-object` 时显式设置 `--cache-control` —— `publish-ellamaka.yml:160` 和 `publish-ellamaka-desktop.yml:210` 已实现
404-
3. 发版完成后主动 purge `latest/*` 路径(Cloudflare API 或 cache-buster 请求)
339+
> R2 bucket 结构、URL 格式、缓存策略、安全配置和 Release 索引策略的完整定义见 `DESIGN-distribution.md` §2-§5。
340+
>
341+
> ellamaka 的 R2 路径为 `ellamaka/v$VERSION/`(版本化)和 `ellamaka/latest/`(latest 别名)。Desktop 的 R2 路径为 `ellamaka-desktop/v$VERSION/`、`ellamaka-desktop/latest/`(prod)和 `ellamaka-desktop/beta/`(beta channel)。
405342
406-
### Desktop 独立路径
343+
ellamaka 与 wopal-cli 共享同一 R2 bucket、同一自定义域名与缓存策略,差异仅在于产品级顶层目录和 tag 命名格式(`v0.1.0` vs `cli-v0.3.0`)。
407344

408-
`ellamaka-desktop/` 与 `ellamaka/` 并列,共享同一 bucket、同一自定义域名与缓存策略,但为独立发布单元:版本化目录、latest 别名、beta channel 和去重原则均独立。差异在于顶层产品目录与产物形态(安装包 + updater feed,而非 CLI 二进制归档)。详见 §9。
345+
Desktop 的 `latest/` 目录服务两类消费者:
409346

410-
### 与 wopal-cli 的一致性
347+
| 消费者 | 读取文件 | 用途 |
348+
|--------|---------|------|
349+
| electron-updater(应用内) | `latest-mac.yml` / `latest.yml` / `latest-linux.yml` | 启动时检测更新、增量下载、签名校验 |
350+
| wopal-site 下载页(人工) | `manifest.json` | 渲染下载卡片、获取各平台 URL |
411351

412-
ellamaka 与 wopal-cli 共享同一套 R2 bucket `wopal-release`、同一个自定义域名 `download.coursedao.com`,以及相同的缓存策略、latest 别名设计和去重原则。差异仅在于产品级顶层目录(`ellamaka/` vs `wopal-cli/`)和 tag 命名格式(`v0.1.0` vs `cli-v0.3.0`)。
352+
**当前缺口(P2 收尾项)**:`publish-ellamaka-desktop.yml` 上传 `v$VERSION/manifest.json` 后没有复制到 `latest/manifest.json`。下载页因此无法用 manifest 模式获取 Desktop 最新版本。修复方法:workflow 加 1 行 `put_with_cache` 将 manifest 同步到 latest 路径。
413353

414354
---
415355

@@ -481,34 +421,7 @@ R2 上传、manifest 校验与 CDN purge 复用 CLI 的既有机制(单 PUT
481421

482422
### 9.5 R2 存储与 URL
483423

484-
见 §8 存储结构:`s3://wopal-release/ellamaka-desktop/v$VERSION/` 与 `.../latest/`。
485-
486-
- Prod 版本化:`https://download.coursedao.com/ellamaka-desktop/v$VERSION/<file>`
487-
- Prod Latest(updater feed):`https://download.coursedao.com/ellamaka-desktop/latest/<feed>`
488-
- Prod Latest(manifest,给下载页用):`https://download.coursedao.com/ellamaka-desktop/latest/manifest.json`
489-
- Beta 版本化:`https://download.coursedao.com/ellamaka-desktop/beta/v$VERSION/<file>`
490-
- Beta Latest:`https://download.coursedao.com/ellamaka-desktop/beta/latest/<feed>`
491-
492-
缓存策略与 CLI 一致(`v$` 30 天、`latest` 60 秒)。
493-
494-
### 9.5.1 latest 目录下的两类消费者
495-
496-
`ellamaka-desktop/latest/` 目录服务两类不同消费者:
497-
498-
| 消费者 | 读取文件 | 用途 |
499-
|--------|---------|------|
500-
| electron-updater(应用内) | `latest-mac.yml` / `latest.yml` / `latest-linux.yml` | 启动时检测更新、增量下载、签名校验 |
501-
| wopal-site 下载页(人工) | `manifest.json` | 渲染下载卡片、获取 macOS/Windows/Linux 平台 URL |
502-
503-
**两者职责独立、格式不同**:
504-
- yml 是 electron-updater 的硬契约(sha512、相对路径、平台分文件)
505-
- manifest.json 是下载页/CLI 的下载入口(sha256、绝对 URL、单文件含全平台)
506-
507-
**当前缺口(P2 收尾项)**:`publish-ellamaka-desktop.yml` 上传 `v$VERSION/manifest.json` 后**没有**把它复制/重新上传到 `latest/manifest.json`。下载页因此无法用 manifest 模式获取 Desktop 最新版本,fallback 只能写死 URL。修复方法:workflow 加 1 行:
508-
509-
```yaml
510-
put_with_cache "release-output/manifest.json" "${LATEST_PREFIX}/manifest.json" "public, max-age=60" "application/json"
511-
```
424+
见 §8 和 `DESIGN-distribution.md` §2。Desktop prod/beta 的 URL 结构与缓存策略已统一定义。
512425

513426
### 9.6 安装入口
514427

@@ -629,28 +542,15 @@ P1 使用 ad-hoc 签名。该签名保证 macOS app bundle 结构完整并通过
629542

630543
---
631544

632-
## 10. Out of Scope
633-
634-
以下适用于 Engine。Desktop 的 out of scope 见 §9.9。
635-
636-
1. 自定义安装目录
637-
2. npm / brew / winget / choco 等多渠道适配
638-
3. 自动后台更新(Engine;Desktop 已通过 electron-updater 提供检测通知)
639-
4. R2 以外的镜像/分发渠道
640-
5. 在分发阶段替代 wopal-space mode 的配置融合与 runtime loading
641-
6. 独立 ellamaka installer 脚本
642-
7. **P1 已移除**:`engine.ts` 下载 URL 切换为 R2——`projects/wopal-cli/src/lib/engine.ts:11` 已定义 `R2_BASE_URL = "https://download.coursedao.com/ellamaka"`,R2 切换早已完成
643-
644-
---
645-
646-
## 11. Related Documents
545+
## 10. Related Documents
647546

648547
| 文档 | 说明 |
649548
|---|---|
650549
| `./DESKTOP.md` | ellamaka-desktop 架构、状态所有权、PTY 生命周期与验证契约 |
651550
| `./BRANDING.md` | ellamaka 品牌注入点清单与桌面分发身份(§17) |
652-
| `../../../docs/products/wopal-space/DESIGN-wopalspace.md` | 产品级 setup integration flow 与系统分层 |
653-
| `../../../docs/products/wopal-space/DESIGN-onboarding.md` | P2 统一入口设计:Desktop onboarding、缓存策略对齐、Desktop auto-update |
551+
| `../../../docs/products/wopal-space/DESIGN-distribution.md` | 产品级分发总设计:R2 架构、缓存策略、完整性模型、Release 索引策略 |
552+
| `../../../docs/products/wopal-space/DESIGN-wopalspace.md` | 产品级架构与版本体系 |
553+
| `../../../docs/products/wopal-space/DESIGN-onboarding.md` | Onboarding 架构、setup 完整流程、版本兼容矩阵维护 |
654554
| `../../wopal-cli/docs/DESIGN.md` | CLI 的 setup / engine / space orchestration 边界 |
655555
| `../../wopal-cli/docs/DISTRIBUTION.md` | CLI 对 ellamaka release 的消费契约 |
656556
| `../../../.wopal/docs/DESIGN.md` | ontology 的 template、command 与 runtime maintenance 设计 |

‎packages/ellamaka-app/src/context/server.tsx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ export function resolveServerList(input: {
4040
input.props?.map((v) => [ServerConnection.key(v), v]) ?? [],
4141
)
4242

43-
for (const value of input.stored) {
43+
for (const value of input.stored ?? []) {
4444
const conn: ServerConnection.Http =
4545
typeof value === "string"
4646
? {
@@ -142,7 +142,7 @@ export const { use: useServer, provider: ServerProvider } = createSimpleContext(
142142
const url = (x: StoredServer) => (typeof x === "string" ? x : "type" in x ? x.http.url : x.url)
143143

144144
const allServers = createMemo((): Array<ServerConnection.Any> => {
145-
return resolveServerList({ stored: store.list, props: props.servers })
145+
return resolveServerList({ stored: store.list ?? [], props: props.servers })
146146
})
147147

148148
const [state, setState] = createStore({
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
import { mkdirSync, rmSync, existsSync } from "node:fs"
2+
import { join } from "node:path"
3+
import { tmpdir } from "node:os"
4+
import { resolveOnboardingMode } from "../src/main/onboarding-gate"
5+
import { createDefaultOnboardingState, markCompleted, writeOnboardingState } from "../src/main/onboarding-state"
6+
7+
export function createOnboardingTestEnv() {
8+
const testHome = join(tmpdir(), `onboarding-e2e-${Date.now()}-${Math.random().toString(36).slice(2)}`)
9+
mkdirSync(testHome, { recursive: true })
10+
11+
return {
12+
testHome,
13+
cleanup: () => {
14+
if (existsSync(testHome)) {
15+
rmSync(testHome, { recursive: true, force: true })
16+
}
17+
},
18+
markOnboardingComplete: () => {
19+
const state = markCompleted(createDefaultOnboardingState())
20+
writeOnboardingState(state, testHome)
21+
},
22+
getMode: () => resolveOnboardingMode(testHome, {}),
23+
}
24+
}
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
import { describe, expect, test, beforeEach, afterEach } from "bun:test"
2+
import { createOnboardingTestEnv } from "./onboarding-harness"
3+
4+
describe("Onboarding E2E Flow", () => {
5+
let env: ReturnType<typeof createOnboardingTestEnv>
6+
7+
beforeEach(() => {
8+
env = createOnboardingTestEnv()
9+
})
10+
11+
afterEach(() => {
12+
env.cleanup()
13+
})
14+
15+
test("initial launch enters onboarding mode", () => {
16+
const mode = env.getMode()
17+
expect(mode).toBe("onboarding")
18+
})
19+
20+
test("completion switches launch mode to workbench", () => {
21+
expect(env.getMode()).toBe("onboarding")
22+
env.markOnboardingComplete()
23+
expect(env.getMode()).toBe("workbench")
24+
})
25+
})

‎packages/ellamaka-desktop/electron-mock.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@ mock.module("electron", () => ({
3737
ipcMain: {
3838
handle: () => {},
3939
on: () => {},
40+
removeHandler: () => {},
41+
removeAllListeners: () => {},
4042
},
4143
session: {
4244
defaultSession: {

0 commit comments

Comments
 (0)