Mica Code Desktop 运行时架构

Mica Code Desktop 运行时架构 由 Archify 生成的架构图。 Electron 外壳 · main · 无 preload · 架构组件 Electron 外壳 main · 无 preload config-web 配置页 · 跨源 iframe · 架构组件 config-web 配置页 跨源 iframe Renderer 页面 · React · transport.js · 架构组件 Renderer 页面 React · transport.js 运行时 · HTTP /api/invoke · 无认证 HTTP 端口(等价宿主 shell) 运行时 HTTP /api/invoke Host 业务核心 · chat · terminals · files · 无认证 HTTP 端口(等价宿主 shell) Host 业务核心 chat · terminals · files mica 子进程 · app-server · commit · 架构组件 mica 子进程 app-server · commit PTY 终端 · node-pty 真终端 · 架构组件 PTY 终端 node-pty 真终端 本机数据 · userData · 会话文件 · 架构组件 本机数据 userData · 会话文件 LLM API · 模型 · MCP servers · 架构组件 LLM API 模型 · MCP servers loadURL 加载页面 拉起运行时 HTTP · SSE invoke 分发 spawn 子进程 模型 · MCP 请求 拉起配置页 userData · 会话文件 PTY 会话 无认证 HTTP 端口(等价宿主 shell) 图例 前端 后端 数据库 外部系统

三层边界

  • • Electron 外壳只做容器:拉运行时、loadURL、徽标与服务器导航
  • • 运行时是零依赖 Node HTTP:/api/invoke 调用面 + /api/events SSE
  • • 同一页面服务桌面、浏览器与手机,window.mica 由 transport.js 建立

Host 业务核心

  • • chat / terminals / files / git / stats 只跑在运行时进程里
  • • 每个 chat 会话派生一个常驻 mica app-server 子进程
  • • 终端是真 PTY(node-pty),空闲 8 小时回收

配置页与安全边界

  • • 配置页是跨源 iframe 内嵌的 config-web,无 preload
  • • 运行时无认证:连上端口就等于拿到宿主 shell,默认 0.0.0.0
  • • ELECTRON_RUN_AS_NODE 在派生子进程之前剥离