前言¶
DeepSeek Harness（DSH）採用插件化架構，旨在通過模塊化擴展提升開發效率。在智能體開發場景中，開發者常面臨兩個痛點：一是缺乏官方的用量/賬單/日誌查詢接口，導致成本控制困難；二是需要頻繁切換頁面查看餘額。
dsh-deepseek-console 是一個爲 DSH Web GUI 打造的 DeepSeek 賬戶控制台插件。它通過 DeepSeek 官方 GET /user/balance 接口同步餘額，並在本地監聽 llm/stream 事件統計 Token 與費用，最終以一個全局懸浮球的形式展示在界面右下角。
核心功能¶
該插件提供以下能力：
- 實時餘額監控：直連官方接口，分離顯示現金餘額與贈送餘額，支持 5 秒緩存與強制刷新。
- 本地用量統計：由於官方未提供用量 API，插件通過監聽本地任務流，按任務和按日累計 Token、費用及緩存命中情況。
- 全局懸浮 HUD：右下角常駐可拖拽懸浮球（
● DS ¥xx.xx），實時顯示當前任務費用與餘額摘要。懸停展開詳情，點擊跳轉控制台。 - 預算與成本保護：支持設置每日消費硬限制（超限拒絕新調用）、預算告警（HUD 標註）與成本保護（超限自動降級低成本模型）。
- 財務推算：基於歷史數據推算餘額可用天數與消費速度。
- 可視化圖表：提供 SVG 折線圖展示消費趨勢（今日/7天/30天）及模型消費佔比。
- 請求日誌與診斷：統一請求日誌存儲在本地 SQLite 數據庫，支持按狀態、模型篩選；提供 API 健康診斷功能（成功率/錯誤分類）。
- Agent 工具：內置
deepseek_usage_report工具，允許 Agent 在會話中直接查詢餘額與用量。 - 模型管理：展示官方模型清單（上下文/價格）及本地啓用/禁用開關。
- 安全與隔離：Key 僅存於本機後端憑證庫，瀏覽器端僅見脫敏字符串；後端使用
subprocess + curl直連，無第三方 SDK 依賴。
安裝與啓用¶
通過 DSH CLI 安裝該插件：
dsh plugin --profile web add @hzjjxc/dsh-deepseek-console
安裝完成後，重啓 dsh web 進程。插件會自動加載，右下角將出現懸浮球，並在「設置 → DeepSeek」中生成控制台入口。
使用方法¶
- 查看餘額與費用：
- 移動鼠標至右下角懸浮球，查看當前餘額、本次任務費用及預算狀態。
- 點擊懸浮球打開控制台，在「概覽」頁查看詳細的消費趨勢與餘額變化歷史。
- 配置預算與限制：
- 進入「設置 → DeepSeek → 高級設置」，配置每日消費硬限制或預算告警閾值。
- 開啓硬限制後，當日估算費用達到上限將拒絕新的 DeepSeek 調用。
- Agent 會話查詢：
- 在 Agent 會話中，直接詢問餘額或用量，模型將自動調用
deepseek_usage_report工具返回結果。
- 在 Agent 會話中，直接詢問餘額或用量，模型將自動調用
技術細節與安全¶
- 數據來源：餘額數據來自官方 API，用量與費用數據完全由本地統計生成。由於官方未提供相關接口，本插件數據與官方賬單可能存在細微差異（如價格檔位）。
- Key 安全：API Key 僅存儲於宿主進程的憑證庫
~/.dsh/.credentials.yaml中。所有 POST 寫操作（保存配置、刷新等）均校驗 Origin，防止跨站 CSRF 攻擊導致 Key 外泄。 - 存儲：請求日誌持久化在
~/.dsh/storages/deepseek_requests.db，數據不足時不顯示財務推算。
總結¶
dsh-deepseek-console 解決了 DSH 環境下 DeepSeek 賬戶管理的痛點，將官方餘額查詢與本地用量統計集成到一個統一的控制台與 HUD 中，幫助開發者實現精細化的成本控制與監控。
