前言¶
DeepSeek Harness (DSH) 採用插件化架構，所有功能模塊均通過插件實現。在開發智能體或使用火山方舟的 Coding Plan / Agent Plan 時，實時監控額度消耗是必要的環節。dsh-ark-quota 插件旨在解決在 DSH Web GUI 中持久化查看火山方舟用量的問題，通過懸浮窗和後臺刷新機制，提供直觀的用量概覽。
插件簡介¶
dsh-ark-quota 是一個運行在 DSH Web 端的本地插件，由用戶 zpliao123 維護。它通過讀取火山引擎的 IAM 訪問密鑰，調用 OpenAPI 獲取用量數據，並將結果持久化存儲在本地配置文件中。
核心功能¶
該插件提供以下核心能力：
- 右側懸浮窗：在頁面右側提供一個可開關的懸浮窗（
shell.overlay）。點擊展開後，根據選擇的 Plan 類型顯示不同的時間檔位：- Coding Plan：當前會話 / 近 1 周 / 近 1 月
- Agent Plan：近 5 小時 / 近 1 周 / 近 1 月
- 設置頁配置：在 DSH 設置頁中提供「火山方舟用量」選項。用戶需在此處填寫火山引擎的 AccessKey ID 和 Secret Access Key，並控制浮窗的顯示與隱藏，同時設置自動刷新的間隔。
- 定時自動刷新：插件通過 Host 後臺按設定間隔調用 OpenAPI 接口獲取數據，同時客戶端會每 30 秒進行一次同步，確保數據時效性。
- 本地持久化：所有敏感憑證（AK/SK）及配置項（浮窗開關、刷新間隔）均保存在
~/.dsh/dsh-ark-quota/config.json。重啓 DSH 後，配置自動加載，無需重複輸入。 - 模型工具支持：插件提供名爲
ark_coding_plan_usage的模型工具，可在對話中直接調用用量查詢。
安裝與啓用¶
由於未提供標準安裝命令行指令，需通過手動配置本地插件包的方式啓用：
- 將插件包解壓或克隆至 DSH 的 Web Profile 目錄下的
profiles/web/node_modules/dsh-ark-quota/。 - 編輯
profiles/web/cordis.patch.yml文件，在相應位置插入插件配置：
- insert:
- id: ark-quota
name: dsh-ark-quota
- 重啓 DSH Web（命令行執行
dsh web或使用桌面端應用），插件生效。
典型用法¶
- 初次配置：重啓 DSH 後，點擊頁面右側的懸浮窗或在設置頁的「火山方舟用量」中，填入火山引擎的 AccessKey ID 和 Secret Access Key。首次填入後，憑證將保存在本地。
- 工具調用：在 DSH 的對話中，可以直接調用模型工具
ark_coding_plan_usage獲取用量數據。
注意事項¶
- 憑證類型：此處填寫的憑證爲火山引擎「訪問控制(IAM) → 訪問密鑰」的 AccessKey，而非模型推理專用的 Ark API Key。
- 安全限制：插件通過本地 HTTP 接口與後臺通信，接口僅允許本機 loopback 訪問。Secret Access Key 永不下發至瀏覽器，僅在本地內存中使用。
結語¶
dsh-ark-quota 通過懸浮窗與配置頁結合的方式，爲 DSH 用戶提供了監控火山方舟用量的基礎能力。其憑證持久化和自動刷新機制降低了日常使用的維護成本。如需查看目錄或源碼，可訪問：插件目錄 | GitHub
