有更新到v2的打算吗？

插件很好用，用了很久。但是前几天用了v2版本，没办法使用了，有计划更新吗？

关于这个问题，我有几个疑问：

你说的 v2 ，是指 opencode 的 0.0.0-beta-202608110357 版本吗？
你使用的 opencode-visual-cache (本插件) 的版本是多少？是最新 v1.6.2 吗？

如果你是指 0.0.0-beta-202608110357 版本（8 月 11 日的 beta 构建），根据我本机实测，本插件 lateast（v1.6.2），使用 ctrl+p install plugin 安装，侧边栏可以显示，插件主要功能正常，你所说的 “没办法使用”，具体指的是 “侧边栏无法显示”? 还是 “侧边栏可以显示，但数据无法显示”？又或者崩溃报错之类？

是的，但是显示加载失败，我重新更新了最新的版本，清理了cache重新下载最新的插件也不行。v2的钩子可能变动比较频繁，我本来想fork一份，但是姑且先问一下

v1版本才有install plugin，v2版本需要 opencode2打开，会启动一个和tui分离的进程

关于这个问题，根据官方迁移文档的 Plugins 章节，其中提到 V1 plugins will not work in V2.，以及各种接口尚未稳定，需要官方定稿。

但根据调研，插件的大部分功能可以先行移植到 opencode v2，但是修改较大，不是简单兼容，并且存在后续变动的可能性，我的想法是，为了兼容之后的 v2 版本，我会先尝试重新设计插件架构，并且尝试移植并试上架插件的 1.7.0 beta 版本（PR #26），等待官方稳定后再合并插件到主线版本。opencode v1 版本下，插件预计不受影响。

opencode-subagent-magazine 还未移植，需要调研 opencode v2 的能力，预计后续跟进。

1.7.0 beta安装方式：

找到 ~/config/opencode/cli.json 文件并打开
修改 plugins 字段中的 opencode-visual-cache 插件包名为 opencode-visual-cache@1.7.0-beta.3 或 opencode-visual-cache@beta
然后重启 opencode2，等待安装就好

图片示例：

beta 版本好像也不兼容 v2 了

@Movoid

@Movoid 请问你使用的具体版本是什么？

我的 opencode v2 版本是 2.0.10
插件使用 opencode-visual-cache@beta 安装（目前最新 beta 是 v1.7.0-beta.6）
隔壁的 opencode-subagent-magazine 最新 beta 是 v1.6.0-beta.4
二者在我本机 opencode 2.0.10 均可正常运行。

关于“不兼容”，可以提供更加具体的描述吗？

@Hotakus

@Hotakus

我使用 opencode v2.0.8，安装 opencode-visual-cache@beta，版本是 v1.7.0-beta.6，报错

Server plugin error
Plugin: opencode-visual-cache@beta
Status: failed
Runtime: server
Source: opencode-visual-cache@beta
Error: Plugin must export a default definition with an id and an effect or setup function.
Reference: err_cfe37d1b

@Movoid

@Movoid

1 、你的安装插件的方法是什么？仅在 cli.json 中直接添加吗？添加后至少重新启动一次 opencode，它会自动安装并启用，这条路径我确认没有问题。

2、另外我尝试在命令行直接使用 opencode plugin add opencode-visual-cache@beta 进行安装，插件同样可以使用。没有出现安装失败的情况。在启动opencode TUI后，使用 /plugin 斜杠命令打开插件列表，插件列表内的 server 部分确实显示插件的 server 不兼容，但是插件的主功能貌似正常工作，不影响使用。因为本插件不是 server 插件，仅是 TUI 插件，所以安装后，需要把 ~\.config\opencode\opencode.jsonc 里 plugins 字段内的非 server 条目删掉（即本插件）。

3、另外，我发现，在 2 的基础上，删掉 ~\.config\opencode\cli.json 内的插件字段后，使用opencode plugin add opencode-visual-cache@beta 进行安装后，插件条目不会自动被添加到 cli.json 文件中，插件条目仅被添加到 opencode.jsonc内（然而这是管理 server 插件的），实际上，opencode V2 需要在 cli.json 文件中显示添加 TUI 插件条目（V1 在 tui.json 中）

例如：

"plugins": [
    {
      "package": "opencode-visual-cache@beta",
      "options": {
        "enabled": true
      }
    },
    {
      "package": "opencode-subagent-magazine@beta",
      "options": {
        "enabled": true
      }
    }
  ],

所以我的总结是：

你可以尝试删掉 opencode.jsonc 中的非 server 插件条目（本插件只是 TUI 插件），这样可以解决报错。
在 ~\.config\opencode\cli.json 文件中的 plugins 字段中，添加上述声明
通过 opencode plugin add xxx 安装的插件貌似只适用于 server 插件，不适用 TUI 插件，需要手动在 cli.json 声明
另外，你可以尝试清除缓存，V2 的插件缓存在 ~\.cache\opencode\npm，V1 的插件缓存在 ~\.cache\opencode\packages

如果会话内还是不能正常使用插件，请详细说明你的安装方法，以便我复现问题。

@Hotakus

@Hotakus

感谢，我删掉了 opencode.json 里的配置，在 cli.json 里添加配置，可以正常工作了。

Navigation Menu

Repository navigation

有更新到v2的打算吗？ #25

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

有更新到v2的打算吗？ #25

Description

Activity

Hotakus commented on Aug 14, 2026

FlyDut commented on Aug 16, 2026

Hotakus commented on Aug 17, 2026

Movoid commented on Sep 19, 2026

Hotakus commented on Sep 19, 2026

Movoid commented on Sep 19, 2026

Hotakus commented on Sep 19, 2026

Movoid commented on Sep 19, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions