前言¶
在 DeepSeek Harness（DSH）裏同時接 DeepSeek 官方、第三方訂閱或本地 CLI 用量時，餘額和窗口往往分散在各自控制台或命令行裏。要判斷「還能用多久、哪邊先見底」，需要反覆切換頁面或手動查命令。下面介紹社區插件 dsh-quota-viewer：在 DSH Web 側邊欄底部集中展示多家提供方的額度與用量，並在本機保留約 90 天曆史供趨勢查看。
這是什麼¶
dsh-quota-viewer 由維護者 black970 發佈，分類爲客戶端插件，面向 web profile。它在側邊欄底部增加一行額度概覽（側邊欄收成圖標欄時變爲底部懸浮卡片），點擊可展開詳情；面板打開時每 10 分鐘自動刷新，也可手動點「更新」。插件以 MIT 許可證開源，當前 package 版本爲 1.0.0。
核心功能¶
概覽與詳情¶
展開詳情面板後，可按提供方分組查看：
- 已用 / 上限 / 剩餘 / 百分比
- 日額度、到期時間
- 按當前速度估算的可用天數
- 上次更新時間（相對時間，如「3 分鐘前」）
頂部一行彙總所有提供方狀態；提供方之間可切換，並可爲各家新增或保存各自的 token。每個提供方下方有天趨勢圖，數據來自本機歷史，可切換天數。
支持的提供方¶
| 提供方 | 數據來源 | 前置條件 |
|---|---|---|
| DeepSeek 官方 | 開放平臺餘額（platform.deepseek.com 的餘額接口） |
憑據服務裏能解析到 DEEPSEEK_API_KEY |
| jojo code | 登錄控制台後的訂閱窗口（時長窗口 / 日額度 / 到期時間） | 面板內用控制台郵箱 + 密碼登錄一次，會話過期自動續期 |
| SCNet 超算 | 控制台 Token Plan 用量 | 掃碼登錄或賬號密碼登錄；會話保活失敗會在面板裏提示 |
| 方舟 Coding Plan | 本機 arkcli usage plan --product coding-plan |
已安裝 arkcli 且已登錄火山賬號（Coding Plan 沒有僅憑 API Key 可調的用量接口） |
任何一家未配置好時，不會影響其他家：該行顯示「未配置 / 暫不可用」及所需步驟，其餘照常顯示。
數據與隱私¶
- 宿主半隻註冊迴環地址可用的 HTTP 路由（請求來源須爲
127.0.0.1/::1，且 Host 頭匹配本機），接口只返回總量與百分比，從不返回密鑰 - 密鑰解析走 DSH 憑據服務，按次請求解析；面板裏保存的 token 存在本機
- 歷史落在
~/.dsh/quota/history.db（SQLite）：同一提供方同一指標 10 分鐘內只留一條採樣，每個指標保留最近 90 天 - 插件無 npm 運行時依賴；出網請求僅發往上述服務的官方域名，無遙測
安裝與啓用¶
在 DSH 中爲 web profile 安裝插件：
dsh plugin --profile web add github:black970/dsh-quota-viewer
裝完後重啓或 reload DSH，側邊欄底部即出現額度行。
典型用法¶
- 展開 / 收起：點擊側邊欄底部額度行，打開或關閉詳情面板。
- DeepSeek 官方：在 DSH 憑據服務中配置可解析的
DEEPSEEK_API_KEY，無需在面板重複填密鑰即可查餘額（若面板支持 token 類提供方，也可在面板填入並保存，或切回憑據服務裏的值）。 - jojo code：在面板登錄區用控制台郵箱 + 密碼登錄；可勾選「設置長效登錄」，token 失效時自動重登。
- SCNet：在面板用掃碼或賬號密碼登錄；保活失敗時面板會提示。
- 方舟 Coding Plan：在本機安裝並登錄
arkcli後，插件通過arkcli usage plan --product coding-plan讀取用量。 - 趨勢圖：在詳情裏按提供方與指標（餘額 / 已用比例）查看本地歷史，並切換展示天數。
適用場景與注意¶
適合經常在 DSH Web 裏開發、且同時使用 DeepSeek 官方與 jojo、SCNet、方舟 Coding Plan 等用量窗口的開發者：一處看彙總與估算可用天數，減少切控制台的成本。
安裝前請注意：DSH 插件在當前 dsh 進程權限下運行，會訪問憑據服務、本機 SQLite 及部分提供方的登錄會話；建議在安裝前閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的環境與合規要求。社區目錄 SkillHub 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-quota-viewer 把 DeepSeek 官方餘額、jojo code、SCNet 與方舟 Coding Plan 的額度與用量收進 DSH 側邊欄，並用本機 90 天曆史畫趨勢。需要時可從目錄頁或倉庫安裝：
- 目錄頁：https://www.skillhub.cn/plugins/black970/dsh-quota-viewer
- GitHub：https://github.com/black970/dsh-quota-viewer
