dsh-opencode-go-plus

安装与使用

0.4.9 将套餐用量面板改为不透明背景，避免半透明主题下文字与底层内容互相干扰。

0.4.8 适配 Harness 0.2.1-rc.2，补齐 engines.dsh。已安装旧版时，在插件管理器更新本插件，再确认版本为 0.4.9；无需版本豁免。

0.4.7 适配 Harness 桌面版 0.2.0-rc.1，修复升级后因版本范围校验而显示“异常”的问题。

0.4.6 修复设置卡片刷新后又显示“尚未检查连接”的问题：检查结果保留在 Host 中，重新打开卡片或收到设置更新时继续显示最近结果；更换密钥、端点或启停配置后失效，需重新检查。重启 Host 后仍需重新检查。

桌面版（含 0.1.7-rc.2 / 0.2.0-rc.1 / 0.2.1-rc.2）

在 插件 → 添加插件 → Git 仓库 中填写：

https://github.com/HaydenSmith1121/dsh-opencode-go-plus

0.4.1 起无需为本插件允许 @google/genai、protobufjs 的安装脚本。 OpenCode Go 使用的 OpenAI / Anthropic 协议模块已随包预编译；安装时不会再拉取完整 pi-ai 的 Google / Protobuf 依赖链，也不需要本地构建。

如果之前停在“需要允许安装脚本”，关闭旧安装任务，重新从上述仓库发起安装以获取 0.4.1 或更新版本。旧任务仍可能引用旧提交；请在安装详情里确认版本。若同一 profile 还有其他插件依赖这些包，它们的脚本提示需要单独处理。此修复不修改全局脚本策略。

配置密钥与刷新状态（0.4.2 起）

登录 OpenCode 官网不会自动连接 Harness。 OpenCode Go 使用 API Key； 请在 OpenCode 控制台 中确认 Go 订阅并复制对应密钥。 官方接入说明见 OpenCode Go。

1. 在 Harness 打开 设置 → 模型 → OpenCode Go。
2. 直接在卡片的 OpenCode Go API Key 输入框粘贴密钥，点击 保存并检查。 无需点上方通用“编辑”：Harness 0.1.7-rc.2 的通用编辑器暂不识别第三方插件。
3. 之后可点击 刷新状态：重新读取凭据、同步模型路由、检查用量接口认证，并重新获取模型目录。 仅打开页面不会发起外网认证检查。

卡片是可折叠的：标题行左侧的箭头或整行文字都可以点开/收起；已配置密钥时会默认收成 一行状态摘要，未配置时默认展开，方便直接粘贴。状态摘要按语义着色 —— 需要处理的 （未配置 / 未验证 / 目录异常）为橙色，认证失败为红色，完全就绪为绿色。

卡片明确区分未配置、未验证、认证成功、401、403、429、网络/服务故障和目录刷新失败。 顶部红绿点只表示宿主是否存有凭据，实际连接结果请看卡片中的检查状态。 检查使用只读的用量和模型目录接口，不发送聊天请求。已有密钥不会回显；空输入不会清除密钥。 密钥通过 Harness 凭据服务保存，不写入插件配置、状态响应或浏览器本地存储。 若凭据由环境或只读来源提供，会显示不可覆盖的提示。

Web

dsh plugin --profile web add dsh-opencode-go-plus

安装后启动或重启 dsh web：

1. 打开 设置 → 模型，找到 OpenCode Go 一行。
2. 该行显示 API Key 状态（绿点 = 已配置）。
3. 在会话的模型选择器中选择 OpenCode Go 模型。

API Key 来自你的 OpenCode Go 订阅（默认引用 OPENCODE_API_KEY）。改引用名的位置随 harness 版本不同：dsh = 0.1.7 在 profile 的 cordis.patch.yml 中该 entry 的 config 里。安装插件不会 自动更改默认模型。

0.3.0 起，插件不再有独立的"设置 → OpenCode Go"分区。 配置入口就是 设置 → 模型 里的 OpenCode Go 行，与其它 provider 并列。refreshMinutes、 autoDiscover、图片预算等插件专有字段的位置同样随版本走（见上面 兼容性的表）。详见 更新日志 0.3.0。

Headless

安装到 Headless profile：

dsh plugin --profile headless add dsh-opencode-go-plus

将以下内容保存为 headless.patch.yml，选择默认模型：

- id: agent-default-model
  config:
    provider: opencode-go
    model: deepseek-v4.1-flash

在 Bash 或 Zsh 中读取 API Key，然后运行任务：

read -s OPENCODE_API_KEY
export OPENCODE_API_KEY
dsh --profile headless --patch ./headless.patch.yml "你好"

模型 ID 须在当前网关目录中可用。Web 和 Headless 使用各自的 profile，需要分别安装插件。

配置密钥与刷新状态（0.4.2 起）

登录 OpenCode 官网不会自动连接 Harness。 OpenCode Go 使用 API Key； 请在 OpenCode 控制台 中确认 Go 订阅并复制对应密钥。 官方接入说明见 OpenCode Go。

1. 在 Harness 打开 设置 → 模型 → OpenCode Go。
2. 直接在卡片的 OpenCode Go API Key 输入框粘贴密钥，点击 保存并检查。 无需点上方通用“编辑”：Harness 0.1.7-rc.2 的通用编辑器暂不识别第三方插件。
3. 之后可点击 刷新状态：重新读取凭据、同步模型路由、检查用量接口认证，并重新获取模型目录。 仅打开页面不会发起外网认证检查。

卡片是可折叠的：标题行左侧的箭头或整行文字都可以点开/收起；已配置密钥时会默认收成 一行状态摘要，未配置时默认展开，方便直接粘贴。状态摘要按语义着色 —— 需要处理的 （未配置 / 未验证 / 目录异常）为橙色，认证失败为红色，完全就绪为绿色。

卡片明确区分未配置、未验证、认证成功、401、403、429、网络/服务故障和目录刷新失败。 顶部红绿点只表示宿主是否存有凭据，实际连接结果请看卡片中的检查状态。 检查使用只读的用量和模型目录接口，不发送聊天请求。已有密钥不会回显；空输入不会清除密钥。 密钥通过 Harness 凭据服务保存，不写入插件配置、状态响应或浏览器本地存储。 若凭据由环境或只读来源提供，会显示不可覆盖的提示。

5. catalogAdditions 改为可配置

上游把追加项硬编码在源码里。现在它是设置项，默认值不变，可在 设置 → OpenCode Go 里增删：

llm-opencode-go:
  catalogAdditions:
    - id: deepseek-v4.1-flash
      siblingId: deepseek-v4-flash
      inputSiblingId: deepseek-v4-flash-vision-exp
      name: DeepSeek V4.1 Flash

条目必须四个字段齐全，缺一个会被忽略（不会半成品地塞进目录）。

配置

Web 用户可直接在 设置 → 模型 里找到 OpenCode Go 一行，从那里改配置。启用开关立即生效。