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/orcaOrca是一款基于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 审计式契约层只暴露白名单 APIwindow.api │ └──────────────────────────┬──────────────────────────────┘ ┌──────────────────────────┴──────────────────────────────┐ │ Renderer 进程src/renderer/ │ │ React UI · 终端渲染 · 浏览器面板 · 状态管理不碰系统资源 │ └─────────────────────────────────────────────────────────┘进程目录核心职责典型文件Mainsrc/main/生命周期、IPC 处理、系统能力src/main/index.tsPreloadsrc/preload/安全桥接、API 白名单src/preload/index.tsRenderersrc/renderer/纯 UI 渲染与交互src/renderer/src/App.tsx共享契约src/shared/跨进程类型与协议定义src/shared/Main 进程应用生命周期与系统能力的总指挥Orca 的 Main 进程入口是src/main/index.ts约 3600 行文件头部的注释直接点明了它的定位main-process entry point; owns app lifecycle, service wiring, window creation, and hook/daemon startup它承担了三类职责生命周期管理app事件监听、单实例锁、图标/主题/托盘、powerMonitor电源事件系统能力宿主PTY 终端本地 SSH、文件监视器、持久化存储src/main/persistence/、SSH 密钥存储、遥测src/main/telemetry/服务装配通过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 代码永远只能访问白名单方法接触不到原始ipcRenderer1100 处ipcRenderer调用集中在这一层意味着任何一次渲染层越权都在代码评审中无处遁形类型即契约所有入参/出参类型来自src/shared/如SshTarget、TerminalPreviewDataPayload三个进程共享同一份 TypeScript 类型杜绝类型漂移。Renderer只做 UI不碰系统资源src/renderer/目录下有 8000 文件是一个庞大的 React 应用但它被严格约束为纯 UI状态管理集中在src/renderer/src/store/通过window.api调用 Preload 暴露的方法终端渲染由 xterm.jsWebGL 后端完成字节流来自 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_DEPENDENCIESxterm、zod 等被内联进包其余依赖保持外部化从打包后的node_modules解析——这是为了让原生模块如 node-pty能在 asar 解包环境中正常工作编译时常量注入遥测开关ORCA_BUILD_IDENTITY等在编译期替换为字面量null或密钥非官方构建根本无法伪造遥测传输这是构建期安全的典型手法启动诊断 BannerMain 产物头部被注入一段诊断脚本ORCA_STARTUP_DIAGNOSTICS1时可把启动 require 轨迹写入文件排查冷启动问题不依赖运行时日志Renderer 端React Tailwind输出index/popout/web三个 HTML 入口preserveEntrySignatures: strict防止共享 chunk 意外挂载第二个 React 根。给开发者的 5 条实践建议Preload 即审计面把所有 IPC 收拢进一个 preload 文件集中评审像 Orca 这样用注释声明审计契约能显著降低类型漂移跨进程类型共享建一个src/shared/目录存放契约类型三个进程引用同一份定义重活进程化终端、文件监听、崩溃敏感的 IO 派发到独立进程/WorkerMain 只保留协调职责宿主适配器解耦把 Electron API 包一层 Environment 接口参考src/main/host/核心逻辑可单测、可替换编译期安全优于运行时判断密钥、开关等敏感常量在构建期注入让不安全路径在产物中根本不存在。结语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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考