# Preload 桥接与安全模型
**本文引用的文件**
- [bridge.ts](file://ai-electron/electron/preload/bridge.ts)
- [index.ts](file://ai-electron/electron/preload/index.ts)
- [lifecycle.ts](file://ai-electron/electron/preload/lifecycle.ts)
- [main.ts](file://ai-electron/electron/main.ts)
- [windowOptions.ts](file://ai-electron/electron/config/windowOptions.ts)
- [config.default.ts](file://ai-electron/electron/config/config.default.ts)
- [osCtl.js](file://ai-electron/electron/controller/osCtl.js)
- [ipcRenderer.ts](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts)
- [useElectronWindow.ts](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts)
## 目录
1. [引言](#引言)
2. [项目结构](#项目结构)
3. [核心组件](#核心组件)
4. [架构总览](#架构总览)
5. [详细组件分析](#详细组件分析)
6. [依赖关系分析](#依赖关系分析)
7. [性能与安全性考虑](#性能与安全性考虑)
8. [故障排查指南](#故障排查指南)
9. [结论](#结论)
10. [附录:新增安全 IPC 接口步骤](#附录新增安全-ipc-接口步骤)
## 引言
本文聚焦 Electron 渲染进程的安全访问模型,重点说明在启用 contextIsolation 后,为什么不能直接在渲染进程中使用 Electron API,以及当前仓库中 preload、bridge、IPC 通道和前端调用链路如何协作。同时给出最小权限暴露策略、跨进程通信边界、常见错误原因,以及新增一个安全 IPC 接口的完整示例路径。
## 项目结构
与 preload 桥和安全模型直接相关的代码主要分布在以下位置:
- 主进程入口与生命周期注册:`ai-electron/electron/main.ts`、`ai-electron/electron/preload/lifecycle.ts`
- Preload 初始化逻辑:`ai-electron/electron/preload/index.ts`
- 上下文桥接暴露:`ai-electron/electron/preload/bridge.ts`
- 窗口与 WebPreferences 配置:`ai-electron/electron/config/windowOptions.ts`、`ai-electron/electron/config/config.default.ts`
- 主进程控制器(IPC 处理):`ai-electron/electron/controller/osCtl.js`
- 前端 IPC 封装与 Hook:`ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts`、`ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts`
```mermaid
graph TB
Main["主进程 main.ts"] --> Lifecycle["生命周期 lifecycle.ts"]
Main --> Preload["预加载 index.ts"]
Preload --> TrayService["托盘服务 trayService"]
Preload --> SecurityService["安全服务 securityService"]
Bridge["上下文桥 bridge.ts"] --> Window["渲染进程 window.electron"]
Config["窗口配置 windowOptions.ts
默认配置 config.default.ts"] --> Window
FrontendIpc["前端 IPC 封装 ipcRenderer.ts"] --> Window
FrontendHook["窗口 Hook useElectronWindow.ts"] --> FrontendIpc
FrontendIpc --> IpcChannel["IPC 通道 controller/osCtl/*"]
IpcChannel --> OsCtl["主进程控制器 osCtl.js"]
```
**图表来源**
- [main.ts:1-19](file://ai-electron/electron/main.ts#L1-L19)
- [lifecycle.ts:1-73](file://ai-electron/electron/preload/lifecycle.ts#L1-L73)
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [useElectronWindow.ts:1-87](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts#L1-L87)
**章节来源**
- [main.ts:1-19](file://ai-electron/electron/main.ts#L1-L19)
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
## 核心组件
本节从安全角度解释每个关键文件的作用。
### 上下文桥 `bridge.ts`
该文件通过 `contextBridge.exposeInMainWorld('electron', {...})` 向渲染进程暴露受控对象。当前仅暴露 `ipcRenderer`,这是实现“只让渲染进程使用经过主进程控制的 IPC 能力”的最小集合。它体现了最小权限原则:不暴露 Node.js、文件系统、子进程、窗口管理等危险 API。
**章节来源**
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
### 预加载入口 `preload/index.ts`
`preload()` 函数在渲染进程上下文之前运行,负责创建托盘服务和安全服务。其设计目标是把需要长期存在的主进程服务启动逻辑放在 preload 阶段执行,而不是在渲染进程中直接引入 Electron 或 Node 能力。这样可以避免渲染进程直接持有系统级能力,降低被恶意脚本利用的风险。
当前实现还包含日志输出和占位注释,表明后续可扩展更多服务初始化逻辑。
**章节来源**
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
### 主进程生命周期 `lifecycle.ts`
Lifecycle 类注册应用就绪、Electron 应用就绪、窗口就绪、关闭前等生命周期钩子。虽然它本身不是 preload 桥的一部分,但它展示了主进程对窗口、屏幕、焦点、显示时机等系统能力的集中管理。这些能力应始终由主进程控制器封装后通过 IPC 暴露,而不能由渲染进程直接操作。
**章节来源**
- [lifecycle.ts:1-73](file://ai-electron/electron/preload/lifecycle.ts#L1-L73)
### 主进程入口 `main.ts`
`main.ts` 创建应用实例、注册生命周期钩子,并把 `preload` 函数注册到应用生命周期中。这说明 preload 是主进程生命周期的一部分,但它在渲染页面加载前执行,从而可以在安全边界内初始化服务并暴露最小化接口。
**章节来源**
- [main.ts:1-19](file://ai-electron/electron/main.ts#L1-L19)
### 窗口配置 `windowOptions.ts` 与 `config.default.ts`
当前默认配置将 `contextIsolation` 设为 false,并将 `nodeIntegration` 设为 true。配置文件注释明确说明:渲染进程目前依赖 `nodeIntegration` 直接 `require('electron')` 调用 IPC;如果智能工作台窗口单独启用 `contextIsolation`,而 preload 没有相应启用,两个窗口行为会不一致。
这意味着当前代码库的实际安全模型与“理想安全模型”之间存在差异:
- 理想模型:启用 `contextIsolation`,禁用 `nodeIntegration`,仅通过 preload 暴露最小 API。
- 当前模型:未启用 `contextIsolation`,渲染进程可直接使用 Electron API,bridge 的存在更像兼容层而非唯一安全边界。
因此,bridge 暴露的接口必须继续保持最小权限,即使当前渲染进程可能拥有更大能力。
**章节来源**
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
### 主进程控制器 `osCtl.js`
`OsCtl` 是 IPC 控制器的代表,封装了窗口控制、文件读取、目录选择、外部链接打开、应用信息获取、流式上传等功能。所有敏感能力都集中在主进程侧,并通过统一的返回值信封 `{ success, data | message }` 返回给前端。这样前端不需要直接操作 `fs`、`path`、`shell` 等危险模块。
其中 `resolveSenderWindow` 根据 IPC 事件发送方解析目标窗口,使无边框窗口的最小化、最大化、关闭等操作能正确作用于发起者或主窗口。
**章节来源**
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
### 前端 IPC 封装 `ipcRenderer.ts`
前端封装提供两个关键能力:
1. `resolveIpcRenderer()`:优先从 `window.electron.ipcRenderer` 获取,回退到 `require('electron').ipcRenderer`,浏览器环境返回 null。
2. `invokeIpc()`:统一构造 `controller//` 通道,调用主进程控制器方法。
3. `onIpc()`:订阅主进程推送,返回取消订阅函数。
该封装兼容当前两种运行方式:既支持未来启用 preload + bridge 后的 `window.electron`,也兼容当前 `nodeIntegration: true` 的 require 方式。
**章节来源**
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
### 前端窗口 Hook `useElectronWindow.ts`
该 Hook 封装无边框窗口的常用操作:最小化、最大化、切换最大化、关闭窗口,并在挂载时同步窗口状态。它同样使用 `resolveIpcRenderer()` 获取 IPC 能力,并把方法名拼接到 `controller/osCtl/` 通道下。
**章节来源**
- [useElectronWindow.ts:1-87](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts#L1-L87)
## 架构总览
下图展示从前端 UI 到主进程控制器的完整 IPC 流程,以及 preload 桥在其中的作用。
```mermaid
sequenceDiagram
participant UI as "前端界面"
participant Hook as "useElectronWindow.ts"
participant Utils as "ipcRenderer.ts"
participant Window as "渲染进程 window.electron"
participant Bridge as "preload bridge.ts"
participant Controller as "主进程 osCtl.js"
UI->>Hook: 触发窗口操作
Hook->>Utils: invokeIpc(method, params)
Utils->>Window: resolveIpcRenderer()
Window-->>Utils: ipcRenderer.invoke(channel, params)
Utils->>Controller: IPC 通道 controller/osCtl/method
Controller->>Controller: resolveSenderWindow(event)
Controller-->>Utils: { success, data | message }
Utils-->>Hook: Promise 结果
Hook-->>UI: 更新状态或提示
```
**图表来源**
- [useElectronWindow.ts:1-87](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts#L1-L87)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
## 详细组件分析
### 安全边界与最小权限暴露策略
当前仓库的安全边界体现在三个层面:
1. **API 暴露面最小化**
`bridge.ts` 只暴露 `ipcRenderer`,不暴露 `BrowserWindow`、`fs`、`child_process`、`shell`、`screen` 等危险能力。即使未来启用 `contextIsolation`,这个暴露面也应保持不变。
2. **能力集中到主进程控制器**
所有涉及窗口、文件、系统路径、外部链接、应用信息的操作都进入 `osCtl.js`,由主进程统一校验、处理、记录日志,并以结构化信封返回。
3. **前端通过统一封装调用**
前端不应直接拼接原始 IPC 通道字符串去猜测主进程 API,而是通过 `ipcRenderer.ts` 提供的 `invokeIpc` 和 `onIpc`,保持通道命名规范 `controller//`。
```mermaid
flowchart TD
Start["前端请求"] --> CheckBridge["检查 window.electron.ipcRenderer"]
CheckBridge -->|存在| UseBridge["使用 preload 暴露的 IPC"]
CheckBridge -->|不存在| FallbackRequire["回退到 require('electron')"]
FallbackRequire --> RequireOk{"require 成功?"}
RequireOk -->|是| UseRequire["使用 nodeIntegration 的 IPC"]
RequireOk -->|否| NotAvailable["当前环境不可用"]
UseBridge --> Channel["构造 controller// Channel
Channel --> Controller["主进程控制器校验和处理"]
Controller --> Result["返回 { success, data | message }"]
NotAvailable --> Error["抛出桌面端不可用错误"]
```
**图表来源**
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
**章节来源**
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
### 为什么不应把 BrowserWindow、fs、child_process 等暴露到 window.electron
- `BrowserWindow`:允许任意创建、销毁、操控窗口,可绕过应用自身的窗口管理策略。
- `fs`:允许读写任意本地文件,可能泄露用户数据或写入恶意文件。
- `child_process`:允许执行任意系统命令,是最危险的 Node.js 能力之一。
- `shell`:可打开外部程序、复制粘贴、访问系统剪贴板。
- `screen`:可探测显示器布局,配合其他能力可用于指纹采集或攻击辅助。
当前 `bridge.ts` 仅暴露 `ipcRenderer`,符合最小权限原则。即使当前 `windowOptions.ts` 中 `contextIsolation` 为 false,也不意味着应该扩大 bridge 暴露面。
**章节来源**
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
### 预加载职责与运行时机
`preload()` 在渲染进程上下文之前运行,适合用于:
- 初始化托盘服务
- 初始化安全服务
- 设置全局安全策略
- 暴露最小化的 `window.electron` 接口
它不适合做以下事情:
- 直接大量初始化业务数据
- 暴露复杂业务逻辑
- 替代主进程控制器处理敏感系统调用
**章节来源**
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
- [main.ts:1-19](file://ai-electron/electron/main.ts#L1-L19)
## 依赖关系分析
```mermaid
graph LR
Bridge["bridge.ts"] --> ElectronAPI["Electron contextBridge / ipcRenderer"]
IndexTs["preload/index.ts"] --> TrayService["trayService.create()"]
IndexTs --> SecurityService["securityService.create()"]
MainTs["main.ts"] --> IndexTs
MainTs --> LifecycleTs["lifecycle.ts"]
WindowOptions["windowOptions.ts"] --> ConfigDefault["config.default.ts"]
FrontendIpc["frontend ipcRenderer.ts"] --> WindowElectron["window.electron"]
FrontendHook["useElectronWindow.ts"] --> FrontendIpc
FrontendIpc --> OsmCtl["osCtl.js"]
```
**图表来源**
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
- [main.ts:1-19](file://ai-electron/electron/main.ts#L1-L19)
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [useElectronWindow.ts:1-87](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts#L1-L87)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
**章节来源**
- [main.ts:1-19](file://ai-electron/electron/main.ts#L1-L19)
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
## 性能与安全性考虑
- **性能**
- preload 中只做必要初始化,避免阻塞渲染进程启动。
- 大文件或流式数据应通过主进程控制器处理,避免一次性把大数据放入 IPC 消息体。
- 窗口状态同步应避免高频重复刷新;当前 `useElectronWindow.ts` 使用防抖思路监听 resize,减少频繁查询。
- **安全性**
- 坚持最小权限暴露:bridge 只暴露 IPC,不暴露 Node/Electron 内部对象。
- 所有系统能力集中在主进程控制器,统一校验参数、记录日志、返回结构化结果。
- 前端不应信任来自主进程的 payload,仍应做基础类型校验。
- 在启用 `contextIsolation` 前,要确保所有窗口共享一致的 webPreferences,避免行为漂移。
[本节为通用指导,不直接分析具体文件]
## 故障排查指南
### contextBridge 报错
**现象**
启动时报错,提示 `contextBridge` 或 `exposeInMainWorld` 不可用。
**可能原因**
- 使用了不支持 contextBridge 的环境。
- preload 脚本没有被 Electron 正确加载。
- 当前实际运行环境仍依赖 `nodeIntegration`,bridge 只是兼容层。
**处理建议**
- 检查是否通过 Electron 的 preload 机制加载该脚本。
- 检查窗口配置中的 preload 路径是否指向编译后的 bridge 文件。
- 在当前仓库中,由于 `contextIsolation: false`,前端更可能走 `require('electron')` 路径;若确实要启用 contextIsolation,需同时调整 `windowOptions.ts` 和 `config.default.ts`,并确保所有窗口行为一致。
**章节来源**
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
### window.electron 为 undefined
**现象**
前端调用 `window.electron.ipcRenderer` 时报 undefined。
**可能原因**
- preload 未执行或执行失败。
- bridge 未正确暴露 `electron`。
- 当前运行环境未使用 preload,而是依赖 `nodeIntegration`。
- 在浏览器环境中运行,既没有 preload,也没有 Electron。
**处理建议**
- 确认前端使用 `resolveIpcRenderer()` 获取 IPC 能力,它能同时兼容 `window.electron` 和 `require('electron')`。
- 确认非 Electron 环境下调用 `invokeIpc` 会抛出“当前环境不可用”的错误,而不是静默失败。
- 如果是浏览器调试,不要期望 `window.electron` 存在。
**章节来源**
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [useElectronWindow.ts:1-87](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts#L1-L87)
### IPC 事件无响应
**现象**
前端调用了 IPC,但主进程没有回调,或返回错误。
**可能原因**
- 通道名称不匹配。当前约定为 `controller//`。
- 主进程控制器未注册该方法。
- 主进程方法抛异常,但未返回结构化结果。
- 发送方窗口解析失败,导致操作了错误窗口。
**处理建议**
- 核对前端调用方法名是否与 `osCtl.js` 中方法一致。
- 检查主进程日志,确认 IPC 到达控制器。
- 检查 `resolveSenderWindow` 是否能拿到有效窗口。
- 对可能失败的方法,检查返回的 `{ success, message }`。
**章节来源**
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
### 权限不足
**现象**
某些操作在前端可用,但主进程拒绝或返回错误。
**可能原因**
- 主进程控制器对参数做了校验,例如目录必须是绝对路径、必须存在且是目录。
- 前端传入了非法路径或空值。
- 当前环境不是桌面客户端,无法调用系统能力。
**处理建议**
- 查看主进程控制器返回的 `message`。
- 前端在调用前尽量做基础校验,但仍以主进程为准。
- 在非桌面环境使用 `isDesktopDialogAvailable()` 或 `resolveIpcRenderer()` 判断可用性。
**章节来源**
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
## 结论
当前仓库的安全模型处于过渡态:bridge 已经定义了最小权限暴露方向,但默认配置仍未启用 `contextIsolation`,前端也保留了 `require('electron')` 的回退路径。对于新增能力,应遵循以下原则:
- 所有系统能力放在主进程控制器。
- 只通过 IPC 暴露必要方法。
- bridge 只暴露 `ipcRenderer`,不暴露任何 Node/Electron 内部对象。
- 前端统一通过 `ipcRenderer.ts` 调用,避免散落的 IPC 字符串。
- 在未来启用 `contextIsolation` 前,先统一窗口配置,避免主窗口与智能工作台行为不一致。
[本节为总结性内容,不直接分析具体文件]
## 附录:新增安全 IPC 接口步骤
### 第一步:在主进程控制器中添加方法
新增一个安全方法到 `osCtl.js`,例如新增一个查询磁盘信息的接口。该方法应:
- 接收有限参数
- 在主进程侧执行系统调用
- 捕获异常
- 返回 `{ success, data | message }`
参考现有方法风格:`minimizeWindow`、`readBinaryFileRange`、`setMapLocalPath`、`uploadQingJianFiles`。
**章节来源**
- [osCtl.js:1-169](file://ai-electron/electron/controller/osCtl.js#L1-L169)
### 第二步:确保 preload 已初始化相关服务
如果新能力依赖托盘、安全或其他服务,应在 `preload/index.ts` 的 `preload()` 中完成初始化。当前已初始化 `trayService` 和 `securityService`。
**章节来源**
- [index.ts:1-16](file://ai-electron/electron/preload/index.ts#L1-L16)
### 第三步:保持 bridge 暴露最小权限
不要直接把新方法写进 `bridge.ts`。bridge 继续只暴露 `ipcRenderer`,让前端通过 IPC 调用主进程控制器。
**章节来源**
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
### 第四步:前端通过统一封装调用
前端调用新接口时,使用 `ipcRenderer.ts` 的 `invokeIpc`,通道形如 `controller/osCtl/newMethod`。不要在业务组件里直接拼接 IPC 字符串。
如果需要在组件中封装窗口相关交互,可参考 `useElectronWindow.ts` 的模式,把方法名集中管理,并处理失败情况。
**章节来源**
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)
- [useElectronWindow.ts:1-87](file://ai-electron/frontend/src/core/hooks/desktop/useElectronWindow.ts#L1-L87)
### 第五步:如需启用 contextIsolation
若要正式启用 `contextIsolation`,需要:
1. 修改 `windowOptions.ts`,把 `contextIsolation` 改为 true,并根据需要调整 `nodeIntegration`。
2. 在 `config.default.ts` 中确保主窗口和智能工作台窗口使用相同的 webPreferences。
3. 确保 preload 路径指向编译后的 bridge 文件。
4. 验证前端通过 `window.electron.ipcRenderer` 仍可调用 IPC。
5. 逐步移除对 `require('electron')` 的直接依赖。
**章节来源**
- [windowOptions.ts:1-41](file://ai-electron/electron/config/windowOptions.ts#L1-L41)
- [config.default.ts:1-50](file://ai-electron/electron/config/config.default.ts#L1-L50)
- [bridge.ts:1-10](file://ai-electron/electron/preload/bridge.ts#L1-L10)
- [ipcRenderer.ts:1-51](file://ai-electron/frontend/src/core/utils/desktop/ipcRenderer.ts#L1-L51)