前言¶
DeepSeek Harness 的 dsh web 可以通過插件擴展界面能力。dsh-credits 是其中用於額度與消耗展示的插件，主要解決三類問題：當前賬戶額度是否可用、當前會話大約花了多少、一段時間內累計花了多少。它把這些信息集中在 dsh web 輸入框下方和右下角累計膠囊中展示。
這是什麼¶
dsh-credits 由 Gaq152 維護，許可證爲 MIT。它按供應商展示內置套餐、餘額或自定義 HTTP 額度，並提供模型計價、本會話估算與累計消耗。當前版本爲 0.3.0。
核心功能¶
- 在輸入框下方顯示賬戶額度與本會話估算消耗。
- 右下角顯示可拖動的累計消耗膠囊。
- 顯示賬戶額度狀態燈，支持 DeepSeek 官方餘額或 OpenCode Go 訂閱用量。
- 跟隨當前對話模型供應商展示額度。
- 顯示即時生成吞吐 TPS。
- 按模型單價估算本會話消耗，並支持峯谷價。
- 支持今天、昨天、本週、本月或自定義時間範圍內的跨會話累計消耗估算。
- 提供設置卡片：展示、額度查詢、閾值與刷新、模型單價、YAML 導出。
- 按 DSH 供應商獨立配置額度來源：內置模板、複用另一供應商額度、自定義 HTTP 接口。
- 支持 YAML 導出到當前 profile 的
cordis.patch.yml。 - 兼容
dsh-credits 0.3.0與dsh 0.1.1-rc.1的新版會話投影接口，並保留舊版投影接口兼容。
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add dsh-credits
安裝後重啓 dsh web。
本地開發時使用本目錄絕對路徑：
dsh plugin --profile web add <本目錄絕對路徑>
升級時先移除舊版本，再清理 pnpm store 並安裝 latest：
dsh plugin --profile web remove dsh-credits
pnpm store prune
dsh plugin --profile web add dsh-credits@latest
卸載：
dsh plugin --profile web remove dsh-credits
如果從 dsh-balance 遷移，先移除舊插件：
dsh plugin --profile web remove dsh-balance
然後刪除 profile 本地目錄，以及 cordis.patch.yml 中給 dsh-balance 寫的 disabled: true。
配置與額度來源¶
配置可以覆蓋 $DSH_HOME/profiles/web/cordis.patch.yml，也可以在設置 → 額度中按卡片保存。設置頁保存後會立即更新當前 dsh web 進程。若要讓額度綁定在服務重啓後保留，需要從 YAML 導出卡片複製配置到當前 profile 的 cordis.patch.yml。
額度來源按 DSH 供應商獨立配置。providerQuotas 的 providerId 必須與 DSH 供應商列表中的實際 ID 一致。未配置或已關閉的供應商不顯示額度；本會話消耗與 TPS 仍可顯示。
支持三種來源：內置模板、複用另一供應商額度、自定義 HTTP 接口。OpenCode Go 多賬號時，可爲不同 providerId 分別綁定 templateId: opencode-go，並分別保存 Key。OpenCode Go 密鑰解析順序爲：
opencodeApiKey → OPENCODE_GO_API_KEY → ~/.local/share/opencode/auth.json
自定義 HTTP 額度¶
自定義 HTTP 額度需要填寫 URL、憑證、鑑權方式和字段映射，並使用「測試並讀取字段」驗證。直接填寫的 Token 或 Cookie 保存到 DSH credentials，不寫入導出的普通配置。頁面只顯示「已設置」，可輸入新值覆蓋。附加請求頭中的 Cookie、Authorization、Token、API Key 等敏感字段會脫敏。
硅基流動不再提供內置餘額模板。需要時給對應 DSH 供應商選擇自定義 HTTP 接口。
舊配置兼容¶
舊版 quotaMode、provider、quotaSources 等字段仍會兼容讀取，但新配置不建議繼續使用。新配置以按供應商綁定的額度來源爲主。
適用場景與注意¶
適合在 dsh web 中查看 DeepSeek 官方餘額、OpenCode Go 訂閱用量、本會話估算消耗、即時 TPS 和跨會話累計消耗。也適合多個供應商或多個 OpenCode Go 賬號分別顯示各自額度。
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 許可證爲
MIT，源碼倉庫爲 GitHub。 - 自定義 HTTP 額度依賴外部接口和憑證，需要自行維護 URL、鑑權、字段映射與憑證有效性。
- 敏感憑證不要寫入普通配置；頁面保存時會按插件規則處理。
結尾¶
dsh-credits 的價值，是把賬戶額度、本會話估算和跨會話累計消耗放到同一個 dsh web 界面中，減少手工覈對。
鏈接¶
- GitHub: https://github.com/Gaq152/dsh-credits
- 目錄頁：已覈實資料未包含目錄頁頁面內容，未給出具體 URL；可按
dsh-credits在社區目錄檢索。
