opencode-map
English

▸ guides/

教程

实战向教程：从第一次会话到发布自己的插件。

##入门

  1. 01

    opencode 快速上手

    安装 opencode、接入模型 provider、用 /init 初始化项目,并掌握 plan/build 工作流与撤销重做。

    最后更新: 2026年10月21日

  2. 02

    opencode 的 provider 与模型

    用 /connect 接入 provider、使用 OpenCode Zen、在 opencode.json 里配置 model 与 small_model、用 /models 切换模型,以及添加自定义 OpenAI 兼容 provider。

    最后更新: 2026年10月21日

##进阶

  1. 01

    opencode 配置详解:opencode.json

    opencode.json/jsonc 用法:文件位置与合并优先级、schema、model/provider 字段、agents、MCP、插件,以及独立的 tui.json。

    最后更新: 2026年10月21日

  2. 02

    opencode 的 agent:内置 agent 与自定义 subagent

    用好 opencode 内置的 build/plan 主 agent 和 general/explore/scout subagent,用 Tab 与 @ 提及调用,并用 Markdown 或 opencode.json 定义自定义 agent。

    最后更新: 2026年10月21日

  3. 03

    为 opencode 接入 MCP server

    在 opencode.json 中配置本地和远程 MCP server:command 与 url 两种形态、{env:} 变量插值、OAuth 认证、opencode mcp CLI,以及按 agent 分配工具。

    最后更新: 2026年10月21日

  4. 04

    opencode 权限:allow、ask、deny

    控制 opencode 哪些动作可以直接执行:permission 配置、allow/ask/deny 三种动作、通配符与 shell 命令模式、external_directory、doom_loop 以及按 agent 覆盖。

    最后更新: 2026年10月21日

  5. 05

    opencode 自定义命令与键位绑定

    在 .opencode/commands 或 opencode.json 里定义自定义斜杠命令——参数、shell 注入、文件引用——以及在 tui.json 里重绑 TUI 键位(含 leader 键)。

    最后更新: 2026年10月21日

  6. 06

    OpenCode v1 到 v2: 逐项迁移对照

    OpenCode 1 到 OpenCode 2 的逐字段对照——改名、移动、移除与 v2 新增, 全部基于官方迁移文档。

    最后更新: 2026年10月21日

##深入

  1. 01

    开发一个 opencode 插件

    为 opencode 编写插件:插件加载位置、模块/hooks 结构、上下文对象、经 bun install 的 npm 依赖、TypeScript 类型与发布流程。

    最后更新: 2026年10月21日