前言¶
DeepSeek Harness (DSH) 采用插件化架构来扩展功能。在集成 OpenCode Go 模型时,手动维护模型列表和路由配置较为繁琐。dsh-llm-opencode-go-live 插件解决了这一问题,它从 Models.dev 实时同步 opencode-go 目录,注册独立的路由,并提供了设置卡片与订阅监控面板。
这是什么¶
这是一个为 DeepSeek Harness 提供的模型推理插件,由 SkylerFee 维护,采用 MIT 许可证。
该插件的核心职责包括:
* 从 Models.dev 读取 opencode-go 模型列表
* 注册独立的 opencode-go-live 路由
* 贡献其自己的 Models 设置卡片
* 使用 pi-ai 进行模型请求
核心功能¶
- 动态目录同步:插件会自动从 Models.dev 获取最新的模型列表。
- 独立路由:除了内置的
opencode-go路由外,该插件注册了专用的opencode-go-live路由,两者互不影响。 - 设置卡片:在 DSH 的设置页面中,该插件拥有独立的配置卡片,用于管理 API 密钥。
- 订阅监控面板:提供浮动面板显示 OpenCode Go 的订阅使用情况。该面板在鼠标悬停时展开,鼠标离开时折叠,且可通过开关控制显示。
- 请求处理:基于 pi-ai 服务处理模型请求。
安装与启用¶
插件需要 DeepSeek Harness 0.1.7-rc.1 或更新版本,以及 Node.js 22.19 或更新版本。
- 在 Web 配置文件下安装插件:
dsh plugin --profile web add @skylerfee/dsh-llm-opencode-go-live
- 安装并启用后,重启 Web 配置文件。
- 打开 设置 -> 模型。
- 点击插件拥有的 OpenCode Go (Live) 卡片中的 编辑。
- 输入您的 API 密钥并应用。
典型用法¶
在模型选择器中,进入 opencode-go-live 组别,选择一个模型即可发起请求。
DSH 会通过其凭证服务存储该密钥,默认引用为 OPENCODE_GO_LIVE_API_KEY。
依赖与注意事项¶
- 依赖项:
- 需要主机提供
@earendil-works/pi-ai^0.87.1。 - 需要 DeepSeek Harness 0.1.7-rc.1 或更新版本。
- 需要以下 peer 依赖:
@deepseek-ai/cordis~4.0.4 || ~4.0.5-alpha.1、@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-llm-pi-ai和@deepseek-ai/dsh-settings。
- 需要主机提供
- 运行状态:
- 目前仅已在 macOS 上验证。Linux 和 Windows 尚未运行。
- 行为细节:
- 刷新目录失败时,会保留最后一次成功的目录快照。
- 若没有目录,提供者可见但没有实时模型。
- 没有凭证的调用会返回
MISSING_CREDENTIAL。 - 可见的模型并不代表上游 API 已授权其请求。
- 数据源:主机在调用时会查询
https://opencode.ai/zen/go/v1/usage接口获取订阅数据。
总结¶
该插件通过自动化目录同步和独立的路由配置,简化了 OpenCode Go 模型在 DSH 中的接入流程。结合订阅监控面板,便于开发者追踪资源消耗。项目地址:GitHub