更新 Oh My OpenCode 插件

保持 oh-my-opencode 插件的最新状态对于体验最新的 AI 智能体（如 Hephaestus）至关重要。本文将介绍如何正确配置自动更新，解决插件缓存导致的版本停滞问题。

# 常见误区：`@latest` 不会自动更新#

很多用户在 ~/.config/opencode/opencode.json 中配置插件时，习惯使用 @latest 标签：

json
1{
2  "plugin": [
3    "npm:oh-my-opencode@latest"
4  ]
5}

注意：这种写法仅在首次安装时有效。

由于 OpenCode 为了性能会缓存已下载的插件内容，即使 npm 发布了新版本，OpenCode 默认也不会自动检查和更新已缓存的插件。这会导致你一直停留在旧版本，无法使用新发布的功能和智能体。

# 正确做法：开启自动更新#

要强制 OpenCode 检查并更新 oh-my-opencode 插件，你需要修改 oh-my-opencode 自身的配置文件。

## 1. 定位配置文件#

找到或创建 ~/.config/opencode/oh-my-opencode.json 配置文件。

全局位置: ~/.config/opencode/oh-my-opencode.json
项目位置: 项目根目录下的 .opencode/oh-my-opencode.json

## 2. 添加 `auto_update` 配置#

在 ~/.config/opencode/oh-my-opencode.json 配置文件中添加 "auto_update": true：

json
1{
2  //配置文件第一行
3  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
4  "auto_update": true, // <- 新增这条
5  //原有配置👇
6  "agents": {
7    ...
8  }
9}

## 3. 重启 OpenCode#

配置保存后，重启 OpenCode。在启动过程中，插件会自动检测并下载最新版本。 ** 注意 ** ，这次启动速度会慢，看到白屏或者黑屏的话，耐心等待，不要强行中断，取决于你的网速(特别是连外网的速度)

# 为什么要更新？#

oh-my-opencode 的更新通常伴随着核心 Agent 的能力升级和新 Agent 的引入。

## Sisyphus (西西弗斯) - 持续进化#

我们熟悉的通用型智能体。适合大多数日常编码、重构和文档任务。更新通常包含 prompt 优化和新的工具集成。

## Hephaestus (赫菲斯托斯) - 新增成员#

最新版本引入了 Hephaestus。这是一个目标导向、深度自驱的 Agent。

特点：不像 Sisyphus 那样依赖每一步的交互，Hephaestus 擅长在给定宏大目标后，自主规划路径、尝试方案、自我修正，直到彻底完成任务。
适用场景：复杂的模块重构、从零构建功能模块、解决深层依赖冲突等。

通过开启自动更新，你可以第一时间获得这些强大的生产力工具。

更新 Oh My OpenCode 插件

相关文档