dsh-account-glance：DSH Web GUI 側邊欄賬戶餘額與計費概覽

在 DeepSeek Harness (DSH) 的 Web GUI 中，賬戶餘額和計費週期通常隱藏在設置菜單的賬戶行中。開發者需要頻繁切換上下文來監控消耗和剩餘額度。dsh-account-glance 在側邊欄賬戶行上方提供了一個緊湊的預覽卡片，將關鍵信息集中展示，減少操作跳轉。

這是 faith372 維護的一個 DSH 客戶端插件。它是一個自包含的組件，直接在 Web 界面的側邊欄顯示 DeepSeek 賬戶餘額、當前高峯/非高峯計費倒計時以及今日的代幣消耗和調用次數。該插件不依賴其他插件，且不需要構建步驟。

核心功能¶

1. 賬戶餘額顯示：直接探查 DeepSeek 的 /user/balance 接口獲取餘額，並在鼠標懸停時顯示來源。
2. 高峯/非高峯倒計時：根據北京時間顯示當前計費週期，倒計時在最後一分鐘會切換爲秒級顯示。非高峯時段享受 50% 折扣。
3. 今日消耗統計：展示今日的消費金額、消耗代幣數和調用次數，並提供手動刷新按鈕。
4. 智能互操作：與 @linxin666/dsh-usage 互操作。如果已安裝該插件，此卡片會優先讀取其路由並自動隱藏 dsh-usage 自帶的預覽卡片，兩者保留各自的賬本記錄。
5. React 平臺注入：基於 React 平臺進行組件注入，適配 Web GUI 渲染。

安裝與啓用¶

安裝此插件需要 DSH 版本 0.2.0-rc.1 或更高版本。

1. 克隆倉庫代碼：

    git clone https://github.com/faith372/dsh-account-glance.git

2. 通過 CLI 添加插件：

    dsh plugin --profile desktop add link:./dsh-account-glance

3. 在 Web GUI 中啓用：
   點擊側邊欄的 Plugins 圖標，切換至 Installed 標籤，找到 dsh-account-glance，開啓對應的開關即可。

典型用法¶

• 計費週期判斷：
  • 高峯時段：週一至週五 09:00-12:00 和 14:00-18:00（原價）。
  • 非高峯時段：其他所有時間（含週末），享受 50% 折扣。
• 與 dsh-usage 共存：
  • 如果安裝了 @linxin666/dsh-usage，此插件會讀取其路由配置，並利用特定的 DOM 屬性（data-dsh-plugin 和 data-dsh-part）自動隱藏 dsh-usage 自帶的卡片，避免界面重複。
  • 兩者各自維護獨立的賬本，因此總金額可能存在細微差異。
• 數據刷新：
  • 點擊卡片上的刷新按鈕可強制重新探查餘額和今日數據。

適用場景與注意¶

• 數據範圍：餘額僅對 DeepSeek 官方路由顯示金額，其他路由（如兼容 DashScope 的第三方提供商）僅顯示令牌和調用次數，不顯示金額。
• 安全性：API 密鑰僅通過 loopback-only 路由傳輸，不會暴露給瀏覽器。
• 界面適配：當側邊欄摺疊至 56px rail 時，卡片會自動隱藏，以匹配 Shell 的摺疊狀態。
• 許可證：部分文件採用 MIT 許可證，部分文件（lib/host/* 和 lib/index.js）改編自 @linxin666/dsh-usage v0.4.4，採用 Apache-2.0 許可證。

通過在側邊欄提供實時的餘額和計費概覽，該插件減少了查看賬戶狀態的交互步驟。所有代碼自包含，遵循 MIT 和 Apache-2.0 許可證。更多信息請訪問 GitHub。