Mica Code CLI 运行时架构

Mica Code CLI 运行时架构 由 Archify 生成的架构图。 mica-code-app · Web / Electron · 本机进程(Bun 运行时) mica-code-app Web / Electron Headless 执行 · exec · app-server · 本机进程(Bun 运行时) Headless 执行 exec · app-server 终端 TUI · Ink · mica-ui · 本机进程(Bun 运行时) 终端 TUI Ink · mica-ui 运行时核心 · apps/cli · turn loop · 本机进程(Bun 运行时) 运行时核心 apps/cli · turn loop mica-agent · prompt · provider adapter · 本机进程(Bun 运行时) mica-agent prompt · provider adapter LLM API · chat / responses · 外部依赖(网络) LLM API chat / responses 本地状态 · $MICA_HOME · sessions · 本机进程(Bun 运行时) 本地状态 $MICA_HOME · sessions 内置插件 / 命令 · hooks · 命令 · 工具 · 本机进程(Bun 运行时) 内置插件 / 命令 hooks · 命令 · 工具 mica-tools · 唯一工具 registry · 本机进程(Bun 运行时) mica-tools 唯一工具 registry mica-mcp · MCP 生命周期 · 本机进程(Bun 运行时) mica-mcp MCP 生命周期 MCP Servers · 远端工具 · 外部依赖(网络) MCP Servers 远端工具 chat 请求 同一 turn loop 输入 · 渲染 agent.run 流式请求(SSE) 工具调用 注册工具 snapshot · turn lease 远端工具 MCP 协议 本机进程(Bun 运行时) 外部依赖(网络) 图例 前端 后端 数据库 外部系统

入口与界面

  • • 交互模式由 Ink TUI 直接驱动同一个 turn loop
  • • headless:mica exec 一次性执行,app-server 常驻讲 Codex v2 协议
  • • 命令经 CommandRegistry 分发,busy 时由单槽 message queue 排队

Turn loop 与本地状态

  • • turn 级最多重试 5 次(间隔 10s),只重放尚未产生副作用的阶段
  • • provider 内建 5 次指数退避,仅在本次尝试还没有输出时重发
  • • 会话 JSON + turn lease 单写者,$MICA_HOME 收拢 config / sessions / cache

扩展点与集成

  • • 插件经 PluginContext 注册工具、hooks 与服务,TUI 与 headless 各有一套装配层
  • • mica-mcp 管理 server 生命周期,远端工具接入同一个 registry,断开即清理
  • • skills 只在 system prompt 里放索引,正文按需读取以保住 prompt cache 前缀