在 DeepSeek Harness (DSH) 的開發流程中，實時監控上下文窗口使用情況和跟蹤會話成本是常見需求。dsh-context-dashboard 側邊欄插件爲此提供了一個輕量級解決方案，將關鍵指標整合到工作流界面中。
是什麼¶
這是一個駐留在 DSH 側邊欄底部的儀表盤插件。它通過一個摺疊式的面板，展示當前會話的上下文使用情況、花費統計以及賬戶餘額。插件由 lcohvne-tomorin 維護，遵循 MIT 協議。
插件會根據當前配置的 LLM 渠道，自動切換按量付費和 Token 套餐兩種計費模式的顯示邏輯，並支持動態枚舉渠道與模型。
核心功能¶
- 實時上下文環：在摺疊態下顯示上下文佔用的百分比與具體數值（如 128K/1M），點擊可展開爲完整面板。
- 雙模式支持：支持按量付費（paygo）和 Token 套餐兩種計費模式，面板會根據當前渠道自動切換展示內容。
- 動態枚舉：渠道與模型清單通過 DSH 的模型選擇器動態獲取，新增模型可直接錄入。
- 價格目錄集成：內置 DeepSeek 官方模型的價格目錄，包含高峯/空閒邏輯；其他模型顯示爲估算。
- 本地歷史存儲：使用本地存儲記錄滾動、每週、每月的用量歷史。
- 自定義覆蓋：支持在設置中通過“價格覆蓋表”自定義單位價格。
- 雙語界面：UI 自動跟隨主題，支持中英文切換。
安裝與啓用¶
安裝此插件需要使用完整的 commit hash 版本。
pnpm dsh plugin --profile <profile> add github:lcohvne-tomorin/dsh-context-dashboard#4fdf5f4109132fe10496dc8785c15d7e31786c5e
使用方法¶
- 展開面板：點擊側邊欄底部的“藥丸”形狀區域（包含環形指示和數字），即可展開完整的儀表盤面板。
- 模式切換：面板會根據當前選中的 LLM 渠道，自動在按量付費和 Token 套餐視圖間切換。
- 刷新余額：面板右上角提供刷新按鈕，可強制重新檢查賬戶餘額。
- 測試模擬：在環境變量中設置
DSH_CD_BALANCE_MOCK=1，可以驅動模擬餘額數據進行測試。 - 自定義價格：在設置頁面的“單價覆蓋表”中，可以錄入新模型的自定義單位價格。
注意事項¶
- 網絡請求：插件僅對白名單內的渠道（如 api.deepseek.com, dashscope.aliyuncs.com）發起餘額查詢請求，不進行實時價格抓取。
- 文件訪問：插件會寫入
$DSH_HOME/storages/dsh-context-dashboard/目錄（包含配置、歷史記錄和摺疊狀態文件）。 - 憑據安全：插件讀取憑據僅用於生成 Authorization 頭，不落盤、不記錄日誌、不顯示在界面上。
- UI 注入：插件通過注入
sidebar.footer.action和settings.section槽位來顯示界面，卸載時會自動移除。 - 數據隱私：所有用量歷史均爲本地存儲，不向任何第三方上報。
- 依賴要求：需要 Node.js 版本大於等於 22。
總結¶
dsh-context-dashboard 是一個專注於本地數據統計與界面展示的插件，適合需要在開發過程中實時掌握上下文消耗和成本的 DSH 用戶。其核心價值在於無需跳轉頁面即可獲取會話狀態與餘額信息，同時保持了較高的數據隱私性。
