dsh-opencode-go

English

在 DeepSeek Harness 中使用 OpenCode Go 订阅模型，支持流式回复、思考模式、工具调用和图片输入。插件自动同步模型列表与容量信息，并提供多账号管理、订阅用量显示和网络代理设置。

适用于 DSH 0.1.5-rc.1 及以上版本。

安装兼容性已覆盖十个宿主版本，从 0.1.5-rc.1 到 0.2.1-alpha.1，具体版本见兼容矩阵。后续宿主版本仍需验证；目前会明确拒绝 developer 消息、动态工具增删和延迟工具加载。

安装

在 DSH 中安装

1. 打开 插件 → 添加插件。
2. 输入 dsh-opencode-go，点击 安装。
3. 安装完成后点击 立即启用。

也可以在添加插件时输入 Git 仓库地址：

https://github.com/Duskriver/dsh-opencode-go

命令行安装

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

安装后启动或重启 dsh web。Web 和 Headless 使用各自的 profile，分别安装和更新。

开始使用

1. 打开 设置 → OpenCode Go，填入 API Key 并保存，或在「账号」中添加账号。
2. 在会话模型选择器中选择 DSH OpenCode Go 下的模型。
3. 开始对话；支持思考的模型可选择其提供的思考档位，支持图片的模型可直接接收图片。

在设置页刷新模型列表即可同步最新目录。每个模型旁的开关控制它是否出现在选择器中，修改后立即生效。模型的上下文窗口和最大输出默认使用目录配置，也可逐个修改并保存。

思考选项中的 默认 使用服务商设置；Off 明确关闭思考。只有开关的模型显示 On / Off，支持强度的模型显示其可用档位，预算式模型显示具体的 token 数值。

预算式模型提供 1,024 / 2,048 / 8,192 / 16,384 tokens 等常用选项。在设置页选择模型，展开“思考预算”，输入数值、点击“添加”并保存，即可在会话中选择自定义预算。可用范围随模型而定；SDK 会根据剩余输出空间缩小实际预算。

插件跟随 DSH 的界面语言，支持中文和英文。

查看订阅用量

点击会话输入区旁的用量胶囊，查看当前账号的 5 小时、周和月用量及重置时间。用量每分钟刷新，也可手动刷新。

在 高级设置 → 额度显示 中选择：

• 自动：使用本插件的模型时显示，默认选项。
• 常驻：使用其他模型时也显示。
• 关闭：隐藏用量显示并停止轮询。

管理多个账号

在「账号」中添加、重命名或更换 Key，展开账号行可查看详细用量。拖动行首手柄调整顺序，第一行成为当前账号。

开启 自动切换 后，当前账号额度耗尽或 Key 不可用时，插件会在开始输出前按列表顺序尝试其他账号。也可以在用量胶囊中点击 切换，直接选择后续请求使用的账号。

新增或删除账号中途关闭页面、断开连接时，宿主会在后续启动或设置、凭据更新时继续恢复。未能写入 Key 的新增账号会保留在列表，可补填 Key 或删除；恢复不会覆盖期间手动选择的当前账号。

高级用法

Headless 模式

安装插件：

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

将以下内容保存为 headless.patch.yml：

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

在 Bash 或 Zsh 中输入 Key 后运行任务：

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

将 model 换成设置页中可用的模型 ID。示例文件见 examples/headless.patch.yml。

网络代理

在 设置 → OpenCode Go → 高级设置 → 代理地址 中填写并保存，例如：

http://127.0.0.1:7890
socks5://127.0.0.1:1080

支持 HTTP、HTTPS、SOCKS5 和带用户名、密码的代理 URL。保存后，后续对话、模型目录更新和用量查询使用新代理。代理运行在 DSH 所在的机器上；远程部署中的 127.0.0.1 指服务器自身。

手动配置

在 高级设置 → DeepSeek V4.1 Flash 协议 中可选择 Responses（实验性） 并保存，便于比较同一模型的不同协议。默认 自动 跟随模型目录；改回自动即可恢复。选择只影响新请求，不会切换已准备或正在执行的调用，也不会在协议错误后自动改用另一协议。

目前仅支持 deepseek-v4.1-flash 的 Responses 覆盖，沿用当前账号、代理、会话标识与用量处理。issue #45 报告了更低延迟，但它不是网关的稳定性能承诺，也不能据此确认底层服务商；是否更快请以自己的测试为准。无需覆盖时省略以下配置：

- id: opencode-go
  config:
    protocolOverrides:
      deepseek-v4.1-flash: openai-responses

将该模型的值设为 null 会明确选择自动，即使继承的配置启用了 Responses；设置页的「恢复默认」会移除当前层覆盖，恢复继承值。其他模型或协议组合会被拒绝。

在 patch 文件中添加 opencode-go 配置块，可与上面的默认模型配置一起使用：

- id: opencode-go
  config:
    apiKeyEnv: OPENCODE_API_KEY
    accounts:
      - id: primary
        name: 主账号
        apiKeyEnv: OPENCODE_API_KEY
      - id: backup
        name: 备用账号
        apiKeyEnv: OPENCODE_GO_BACKUP_KEY
    autoSwitch: true
    proxyURL: http://127.0.0.1:7890
    refreshMinutes: 60
    modelVisibility:
      deepseek-v4-pro: false
    modelLimits:
      deepseek-v4.1-flash:
        maxTokens: 8192
      qwen3.7-plus:
        thinkingBudgets: [4096, 6000]
    maxImages: 30

按需保留配置项，并通过 DSH 凭据服务或环境变量提供对应的 Key。apiKeyEnv 选择当前账号，accounts 的顺序决定自动切换顺序。

| 配置项 | 用途 | | --- | --- | | baseURL | OpenCode Go 网关地址，默认 https://opencode.ai/zen/go/v1 | | usageDisplay | 额度显示模式：auto、always 或 off | | proxyURL | 网络代理；空字符串使用默认网络设置 | | refreshMinutes | 模型目录缓存时长，默认 60 分钟；设置页可随时手动刷新 | | modelVisibility | 按模型 ID 控制选择器中的显示状态 | | protocolOverrides | 实验性协议覆盖；目前仅支持 deepseek-v4.1-flash: openai-responses，省略或模型值为 null 时自动跟随目录 | | modelLimits | 按模型覆盖 contextWindow、maxTokens，或用 thinkingBudgets 添加思考预算选项；空值使用默认设置 | | maxImages | 单次请求历史中的图片数量上限，默认不设上限；超过时先卸载最旧图片 | | streamIdleTimeoutMs | 等待下一个流事件的最长时间，默认 300000 毫秒 | | requestPreparationTimeoutMs | 目录查询及每次尝试的凭据、图片准备时限，默认 60000 毫秒 | | requestTimeoutMs | 一次发送的完整时限，包含目录查询、账号切换和流式输出，默认 1800000 毫秒；预先准备的调用从发送时计时 |

图片卸载会保留原始附件，并将请求中的旧图片替换为文字占位；调高上限不会自动恢复已卸载的历史图片。

图片数量超限会在读取附件前返回卸载请求；图片准备在同一插件模块内共享四个执行名额和最多 32 个等待名额，精确字节超限时停止安排剩余图片。正在发送的图片请求共享 128 MiB 的已准备原始数据与 base64 预算；这不是进程总内存上限。排队或共享预算超限会返回 IMAGE_RESOURCE_BUSY，可在其他请求结束后重试。数量与字节限制可能需要宿主分次卸载后重试。

首次查询目录失败会报告 DISCOVERY_FAILED；已有目录时保留之前确认过的模型。网关明确返回空列表才会清空目录。列表中仅部分行格式错误时，仍可使用有效模型，设置页与日志会提示被忽略的行数。高级表单的普通配置项一次提交并检查版本；凭据由独立服务保存，凭据保存失败时保留其草稿，重试只提交未成功的部分。

导出错误诊断

需要排查请求失败时，在启动 DSH 前设置诊断目录：

export DSH_OPENCODE_GO_DEBUG_DIR=/tmp/dsh-opencode-go-debug
dsh web

Windows PowerShell：

$env:DSH_OPENCODE_GO_DEBUG_DIR = "$env:TEMP\dsh-opencode-go-debug"
dsh web

复现后，错误信息会给出 JSON 文件路径。记录包含模型、请求参数摘要、HTTP 状态、上游日志与路由编号及错误响应，便于提交 问题反馈。分享前检查服务返回的错误内容；清空环境变量并重启 DSH 即可关闭诊断。

DSH debug 日志另有每次发送的调用编号，以及各次尝试的阶段耗时、HTTP 状态、上游请求编号、首次输出等待时间与错误码，包含 HTTP 200 后的流中断；图片请求还记录排队累计等待与资源占用峰值。错误文件带有相同调用编号与尝试序号，便于关联排查。这些摘要不记录提示词、Key、代理地址或原始会话编号。

更新与卸载

更新到 npm 最新版本：

dsh plugin --profile web update dsh-opencode-go --latest

更新后重启 dsh web 并刷新页面；桌面版完全退出后重新打开。Headless 用户将 web 换成 headless。

卸载：

dsh plugin --profile web remove dsh-opencode-go

从 0.1.16 及更早版本升级时，在旧会话或 Agent 预设中重新选择 DSH OpenCode Go；手动配置使用 provider: dsh-opencode-go。

更多

• 开发与测试
• 验证记录
• 问题与建议
• MIT 许可证