OpenCode on Yanmu

OpenCode + Obsidian：打造你的AI驱动知识管理工作流

Thu, 30 Apr 2026 02:00:15 +0800

📋 目录

一、什么是 opencode-obsidian 插件？

opencode-obsidian 是一个第三方社区插件，它将 OpenCode AI 助手直接嵌入到 Obsidian 窗口中。不同于传统的终端集成方案，这个插件使用 OpenCode 的 Web 视图直接嵌入，你看到的就是完整的 OpenCode 界面，不需要在终端和 Obsidian 之间来回切换。

核心特性：

🖥️ OpenCode 界面直接嵌入 Obsidian 侧边栏或主编辑区
🔄 服务端自动管理——打开面板即启动，关闭即停止
📄 实验性的上下文注入——自动将当前打开的笔记和选中文本传给 AI
⌨️ 快捷键 Ctrl/Cmd + Shift + O 快速切换面板

适用场景：

总结和提炼长文本内容
起草、编辑和润色写作
查询和探索你的知识库
生成大纲和结构化笔记

⚠️ 插件作者与 OpenCode / Obsidian 无关联，这是一个独立的第三方项目。目前版本为 0.2.1（Beta 阶段），仅支持桌面端。

二、环境准备

在开始之前，确保你已准备好以下内容：

项目	要求	说明
Obsidian	≥ 1.4.0	官网下载
Node.js	≥ 18+	下载地址，用于安装 OpenCode

准备就绪后，跟着下面的步骤走就行。

三、安装 BRAT 插件

BRAT（Beta Reviewer’s Auto-update Tool）是 Obsidian 的一个社区插件，专门用来安装尚未上架社区插件市场的 Beta 版插件。opencode-obsidian 目前还没有正式上架，所以需要通过 BRAT 安装。

步骤 1：打开社区插件市场

在 Obsidian 中依次点击：设置 → 第三方插件 → 关闭「安全模式」→ 社区插件市场

步骤 2：搜索并安装 BRAT

在社区插件市场中搜索 BRAT（全名：Obsidian42 - BRAT），点击「安装」→「启用」。

💡 BRAT 的全称是 Beta Reviewer’s Auto-update Tool，由 TfTHacker 开发。它能自动检测 Beta 插件的更新并提醒你升级。

四、通过 BRAT 安装 opencode-obsidian

安装好 BRAT 后，就可以用它来安装 opencode-obsidian 插件了。

步骤 1：打开 BRAT 设置

设置 → 第三方插件 → 找到已安装的 BRAT，点击右侧的齿轮图标进入设置。

步骤 2：添加 Beta 插件

在 BRAT 设置页面中，点击 「Add Beta plugin」 按钮。

步骤 3：输入仓库地址

在弹出的输入框中输入：

`1`	`mtymek/opencode-obsidian`

点击 「Add Plugin」。

BRAT 会自动从 GitHub 拉取最新的 release 版本并安装。

步骤 4：启用插件

安装完成后，前往设置 → 第三方插件 → 在「已安装插件」列表中找到 OpenCode-Obsidian，打开开关启用它。

✅ 启用后，Obsidian 左侧栏会出现一个终端样式的图标——这就是 OpenCode 的入口。

自动更新

BRAT 会定期检查 GitHub 上的新版本。当有更新时，它会在 Obsidian 中弹出通知，你只需点击确认即可自动升级。

五、安装 OpenCode CLI

插件本身只是一个"壳"——它会在后台启动 opencode serve 服务，然后把 OpenCode 的 Web 界面嵌入到 Obsidian 里。所以你只需要通过 npm 安装 OpenCode CLI 就够了。

打开系统的终端（Windows 用 PowerShell，macOS/Linux 用 Terminal）：

`1`	`npm i -g opencode-ai`

验证安装：

1
2

opencode --version
# 期望输出类似: 1.14.39

⚠️ Windows 用户：如果插件提示「Executable not found at ‘opencode’」，请跳到本文第十节查看解决方案。

六、插件设置详解

启用插件后，进入设置 → 第三方插件 → OpenCode-Obsidian 的齿轮图标，可以看到以下配置项：

基础设置

设置项	默认值	说明
OpenCode 可执行文件路径	`opencode`	如果系统 PATH 中找不到，填入完整路径
端口	`14096`	OpenCode 服务监听的端口号
主机名	`127.0.0.1`	服务绑定的地址
项目目录	（自动取 Vault 路径）	OpenCode 操作的工作目录
启动超时	`45000` (45秒)	等待服务启动的最大毫秒数

界面设置

设置项	默认值	说明
默认视图位置	`sidebar`	`sidebar` = 侧边栏，`main` = 主编辑区
自动启动	`关闭`	打开 Obsidian 时自动启动 OpenCode 服务

上下文注入（实验性）

设置项	默认值	说明
注入工作区上下文	`关闭`	自动将当前笔记信息传给 OpenCode
最大笔记数量	`20`	上下文中包含的最大笔记数
最大选中文本长度	`2000`	传给 AI 的选中文本字符上限

自定义命令

设置项	默认值	说明
使用自定义命令	`关闭`	启用后可自定义 OpenCode 启动命令
自定义命令	（空）	自定义的启动命令（见第九节）

七、首次使用

打开 OpenCode 面板

有三种方式打开 OpenCode：

点击侧边栏图标：点击左侧栏的终端图标
快捷键：Ctrl + Shift + O（macOS 用 Cmd + Shift + O）
命令面板：Ctrl/Cmd + P → 输入 Toggle OpenCode panel

首次启动流程

打开面板后，插件会自动执行以下操作：

检测 OpenCode 可执行文件路径
启动 OpenCode 服务（opencode serve）
在嵌入式 Web 视图中加载 OpenCode 界面

启动成功后，你会看到完整的 OpenCode 对话界面，可以直接在里面输入 prompt。

验证一切正常

在 OpenCode 界面中输入：

/help

如果看到命令列表，说明一切正常。你也可以输入：

/models

查看可用的 AI 模型。OpenCode 内置了免费模型（如 GLM-4.7、MiniMax-2.1），无需任何配置即可使用。

快捷键速查

快捷键	功能
`Ctrl/Cmd + Shift + O`	切换 OpenCode 面板

八、上下文注入（实验性功能）

这是 opencode-obsidian 插件最独特的功能之一——它可以自动将 Obsidian 的工作上下文传递给 OpenCode。

开启方式

在插件设置中，打开 「注入工作区上下文」 开关。

注入的内容

启用后，插件会自动将以下信息传给正在运行的 OpenCode 实例：

📂 当前打开的笔记列表：你正在编辑哪些文件
📝 选中的文本：你在笔记中选中的文字

使用场景

选中一段文字，打开 OpenCode 面板，直接说「润色这段话」——AI 已经知道你说的是哪段文字
同时打开多篇笔记，让 AI「对比这两篇笔记的差异」——AI 已经知道你打开的是哪些文件

局限性

⚠️ 这是实验性功能，目前有一些限制：

在 OpenCode 界面中创建新 Session 时，上下文不会自动注入

上下文更新有一定的延迟

九、自定义命令模式

默认情况下，插件会自动调用 opencode serve 命令启动服务。如果你需要更多控制，可以启用自定义命令模式。

什么时候需要自定义命令？

需要添加额外的 CLI 参数
使用自定义的启动脚本
通过容器或虚拟环境运行 OpenCode
OpenCode 安装在非标准路径

配置步骤

在插件设置中打开 「使用自定义命令」
在 「自定义命令」 输入框中填写完整命令

命令模板

`1`	`opencode serve --port 14096 --hostname 127.0.0.1 --cors app://obsidian.md`

⚠️ 重要注意事项

端口和主机名必须与设置中的值一致
必须包含 --cors app://obsidian.md，否则 Obsidian 无法嵌入 OpenCode 的 Web 界面

十、常见问题与故障排除

❌ 找不到 OpenCode 可执行文件

现象：打开面板后提示「Executable not found at ‘opencode’」，但终端中执行 opencode 是正常的。

原因：Electron（Obsidian 底层框架）在 Windows 上不完全继承系统 PATH 环境变量。

解决方案：

在终端中查找 opencode.cmd 的完整路径：

`1`	`where opencode.cmd`

将输出的完整路径填入插件设置的「OpenCode 可执行文件路径」中，例如：

`1`	`C:\Users\你的用户名\AppData\Roaming\npm\opencode.cmd`

❌ 服务启动超时

可能原因：网络问题、模型加载慢、端口被占用。

解决方案：

检查端口 14096 是否被其他程序占用
尝试修改端口号（比如改成 15096）
增加启动超时时间

❌ 面板显示空白

可能原因：CORS 配置不正确。

解决方案：

如果使用了自定义命令，确保命令中包含 --cors app://obsidian.md。

❌ 面板无法嵌入

可能原因：OpenCode 版本过旧。

解决方案：

`1`	`npm i -g opencode-ai@latest`

❌ 中文文件名乱码（Windows）

解决方案：在 PowerShell 中执行：

`1`	`chcp 65001`

然后重启 Obsidian。

❌ 插件更新后需要重新配置

BRAT 更新插件时会保留你的设置数据。如果发现设置丢失，重新进入设置页面配置即可。

总结

整个安装流程可以用一张图概括：

┌──────────────────────────────────────────┐
│           安装 BRAT 插件                  │
│   设置 → 社区插件市场 → 搜索 BRAT → 安装   │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│      通过 BRAT 安装 opencode-obsidian      │
│   BRAT 设置 → Add Beta plugin             │
│   输入: mtymek/opencode-obsidian           │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│           安装 OpenCode CLI               │
│   npm i -g opencode-ai                   │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│         启用插件，开始使用                  │
│   Ctrl+Shift+O 打开面板                   │
│   直接在 Obsidian 里使用 OpenCode         │
└──────────────────────────────────────────┘

一句话总结：装 BRAT → 搜 mtymek/opencode-obsidian → 装好 OpenCode CLI → Ctrl+Shift+O 开始用。就这么简单。

📚 参考来源：

opencode-obsidian GitHub 仓库

BRAT 插件 GitHub 仓库

OpenCode 官方文档

OpenCode 全深度指南：开源版 Claude Code 的安装、配置与高级玩法

Thu, 30 Apr 2026 02:00:15 +0800

📋 目录

一、什么是 OpenCode？

OpenCode 是近期热度最高的 AI 编程工具，本质上是一个开源版的 Claude Code。它几乎复刻了 Claude Code 的所有核心功能，同时解决了 Claude Code 在中国用户中常见的限速、封号等痛点。

与 Claude Code 对比

对比维度	Claude Code	OpenCode
开源	❌ 闭源	✅ 开源
免费模型	❌ 需付费 API	✅ 内置免费模型
中国用户友好	⚠️ 限速/封号风险	✅ 无限制
Skills/MCP	✅ 支持	✅ 完全兼容
Session 并行	❌	✅ 核心亮点

核心定位

开源版 Claude Code：具备几乎全部功能，中国用户友好，不限速不封号
免费模型：开箱即用 GLM-4.7、MiniMax-2.1 等免费模型，零配置即可上手
顶级模型接入：通过 Antigravity 插件免费接入 Gemini 3 Pro、Claude 4.5 Opus；通过 /connect 接入 GPT Codex
杀手级功能：Session 并行、Timeline 回退、Share 分享、Ultra Work 多智能体协作
插件生态：Oh My Open Code (OMO) 集成七大编程智能体 + 三大 MCP Server + 多种工具

二、四种安装形态

⭐ 1. 命令行版（主力推荐）

最稳定、功能最全的使用方式。

# 安装（需先安装 Node.js）
npm i -g opencode-ai

# 启动
opencode

前置条件：需要安装 Node.js（前往 nodejs.org 下载对应系统版本）

2. 桌面客户端（Beta）

从官网下载客户端，一路下一步安装，选择项目文件夹即可使用。

⚠️ 目前处于 Beta 测试阶段，bug 较多，暂不推荐作为主力工具。

3. VS Code 插件版

前提：已安装命令行版 OpenCode。插件版的核心价值在于与 IDE 的无缝集成，让 AI 直接感知你的代码上下文。

在 VS Code 扩展商店搜索 OpenCode 并安装
快捷键 Ctrl + Shift + P → 输入 open opencode 回车
插件会自动关联左侧窗口打开的代码文件
选中代码后按 Ctrl + Alt + K 可快速粘贴到 OpenCode 聊天窗口

4. 云端运行环境（GitHub Actions）

非常适合开源项目的自动化 Issue 修复：

将项目上传到 GitHub 公开仓库
在仓库中配置 API Key（Settings → Secrets and Variables → Actions）
在 Issue 评论中输入 /opencode + 需求描述
GitHub Actions 自动运行 OpenCode 工作流
完成后自动创建 Pull Request

三、免费模型配置

查看可用模型

`1`	`/models # 查看所有可用模型（带 free 标记的即可免费使用）`

模型	特点
GLM-4.7	编程能力强，零配置
MiniMax-2.1	编程能力出色，响应快

接入顶级模型

方式一：Antigravity 插件（免费接入 Gemini + Claude）

Antigravity 是 Google 推出的 AI 编程 IDE，它慷慨地免费提供了 Gemini 3 Pro 和 Claude 4.5 Opus。

在 OpenCode 中粘贴安装提示词（从 Antigravity GitHub 首页复制）
等待 AI 自动完成安装
打开新终端执行登录命令，选择 Google → Antigravity 登录
登录 Google 账户，粘贴生成的 URL
重启 OpenCode，/models 即可看到 Gemini 3 Pro 和 Claude 4.5 Opus

方式二：GPT Codex（OpenAI 官方合作）

OpenAI 与 OpenCode 官宣合作，可直接接入 ChatGPT Codex。

`1`	`/connect # 选择 OpenAI → GPT Pro → 浏览器登录`

前提：需要有 ChatGPT Plus 或以上订阅。

方式三：OpenRouter（万能接入）

通过 OpenRouter 可以接入市面上几乎所有大模型，国内用户也能方便获取额度。

`1`	`/connect # 选择 OpenRouter → 填写 API Key`

OpenCode 支持 75 种 AI 接入方式，几乎囊括所有模型供应商。

四、核心功能亮点

1. 反问式需求澄清

在动手编码之前，OpenCode 会反向询问你一系列问题：

只需要代码样例，还是完整可运行的程序？
哪些功能是必须实现的？
调用哪个模型？
环境变量如何保存？

这种"先问清楚再动手"的机制，大幅减少了返工。

2. 命令行代码比对界面

OpenCode 的命令行 diff 展示被认为是所有命令行编程工具中做得最好的，代码变更一目了然。

⭐ 3. Session 并行处理

这是 OpenCode 最具特色的功能——多 Session 并行运行：

# 发起第一个任务（如：增加计时器）
# 任务执行中，创建新 session
/new

# 发起第二个任务（如：画笔调色）
# 查看所有 session 状态
/sessions

# 在 session 间切换
/session <id>

打转符号表示 Session 正在后台运行。两个需求可以完全并行开发，互不干扰。

4. Timeline 检查点回退

`1`	`/timeline # 查看当前 Session 的完整对话记录`

选择任意历史节点：

Revert：将代码和聊天内容同时回退到该时间点
View：查看当时 AI 做了什么修改

相当于编程过程中的"时光机"，可以大胆尝试不同方案。

1
2
3

/share      # 将对话记录分享为网页
/unshare    # 取消分享
/export     # 导出对话记录为文件

分享后生成一个网页链接，展示完整的对话记录和代码修改过程，方便与他人协作或展示。

五、Skills 技能迁移

OpenCode 完全兼容 Claude Code 的 Skills 目录结构，迁移成本极低：

1
2

# 目录结构对应关系
.claude/skills/<skill-name>/    →    .opencode/skills/<skill-name>/

操作步骤

在项目根目录新建 .opencode 文件夹
在 .opencode 下新建 skills 文件夹
将原 .claude/skills/ 下的技能文件夹直接复制过来
重启 OpenCode，AI 即可识别并调用这些 Skills

每个 Skill 就是一个带目录的说明书，告诉 AI 如何完成特定领域的任务。

六、MCP 配置

OpenCode 支持两种 MCP（Model Context Protocol）模式：

本地 MCP（Local）

通过本地命令执行。在 ~/.config/opencode/opencode.json 中配置：

{
  "mcpServers": {
    "shed-cn": {
      "type": "local",
      "command": "npx",
      "args": ["shed-cn"],
      "enabled": true
    }
  }
}

远程 MCP（Remote）

通过 URL 远程调用。以 Context7 为例：

{
  "mcpServers": {
    "context7": {
      "type": "remote",
      "url": "https://context7-mcp-server-url",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      },
      "enabled": true
    }
  }
}

配置完成后重启 OpenCode，输入 /mcp 即可查看已配置的 MCP Server。

七、Oh My Open Code (OMO) 超强插件 ⭐

OMO 是 OpenCode 上最火的编程插件，本质上是 工具 + MCP + 编程 Agent 的组合捆绑包。

七大编程智能体

智能体	角色	推荐模型
🧠 西西弗斯 (Sisyphus)	主智能体，规划与调度	Claude 4.5 Opus / GPT 5.2
🔮 先知 (Prophet)	架构设计、代码评审	—
📚 图书管理员 (Librarian)	查阅文献、文档检索	—
🔍 探索者 (Explorer)	网络搜索	—
🎨 前端工程师	前端开发	Gemini 3 Pro
📝 文档编写者	文档生成	—
🖼️ 多模态	图片/PDF 理解	—

每个智能体都分配了最适合其工作的大模型，据作者称耗费了 24,000 美元的 Token 才找到最佳组合。

三大 MCP Server

Web Search：网络搜索
Context7：获取最新技术文档
Grep App：GitHub 仓库快速代码搜索

集成工具

LSP 高级版：通过编程语言的语法和语义帮助 AI 快速定位代码
AST 工具：通过代码语法树进行关联搜索
LOC 工具：借助多模态视觉能力理解图片、PDF
Delegate Task / Background Task：Agent 任务分配和后台调度

安装与使用

配置文件位置：C:\Users\<用户名>\.config\opencode\oh-my-opencode.json

从 OMO GitHub 首页复制 install 开头的提示词
粘贴到 OpenCode 中，回答配置问题（订阅情况等）
自动完成安装

两种核心用法

① @ 指定智能体

`1`	`@前端工程师帮我优化这个页面的响应式布局`

② Ultra Work 模式（魔法词 ULW）

`1`	`ULW 帮我创建一个宠物商店应用`

Ultra Work 模式下，西西弗斯作为主智能体会：

将任务拆解成 Todo List
同时开启多个后台任务并行执行
居中调度各个智能体协同工作
最终交付完整项目

Ralph Loop 循环模式

强制 AI 长时间循环工作，适合极难任务：

`1`	`/ralph-loop`

示例：“使用 Spring Boot 4 最新标准重构整个项目，直到所有测试用例通过”——可以连续运行数小时直到任务完成。

八、其他实用功能

`/init` — 项目知识初始化

让 AI 通读整个项目文件夹，生成 agents.md 文件作为系统提示词，帮助 AI 快速了解项目。

`/compact` — 上下文压缩

将之前的对话提炼为简洁摘要，释放模型上下文窗口，避免 Token 超限。

自定义命令

在 ~/.config/opencode/commands/ 下创建 .md 文件定义自定义命令：

# 运行测试
模式：build
命令：npm test
描述：运行项目的全部测试用例

使用：/运行测试 即可触发。

自定义智能体

在 ~/.config/opencode/agents/ 下创建 .md 文件：

# Code Review Agent
类型：subagent
模型：claude-4.5-opus
描述：专门负责代码审查，检查代码质量、安全漏洞和最佳实践。

Primary Agent：按 Tab 键切换，在对话中直接使用
Sub Agent：由主智能体在后台自动调度

九、总结与推荐

适用场景

场景	推荐度	说明
新手入门 AI 编程	⭐⭐⭐⭐⭐	免费模型零成本上手
日常开发辅助	⭐⭐⭐⭐⭐	Session 并行 + Timeline 回退
复杂项目开发	⭐⭐⭐⭐⭐	OMO 插件多智能体协作
开源项目维护	⭐⭐⭐⭐	GitHub Actions 云端自动化
练习 Skills/MCP	⭐⭐⭐⭐⭐	完全兼容 Claude Code 生态

十、实战记录：安装 Oh My OpenAgent

以下是笔者亲测安装 Oh My OpenAgent（原 Oh My Open Code）的完整对话记录，环境为 Windows + PowerShell。

环境检查

1
2

opencode --version
# 输出: 1.14.39

安装过程

在 OpenCode 对话中直接告诉 AI：

“Install and configure oh-my-openagent by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md"

AI 会先询问你拥有的模型订阅情况：

订阅	我的情况
Claude Pro/Max	❌ 无
OpenAI / ChatGPT Plus	❌ 无
Gemini	❌ 无
GitHub Copilot	✅ 学生认证版
OpenCode Zen	✅ 免费可用
Z.ai Coding Plan	❌ 无
OpenCode Go	❌ 无
Kimi for Coding	❌ 无
Vercel AI Gateway	❌ 无

⚠️ AI 会提示 “Without a Claude subscription, the Sisyphus agent might not work ideally”，但 GitHub Copilot 会作为后备模型自动接管。

确认订阅后，AI 自动执行安装命令：

bunx oh-my-openagent install --no-tui \
  --claude=no --openai=no --gemini=no \
  --copilot=yes --opencode-zen=yes \
  --zai-coding-plan=no --opencode-go=no \
  --kimi-for-coding=no --vercel-ai-gateway=no

安装成功的输出：

[1/4] Checking OpenCode installation...
[OK] OpenCode 1.14.39 detected
[2/4] Adding oh-my-openagent plugin...
[OK] Plugin added -> C:\Users\<用户名>\.config\opencode\opencode.json

安装后的配置文件

主配置文件 ~/.config/opencode/opencode.json：

{
  "plugin": [
    "oh-my-openagent@latest"
  ]
}

Agent 模型配置 ~/.config/opencode/oh-my-openagent.json：

AI 自动根据 GitHub Copilot 订阅分配了模型：

Agent	分配的模型
Sisyphus（主智能体）	`github-copilot/claude-opus-4.7`
Oracle（先知）	`github-copilot/gpt-5.5` (medium)
其余 Agent	自动选择 Copilot 可用模型

认证配置

安装完成后需要手动认证 GitHub Copilot：

`1`	`opencode auth login`

交互步骤：

上下键选择 GitHub Copilot
按回车确认
浏览器自动打开，登录 GitHub 学生账号
授权完成，终端显示认证成功

如何重新配置 Agent 模型？

方式一：直接告诉 AI

“把 Sisyphus 的模型改成 claude-sonnet-4.6” “Oracle 用 gpt-5.5”

方式二：手动编辑配置文件

直接修改 ~/.config/opencode/oh-my-openagent.json 中对应 agent 的 model 字段。

追加配置：补上 OpenCode Zen 作为备选

安装时遗漏了免费的 OpenCode Zen（--opencode-zen=no），后续在 OpenCode 新对话中直接让 AI 帮忙修正：

“其实我还有你免费的 OpenCode Zen，但是我已经登录 GitHub Copilot 了，你帮我修改一下”

AI 的第一次尝试把 OpenCode Zen 设成了主力（opencode/claude-opus-4-7），GitHub Copilot 变成了备选。实际需求是反过来的：

“不是，是 GitHub Copilot 作为主力，OpenCode Zen 自带的免费模型作为备选”

AI 修正后，最终配置策略：

1
2

主力模型: github-copilot/*     （已付费，优先使用）
备选模型: opencode/*           （免费额度，Copilot 不可用时自动切换）

关键配置片段（以 Sisyphus 为例）：

{
  "sisyphus": {
    "model": "github-copilot/claude-opus-4-7",
    "fallback_models": [
      { "model": "opencode/claude-opus-4-7" },
      { "model": "opencode/gpt-5.5" }
    ]
  }
}

💡 经验：描述配置需求时，主次关系要说清楚——“XX 作为主力，YY 作为备选”，避免 AI 搞反。

使用提示

安装完成后，在终端输入 opencode 即可开始：

在 prompt 中包含 ultrawork 或 ulw 触发自动并行处理
按 Tab 进入 Prometheus（规划器）模式
运行 /start-work 执行完整编排

附录：踩坑记录

问题	解决
`doctor` 命令超时（30s）	部分检查可能挂起，加 `--verbose` 排查，或跳过不影响使用
PowerShell 下 `if` 语法报错	OpenCode 的 bash 命令在 PowerShell 下需转换语法
Sisyphus 非 Claude 模型性能下降	这是已知限制，有 Claude 订阅体验最佳
AI 把主力/备选模型搞反	描述需求时说清主次：“XX 作为主力，YY 作为备选”，不要只说"帮我加上 YY”

📚 参考来源：技术爬爬虾 - OpenCode 详细攻略、Oh My OpenAgent 安装指南

OpenCode 新手进阶：并行调度与使用技巧全攻略

Thu, 30 Apr 2026 02:00:15 +0800

📋 目录

📌 核心要点概括

功能	一句话说明
Session 并行	OpenCode 杀手级功能，多个任务同时跑，互不干扰，效率翻倍
Ultra Work 模式	输入 `ULW`，主智能体自动拆解任务、调度多个子智能体并行干活
@ 指定智能体	让擅长前端的干前端，擅长架构的做评审，人尽其才
Timeline 时光机	随时回退到任意历史节点，大胆试错零成本
Ralph Loop	让 AI 循环工作数小时，攻坚极难任务

一、Session 并行：让 AI 同时干多件事

这是 OpenCode 相比其他 AI 编程工具最大的差异化优势。传统工具只能串行——一个任务跑完才能开始下一个。OpenCode 可以同时开启多个 Session，互不干扰。

基础操作

/new              # 创建新 Session
/sessions         # 查看所有 Session 的状态（打转符号 = 正在运行）
/session <id>     # 切换到指定 Session
/session prev     # 回到上一个 Session

实战场景

假设你在开发一个"你画我猜"小游戏，有两个独立需求：

需求 A：增加一个计时器，首次落笔开始计时，超过 20 秒游戏失败
需求 B：画笔可以调节颜色

传统做法

先做完 A，再做 B → 需求 B 白白等待 5-10 分钟。

OpenCode 做法

1. 输入需求 A，AI 开始工作
2. 输入 /new，创建新 Session
3. 输入需求 B，AI 开始工作
4. 输入 /sessions 查看进度：

   Session 1  ◐  正在添加计时器逻辑...
   Session 2  ◐  正在添加颜色选择器...

两个需求完全并行开发，总耗时从 15 分钟压缩到 8 分钟。

注意事项

⚠️ Session 之间完全隔离，修改同一文件可能冲突，建议分配给不同模块
⚠️ 后台 Session 不会自动通知完成，需要手动 /sessions 查看
✅ 可以随时 /new 开第三个、第四个……没有数量限制

二、Ultra Work：一键召唤 AI 编程团队

如果说 Session 并行是"手动挡"，那 Ultra Work 就是"全自动驾驶"。输入一个魔法词，AI 自动把任务拆开、分配给最合适的智能体、并行执行。

触发方式

在 prompt 中包含以下任一关键词：

1
2
3

ULW
ultrawork
Ultra Work

工作原理

你的需求：帮我做一个宠物商店网站
        │
        ▼
  ┌─────────────────────────────┐
  │  西西弗斯（主智能体）         │
  │  1. 拆解任务 → Todo List     │
  │  2. 分配子任务              │
  └──────┬──────────┬───────────┘
         │          │
    ┌────▼───┐ ┌───▼────┐ ┌────────▼────┐
    │ 先知    │ │ 前端    │ │ 文档编写者   │
    │ 架构设计 │ │ UI 开发 │ │ 文档生成     │
    └────────┘ └────────┘ └─────────────┘
         │          │            │
         └──────────┴────────────┘
                    │
                    ▼
              完整项目交付

自动拆分 Todo List
同时开启 3 个后台任务并行执行
主智能体居中调度
最终交付完整项目

什么时候用？

场景	适用	说明
从零创建完整项目	✅ 极佳	自动拆分前端、后端、文档
多模块并行开发	✅ 极佳	各智能体分工明确
单文件小修改	❌ 不推荐	杀鸡用牛刀，反而更慢
简单 bug 修复	❌ 不推荐	普通对话更快

💡 复杂度越高，Ultra Work 的价值越大。简单任务反而会因为调度开销变慢。

实际效果

用 Ultra Work 模式创建了一个宠物商店网站：

✅ 在没有任何图片素材的情况下，用 emoji 作为装饰
✅ 界面清新、交互流畅、动画完整

三、@ 指定智能体：让专业的人干专业的事

安装了 Oh My OpenAgent（OMO）后，你拥有一个 AI 编程团队。通过 @ 可以点名让特定智能体干活。

智能体能力表

智能体	擅长领域	最适模型	示例用法
🧠 西西弗斯	统筹规划、任务调度	Claude Opus	复杂多步骤任务
🔮 先知	架构设计、代码评审	GPT 5.5	项目结构设计
🎨 前端工程师	UI 开发、页面布局	Gemini 3 Pro	响应式布局优化
🔍 探索者	网络搜索、查资料	MiniMax	查最新 API 文档
📚 图书管理员	文献查阅、文档检索	—	梳理开源项目源码
📝 文档编写者	README、注释生成	—	生成项目文档
🖼️ 多模态	图片/PDF 理解	—	根据设计稿写代码

使用示例

@前端工程师 帮我把这个登录页改成响应式布局，移动端也要好看

@先知 审查一下 src/service/ 目录下的代码，找出潜在的性能问题

@探索者 查一下 React 19 的 Server Components 最新用法

@文档编写者 给整个项目生成一份 API 文档

切换主智能体

按 Tab 键可以切换当前对话的主智能体，适合长时间使用某个特定角色。

四、Timeline 时光机：随意试错，随时回退

编程中最怕什么？改了一大堆代码，发现方向错了，又回不去。Timeline 就是你的后悔药。

基本用法

`1`	`/timeline # 列出当前 Session 的每一步对话记录`

选择任意节点：

Revert：代码和聊天内容同时回退到该节点，就像什么都没发生过
View：查看当时 AI 做了什么修改

实战场景

1
2
3

1. 你让 AI 重构了某个模块 → 效果不理想
2. /timeline → 选择重构前的节点 → Revert
3. 代码回到重构前，换个思路重新来

使用技巧

🕐 完成一个阶段性任务后，在心里记下那个节点（第几次对话）
🕐 大胆尝试激进方案——反正可以一键回退
🕐 对比两个方案：Revert 到 A 方案 → 看看效果 → Revert 到 B 方案 → 对比

这就是编程版的"存档/读档"，让你敢于探索任何可能性。

五、Ralph Loop：让 AI 死磕到底

这个模式会让 AI 持续循环工作，直到任务真正完成。适合那些需要反复迭代的硬骨头。

启动方式

`1`	`/ralph-loop`

适用场景

"使用 Spring Boot 4 最新标准重构整个项目，直到所有测试用例通过"

"逐个检查 src/ 下所有文件的代码规范，修复每一个违规项"

"为项目添加完整的单元测试，直到覆盖率达到 90%"

和 Ultra Work 的区别

对比维度	Ultra Work	Ralph Loop
工作机制	并行拆分、多智能体协作	串行循环、持续迭代
适合场景	从零构建、多模块项目	重构、修复、达标类任务
耗时	几分钟到十几分钟	可能数小时
终点	任务拆解完成	满足终止条件

⚠️ Ralph Loop 可能运行很久，注意 API 额度消耗。

六、日常提速小技巧

1. 善用 `/compact` 节省上下文

当你和 AI 聊了很多轮，上下文窗口快满时：

`1`	`/compact`

AI 会把之前的对话提炼成一个摘要，释放空间继续工作。不需要开新对话丢失上下文。

2. 用 `/init` 让 AI 快速上手新项目

进入一个新项目时，先让 AI 通读代码：

/init

AI 会扫描整个项目，生成 agents.md 作为系统提示词。之后任何对话都会基于这个理解，效率大幅提升。

1
2
3

/share      # 生成分享链接，展示完整对话和代码修改
/unshare    # 取消分享，链接失效
/export     # 导出对话记录为文件

适合场景：

给同事展示你是如何用 AI 解决某个问题的
记录踩坑过程，供团队参考
写博客时的素材

4. 查看可用模型

`1`	`/models # 带 free 标记的是免费模型`

GLM-4.7 和 MiniMax-2.1 编程能力不错，适合轻量任务。

5. 快捷粘贴代码（VS Code 插件）

在 VS Code 中选中代码片段 → Ctrl + Alt + K → 直接粘贴到 OpenCode 对话框。

省去复制粘贴的切换成本，保持心流。

七、新手推荐工作流

┌─────────────────────────────────────────────┐
│                 拿到新需求                    │
└──────────────────┬──────────────────────────┘
                   │
                   ▼
          ┌────────────────┐
          │ 简单？          │
          └───┬────────┬───┘
              │ 是      │ 否（复杂/多模块）
              ▼         ▼
    ┌─────────────┐  ┌─────────────────┐
    │ 普通对话搞定  │  │ 输入 ULW 触发    │
    │             │  │ Ultra Work 模式  │
    └─────────────┘  └────────┬────────┘
                              │
                   ┌──────────▼──────────┐
                   │ 多个独立子任务？       │
                   └───┬──────────┬──────┘
                       │ 是        │ 否
                       ▼           ▼
              ┌─────────────┐ ┌──────────────┐
              │ /new 开多个   │ │ 等 Ultra Work │
              │ Session 并行  │ │ 自动完成       │
              └──────┬──────┘ └──────────────┘
                     │
                     ▼
              ┌─────────────┐
              │ /sessions    │
              │ 查看所有进度  │
              └──────┬──────┘
                     │
                     ▼
              ┌─────────────┐
              │ 某个方向错了？ │
              └───┬─────────┘
                  │
                  ▼
              ┌─────────────┐
              │ /timeline →  │
              │ Revert 回退   │
              └─────────────┘

一句话总结

小活直接聊，大活喊 ULW，并行用 Session，错了就 Timeline 回退，死磕开 Ralph Loop。

八、一个真实案例

在 Oh My OpenAgent 安装完成后，想调整 Agent 模型配置——让 GitHub Copilot 作为主力，免费的 OpenCode Zen 作为备选。

第一次尝试

直接在 OpenCode 对话中说：

“其实我还有你免费的 OpenCode Zen，但是我已经登录 GitHub Copilot 了，你帮我修改一下”

AI 把 OpenCode Zen 设成了主力——因为没说清楚主次关系。❌

纠正

“不是，是 GitHub Copilot 作为主力，OpenCode Zen 自带的免费模型作为备选”

AI 立即修正，更新了 oh-my-openagent.json，所有 Agent 都用 github-copilot/* 为主、opencode/* 为 fallback。✅

💡 教训：跟 AI 描述需求时，主次关系一定要说清楚——“XX 作为主力，YY 作为备选”，不要只说"帮我加上 YY"。

📚 参考来源：OpenCode 全深度指南、Oh My OpenAgent 📅 笔记生成日期：2026-05-07

OpenCode on Yanmu

OpenCode + Obsidian：打造你的AI驱动知识管理工作流

📋 目录

一、什么是 opencode-obsidian 插件？

二、环境准备

三、安装 BRAT 插件

步骤 1：打开社区插件市场

步骤 2：搜索并安装 BRAT

四、通过 BRAT 安装 opencode-obsidian

步骤 1：打开 BRAT 设置

步骤 2：添加 Beta 插件

步骤 3：输入仓库地址

步骤 4：启用插件

自动更新

五、安装 OpenCode CLI

六、插件设置详解

基础设置

界面设置

上下文注入（实验性）

自定义命令

七、首次使用

打开 OpenCode 面板

首次启动流程

验证一切正常

快捷键速查

八、上下文注入（实验性功能）

开启方式

注入的内容

使用场景

局限性

九、自定义命令模式

什么时候需要自定义命令？

配置步骤

命令模板

⚠️ 重要注意事项

十、常见问题与故障排除

❌ 找不到 OpenCode 可执行文件

❌ 服务启动超时

❌ 面板显示空白

❌ 面板无法嵌入

❌ 中文文件名乱码（Windows）

❌ 插件更新后需要重新配置

总结

OpenCode 全深度指南：开源版 Claude Code 的安装、配置与高级玩法

📋 目录

一、什么是 OpenCode？

与 Claude Code 对比

核心定位

二、四种安装形态

⭐ 1. 命令行版（主力推荐）

2. 桌面客户端（Beta）

3. VS Code 插件版

4. 云端运行环境（GitHub Actions）

三、免费模型配置

查看可用模型

推荐免费模型

接入顶级模型

方式一：Antigravity 插件（免费接入 Gemini + Claude）

方式二：GPT Codex（OpenAI 官方合作）

方式三：OpenRouter（万能接入）

四、核心功能亮点

1. 反问式需求澄清

2. 命令行代码比对界面

⭐ 3. Session 并行处理

4. Timeline 检查点回退

5. Share 分享

五、Skills 技能迁移

操作步骤

六、MCP 配置

本地 MCP（Local）

远程 MCP（Remote）

七、Oh My Open Code (OMO) 超强插件 ⭐

七大编程智能体

三大 MCP Server

集成工具

安装与使用

两种核心用法

① @ 指定智能体

② Ultra Work 模式（魔法词 ULW）

Ralph Loop 循环模式

`/init` — 项目知识初始化

`/compact` — 上下文压缩

1. 善用 `/compact` 节省上下文

2. 用 `/init` 让 AI 快速上手新项目