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 中安装
- 打开 插件 → 添加插件。
- 输入
dsh-opencode-go，点击 安装。 - 安装完成后点击 立即启用。
也可以在添加插件时输入 Git 仓库地址：
https://github.com/Duskriver/dsh-opencode-go
命令行安装
dsh plugin --profile web add dsh-opencode-go
安装后启动或重启 dsh web。Web 和 Headless 使用各自的 profile，分别安装和更新。
开始使用
- 打开 设置 → OpenCode Go，填入 API Key 并保存，或在「账号」中添加账号。
- 在会话模型选择器中选择 DSH OpenCode Go 下的模型。
- 开始对话；支持思考的模型可选择其提供的思考档位，支持图片的模型可直接接收图片。
在设置页刷新模型列表即可同步最新目录。每个模型旁的开关控制它是否出现在选择器中，修改后立即生效。模型的上下文窗口和最大输出默认使用目录配置，也可逐个修改并保存。
思考选项中的 默认 使用服务商设置；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 许可证
