前言¶
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' 拒絕跟隨重定向，憑據不會轉發到其他來源，也絕不發給瀏覽器。
