dsh-opencode-go：DeepSeek Harness 的 OpenCode Go 和 Zen 实时目录插件

下面介绍 dsh-opencode-go 插件。DeepSeek Harness（DSH）支持通过插件扩展功能。在管理 OpenCode Go 和 Zen 等模型时，动态获取最新的模型列表、代币费率、协议支持以及零费率限制是常见需求。dsh-opencode-go 插件旨在解决这些问题，它为 DSH 提供了 Live OpenCode Go 和 Zen 目录，包括当前代币费率、零费率过滤器、协议选择和会话亲和性头部。

功能定位¶

该插件属于“模型推理”类别，由 gosomea 维护。它通过公共提供商 API，将 OpenCode Go 和 Zen 的模型目录集成到 DSH 中。

核心功能¶

插件主要提供以下能力：

Live OpenCode Go and Zen catalogs：获取最新的模型列表。
Token rates：显示当前费率（输入、输出、缓存读/写）。
Zero-rate filters：支持零费率过滤。
Protocol selection：允许选择协议。
Session affinity headers：通过 HTTP 头部处理会话亲和性。
KV Cache effect：利用会话亲和性支持 KV 缓存。

安装与配置¶

1. 构建与打包¶

在项目源码目录下执行以下命令进行构建和打包：

npm run build
npm pack

2. 安装插件¶

使用构建生成的 tarball 文件安装插件：

dsh plugin --profile web add /absolute/path/foreveryu-dsh-opencode-go-0.1.2.tgz

3. 配置提供者¶

安装后，需要在 DSH 配置中设置 API Key 环境变量。配置示例如下：

opencode-go.providers: {
  opencode-go: {
    apiKeyEnv: OPENCODE_GO_API_KEY
  }
}

使用方法¶

打开 Settings → Models → OpenCode Go / Zen。
可以手动刷新、按模型 ID/名称搜索，或启用零费率过滤器。
配置完成后，提供者的模型会自动出现在列表中。

技术细节与注意事项¶

API 端点：Go 和 Zen 使用不同的 /models 列表，分别位于 /inference/go/v1 和 /inference/v1 端点。
数据来源：HTTP 传输、流式、工具、图像和推理转换均使用 DSH 的 PiAiAdapter。
缓存位置：缓存文件位于 $DSH_HOME/plugins/dsh-opencode-go/catalog-v1.json，该文件仅包含公共元数据。
休眠状态：未配置的插件处于休眠状态，不会生效。

系统要求与限制：

DSH 版本：支持 DeepSeek Harness 0.2.0-rc.2 和 0.2.1-alpha.3。
Node 版本：Node.js 版本必须满足 ^22.19 || >=24。
包名差异：该项目的未限定范围 npm 名称（dsh-opencode-go）属于不同作者，项目仅发布于 @foreveryu/dsh-opencode-go 下。
迁移审查：自定义提供商端点或协议覆盖需要在迁移前进行审查。
技能依赖：刷新、修复和迁移功能需要对应的技能支持（位于 $DSH_HOME/skills/dsh-opencode-go）。
输入限制：插件仅支持 DSH 的文本和图像输入。

总结¶

dsh-opencode-go 通过提供实时目录和过滤能力，简化了 OpenCode Go 和 Zen 模型的管理。有关更多细节，请参阅GitHub 仓库。