@goodandready/dsh-opencode-provider

dsh plugin --profile web add @goodandready/dsh-opencode-provider

📦 @goodandready/dsh-opencode-provider

<div align="center">

<h3>面向 DeepSeek Harness 的 OpenCode Console 与 OpenCode Go 提供商插件</h3>

<p>

<a href="https://goodandready.app/"><img src="https://img.shields.io/badge/🌐_DSH_Hub-goodandready.app-ff4500.svg?style=for-the-badge&labelColor=1a1a2e" alt="GoodAndReady 插件展厅"></a>

<a href="https://www.npmjs.com/package/@goodandready/dsh-opencode-provider"><img src="https://img.shields.io/npm/v/@goodandready/dsh-opencode-provider?style=for-the-badge&color=crimson&logo=npm" alt="npm 版本"></a>

<a href="https://github.com/GooDAnDReaDY/dsh-opencode-provider/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="许可证"></a>

</p>

</div>

<table align="center">

<tr>

<td align="center">

⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。

<br><br>

🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。

</td>

</tr>

</table>

---

面向 DeepSeek Harness（dsh）的 OpenCode / OpenCode Go 提供商插件。

插件注册两个原生 LLM 路由：

路由 · 产品 / 方案 · 基础接口 · 特性说明

opencode-direct · OpenCode Console / Zen · https://opencode.ai/inference · 按量计费（pay-as-you-go）

opencode-go-direct · OpenCode Go / Go Plus · https://opencode.ai/inference/go · 订阅专属，含 5小时/每周/每月配额估算

密钥在每次调用时动态解析：在设置中或环境文件中更换凭据无需重启服务器即可立即生效。

-direct 后缀用于避免与内置 llm-pi-ai 已声明的 opencode / opencode-go 冲突。

重复 id 会触发 DUPLICATE_DIRECTORY，导致核心丢弃内置目录、其他提供商消失并禁用添加按钮。

旧会话继续使用内置路由；要使用本插件的账户、配额、回退和遥测，请选择

OpenCode (plugin) 或 OpenCode Go (plugin)。

架构示意

graph LR
    subgraph DSH["DeepSeek Harness 核心"]
        Agent["DSH 智能体 / 聊天"]
        Creds["凭据服务 / auth.json"]
    end

    subgraph Plugin["dsh-opencode-provider"]
        Router{"路由选择器"}
        Pool["多账户连接池<br/>(智能轮换与冷却)"]
        Heatmap["遥测与请求热力图<br/>(5小时 / 周 / 月)"]
        
        subgraph Transports["4 种底层传输协议 (Wire Transports)"]
            T1["OpenAI Chat"]
            T2["Anthropic Messages<br/>(Thinking Signatures)"]
            T3["OpenAI Responses"]
            T4["Google GenAI<br/>(thoughtSignature 重放)"]
        end
    end

    subgraph OpenCode["OpenCode 网关"]
        Console["opencode-direct (Console / Zen)"]
        Go["opencode-go-direct (Go / Go Plus)"]
    end

    Agent --> Router
    Creds -.-> Pool
    Router -->|opencode-direct| Pool
    Router -->|opencode-go-direct| Pool
    Pool --> Heatmap
    Pool --> Transports
    T1 & T2 & T3 & T4 --> Console & Go

功能全貌

• 4 种原生传输协议，按模型自动优选：
• OpenAI Chat Completions（DeepSeek、GLM、Kimi、MiMo、LongCat、Hy3、Step 等）。
• Anthropic Messages（Claude、MiniMax、Qwen）。
• OpenAI Responses（GPT、Grok、Muse）。
• Google Generative AI（Gemini）。
• 完整数据类型流式支持：文本、思考推理（reasoning）、流式工具调用（tool calls）、用量统计与 finish reasons。
• 多模态图像传输：通过持久化附件服务，按协议原生转换与传输；文件转为 DSH 确定性 handle 文本（由 harness 提供只读路径），不传 inline 字节。
• 工具结果中的图像在 Anthropic、OpenAI Responses 和 Google 中内联；OpenAI Chat 因消息格式限制保留文本占位符。
• 账户引导：Import all from auth.json 将所有 OpenCode 密钥导入独立 credential ref 并添加账户；Check all accounts 刷新每个账户的配额与健康状态。
• 协议特定元数据重放：
• Anthropic 思考签名（thinking signatures）。
• Google 历史函数调用中的 thoughtSignature。
• 多账户智能无缝轮换：
• 在生成流开始前，遇到 401/403/429 或配额用尽响应（400/402/403/429）自动重试下一个账户。
• 最多 20 个账户，支持拖拽调整优先级。无效密钥冷却 5 分钟，超额冷却 10 分钟（或遵循 Retry-After），速率限制冷却 60 秒。上次成功服务的账户会提升到首位并在重启后保留。
• 正在流式传输中的请求不会被打断，下一个请求会自动使用下一个可用密钥。
• 侧边栏配额卡片：Auto / Always / Off 模式；Auto 在存在 Go 用量时显示，Off 停止后台轮询。
• 多账户额度与健康监控：每行独立展示 5 小时、每周与每月使用情况，活跃账户驱动侧边栏与配额面板。
• 每账户预计可用时长：按各窗口的平均消耗速度估算耗尽时间，并标记在重置前最先耗尽的窗口；API 仅提供当前百分比与重置时间，因此为近似值。
• 模型 ➔ 账户路由规则：支持 Glob 通配符（如 free、deepseek-*）将模型优先绑定至特定账户，其他账户保留为备用。
• 按模型覆盖：可在设置中为每个模型修改上下文窗口和输出上限；0 表示该模型省略输出上限。
• 配额回退：在设置中选择免费模型；Go 返回配额错误时，同一请求通过 Console/Zen 重试一次。若回退也失败，返回原始配额错误。
• 会话粘性账户：同一会话优先使用上次成功的账户，并通过本地 sticky.json 跨重启保留（仅哈希后的 session id 和密钥指纹）；显式模型规则、固定账户和配额回退优先。
• 路由追踪：配额面板显示最近的账户/模型决策（rule、sticky、rotation、quota-fallback），不记录提示词或密钥。
• 按账户请求统计：请求日志记录 ok、latencyMs、ttftMs 和 error；热力图表格显示每个账户的请求数、错误数及平均延迟/TTFT。
• 本地时间请求热力图：星期×小时交互式热力图，排除系统心跳与重复记录，可按模型或账户过滤，仅保存 {at, provider, model, purpose, account, reason, ok, latencyMs, ttftMs, error} 元数据，不保存任何提示词与回复。
• 稳定的 x-opencode-session 标头：根据 DSH 会话 ID 派生，确保重试与连续对话复用相同的网关路由键。
• 实时模型目录：自动从 /v1/models 同步，并以 models.dev 生成文件作为回退。
• 代理：一个实时 proxyUrl 设置即可让推理、模型目录和额度检查走 HTTP、HTTPS 或 SOCKS5；地址变化前复用 dispatcher。proxyUsername 与凭据服务中的密码可为 HTTP 和 SOCKS5 启用 Basic 认证，密码不会返回浏览器。
• 路由开关：可独立启用或禁用 Console/Zen 与 Go/Go Plus 路由；禁用的路由会从选择器移除并拒绝请求，至少保留一个路由。
• Go 订阅额度估算：每月美元额度以及 5 小时、每周和每月的估算请求次数。
• /opencode 斜杠指令：快速查询状态、配额、账户、模型及执行联通性测试。
• TUI 设置：/settings → OpenCode 支持密钥、端点、allowlist、活动账户、回退模型、粘性路由和超时。
• Web UI 一键更新：设置页集成版本比对与一键热更新按钮。
• MCP 工具上限防护：在大规模 MCP 工具集达到 128 工具限制时，优先保留 DSH 核心系统工具。

安装指南

从源码构建与打包：

npm install
npm run build
npm pack

通过打包文件 (.tgz)安装：

dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.36.tgz
# DSH 桌面端：
dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.36.tgz

# 或从 npm 安装已发布版本：
dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.36

安装完成后重启 dsh 或 DSH 桌面端，在模型选择器中选择 OpenCode (plugin) 或 OpenCode Go (plugin) 即可。

配置示例

- id: llm-opencode
  name: "@goodandready/dsh-opencode-provider"
  config:
    apiKeyEnv: OPENCODE_API_KEY   # 环境变量或 DSH 凭据名
    # apiKey: oc_sk_...           # 仅本地调试，严禁提交代码库
    openCodeAuthEntry: opencode-go
    requestTimeoutMs: 300000
    streamIdleTimeoutMs: 300000
    visibleModels: []
    modelTransports: {}
    accounts:
      - label: Go #2
        apiKeyEnv: OPENCODE_API_KEY_2
    activeA

…(truncated)