dsh-usage-meter：DeepSeek Harness 側邊欄常駐用量儀表

DeepSeek Harness（DSH）採用插件化架構，開發者在調試或長時間運行會話時，往往需要頻繁查看上下文窗口占用率和賬號餘額。手動進入設置頁面會打斷工作流。下面介紹一個插件，它在 DSH 側邊欄底部常駐一個儀表，提供常駐的用量與餘額顯示。

kxdyh/dsh-usage-meter 是由開發者 kxdyh 維護的客戶端插件。它通過讀取官方接口數據，在 DSH 側邊欄底部提供常駐的用量與餘額儀表，無需打開設置頁面即可實時掌握上下文佔用率和剩餘額度。

核心功能¶

1. 常駐側邊欄顯示：儀表位於側邊欄底部，支持深色/淺色主題自適應。
2. 餘額讀取：直接讀取官方賬號接口餘額，精確到小數點後 7 位，不進行四捨五入估算。
3. 上下文追蹤：實時顯示上下文窗口占用率、已用與上限 token 數量。進度條在佔用率 70% 變爲琥珀色，90% 變爲紅色。
4. 零額外請求：不輪詢模型，不發送額外請求，僅利用宿主已有的會話數據。
5. 收起適配：側邊欄收起爲 56px 導軌時，儀表自動變爲緊湊環形指示器。

安裝與啓用¶

使用 dsh CLI 安裝：

dsh plugin --profile <你的 profile> add github:kxdyh/dsh-usage-meter

安裝完成後無需重啓，側邊欄底部會立刻出現儀表。

典型用法¶

1. 安裝後，儀表會自動出現在側邊欄底部，默認顯示上下文佔用率和餘額。
2. 點擊儀表區域可展開明細，查看輸入/輸出/緩存讀取/寫入的 token 詳情。
3. 展開後點擊刷新按鈕（↻）可立即更新余額與用量，平時每 60 秒自動更新一次。
4. 若要查看餘額，需在 DSH 設置中登錄 DeepSeek 賬號。

適用場景與注意¶

本插件依賴 dsh 桌面版或 Web 版。查看餘額需先在 DSH 設置中登錄 DeepSeek 賬號，插件僅讀取餘額，不發起登錄或上傳憑據。

• Token 數據：僅在會話產生模型用量後才顯示。
• 費用顯示：不顯示費用，也不進行費用估算。
• 側邊欄收起：收起時儀表會切換爲環形指示器，懸停可查看數值。

該插件通過常駐儀表和精確讀取官方數據，解決了開發者頻繁查看用量和餘額的需求，適合需要精細化控制上下文窗口和預算的開發者。