前言¶

DeepSeek Harness (DSH) 採用插件化架構，允許開發者擴展 Web 界面功能。在使用 DeepSeek API 進行開發或日常對話時，查看賬戶餘額、當日累計消費以及當前是否處於高峯計價時段往往需要切換頁面或刷新。dsh-balance-chart 是一個 DSH Web GUI 插件，它將賬戶餘額、當日消費和峯谷時段計價繪製在會話標題欄上的雙層圖表，提供零依賴的實時監控。

插件定位¶

名稱：dsh-balance-chart
維護者：fqsklm
協議：MIT
定位：DSH Web GUI 插件，用於在會話標題欄展示餘額、當日消費和峯谷時段計價的雙層圖表。採用零依賴設計，並以餘額差值優先記賬，更貼近真實扣費。

核心功能¶

• 餘額進度條：在標題欄顯示賬戶餘額，滿格金額可在設置中修改。
• 峯谷時段條：顯示 24 小時峯谷時段，支持點擊跳轉 DeepSeek 平臺用量頁。
• 每輪消耗柱狀圖：顯示每輪對話的餘額消耗，按當時計價時段着色。
• 當日累計折線：疊加在柱狀圖上，顯示今日累計消耗。
• 懸停詳情：鼠標懸停可查看某輪的詳細消耗數據（含時間、輪次、累計、tokens 拆分等）。
• 全屏視圖：點擊全屏圖標查看全天賬單明細表和每輪詳情。
• 摺疊：點擊摺疊成摘要條，節省空間，狀態會自動保存。
• 設置：支持修改價卡、峯谷時段、週末規則等，不涉及代碼修改。
• 自動貼到最新：卡片和全屏視圖自動滾動到最新數據，避免停留在歷史數據。

安裝與啓用¶

1. 克隆倉庫到本地目錄：

    git clone https://github.com/fqsklm/dsh-balance-chart.git
    cd dsh-balance-chart

2. 將插件添加到 DSH Web profile：

    dsh plugin --profile web add link:$PWD

3. 手動編輯配置文件以掛載插件。編輯 $DSH_HOME/profiles/web/cordis.patch.yml，在文件末尾添加以下內容：

    - insert:
        - id: balance-chart
          name: dsh-balance-chart

4. 回瀏覽器按 F5 刷新頁面，標題欄將顯示圖表。

使用方法¶

• 看一眼：標題欄展開時，第一行顯示峯谷條和今日消耗，下方是柱狀圖和餘額條。
• 懸停：鼠標移到柱狀圖上，查看某輪的詳細消耗數據。
• 跳轉平臺：點擊峯谷條任意位置，新標籤頁打開 DeepSeek 平臺用量頁。
• 摺疊：點擊 ▴ 摺疊成一行摘要，狀態會自動保存。
• 全屏：點擊 ⛶ 查看全天賬單明細表和每輪詳情。
• 設置：點擊 ⚙ 修改價卡或規則。

配置與數據¶

• 前置條件：DSH 憑據中必須包含 DEEPSEEK_API_KEY，否則餘額層將顯示不可用，但消耗換算仍可正常工作。
• 配置文件：位於 $DSH_HOME/.dsh-balance-chart.（需手動編輯 cordis.patch.yml 以掛載插件，數據文件默認保存在 DSH_HOME 目錄）。
• 記賬方式：默認採用餘額差值優先記賬，更貼近真實扣費。

結語¶

該插件通過零依賴的設計，解決了在 DSH 界面中無法直觀查看餘額、消費和峯谷計價的問題。安裝後，圖表會自動跟隨對話更新，無需切換窗口。

• GitHub 倉庫
• 插件目錄