Day1

项目概览与环境准备

1. Fork 并克隆官方仓库：https://github.com/anomalyco/opencode2. 阅读 README 和 CONTRIBUTING.md3. 安装 Bun 1.3+、Go 1.22+、Turbo4. 本地编译运行开发版本

成功在本地启动 OpenCode 开发服务器和 TUI 客户端

Day2

基础功能体验

1. 配置至少 2 个模型（如 Claude 4.5、GPT-4o）2. 体验 Build 模式和 Plan 模式的区别3. 完成 3 个简单编程任务：函数实现、单元测试、代码重构4. 熟悉 TUI 界面所有快捷键

能够流畅使用 OpenCode 完成日常编码任务

Day3

配置系统与会话管理

1. 深入研究~/.opencode/目录结构2. 学习全局配置config.json和项目级配置3. 理解会话存储机制和上下文管理4. 尝试导入导出会话历史

能够根据不同项目需求灵活配置 OpenCode

Day4

工具系统与 MCP 协议

1. 学习内置 13 个核心工具的使用2. 安装并体验几个社区 MCP 服务器3. 理解 MCP 协议的基本工作原理4. 尝试调用远程 MCP 工具

能够配置和使用各种工具扩展 OpenCode 能力

Day5

Skills 系统与自动化

1. 学习 SKILL.md 文件格式规范2. 安装并使用几个热门社区 Skills3. 编写一个简单的自定义 Skill4. 体验自动化任务执行

能够编写简单的 Skill 来自动化重复工作

Day6

多端使用与集成

1. 安装 VSCode 扩展并体验 IDE 集成2. 部署 OpenCode 服务器到远程机器3. 体验远程客户端连接4. 配置 GitHub 集成

能够在不同环境下使用 OpenCode

Day7

第一周总结与问题记录

1. 整理使用过程中遇到的问题2. 带着问题浏览项目目录结构3. 画出你理解的 OpenCode 工作流程图4. 制定第二周源码阅读重点

形成对 OpenCode 整体工作流程的初步理解

Day8

Monorepo 项目结构分析

1. 详细分析packages/目录下的所有子包2. 理解每个子包的功能定位3. 学习 Turbo Monorepo 的构建流程4. 梳理模块间的依赖关系

能够说出每个子包的主要作用和依赖关系

Day9

客户端 – 服务器通信机制

1. 分析 TUI 客户端（Go）的入口代码2. 分析服务器端（TypeScript）的入口代码3. 研究 HTTP/WebSocket 通信协议4. 理解 SSE 流式响应的实现

能够跟踪一条用户指令从输入到响应的完整路径

Day10

Session 会话管理系统

1. 深入packages/opencode/src/session/目录2. 理解会话状态的存储和恢复机制3. 分析消息历史的管理方式4. 研究上下文窗口的实现

能够解释 OpenCode 如何维护对话上下文

Day11

Provider 模型适配层

1. 分析packages/opencode/src/provider/目录2. 理解 Provider 抽象接口的设计3. 以 Claude 和 OpenAI 为例，研究具体实现4. 学习模型格式转换和统一处理

能够为一个新的 LLM 提供商编写简单的适配

Day12

Agent 智能体系统

1. 分析packages/opencode/src/agent/目录2. 理解 Build Agent 和 Plan Agent 的区别3. 研究 Agent 的任务调度和执行流程4. 学习权限控制机制

能够解释不同 Agent 的工作原理和适用场景

Day13

Tool 工具执行系统

1. 分析packages/opencode/src/tool/目录2. 理解工具注册和调用机制3. 研究几个核心工具的实现（如文件读写、命令执行）4. 学习工具调用的安全隔离

能够解释 OpenCode 如何调用工具来完成任务

Day14

第二周总结与架构梳理

1. 画出完整的 OpenCode 系统架构图2. 标注各个模块之间的数据流3. 整理核心数据结构和接口定义4. 确定第三周要深入研究的重点模块

形成对 OpenCode 整体架构的清晰认识

Day15

Prompt 工程与提示词系统

1. 分析packages/opencode/src/prompt/目录2. 理解系统提示词的构建过程3. 研究环境感知和上下文注入机制4. 学习动态提示词模板的实现

能够修改系统提示词来改变 OpenCode 的行为

Day16

任务拆解与规划算法

1. 深入研究 Plan Agent 的实现2. 理解复杂任务的拆解逻辑3. 分析任务执行的状态机管理4. 学习错误处理和重试机制

能够解释 OpenCode 如何将大任务拆分为小步骤

Day17

LSP 语言服务集成

1. 分析packages/opencode/src/lsp/目录2. 理解 LSP 客户端的实现3. 研究代码分析和诊断功能4. 学习符号搜索和代码跳转

能够解释 OpenCode 如何理解代码结构

Day18

MCP 协议完整实现

1. 分析packages/opencode/src/mcp/目录2. 理解 MCP 服务器的发现和连接机制3. 研究工具的动态加载和调用4. 学习 MCP 协议的消息格式

能够编写一个简单的 MCP 服务器

Day19

插件系统架构

1. 分析packages/plugin/目录2. 理解插件的生命周期管理3. 研究插件与核心系统的通信方式4. 学习插件的沙箱隔离机制

能够编写一个简单的 OpenCode 插件

Day20

安全与权限控制

1. 分析权限系统的实现2. 理解 Plan 模式的只读限制3. 研究代码执行的安全隔离4. 学习用户确认机制的设计

能够解释 OpenCode 如何保障代码执行安全

Day21

第三周总结与源码调试

1. 为核心模块添加调试日志2. 单步调试一个完整的任务执行流程3. 整理源码中使用的设计模式4. 记录你认为可以改进的地方

能够通过调试来理解源码的执行过程

Day22

自定义工具开发实战

1. 设计并实现一个实用的自定义工具2. 集成到 OpenCode 的工具系统中3. 测试工具的功能和稳定性4. 编写工具的使用文档

拥有一个可以在 OpenCode 中使用的自定义工具

Day23

自定义 Agent 开发实战

1. 基于现有 Agent 创建一个新的 Agent 类型2. 为新 Agent 设计专属的系统提示词3. 实现 Agent 的特殊逻辑和行为4. 测试 Agent 在特定场景下的表现

拥有一个可以切换使用的自定义 Agent

Day24

新模型提供商适配

1. 选择一个尚未支持的 LLM 提供商2. 按照 Provider 接口规范编写适配代码3. 测试模型的调用和响应处理4. 提交 PR 到官方仓库

完成一个新模型提供商的适配并提交 PR

Day25

核心功能改进

1. 从之前记录的改进点中选择一个2. 设计改进方案并编写代码3. 进行全面的测试4. 准备 PR 的描述和文档

完成一个核心功能的改进并提交 PR

Day26

社区贡献流程学习

1. 阅读官方的贡献指南2. 了解 PR 的审核流程和标准3. 学习如何编写高质量的 PR 描述4. 参与社区 Issue 的讨论

熟悉 OpenCode 社区的贡献流程

Day27

部署与性能优化

1. 学习 OpenCode 的生产环境部署2. 分析系统的性能瓶颈3. 尝试进行一些性能优化4. 学习监控和日志分析

能够部署和维护自己的 OpenCode 服务

Day28

一个月学习总结

1. 整理所有学习笔记和代码示例2. 完善你的 OpenCode 系统架构图3. 总结学到的架构设计和编程技巧4. 制定后续深入学习的计划

形成完整的 OpenCode 知识体系