dsh-opencode-go-sub

dsh-opencode-go-sub

让 DeepSeek Harness 像 opencode 官方客户端一样，直接显示 OpenCode Go 订阅 + OpenCode Zen 免费档的完整模型目录。

服务端插件：注册 opencode-go（订阅）与 opencode-zen（免费）两个 provider 路由。

• 🧾 动态模型列表：listModels() 实时拉取 https://opencode.ai/zen/go/v1/models（公开端点，与 opencode 客户端 /models 同源），网关新增/下架模型会自动同步；端点不可达时回退到内置快照，列表永不为空。
• 🔑 零配置密钥（核心）：插件自动从 DeepSeek Harness 自身发现订阅 key，不依赖任何 cordis 服务注入——解析链： ① 环境变量 OPENCODE_GO_API_KEY / OPENCODE_ZEN_API_KEY / OPENCODE_API_KEY（与 DSH 凭证层同款优先级：env 优先）； ② ~/.dsh/.credentials.yaml（DSH 凭证文件，用户在 DSH 内填一次即可，无需安装 opencode 客户端、无需设置环境变量）； ③ dsh-api-key-pool 的 pool-config.json（pools.opencode-go / pools.opencode 下的 keys）。 插件启动时会在日志打印 key 来源（如 key resolved from dsh-credentials:OPENCODE_GO_API_KEY），便于确认。
• 🚦 错误原样透出：403（区域封锁、未开启 "Enable models hosted in China" 等）会把网关返回的原文显示在 GUI 里。
• 🔧 版本兼容：实现了新版 DSH 适配器接口（prepareCall），兼容 dsh-llm 0.1.0-rc.6 ~ 0.1.1-rc.x（新旧版本均可直接安装使用）。

安装

从 GitHub 安装：

dsh plugin --profile web add github:Yuanloss/dsh-opencode-go-sub

若从本地克隆目录安装：dsh plugin --profile web add file:/你克隆的目录/dsh-opencode-go-sub

重启 dsh web 后，模型选择器出现两个分组：OpenCode Go（订阅） 与 OpenCode Zen（免费）（模型以 opencode-go/<model>、opencode-zen/<model> 形式出现）。

配置密钥

只要在 DSH 里把 key 填过一次，插件就自动读取，不需要再手动编辑任何文件。

模型设置/凭证界面里填的 API key，会由 DSH 凭证服务写入 ~/.dsh/.credentials.yaml；插件直接读取这个文件（键名 OPENCODE_GO_API_KEY）。所以三种入口任选其一即可，殊途同归：

1. 在 DSH 界面里填（推荐）：在 DSH 的凭证/模型设置界面输入 key（等价于往 ~/.dsh/.credentials.yaml 写一行）：

   OPENCODE_GO_API_KEY: sk-你的Go订阅key
   

   key 在 opencode.ai 控制台 → 你的 workspace → OpenCode Go 页面复制。装了这个插件，只要在 DSH 里填过这一项就能直接用。
2. 环境变量（重启 dsh web 前设置）：

   OPENCODE_GO_API_KEY=sk-你的Go订阅key
   

3. 安装 dsh-api-key-pool 后，在其 pool-config.json 的 pools.opencode-go.keys 中配置。

解析优先级：环境变量 > ~/.dsh/.credentials.yaml > key pool。插件直接读凭证文件，不依赖任何 cordis 服务注入。启动日志会打印 key 来源（如 key resolved from dsh-credentials:OPENCODE_GO_API_KEY）。

⚠️ 重要（区分"配置密钥"和"添加 provider 路由"）：

• 配置密钥：在任何界面输入 key / 设置凭证，都可以，插件会自动读取。
• 添加 provider 路由：不要手动新增一个命名为 opencode-go 的自定义提供商模型 provider——插件已在内部注册 opencode-go（订阅）与 opencode-zen（免费）两个路由，再加同名的会触发 DUPLICATE_ADAPTER 冲突，可能导致插件加载失败。
• DSH 内置 pi-ai 自带同名目录项（最容易踩的坑）：DSH 自带的多提供方适配器 pi-ai 本身就内置了 id 为 opencode-go 的 provider（Models 设置页会把它当作"已安装 provider"提供一键启用）。若在 Models 页启用了它，会在 ~/.dsh/settings.yaml 的 llm-pi-ai.providers 下写入一条只有 apiKeyEnv 的 opencode-go——它与本插件的 opencode-go 路由重名。由于 llm-pi-ai 会把自己名下所有 provider（例如你添加的 Volcano Engine (Agent Plan)、硅基流动）整批一次性注册，只要其中出现已被本插件占用的 opencode-go，整批注册就会失败——表现就是模型选择器里看不到你添加的那些模型 provider。修复：在 Models 设置页删除那个同名的 opencode-go provider（或删除 settings.yaml 中 llm-pi-ai.providers.opencode-go 整段；保留 .credentials.yaml 里的 OPENCODE_GO_API_KEY 即可）。本插件启动时会自动扫描该冲突并打印删除指引，保存后 pi-ai 会自动重新注册，无需重启。
• 插件自带订阅 + 免费两组，无需手动添加。若确需接入其他第三方 OpenAI 兼容端点，请用别的路由名（如 ocgo、my-gateway）。

模型呈现（两个分组，有序 + 友好命名）

模型选择器里会以 provider 分组出现两组（与 opencode 官方客户端一致）：

• OpenCode Go（订阅）：订阅档 30 个模型，按厂商分组有序排列，并有中文友好命名与说明。
• OpenCode Zen（免费）：免费档 5 个模型（key=public，无需订阅），名称带「（免费）」标注。

订阅档列表会实时同步网关目录（/zen/go/v1/models），已收录的按内置目录顺序渲染，新出现的模型自动追加到组内末尾；端点不可达时回退内置快照。

已知限制

• gpt-5.6-luna / grok-4.5 走 Responses API：网关的 chat/completions 路由对它们恒 500 / "Endpoint is unavailable"，插件已自动把它们路由到 /v1/responses。二者由 OpenAI / xAI 托管，中国大陆区域会被上游拒绝（403 unsupported_country_region_territory）——需要走受支持区域的网络出口（VPN 需系统级 TUN 模式，浏览器级代理对 dsh web 进程无效）。
• qwen3.7-max 上游走 Anthropic /messages 方言，当前版本经 chat/completions 调用可能失败——可自行在 MESSAGES_ONLY 逻辑上扩展，或换用 qwen3.8-max / qwen3.7-plus。
• x-opencode-session 头（OpenCode Go 自 2026-09-05 强制）：网关要求每个推理请求带稳定的 per-conversation id，缺失即 400 MissingSessionID。插件自动读取 DSH agent-loop 注入的会话 id（GenerateOptions.sessionId，形如 session-<uuid>）并规整为裸 UUID 发送；非会话直连调用回退到进程级稳定 UUID，因此无需任何配置。若用 DSH 官方 pi-ai 路由接入 opencode-go（而非本插件），官方讨论 #5495 提供了 sessionHeader: x-opencode-session 的配置方案。
• 图片附件暂不转发（image block 会被忽略，与 dsh-opencode-zen 一致）；纯文本会话不受影响。
• 模型调用受订阅额度与上游区域限制：中国大陆访问 GPT / Grok 系列会 403；DeepSeek 新版需先在 opencode.ai 控制台开启 "Enable models hosted in China"。

DSH 版本兼容

适配器契约已在 dsh-llm 0.1.2-rc.1 与 0.1.5-rc.1 的真实注册表下实测通过：

npm test                  # 契约 + 冲突 + 会话头 + 真实注册表集成测试
node test-integration.mjs "<dsh-llm 包目录>"   # 指定候选版本回归

• 覆盖 registerAdapter（含 DUPLICATE_ADAPTER 语义）、listProviders、imageRequestPricing、listModels、prepareCall 五个真实调用路径。
• imageRequestPricing 必须实现：dsh-token-meter 的 measure() 会无条件调用它，而 dsh-compaction-basic 的 prepareCompaction() 会走到这里；继承 dsh-llm 抽象类的适配器自带默认实现，本插件零依赖、故显式补上（返回 undefined = 不声明图片计价）。缺失会抛 TypeError: adapter.imageRequestPricing is not a function，导致上下文压缩失败（v0.1.10 修复）。
• 升级 DSH 后建议先跑集成测试；出现 xxx is not a function 或 INVALID_* 即表示契约漂移，需按新版补实现。
• 注意：DSH 0.1.5-rc.1 自身尚未内置 x-opencode-session 修复，opencode-go 可正常使用依赖的是本插件的实现，而非 DSH 版本。

---

中文版 README · English README