在 DeepSeek Harness (DSH) 的 Web 環境中，插件系統極大地擴展了功能邊界。DSH 的設計理念是“一切皆插件”，社區維護的獨立目錄與 DeepSeek 官方應用沒有直接隸屬關係，開發者可以據此構建定製化的工作流。
火山引擎的 Agent Plan 提供了公開的餘量查詢 API，但 Coding Plan 缺乏此類接口。控制台只能看到整體百分比，無法回溯單次請求或按模型拆分。本文介紹的 dsh-volcengine-usage 插件旨在解決這一問題，在 DSH 頁面提供可拖動的 Coding Plan 用量監控卡片。
插件介紹¶
該插件由用戶 helloworld1631 開發，當前狀態爲等待維護者審覈，尚未在官方目錄聲明爲已收錄。它是一個 MIT 許可的開源項目，專注於在 DSH Web 界面展示 Coding Plan 的額度消耗情況。
與社區中已有的 dsh-billing-balance 或 dsh-quota-panel 等通用插件不同，此插件保留了特定的窄場景需求：僅顯示火山 Coding Plan 的三個額度窗口（5 小時、每週、每月）。它使用控制台登錄態而非要求用戶配置 AK/SK，並提供一個簡單、可拖動的完整卡片。代價是 Cookie 可能過期，且接口可能隨控制台更新而變化。
核心功能¶
- 用量展示：在卡片上直觀展示 5 小時、每週和每月的用量百分比。
- 刷新機制：點擊右上角的
↻按鈕可立即刷新，卡片也會每 5 分鐘自動刷新。 - 交互與記憶：按住“火山 Coding Plan”標題欄即可拖動卡片，瀏覽器會保存卡片位置，刷新或重啓後仍會保留。
- 安全處理：Cookie 和 Web ID 僅在 DSH 服務端讀取，不會發送給瀏覽器端。
- 開發接口：服務端提供一個穩定的本機 JSON 接口，便於二次開發或集成。
安裝與啓用¶
在 DSH 插件目錄中添加該插件：
dsh plugin --profile web add github:helloworld1631/dsh-volcengine-usage
安裝完成後，重啓 DSH Web 服務：
dsh web
配置憑據¶
插件依賴 DSH 的 credentials 服務來解析憑據。你需要配置以下環境變量：
VOLCENGINE_COOKIE：完整的 Cookie 字符串VOLCENGINE_WEB_ID：Web ID
在 credentials-local (version 1) 中通常以 YAML 格式寫入：
version: 1
refs:
VOLCENGINE_COOKIE: "完整 Cookie"
VOLCENGINE_WEB_ID: "Web ID"
請使用 DSH 自帶的憑據管理能力或 YAML 序列化器寫入，不建議手工拼接長 Cookie。
使用方法¶
安裝並配置完成後，DSH 頁面會出現一個可拖動的用量卡片：
- 查看用量：卡片頂部顯示 5 小時、每週和每月的用量百分比。
- 手動刷新：點擊卡片右上角的
↻按鈕立即獲取最新數據。 - 自動刷新：卡片會每 5 分鐘自動更新一次。
- 移動卡片：按住標題欄拖動，位置會被瀏覽器本地記錄。
如果火山會話過期，更新本機憑據後重新刷新即可。
注意事項¶
- 接口穩定性：插件使用登錄後的控制台網頁 Cookie 調用控制台內部頁面請求，並非火山引擎承諾穩定的公開 Coding Plan API。接口可能變化，Cookie 可能過期。
- 憑據安全：本倉庫不包含、也不應提交任何 Cookie、API Key、Web ID 或
.credentials.yaml文件。服務端接口默認只接受本機環回連接，瀏覽器端無法讀取原始憑據。 - 插件狀態：請根據當前的審覈狀態和自身需求，選擇更合適的插件或自行維護。
生態鏈接¶
- 插件目錄：https://www.skillhub.cn/plugins/helloworld1631/dsh-volcengine-usage
- GitHub 倉庫：https://github.com/helloworld1631/dsh-volcengine-usage
