企业官网建设流程全解析

Orca Electron 43 进程模型实践：Main / Preload / Renderer 职责划分完整指南

【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and VPS.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca

🐋Orca是一款基于Electron 43构建的 AI Agent 编排桌面应用（ADE），它让你用自己的订阅同时运行 Codex、Claude Code 等多个编码代理，并在每个独立的 git worktree 中并行推进任务。要支撑终端、PTY、SSH 远程工作树和移动中继等重负载场景，Orca 对 Electron 的Main / Preload / Renderer 三进程模型做了非常严格的职责划分。本文带你从构建配置到源码路径，快速看懂这套进程架构的设计思路，帮助你在自己的 Electron 项目中借鉴其边界划分与稳定性实践。

一图看懂：三进程各司其职

┌─────────────────────────────────────────────────────────┐ │ Main 进程（src/main/） │ │ 应用生命周期 · PTY/终端 · Daemon 守护进程 · 文件系统/网络/持久化 │ └──────────────────────────┬──────────────────────────────┘ │ ipcMain / ipcRenderer ┌──────────────────────────┴──────────────────────────────┐ │ Preload 进程（src/preload/） │ │ contextBridge 审计式契约层，只暴露白名单 API（window.api） │ └──────────────────────────┬──────────────────────────────┘ ┌──────────────────────────┴──────────────────────────────┐ │ Renderer 进程（src/renderer/） │ │ React UI · 终端渲染 · 浏览器面板 · 状态管理（不碰系统资源） │ └─────────────────────────────────────────────────────────┘

Main 进程：应用生命周期与系统能力的"总指挥"

Orca 的 Main 进程入口是src/main/index.ts（约 3600 行），文件头部的注释直接点明了它的定位：

main-process entry point; owns app lifecycle, service wiring, window creation, and hook/daemon startup

它承担了三类职责：

1. 生命周期管理：app事件监听、单实例锁、图标/主题/托盘、powerMonitor电源事件；
2. 系统能力宿主：PTY 终端（本地 + SSH）、文件监视器、持久化存储（src/main/persistence/）、SSH 密钥存储、遥测（src/main/telemetry/）；
3. 服务装配：通过src/main/host/下的"宿主适配器"把 Electron 能力注入运行时层，例如ElectronAppEnvironment、ElectronSecretStore，使核心逻辑与 Electron API 解耦。

值得注意的是 Main 进程还负责派生守护进程（daemon）与一系列边车进程：终端、文件监听等重活被放到独立进程中，避免阻塞主线程。src/main/hang-watchdog/中的主线程挂死看门狗，正是这套"进程隔离"思想的稳定性保障——看门狗跑在 Worker 线程里，能在 macOS AppKit 主线程死锁时依然存活。

Preload 进程：contextBridge 构筑的安全"传令兵"

src/preload/index.ts是整个项目中最被"审计"的文件——它长达 5000+ 行，文件头注释写道：

preload is the audited renderer/Electron IPC contract; co-locating the surface eases security and type-drift review

设计上有三个关键实践：

• 单一契约面：Preload 把全部 IPC 请求/事件收拢在一处，通过contextBridge.exposeInMainWorld('api', api)暴露给渲染层，UI 代码永远只能访问白名单方法，接触不到原始ipcRenderer；
• 1100+ 处ipcRenderer调用集中在这一层，意味着任何一次"渲染层越权"都在代码评审中无处遁形；
• 类型即契约：所有入参/出参类型来自src/shared/（如SshTarget、TerminalPreviewDataPayload），三个进程共享同一份 TypeScript 类型，杜绝类型漂移。

Renderer：只做 UI，不碰系统资源

src/renderer/目录下有 8000+ 文件，是一个庞大的 React 应用，但它被严格约束为"纯 UI"：

• 状态管理集中在src/renderer/src/store/，通过window.api调用 Preload 暴露的方法；
• 终端渲染由 xterm.js（WebGL 后端）完成，字节流来自 Main 进程；
• 多窗口模型：除了主窗口，还有独立的弹出式仪表盘（src/renderer/popout.html）与 Web 端入口（src/renderer/web-index.html），它们复用同一份 preload /window.api，却各自独立启动 React 根节点。

这种"渲染层零系统权限"的约束，让 Orca 即使 UI 卡顿或崩溃，也不会波及终端会话与 Agent 进程。

构建流水线：electron-vite 如何产出三端产物

打开electron.vite.config.ts，就能看清三进程的构建边界：

• Main 端（main.build）：入口为src/main/index.ts，并且通过rollupOptions.input声明了10+ 个额外进程入口——daemon-entry（守护进程）、plugin-host-entry（插件宿主）、computer-sidecar（计算机操作边车）、stt-worker（语音识别）、各类 session-scanner Worker 等。所有产物以CommonJS输出，保证 Electron 与边车启动器可稳定加载；
• 依赖外部化策略：BUNDLED_MAIN_DEPENDENCIES（xterm、zod 等）被内联进包，其余依赖保持外部化，从打包后的node_modules解析——这是为了让原生模块（如 node-pty）能在 asar 解包环境中正常工作；
• 编译时常量注入：遥测开关（ORCA_BUILD_IDENTITY等）在编译期替换为字面量null或密钥，非官方构建根本无法伪造遥测传输，这是构建期安全的典型手法；
• 启动诊断 Banner：Main 产物头部被注入一段诊断脚本，ORCA_STARTUP_DIAGNOSTICS=1时可把启动 require 轨迹写入文件，排查冷启动问题不依赖运行时日志；
• Renderer 端：React + Tailwind，输出index/popout/web三个 HTML 入口，preserveEntrySignatures: 'strict'防止共享 chunk 意外挂载第二个 React 根。

给开发者的 5 条实践建议

1. Preload 即审计面：把所有 IPC 收拢进一个 preload 文件集中评审，像 Orca 这样用注释声明"审计契约"，能显著降低类型漂移；
2. 跨进程类型共享：建一个src/shared/目录存放契约类型，三个进程引用同一份定义；
3. 重活进程化：终端、文件监听、崩溃敏感的 IO 派发到独立进程/Worker，Main 只保留协调职责；
4. 宿主适配器解耦：把 Electron API 包一层 Environment 接口（参考src/main/host/），核心逻辑可单测、可替换；
5. 编译期安全优于运行时判断：密钥、开关等敏感常量在构建期注入，让不安全路径在产物中根本不存在。

结语

Orca 的进程模型并没有使用什么"新框架"，而是把 Electron 经典的Main 掌控系统、Preload 守好边界、Renderer 只管渲染三段式纪律执行到了极致：一个入口文件、一个契约文件、一份构建配置，就把 8000+ 文件的大型应用切出了清晰的进程边界。如果你正在维护一个多窗口、重 IO 的 Electron 应用，这套职责划分方案值得直接抄作业。

【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and VPS.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca