opencode/src/
├── acp/            # Agent Client Protocol 支持
├── agent/          # AI 代理系统
├── auth/           # 认证系统
├── bun/            # Bun 运行时集成
├── bus/            # 事件总线
├── cli/            # 命令行界面
├── command/        # 内置命令
├── config/         # 配置管理
├── env/            # 环境变量管理
├── file/           # 文件系统操作
├── flag/           # 功能标志
├── format/         # 代码格式化
├── global/         # 全局变量和路径
├── id/             # 唯一标识符生成
├── ide/            # IDE 集成
├── installation/   # 安装管理
├── lsp/            # 语言服务器协议
├── mcp/            # Model Configuration Protocol
├── opencode/       # 主包入口
├── package/        # 包管理
├── permission/     # 权限管理
├── plugin/         # 插件系统
├── project/        # 项目管理
├── provider/       # AI 模型提供商
├── pty/            # 伪终端
├── question/       # 问题管理
├── session/        # 会话管理
├── server/         # 服务端实现
├── shell/          # Shell 集成
├── snapshot/       # 代码快照
├── skill/          # 技能系统
├── storage/        # 数据存储
├── tool/           # 工具集
├── util/           # 工具函数
└── worktree/       # 工作树管理

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   接口层         │     │   核心服务层     │     │   基础设施层     │
│                 │     │                 │     │                 │
│ ┌─────────────┐ │     │ ┌─────────────┐ │     │ ┌─────────────┐ │
│ │     CLI     │ │     │ │   Agent     │ │     │ │  事件总线    │ │
│ └─────────────┘ │     │ └─────────────┘ │     │ └─────────────┘ │
│ ┌─────────────┐ │     │ ┌─────────────┐ │     │ ┌─────────────┐ │
│ │    Server   │ │     │ │  Session    │ │     │ │  配置管理    │ │
│ └─────────────┘ │     │ └─────────────┘ │     │ └─────────────┘ │
│ ┌─────────────┐ │     │ ┌─────────────┐ │     │ ┌─────────────┐ │
│ │     TUI     │ │     │ │   Provider  │ │     │ │  文件系统    │ │
│ └─────────────┘ │     │ └─────────────┘ │     │ └─────────────┘ │
└─────────────────┘     └─────────────────┘     └─────────────────┘

// 代理执行简化流程
async function executeAgent(sessionID: string, prompt: string) {
  // 1. 创建会话和消息
  const session = await Session.get(sessionID)
  const userMessage = await MessageV2.create({
    sessionID,
    role: "user",
    parts: [{ type: "text", text: prompt }]
  })
  
  // 2. 选择代理
  const agent = await Agent.get(session.agent || "build")
  
  // 3. 调用 AI 模型
  const response = await agent.process(userMessage)
  
  // 4. 处理 AI 响应
  const assistantMessage = await MessageV2.create({
    sessionID,
    role: "assistant",
    parentID: userMessage.id,
    parts: response.parts
  })
  
  // 5. 执行工具调用
  for (const part of response.parts) {
    if (part.type === "tool") {
      await Tool.execute(part)
    }
  }
  
  return assistantMessage
}

// 会话管理核心功能
namespace Session {
  // 创建会话
  export const create = async (input?: { parentID?: string; title?: string }) => {
    const session = await createNext({
      directory: Instance.directory,
      parentID: input?.parentID,
      title: input?.title
    })
    return session
  }
  
  // 获取会话消息
  export const messages = async (input: { sessionID: string; limit?: number }) => {
    const result = [] as MessageV2.WithParts[]
    for await (const msg of MessageV2.stream(input.sessionID)) {
      if (input.limit && result.length >= input.limit) break
      result.push(msg)
    }
    result.reverse()
    return result
  }
  
  // 会话消息流
  export function* list() {
    const project = Instance.project
    for (const item of await Storage.list(["session", project.id])) {
      yield Storage.read<Info>(item)
    }
  }
}

// 工具执行核心
namespace Tool {
  // 注册工具
  export const register = (tool: Tool) => {
    tools.set(tool.id, tool)
  }
  
  // 执行工具
  export const execute = async (part: ToolPart) => {
    const tool = tools.get(part.tool)
    if (!tool) {
      throw new Error(`Tool ${part.tool} not found`)
    }
    
    const result = await tool.execute(part.state.input)
    return result
  }
}

# 启动服务器
opencode serve

# 启动 Web 应用
opencode web

# 运行 TUI 界面
opencode tui

# 管理会话
opencode session list
opencode session create

# 管理模型
opencode models list
opencode models set

# 管理代理
opencode agent list
opencode agent set

# 会话管理
GET  /session              # 列出会话
POST /session              # 创建会话
GET  /session/:sessionID   # 获取会话
DELETE /session/:sessionID # 删除会话

# 消息管理
GET  /session/:sessionID/message      # 获取会话消息
POST /session/:sessionID/message      # 发送消息
GET  /session/:sessionID/message/:id  # 获取消息

# 工具管理
GET  /tool        # 列出工具

# 代理管理
GET  /agent       # 列出代理

// 自定义工具示例
const MyTool: Tool = {
  id: "my-tool",
  name: "My Custom Tool",
  description: "My custom tool description",
  parameters: z.object({
    input: z.string()
  }),
  execute: async (input) => {
    // 工具实现
    return { output: `Processed: ${input.input}` }
  }
}

// 注册工具
Tool.register(MyTool)