dsh-usage-widget：DSH 側邊欄用量監控

在使用 DeepSeek Harness（DSH）進行開發或調試時，頻繁切換頁面查看賬戶餘額或 Kimi Code 配額會打斷工作流。dsh-usage-widget 插件通過在左側欄底部提供一個常駐的緊湊型小部件，解決了這一痛點。

dsh-usage-widget 是一個 DSH 插件，由 AHui-Lab 維護。它將用量監控功能直接集成到 Web/Desktop 界面的左側欄底部，提供實時的賬戶狀態概覽。

核心功能¶

該插件在左側欄底部註冊了一個“用量”入口，具備以下特性：

• 數據展示：顯示 DeepSeek 賬戶餘額，以及 Kimi Code 配額（包含 5 小時窗口配額與每週配額）。
• 佈局與交互：始終可見於側邊欄底部。點擊條目可摺疊或展開，支持 DeepSeek 與 Kimi 的切換開關。
• 自動刷新：每 60 秒自動刷新數據。

安裝與啓用¶

插件支持通過 GitHub 倉庫或 npm 包安裝，安裝後需重啓 DSH。

# 通過 GitHub 倉庫安裝（推薦）
dsh plugin --profile <name> add github:AHui-Lab/dsh-usage-widget

# 通過 npm 包安裝
dsh plugin --profile <name> add dsh-usage-widget

重啓 DSH 後，在左側欄底部即可找到“用量”條目。

數據流與配置¶

由於瀏覽器存在 CORS 限制，無法直接調用 api.kimi.com，插件提供了兩種數據獲取路徑和對應的密鑰配置方式。

數據路徑¶

1. 主機路由模式（優先）：
   插件在主機 Web 服務器上註冊了 /usage-monitor/deepseek 和 /usage-monitor/kimi 路由。該路由通過上游 API 獲取數據，並優先使用客戶端發送的 Authorization 頭，否則回退到 DSH 憑據服務或環境變量。

2. 瀏覽器直接回退（備用）：
   當主機路由不可用時，插件嘗試在瀏覽器端直接請求上游。DeepSeek 支持 CORS，此模式有效；Kimi 在此模式下受 CORS 限制無法直接訪問。

API 密鑰配置¶

密鑰是按機器配置的，不會隨插件分發。

• 主機模式：
  在 ~/.dsh/.credentials.yaml 中設置以下環境變量：

  • DEEPSEEK_API_KEY
  • KIMI_CODING_API_KEY
    主機進程會讀取這些配置。

• 瀏覽器模式：
  打開插件面板，點擊齒輪圖標，將 API Key 和 Token 粘貼到面板中。這些密鑰僅保存在瀏覽器的 localStorage 中（前綴爲 usage-monitor.key.*），並僅用於上游請求。

開發與注意事項¶

• 無需構建：插件倉庫中已包含 lib/ 目錄（包含 index.js 和 client.js），安裝即用，無需執行構建步驟。
• 適用場景：適合需要在不離開 DSH 界面的情況下持續監控 API 用量的開發者。
• 社區插件：該插件爲社區維護項目，非 DeepSeek 官方插件。
• 依賴：需要 DSH Web/Desktop 配置文件，且插件針對瀏覽器客戶端設計。

生態與鏈接¶

DSH 的設計理念是“一切皆插件”，該插件屬於社區生態的一部分。若需查看源碼或提交問題，可訪問：

• GitHub 倉庫
• 社區目錄