前言¶
DeepSeek Harness 的插件生態允許開發者擴展 Web UI 的功能。對於同時使用 Claude Code 的用戶，在 DSH 的 Web 界面中實時監控 Anthropic 的配額限制是一個常見需求。現有的 DSH UI 沒有內置此功能，dsh-claude-usage 插件通過在設置行右側添加一個使用環，解決了這一問題。
簡介¶
該插件由 leonardoxr 維護，是一個爲 DeepSeek Harness Web UI 提供的 Anthropic Claude 計劃使用指標指示器。它保持了標準設置齒輪和標籤的外觀，並在右側添加了一個上下文儀表盤風格的使用環。該環包含 Anthropic 標誌，並在鼠標懸停或鍵盤聚焦時打開詳細的配額面板。
核心功能¶
- 原生外觀：使用與對話上下文儀表盤相同的 28px 幾何形狀和 DSH 設計令牌，確保視覺一致性。
- 完整配額詳情：顯示 Claude 計劃限制的完整信息，包括 5 小時會話窗口、每週窗口、模型範圍的每週限制、額外使用狀態、計劃層級和速率限制層級。
- 輪詢與緩存策略：默認每 5 分鐘輪詢一次，可通過 bundle 行配置。支持 250ms 防抖的懸停刷新，一次只發送一個請求。插件尊重 Anthropic 的
Retry-After冷卻機制，並在臨時失敗時回退到“最後良好”數據。 - 安全與隱私：插件通過 Loopback API 路由讀取 OAuth 訪問令牌，並進行嚴格規範化。它僅執行只讀訪問，從不存儲、傳輸、記錄或刷新令牌。
安裝與啓用¶
安裝前請確保環境滿足以下要求：
- Node.js 20 或更新版本
- pnpm 10
- DeepSeek Harness 0.1.1-rc.2 或兼容版本
- Claude Code CLI 已登錄（claude login）
在插件目錄下執行以下命令以添加到 Web 配置文件：
dsh plugin --profile web add .
安裝後，在 DSH 的 Web UI 中導航至 Settings → Plugins → Claude usage 即可看到該插件已生效。
配置說明¶
在 Settings → Plugins → Claude usage 中，可以配置以下四個參數。這些更改在點擊保存前僅本地生效，保存後通過 DSH 設置持久化，並即時應用到當前 Web 窗口。
| 配置項 | 默認值 | 說明 |
|---|---|---|
| refreshIntervalMs | 300000 | 後臺輪詢間隔，最小 60 秒。 |
| hoverRefreshMinAgeMs | 30000 | 懸停刷新的最小間隔，最小 5 秒。 |
| requestTimeoutMs | 15000 | 每個 Anthropic 使用請求的超時時間。 |
| credentialsFile | (空) | 可選的 Claude Code 憑據文件絕對路徑，留空則使用系統默認位置。 |
工作原理¶
- Host 插件：注入 DSH 的 webServer 服務，並註冊
GET /api/plugins/claude-usage路由。 - 憑證讀取：每次請求時，Host 進程以只讀方式查找 Claude Code 的 OAuth 訪問令牌。
- 數據獲取：調用 Anthropic 的 OAuth 使用端點（與 Claude Code 的
/usage命令後端相同），使用oauth-2025-04-20beta 頭。 - 數據規範化：嚴格規範器僅返回配額相關數據（百分比、ISO 重置時間、額外使用標誌）。
- 客戶端渲染：瀏覽器註冊獨立動作，在設置行右側預留空間，不干擾內置設置按鈕。
適用場景與注意¶
- 操作系統：目前僅支持 Windows 或 Linux。macOS 的憑據存儲在 Keychain 中，暫不支持。
- 權限要求：插件以當前 DSH 進程權限運行，讀取
~/.claude/.credentials.json。請確保對源碼和許可證保持關注。 - 只讀安全：該插件僅用於查看配額，不會觸發令牌刷新或破壞現有的登錄狀態。
總結¶
dsh-claude-usage 爲 DeepSeek Harness 用戶提供了原生的 Claude 配額監控能力。它通過精心的緩存策略和嚴格的 Loopback 機制，在不影響系統安全的前提下提供了實用的配額信息。更多細節請參考 GitHub 倉庫 或 SkillHub 目錄。
