前言¶
DeepSeek Harness (DSH) 採用插件化架構，強調功能的模塊化與擴展性。在多模型或多賬號切換的開發與使用場景中，實時掌握當前 API 的餘額或流量使用情況是提升效率的關鍵。dsh-quota-cards 旨在解決這一痛點，通過在消息輸入框左側提供常駐的額度卡片，讓用戶無需離開聊天界面即可查看當前模型的額度狀態。
簡介¶
dsh-quota-cards 是一個 DSH 額度查詢插件。它在 composer 的左側（conversation.input.left）常駐一張額度卡片，該卡片會跟隨當前選中的模型自動切換內容，展示對應賬號的額度或流量。插件支持手動刷新（帶防抖）和按週期自動刷新。
核心功能¶
- 常駐額度卡片：位於 composer 左側（
conversation.input.left插槽）。 - DeepSeek 餘額展示：顯示賬戶餘額，包含總額及授予/充值詳情（通過 Tooltip 展示）。
- OpenCode Go 用量展示：顯示 5 小時（滾動）/每週/每月窗口的剩餘代幣使用量百分比。
- 跟隨模型切換：通過
session.modelsRPC 實時解析當前模型。ID 包含deepseek的顯示餘額卡片，opencode的顯示用量卡片，其他顯示佔位符。 - 手動刷新：點擊立即刷新，繞過緩存。具備 2 秒冷卻機制，冷卻期間或請求進行中時忽略點擊。
- 自動刷新：支持 1/5/10/30/60 分鐘間隔，每次獲取後重新安排下一次刷新。
安裝與啓用¶
插件依賴 DSH 已安裝運行 (dsh web) 及系統 PATH 中的 pnpm。
- 將插件解壓至本地目錄，例如
D:/plugins/dsh-quota-cards。 - 執行安裝命令將插件添加至 Web 配置文件：
dsh plugin --profile web add file:D:/plugins/dsh-quota-cards
- 重啓
dsh web。 - 打開設置，進入「額度查詢」頁面，確認憑證引用（默認爲
DEEPSEEK_API_KEY和OPENCODE_GO_API_KEY），並檢查密鑰是否存在。 - 返回聊天頁面，額度卡片將出現在 composer 左側。
典型用法¶
- 重啓
dsh web。 - 在設置中配置 API 密鑰。
- 在聊天界面切換模型（如從 DeepSeek 切換到 OpenCode Go），觀察左側卡片內容的自動變化。
注意事項¶
- 依賴項：主機服務依賴
settings,credentials,sessions,agentDefaultModel，可選webServer；客戶端服務依賴slots,connection，插槽包括conversation.input.left和settings.section。 - 提供者匹配：通過 ID 匹配。DeepSeek 官方 ID 爲
deepseek-official時顯示餘額卡片；OpenCode Go 常見 ID 爲opencode-go時顯示用量卡片。 - 安全性：密鑰通過
ctx.credentials.resolve()在主機端解析，瀏覽器僅接收只讀的查詢結果。設置寫入需要同源 POST 請求。 - 運行時依賴：無第三方運行時依賴，其
peerDependencies包括schemastery和@deepseek-ai系列包。
結語¶
該插件通過常駐 UI 和自動刷新機制，簡化了 DSH 用戶的額度管理流程。對於需要頻繁切換模型或管理多賬號的開發者，這是一個實用的工具。
