dsh-usage-dash：DSH 側欄額度監控插件

前言¶

在智能體開發過程中，管理多個平臺的額度是常見痛點。頻繁切換至 OpenCode Go、火山引擎或 DeepSeek 官方平臺查看餘額會打斷工作流。DeepSeek Harness (DSH) 提供了插件化擴展能力，這款插件旨在解決上述問題，通過 Web 界面提供常駐的額度概覽。

是什麼¶

dsh-usage-dash 是一個 DSH Web 插件，作者爲 yanzoro926。它通過在 DSH 側欄底部展示各 Coding Plan 的剩餘百分比，幫助開發者快速掌握資源消耗情況。該插件支持 OpenCode Go、火山引擎 CodingPlan、DeepSeek 官方餘額及自定義套餐。

核心功能¶

側欄常駐徽章：在側欄底部顯示常駐徽章，兩行一組展示各套餐的剩餘百分比。當側欄摺疊時，顯示最緊張窗口的剩餘量。
詳情彈窗：點擊徽章後，上方浮出詳情卡片，展示進度條與重置倒計時。
預警機制：剩餘額度 ≤10% 時顯示紅色，≤40% 時顯示橙色。
自動刷新：每 60 秒自動刷新數據。
峯谷狀態：顯示 DeepSeek 官方峯谷狀態（閒時爲綠色圓點，忙時爲橙色圓點）。高峯時段爲北京時間 09:00-12:00 和 14:00-18:00。
多源支持：支持 OpenCode Go、火山引擎 CodingPlan、DeepSeek 官方 API 和自定義套餐。

安裝與啓用¶

安裝前需確保已安裝 DeepSeek Harness CLI (dsh)。

# 1. 安裝插件
dsh plugin --profile web add dsh-usage-dash

# 2. 重啓 DSH Web
#    在運行 dsh web 的終端按 Ctrl+C 停止，重新執行 dsh web
# 3. 瀏覽器硬刷新 (Ctrl+Shift+R)

配置與使用¶

OpenCode Go¶

無需額外配置。插件會自動讀取 ~/.local/share/opencode/auth.json 中的 Go key 進行調用。如需覆蓋，可在設置中手動填入。

火山引擎¶

推薦使用火山引擎 CLI 進行認證：

npm i -g @volcengine/cli
ve login
arkcli auth login

兜底方案是使用 arkcli auth login volc-sso。

DeepSeek 官方 API¶

在 DSH 設置中填入 DeepSeek API Key（可在 platform.deepseek.com/api_keys 創建）。

自定義套餐¶

在 設置 → 額度顯示 → 自定義套餐 中添加。插件會自動識別以下兩種 JSON 格式之一：

格式 A (OpenCode 風格):

    {
      "usage": {
        "rolling": { "percent": 4, "resetsAt": "..." },
        "weekly":  { "percent": 3, "resetsAt": "..." },
        "monthly": { "percent": 1, "resetsAt": "..." }
      }
    }

格式 B (扁平列表):

    {
      "windows": [
        { "label": "5h", "percent": 20, "resetAt": "..." },
        { "label": "weekly", "percent": 40, "resetAt": "..." }
      ]
    }

安全與限制¶

本地運行：插件僅接受 loopback Host（127.0.0.1 / localhost / [::1]）請求，並基於同源瀏覽器標記驗證，防止跨站攻擊（DNS rebinding 防護）。
數據安全：所有 Token 僅存儲在本地用戶目錄（0600 權限），數據完全屬於用戶自己。

總結¶

dsh-usage-dash 通過側欄常駐徽章和詳情卡片，爲 DSH Web 用戶提供了直觀的額度管理入口。結合 DeepSeek 官方峯谷狀態顯示，它能夠幫助開發者在不離開當前界面的情況下，快速掌握資源消耗與充值狀態。

GitHub 倉庫: https://github.com/yanzoro926/dsh-usage-dash
社區目錄: https://www.skillhub.cn/plugins/yanzoro926/dsh-usage-dash