前言¶
DeepSeek Harness（DSH）Web Client 是一個基於插件架構的客戶端。在進行長對話、批量測試或監控資源消耗時，開發者需要實時掌握當前會話的上下文窗口占用率以及賬戶餘額。@achasoft/dsh-usage-info 插件通過在會話頭部提供一個按鈕，將上下文可視化與賬戶餘額讀取集成在 Web 界面中，解決了手動查詢和估算成本的問題。
這是什麼¶
這是一個爲 DeepSeek Harness Web Client 設計的插件，用於顯示上下文佔用率和賬戶餘額。它包含一個會話頭部的讀出按鈕、一個餘額讀取能力接口（Seam），以及一個 DeepSeek 提供商。該插件由 navid-kianfar 維護，遵循 MIT 許可證。
核心功能¶
插件主要提供以下功能：
- 頭部讀出：在會話頭部的工具欄中顯示一個按鈕。該按鈕會顯示上下文佔用率的環形圖，以及賬戶餘額的首個貨幣單位。在數據未加載前顯示儀表盤圖標；無法讀取餘額時顯示琥珀色圓點；餘額低於或等於閾值時按鈕變紅。
- 上下文可視化：顯示上下文百分比、已用/窗口令牌數（
~used / window），並通過彩色條形圖展示系統提示詞、工具定義和對話部分的佔比（估算值）。 - 會話成本計算：根據配置費率計算會話成本，包含總令牌數，以及按桶分類的成本（未緩存輸入、緩存寫入、緩存讀取、輸出）。在首次計費前，令牌數顯示爲“—”。
- 餘額讀取：支持通過宿主機 API 密鑰讀取 DeepSeek 提供商的餘額，無需將密鑰暴露給瀏覽器。
- 設置卡片：在插件配置中提供開關，控制各部分顯示、刷新間隔（秒）、低餘額閾值、成本貨幣和費率。
安裝與啓用¶
安裝該插件到 web 配置文件（dsh web 啓動的配置）：
dsh plugin --profile web add @achasoft/dsh-usage-info
安裝完成後，重啓 dsh web 即可加載插件。
典型用法¶
- 啓用餘額讀取：在
dsh web中啓用內置的 DeepSeek 提供商，這是讀取餘額的前提。 - 查看面板：點擊會話頭部的按鈕打開使用情況面板，查看上下文和成本。點擊面板外部或按
Escape鍵關閉。 - 配置設置：進入 Settings > Plugins > Plugin configuration，展開 Usage information。在此處調整刷新間隔、低餘額閾值或費率。
適用場景與注意¶
- 版本要求：必須使用 DeepSeek Harness Web Client 版本
0.1.5-rc.2。 - 運行環境：需要 Node.js 版本
^22.19或>=24，且 PATH 中需包含pnpm。 - 餘額讀取限制：餘額讀取功能依賴宿主機端的 API 密鑰。OpenAI 兼容網關通常不提供餘額端點（返回 404），此時插件會停止輪詢。同一時間只能掛載一個提供者。
- 自動保存：設置卡片沒有保存按鈕，任何開關或文本字段在輸入有效值後即自動保存；刷新間隔在失焦或回車時保存。
- 源碼審查：安裝前應檢查源碼與許可證，因爲插件以當前 DSH 進程的權限運行。
短結尾¶
該插件爲 DeepSeek Harness Web Client 提供了直觀的上下文監控與成本追蹤能力。通過宿主機讀取餘額的設計，確保了 API 密鑰的安全性。更多細節與源碼請訪問 GitHub 倉庫。
