前言¶
DeepSeek Harness（DSH）採用插件化架構，旨在將功能擴展與核心解耦。在使用火山方舟（Volcano Ark）Coding Plan 訂閱時，開發者通常需要在多個模型路由和賬號間切換，同時需要實時監控各週期的剩餘額度。手動查詢既耗時又容易遺漏。dsh-ark-quota 插件將額度監控與 DSH 的會話路由能力結合，在側欄提供直觀的用量展示與預測。
插件簡介¶
dsh-ark-quota 是一個由 lordqyxz 維護的 DSH 插件。它的核心作用是在 DeepSeek Harness 的側欄顯示火山方舟訂閱套餐的剩餘額度。插件通過計算滑窗水位動力學和指數加權最小二乘擬合，提供“燃燒節奏”與耗盡預測，並支持隨當前會話模型自動切換關聯的火山賬號。
核心功能¶
- 側欄展示與摺疊膠囊
插件在側欄底部生成卡片或摺疊膠囊，展示 5 小時、近 1 周和近 1 月的用量條與重置倒計時。最緊急的檔位會常駐在摺疊膠囊上，懸停即可查看全部信息。 - 燃燒節奏與耗盡預測
針對 5 小時檔位，使用滑窗水位動力學計算淨增速；針對周/月檔位，使用額度進度除以時間進度的平均節奏。插件使用指數加權最小二乘擬合最近燃燒速率，並將預測段直接繪製在進度條上。快照數據通過storageDomain落盤，可跨重啓保留。 - 自動切換賬號
卡片身份取自 DSH 的llm provider路由。當你在會話中切換模型時，卡片會自動切到對應火山賬號的額度信息。你也可以手動固定某一路由。 - 多賬號管理
插件支持多賬號。它會按路由保存密鑰並自動建組；如果多個路由填寫同一對 AK/SK，系統會自動合併爲一個賬號。當未訂閱 Coding Plan 時，會自動回落調用 Agent Plan 的GetAFPUsage接口。 - 設置頁熱加載
在 DSH 設置頁的「方舟額度」分區，可以修改 AK/SK。保存後配置即時生效，無需重啓。
安裝與啓用¶
插件遵循 MIT 協議。安裝方式如下：
命令行安裝：
dsh plugin --profile <profile> add https://github.com/lordqyxz/dsh-ark-quota
設置頁安裝：
進入 DSH 設置頁 → 插件 → 安裝，填入：
https://github.com/lordqyxz/dsh-ark-quota
安裝完成後，進入「設置」→「方舟額度」分區，選擇對應的模型路由，粘貼 AK/SK 並保存。側欄底部將出現卡片。
典型用法¶
- 在「設置」→「方舟額度」中選擇你要監控的模型路由。
- 粘貼該路由對應的火山方舟 AK/SK。
- 保存設置。
- 在 DSH 中創建會話並切換模型，觀察側欄卡片是否隨模型自動切換。
若需在本地校驗密鑰（不經過瀏覽器環境），可使用：
ARK_AK=… ARK_SK=… node tools/check.mjs
注意事項與要求¶
- 版本要求：需要 DeepSeek Harness 的
dsh web環境，版本需爲 0.2.0-rc.1 或 0.2.0-rc.2。 - 賬號要求：需擁有火山方舟的訂閱及一對有效的 API 訪問密鑰（AK/SK）。
- 安全提醒：AK/SK 是真實憑據。插件在 schema 中將密鑰聲明爲
role('secret')，設置界面只寫不讀。請勿將密鑰提交至 Git 倉庫或發送給他人。
結語¶
dsh-ark-quota 通過側欄小組件和算法預測，簡化了火山方舟訂閱額度的管理流程。它解決了多模型路由下的賬號切換與額度監控問題，適合需要頻繁調用不同模型且對成本敏感的開發者。
- 項目主頁：https://github.com/lordqyxz/dsh-ark-quota
- 生態目錄：https://www.skillhub.cn/plugins/lordqyxz/dsh-ark-quota
