dsh-monitor：DeepSeek Harness 會話計費與用量查詢插件

DeepSeek Harness（DSH）的核心理念是“一切皆插件”。在使用過程中，會話的實時費用和不同模型提供方的配額狀態是常見的痛點。dsh-monitor 插件旨在解決這兩個問題：提供精確的會話費用角標，以及按模型提供方配置的用量查詢面板。

核心功能¶

• 會話費用角標：在會話頭部實時顯示成本，包含輸入、緩存命中、緩存未命中和輸出的 Token 詳情，刷新後依然準確。
• 按提供方用量面板：點擊模型切換器旁的儀表盤圖標，查看當前會話提供方的配額狀態。
• 三種預設配置：
  • DeepSeek 官方：內置，直接查詢 api.deepseek.com 的餘額。
  • OpenCode：查詢 5 小時/周/月套餐的用量百分比和重置時間。
  • 自定義 HTTP：支持任意 HTTP 用量端點，配置 URL、Headers 和 JSON 路徑。
• 官方價格同步：一鍵從 DeepSeek 官方定價頁同步價格表和峯谷時段。

安裝與啓用¶

通過官方安裝命令將插件加入 web profile 的 bundle 層：

dsh plugin --profile web add https://github.com/Coco-king/dsh-monitor.git#v0.3.1

插件會聲明 dsh.bundle.patch，因此會自動加入 bundle 層。修改代碼後需重新運行上述命令以應用更改。

使用方法¶

1. 配置提供方：進入 Settings -> Usage -> Provider usage config，點擊添加提供方。提供方 ID 爲下拉菜單，可選項包括 Settings -> Models 中配置的模型提供方，以及已在此處配置的提供方。選擇預設並填入字段即可。
2. 查看用量：在 Composer 中，點擊模型切換器左側的儀表盤圖標。面板會顯示當前會話提供方的配額：提供方名稱、預設徽章以及右上角的刷新圖標。
3. 管理價格：進入 Settings -> Usage -> Billing prices。可以手動編輯價格，或從官方文檔同步。價格表會自動同步峯谷時段配置。
4. 首次啓動：插件首次啓動時，會將歷史會話數據回填到本地 SQLite 賬本中。此過程可能需要幾秒鐘，控制台會顯示進度條或日誌，頁面在此期間保持可用。

注意事項¶

• DeepSeek 官方餘額：無需額外配置，插件會自動複用 Settings -> Models 中的 API Key 查詢官方餘額。
• 更新代碼：修改代碼後必須重新運行安裝命令才能生效。
• 數據回填：首次運行時會有一次性的數據回填操作，之後增量同步非常快。
• 許可證：插件遵循 MIT 許可證。

總結¶

dsh-monitor 通過 SQLite 本地賬本和事件溯源的會話投影，實現了費用的精準計算。適合需要精細化管理 DeepSeek 及第三方 API 成本和配額的開發者。更多信息請參考插件目錄或 GitHub 倉庫。