前言¶
DeepSeek Harness（DSH）支持通過插件擴展功能，但目前官方未提供直接查看餘額和平臺用量的入口。在使用過程中，若要掌握賬戶狀態和成本消耗，通常需要離開 DSH 或依賴外部工具。dsh-deepseek-monitor 插件將 DeepSeek 平臺的餘額與用量監控能力移植進 DSH，集成在設置卡片和輸入工具行中，方便在開發過程中實時掌握資源情況。
這是什麼¶
dsh-deepseek-monitor 是 DeepSeek Harness 的 Web 插件，由 HaoyueQin 維護。它將 DeepSeek 平臺的監控能力引入 DSH 界面，解決用戶在開發過程中無法直觀查看餘額和 Token 消耗的問題。插件基於 MIT 許可證發佈。
核心功能¶
設置集成
插件集成到「設置 → 模型 → DeepSeek」供應商卡片中。卡片內包含「賬戶明細」按鈕，點擊後展開面板顯示詳細信息。
輸入框實時餘額
在輸入框工具行（模型名稱左側）顯示實時餘額。餘額芯片會根據數值顏色變化（綠色爲正，紅色爲負），並支持在設置中開關顯示。
賬戶明細麪板
展開面板包含以下內容：
- 餘額卡：顯示今日消耗、本月費用及低餘額警示。
- 模型用量行：列出各模型的官方產品名，包含進度條、緩存命中率、費用等數據。
- 每日堆疊柱狀圖：展示每日用量分佈，支持月份切換。
平臺 Token 配置
提供兩種獲取 Token 的方式：
1. 一鍵複製控制台抓取腳本，在平臺頁粘貼運行。
2. 手動在瀏覽器控制台（F12）粘貼獲取。
配置前會進行接口驗活，保存後憑據僅寫入不回顯。
設置選項
支持配置輸入框餘額顯示開關、自動刷新間隔（最小 60 秒）、低餘額提醒閾值，以及重載或清除緩存。
安裝與啓用¶
使用官方安裝命令將插件添加到指定配置文件。
dsh plugin --profile <name> add dsh-deepseek-monitor@latest
典型用法¶
- 安裝插件後，進入「設置 → 模型 → DeepSeek」。
- 點擊「賬戶明細」按鈕，查看餘額卡和模型用量行。
- 在輸入框左側查看實時餘額，或使用設置中的 Token 配置功能。
適用場景與注意¶
本插件適用於需要頻繁監控 DeepSeek API 使用情況、成本控制和資源規劃的 DSH 用戶。
注意：
- 插件不存儲 API Key，所有解析均通過 dsh 憑據縫完成，不上屏、不入日誌。
- 平臺 Token 經 fenced 路由寫入（write-only），任何接口不回顯。
- 抓取腳本純本地運行，不向第三方發送數據。
- 偏好與緩存持久化存儲於 storage-domain deepseek_monitor。
短結尾¶
dsh-deepseek-monitor 爲 DSH 用戶提供了無需離開界面即可查看餘額和用量的能力。所有數據交互均遵循本地化和安全原則，適合需要精細化成本控制的開發者使用。
