OpenCode 源码解析 · 第 20 讲
OpenCode 源码解析 第 20 讲：总结与实战指南——从源码到生产部署的完整路径 基于 OpenCode 源码 · 2026-07-27 这是 OpenCode 源码解析 系列的第 20 讲（最终讲）。前 19 讲我们逐层拆解了 CLI、Session、Agent、Tool、Provider、ACP、LSP、MCP、配置系统、Control Plane、TUI、数据库、Effect 运行时、事件总线、Session Processor 等每个核心模块。这一讲，我们将所有拼图拼成一幅完整的架构图，提炼 OpenCode 的设计哲学，并给出从开发到生产部署的实战指南。 一、架构全景回顾：一张图串起所有模块 🖥️ 客户端层 CLI (yargs) · TUI (OpenTUI + SolidJS) · Desktop (Electron) · Web App (SolidJS) ⬇️ 🔌 协议层 ACP (Agent Client Protocol) · MCP (Model Context Protocol) · LSP (Language Server Protocol) ⬇️ ⚙️ 核心引擎 Agent → Session → Tool Registry · Provider Abstraction · Effect Runtime ⬇️ 🏗️ 基础设施层 Hono Server · Drizzle DB (SQLite) · Event Bus · Plugin System · Config packages/opencode (v1.17.13) · TypeScript Monorepo · Bun 1.3.14 · Effect 4.0 beta · SolidJS · Hono · Drizzle ORM 数据流向全景 用户请求到 AI 响应的完整链路 用户输入 → CLI/TUI/Web → Hono Server → Session → Agent Provider + Model → LLM 推理 → Tool 调用 → Event Bus → UI 渲染 🔄 Effect 运行时贯穿全程：错误处理 · 并发控制 · 资源管理 · 可测试性 Monorepo 包结构 包名 职责 关键技术 packages/opencode CLI 入口 + 核心业务逻辑 yargs + Effect.gen packages/core 共享核心：Session、Agent、Tool、Provider、DB Effect + Drizzle + ai-sdk packages/server HTTP API 服务层 Hono + WebSocket packages/desktop Electron 桌面应用 Electron 42 + IPC + Sidecar packages/app Web UI 前端应用 SolidJS + Vite + Tailwind packages/plugin 插件系统 SDK Hooks 接口 + v2 Effect 集成 packages/tui 终端用户界面组件 OpenTUI + SolidJS packages/sdk SDK 客户端库 TypeScript + Fetch API packages/schema 数据模型 Schema 定义 Zod + Drizzle SQL 二、三大设计哲学 哲学一：函数式编程 —— Effect 运行时贯穿一切 OpenCode 最显著的技术选择是将 Effect 4.0 作为整个应用的运行时基础。这不是一个可有可无的框架，而是整个架构的"操作系统"。 在 packages/opencode/src/cli/cmd/run.ts 的 CLI 入口中，每个命令的处理都通过 Effect.fn 声明： // packages/opencode/src/cli/cmd/run.ts 第263行 export const RunCommand = effectCmd({ command: "run [message..]", describe: "run opencode with a message", instance: (args) => !ar…
阅读全文：OpenCode 源码解析 第 20 讲