dsh-usage：DeepSeek Harness 用量與額度監控面板

DeepSeek Harness (DSH) 插件系統允許用戶擴展功能。dsh-usage 插件在 DSH 設置面板中增加了一個「用量」區塊，用於監控 token 消耗和 API 額度。它由用戶 linanbuan 維護，基於 MIT 協議開源。

核心功能¶

該面板主要解決智能體開發與使用中的成本監控問題，提供以下能力：

• 用量明細：展示當日與累計的 token 用量、緩存命中，以及輸入/輸出/緩存寫入/計費次數的詳細分解。
• 歷史日曆：提供月曆視圖，每天通過兩根按比例的長度條展示總用量與緩存命中。點選某天可查看精確數字，支持翻月查看。
• API 額度監控：支持已接入的 API 額度查詢，包括已用比例與刷新時間。
• 性能與緩存：本地摺疊顯示用量（60 毫秒級），提供方額度併發獲取（90 秒新鮮度）。
• 隱私與健壯性：API 密鑰僅保留在 Host 側，瀏覽器只接收響應體。網絡讀取設置 20 秒超時，若超時或失敗會重試一次；若兩輪都失敗，保留上一輪的好數字並標註原因。

安裝與啓用¶

1. 前置條件：需先安裝 DeepSeek Harness 桌面端。
2. 安裝插件：將本目錄放到任意位置，執行以下命令安裝到指定 profile：

    dsh plugin --profile <你的 profile> add <本目錄的絕對路徑>

3. 生效：安裝後 Host 模塊需要重啓 Harness 才能生效，瀏覽器端通常由 HMR 立即更新。
4. 禁用：如需禁用，在 profile 自己的 cordis.patch.yml 中覆蓋配置：

    - id: usage-panel
      disabled: true

顯示細節¶

• 數值格式：用量數字以完整整數顯示，不做 K / M 等縮寫。
• CommandCode：僅顯示百分比，不顯示金額。
• OpenCode-Go：顯示窗口百分比與刷新時間。

自檢¶

運行以下命令可進行插件自檢，確保路由、斷言及配置均正常：

pnpm test
# 或
node test/selfcheck.mjs

許可與地址¶

本項目遵循 MIT 許可證。更多細節可參考：
* GitHub 倉庫
* 技能中心目錄