前言¶
DeepSeek Harness（DSH）是面向智能体开发的工具。在实际开发中，开发者常需在切换模型时确认当前提供方的配额情况，例如 OpenCode Go 的订阅限额或 DeepSeek 的预充值余额，并希望结合本机 token 用量估算消费金额。dsh-opencode-go-quota 插件通过右下角常驻胶囊解决这一问题，无需跳转页面即可查看状态。
核心功能¶
右下角常驻一枚静态胶囊「余额」。点击展开后立即按当前选择的模型提供方拉取并显示限额/余额。插件支持两种类型的数据展示：
1. plan 型提供方（如 OpenCode Go）：显示限额与进度。
2. tokens 型提供方（如 deepseek-official）：显示余额与消费估算。
消费金额由定价表 × 本机 token 用量估算。卡片默认折叠，每次展开重新请求。任一 plan 窗口达到 rate-limited 时卡片内以红色提示「已达限额」。
安装与启用¶
从 GitHub 安装源码：
git clone https://github.com/zer0zio-stack/dsh-opencode-go-quota.git
dsh plugin --profile web add .\dsh-opencode-go-quota
本地开发：
dsh plugin --profile web add .
安装完成后重启 dsh web（插件清单在启动时读取，正在运行的实例不会热加载新插件）。
配置与提供方¶
安装时 cordis.patch.yml 插入一行，内置适配器。提供方配置如下：
| 提供方 | kind | 数据源 | 凭据 |
|---|---|---|---|
opencode-go |
plan |
https://opencode.ai/zen/go/v1/usage |
OPENCODE_GO_API_KEY |
deepseek |
tokens |
https://api.deepseek.com/user/balance |
DEEPSEEK_API_KEY |
deepseek-official |
tokens |
https://api.deepseek.com/user/balance |
DEEPSEEK_API_KEY |
DeepSeek V4 定价已按用户提供的 deepseek_markdown_20260815_c4af7f.md 内置在代码中，支持高峰/空闲时段区分。需要覆盖定价时，可在 profile 的 cordis.patch.yml 按 id: opencode-go-quota 覆盖整行配置并重写 providers.<id>.pricing。
工作原理与限制¶
仅适用于 web profile；headless 中该行因缺少 webServer 保持 pending。
限额与余额是 API 原值；消费金额是定价表 × 本机 token 用量的估算，不含折扣、税费、跨币种差异或插件启动前已删除的会话日志。token 用量按 Host 本地时区分桶；高峰/空闲时段也按事件发生时的 Host 本地小时判定。
API key 只在本进程内解析，redirect: 'error' 拒绝跟随重定向，凭据不会转发到其他来源，也绝不发给浏览器。
