手贱装了个插件，我把OpenCode玩崩了

问题现象

起因是用opencode使用kimi-webbridge，于是本机按官网步骤安装kimi-webbridge，但官网原生不支持opencode连接kimi-webbridge，于是让opencode自己装，结果它自己封装了一个skill，但恰巧在此过程中我又升级了opencode版本到最新的OpenCode v1.18.6。

然后，就出现了以下问题：

本机opencode客户端聊天不响应了！！！

发个消息不回复。

然后用deepseek和mimo查问题，始终说不到点子上。

问有deepseek OpenCode运行日志在哪，还是返回一堆不正确的东西。

没办法回滚到OpenCode v1.18.5版本，重装，结果还是同样的问题不回复。

然后利用hermes来修复，结果把opencode工作的历史记录全搞没了，整个崩溃。

反查hermes执行日志有一条删除缓存和配置的一些指令，没有注意：

Java 复制代码

Clean local state (keep skills and settings)\nrm -f \"/mnt/c/Users/Administrat\n... (已截断)"

然后赶紧让hermes还原配置，结果来了句 "很抱歉，配置和历史会话数据确实丢失了。"

有点崩溃啊，硬着头皮再继续查问题吧！

换了几个版本的opencode都无法恢复，至此怀疑与升级版本无关，于是猜测与装kimi-webbridge有关。但还是要查到具体的运行报错才行。于是找官网，在故障排查里面找到了。

日志

日志文件写入位置：

macOS/Linux: ~/.local/share/opencode/log/
Windows: 按 WIN+R 并粘贴 %USERPROFILE%\.local\share\opencode\log

日志文件以时间戳命名（例如 2025-01-09T123456.log），并保留最近的 10 个日志文件。

在路径log日志里面看到一堆异常

Python 复制代码

message="background dependency install failed" dir="C:\\Users\\Administrator\\.config\\opencode" error="Cause([Fail(NpmInstallFailedError (cause: @opencode-ai/plugin: No matching version found for @opencode-ai/plugin@local.))])"
 message="background dependency install failed" dir="E:\\Project\\JZTProject\\tmp-workspace\\.opencode" error="Cause([Fail(NpmInstallFailedError (cause: @opencode-ai/plugin: No matching version found for @opencode-ai/plugin@local.))])"
 message="background dependency install failed" dir="C:\\Users\\Administrator\\.opencode" error="Cause([Fail(NpmInstallFailedError (cause: @opencode-ai/plugin: No matching version found for @opencode-ai/plugin@local.))])"
 message="duplicate skill name" name=gpt-image-2-style-library existing="C:\\Users\\Administrator\\.claude\\skills\\gpt-image-2-style-library\\SKILL.md" duplicate="C:\\Users\\Administrator\\.agents\\skills\\gpt-image-2-style-library\\SKILL.md"
 message="duplicate skill name" name=agent-reach existing="C:\\Users\\Administrator\\.claude\\skills\\agent-reach\\SKILL.md" 
......

日志中发现了以下两类异常：

问题一：依赖安装失败

text 复制代码

message="background dependency install failed"
error="NpmInstallFailedError (cause: @opencode-ai/plugin: No matching version found for @opencode-ai/plugin@local.)"

opencode 在多个目录（.config/opencode、.opencode、项目下的 .opencode）均因无法找到 @opencode-ai/plugin@local 版本导致插件依赖安装失败。

问题二：Skill 名称冲突

大量 duplicate skill name 警告，多个同名 skill 同时存在于不同目录中：

gpt-image-2-style-library、agent-reach --- .claude/skills 和 .agents/skills 冲突
kimi-webbridge --- .claude/skills 和 .config/opencode/skills 冲突
所有 lark-* skill --- .agents/skills 和项目目录冲突
多个 alibabacloud-* skill --- 多个目录冲突

解决

先清除缓存.cache\opencode；
删除这个config\opencode\tools\kimi-webbridge.ts文件，防止openclod加载（正式因为kimi-webbridge.ts 引用了不存在的 @opencode-ai/plugin 包，导致所有依赖安装失败，sidecar 启动崩溃）；
再解决冲突的SKILL，删除目录下的.claude\skills\agent-reach等重复项；

再重启opencode后恢复正常，但，之前的记录还是无法恢复！

写这篇记录呢是想说不要太冲动，如果是生产环境可能就直接GG了。