dsh-opencode-go

dsh-opencode-go

English · 常见问题 · 高级指南 · 开发与测试

为 DeepSeek Harness (DSH) 量身打造的 OpenCode Go 专属接入与多账号管理插件。

DSH 原生支持接入 OpenCode Go，但原生模式无法满足复杂的生产与日常开发需求（如多账号无感容灾、会话级 Prompt 缓存绑定、会话内实时额度透视等）。本插件基于 Cordis 微内核架构，在提供完整模型协议转换的同时，带来了流畅的客户端 UI 与企业级容灾体验。

文档中的现有界面截图展示 Classic 主题；默认的 Native 主题会跟随当前 DSH 的颜色、字体与几何 token。 ✨ 核心特性 🆓 双路由动态模型目录（Free 默认为关闭的 opt-in）：Go 与平台免费模型分别从各自网关的 /models 发现，保留同名模型；平台免费通道（Free）默认关闭，需在 设置 → OpenCode Go → 高级设置 → 免费通道 显式开启后才注册路由、拉取目录并出现在模型选择器中；两套模型开关与容量设置独立。 🛑 免费通道限流保护：遵循上游 Retry-After，冷却期间暂停新请求；共享免费额度或 IP 限制不会触发 Go 换号。 🛡️ 多账号无感容灾：支持最多 20 个账号集中管理与拖拽排序。当主账号额度耗尽或 Key 失效时，在输出前自动尝试备用账号，成功后自动扶正，告别“聊到一半额度没了”的打断感。 ⚡ 会话级 Prompt 缓存绑定：严格遵循网关协议注入专有 x-opencode-session 路由头，稳定复用网关上下文缓存，显著降低响应首字延迟。 📊 会话内额度实时透视：在聊天输入框旁常驻“用量胶囊”，直观展示 5 小时滚动、每周、每月的额度百分比及重置时间倒计时；支持休眠节能与静默刷新。 💰 官方历史用量看板：按所选 Key 的工作区汇总官方每日 CSV，查看请求、Token、官方用量金额与模型明细，包含其他客户端的调用。 🎛️ 模型与热配置：无需重启 DSH！随时在线调整模型上下文窗口、最大输出上限、思考预算（Thinking Budget），并支持 HTTP/HTTPS/SOCKS5 代理。 🚀 快速开始

适用于 DSH 0.2.1-rc.5 及以上版本；开发与验证方式见开发说明。 1. 安装插件 方式 A：在 DSH 界面中一键安装（推荐） 1. 打开 DSH，进入 插件 → 添加插件。 2. 输入 dsh-opencode-go（或填入仓库地址 https://github.com/Duskriver/dsh-opencode-go），点击 安装。 3. 安装完成后点击 立即启用。

方式 B：命令行安装 *命令行安装后请重启 dsh web。Headless 用户请使用 --profile headless。* 2. 配置与使用 1. 打开 设置 → OpenCode Go → 账号，点击添加，填写账号名称与 OpenCode Go API Key 后确认。 2. 在任意会话的模型选择器中，选择 DSH OpenCode Go 目录下的模型。 3. 开始对话，输入区右下角即可看到实时的用量胶囊。 💡 深度功能与运行机制 1. 多账号管理与无感容灾（Auto-failover）

在 设置 → OpenCode Go → 账号 中集中管理你的所有账号： 拖拽排序即优先级：列表第一项为当前主账号；鼠标拖拽左侧手柄调整顺序，这个顺序也是自动尝试备用账号的优先次序。 出词前无感切换：开启“自动使用备用账号”后，若当前账号在发出请求后遇到了 401/403 鉴权失败、429 限流或 Quota 额度耗尽： 插件会在开始向你输出文字前，静默挑出下一个备用账号重新发送请求。 成功出词的备用账号会自动移至首位成为新主账号，并在会话面板给出切换提示。 *防御机制*：若模型已经开始吐字或已产生计费，插件不会切换，避免拼接乱码或重复扣费。 防雪崩冷却黑名单：被网关拒绝的 Key 会进入 5 分钟的内存冷却名单，避免短时间内反复向已失效的账号发起无意义的重试。 凭据安全隔离：Key 直接存储至 DSH 底层凭据系统，前端界面永远不会回显明文密钥。 2. 会话内订阅额度透视（UsagePill）

在聊天输入区旁，常驻有直观的“用量胶囊”。点击即可展开完整的用量卡片： 三窗口精准监控： 🟢 5 小时滚动配额：短周期高频使用的健康度。 🟡 每周配额：本周累计使用进度。 🔴 每月配额：月度套餐消耗百分比。 每个窗口均显示精确的重置倒计时；进度条会随着接近上限变黄，耗尽时变红。 节能与防抖机制：默认每分钟静默刷新；当页面切入后台或浏览器最小化时自动暂停轮询，切换回前台时即时刷新。 账号全名与快速切换：多账号时直接显示当前账号全名（名字过长以省略号截断），展开面板点击“切换”即可直接提拔目标账号为主账号。 显示模式（在 高级设置 → 额度显示 中配置）： 自动（默认）：仅在使用 DSH OpenCode Go 模型时显示。 常驻：切换到其他厂商模型时，仍然保持胶囊显示。 关闭：隐藏胶囊并停止后台用量轮询。 3. 官方历史用量看板（Analytics）

从对话输入框的用量胶囊展开面板，或侧栏的看板按钮打开：

窄屏浅色预览 · 模型排行与明细预览（均为示例数据） 官方 CSV 单一来源：请求、输入 / 输出 / 缓存 Token、官方用量金额、每日图表与模型明细来自同一份官方每日 CSV；provider + model 区分同名模型。支持今日、7 / 30 / 90 天，日期统一使用 UTC。 独立查看账号：默认当前调用账号，只查看所选 Key 所属工作区，包含其他客户端；切换查看账号不改变对话账号。看板的三个额度窗口跟随所选账号。匿名 Free 覆盖不作保证。 官方用量金额：直接汇总 cost_micro_cents（1 美元 = 1 亿单位），不等同于 Go 额外扣款。官方日汇总可能延迟。 双主题统一界面：设置页、用量胶囊、侧栏与看板共用布局，通过 appearanceTheme 选择 DSH Native（默认） 或 OpenCode Go Classic，并跟随宿主明暗模式；主题差异见分组高级设置。宽屏弹窗、窄屏全屏，保留 Token 堆叠或请求日柱图、模型排行与明细。 按需查询：打开、切账号、切区间或手动刷新时查询，Host 短缓存 30 秒，强制刷新绕过缓存，不后台轮询历史。仅官方模型网关支持历史查询；错误明确显示，不回退本地扫描。

Key 留在 Host；常规报告只向浏览器传递聚合数字与 provider / model / day。用户主动下载的官方 CSV 可包含成员字段。完整口径见用量统计说明。 4. 免费通道（Free，默认关闭的 opt-in）

DSH OpenCode Free 不是默认能力：为避免误用与合规风险，它默认关闭。需要时在 设置 → OpenCode Go → 高级设置 → 免费通道 打开开关并保存（或配置 freeEnabled: true）。关闭状态下插件不注册 dsh-opencode-free 路由、不请求 freeBaseURL 的模型目录，也不会在设置页的模型目录与模型发现中暴露 Free 模型；关闭开关并保存后该路由会撤回，进行中的请求允许完成。Go 通道与账号逻辑不受影响。