loaditout.ai
SkillsPacksTrendingLeaderboardAPI DocsBlogSubmitRequestsCompareAgentsXPrivacyDisclaimer
{}loaditout.ai
Skills & MCPPacksBlog

opencode-deep-dive

MCP Tool

yahtoo/opencode-deep-dive

A source-driven deep dive into OpenCode, covering the architecture and implementation of a modern AI coding agent.

Install

$ npx loaditout add yahtoo/opencode-deep-dive

Platform-specific configuration:

.claude/settings.json
{
  "mcpServers": {
    "opencode-deep-dive": {
      "command": "npx",
      "args": [
        "-y",
        "opencode-deep-dive"
      ]
    }
  }
}

Add the config above to .claude/settings.json under the mcpServers key.

About

深入 OpenCode:AI Coding Agent 架构与实现

> 一本基于真实源码展开的 OpenCode 深度解构手册。

以 OpenCode 为分析对象,系统拆解一个现代 AI Coding Agent 从配置、会话、工具、权限到 UI 与扩展生态的完整工程实现。

它不试图重复官方文档,而是把散落在源码中的关键机制重新组织成一条可阅读、可验证、可复用的工程主线:AI Coding Agent 到底如何组织上下文?Tool 为什么能安全执行?Session、Agent、Provider、MCP、Plugin 在工程上如何协作?

你能在这里看到什么
  • 从一次用户输入出发,串起 OpenCode 的完整执行链路
  • 结合关键源码片段,理解各核心模块的职责边界与设计权衡
  • 用工程视角看清 AI Coding Agent 的可扩展性、安全性与可维护性
  • 为自己实现类似工具提供可复用的架构参考
适合谁
  • 想理解 AI Coding Agent 内部工作方式的开发者
  • 想从真实项目中学习 Agent 工程设计的工程师或技术写作者
  • 想沿着源码阅读一遍 OpenCode 核心机制的读者
  • 想构建 CLI Agent、工具调用系统或插件体系的人
推荐阅读路径
  • 想先看全貌:从 第 2 章:一次对话的完整旅程 开始
  • 想抓住核心价值:优先阅读第三篇 AI 核心
  • 想看扩展能力:直接阅读第四篇 扩展生态
  • 想动手实现自己的 Agent:跳到 第 22 章:构建你自己的 Agent
项目特色
  • 基于真实源码,不编造中间层抽象
  • 每章围绕一个问题展开,强调从 what 走向 why
  • 代码片段控制在 10-30 行,便于聚焦关键逻辑
  • 配合 ASCII 架构图,帮助建立系统级直觉
  • 覆盖配置、存储、Session、Tool、Permission、MCP、Plugin、TUI 等关键模块

---

全书结构
  • 第一篇:建立全局视野,看清 OpenCode 是什么、一次对话如何流动、整体工程如何分层
  • 第二篇:拆解基础设施层,包括配置、Effect、事件总线、存储与项目隔离
  • 第三篇:进入 AI 核心,理解 Provider、Agent、Session、Tool、Permission 如何协同
  • 第四篇:分析扩展生态,覆盖 MCP、Skill、Command、Plugin、Server 与 API
  • 第五篇:转向用户界面,理解 TUI、Web 与桌面端的组织方式
  • 第六篇:回到工程实践,讨论调试、性能、健壮性与自定义 Agent 构建
阅读说明
  • 全书以中文写作,关键术语保留英文
  • 引用的 OpenCode 源码位于 code/opencode/ 子模块
  • 书中源码路径统一相对于 code/opencode/packages/opencode/ 表示,如 src/session/prompt.ts
  • 章节内容以“场景 -> 探索 -> 解答”的方式展开,适合顺读,也适合按主题跳读
写作风格
  • 中文行文,关键术语保留英文
  • 每章围绕一个核心问题,以"场景 → 探索 → 解答"展开
  • 代码片段精选(10-30 行),配详细注释,不堆砌
  • 架构图先行,再深入细节

---

目录
第一篇:全局视野(Global Perspective)
  • 第 1 章:OpenCode 是什么(What is OpenCode)
  • 第 2 章:一次对话的完整旅程(Anatomy of a Conversation)
  • 第 3 章:工程架构全景(Engineering Architecture)
第二篇:基础设施层(Infrastructure Layer)
  • [第 4 章:配置系统 —— 分层与合并(Configurati

Tags

agent-architectureai-coding-agentdeveloper-toolsllmmcpopencodesource-code-analysistypescript

Reviews

Loading reviews...

Quality Signals

1
Stars
0
Installs
Last updated21 days ago
Security: AREADME

Safety

Risk Levelmedium
Data Access
read
Network Accessnone

Details

Sourcegithub-crawl
Last commit3/27/2026
View on GitHub→

Embed Badge

[![Loaditout](https://loaditout.ai/api/badge/yahtoo/opencode-deep-dive)](https://loaditout.ai/skills/yahtoo/opencode-deep-dive)