前言¶
DeepSeek Harness (DSH) 專注於智能體的路由管理與會話控制。在實際開發中，當通過 OpenRouter 等第三方中繼提供商調用底層模型時，DSH 原生界面通常無法顯示中繼端的餘額、配額窗口或具體的 Token 成本。dsh-quota 插件解決了這個問題，它將計費提供商與路由名稱解耦，並提供一個可視化的儀表盤來追蹤 Token 使用量、成本預算以及提供商狀態。
核心功能¶
- 會話與成本追蹤：插件跟隨活動會話的路線、模型、推理強度以及官方
tokenUsage投影。它能在 DSH Host 存儲中持久化去重後的每次調用使用日誌，並追蹤當前會話、每日及滾動 30 天的 Token 數量與預估 CNY 成本。 - 多提供商集成：支持顯示提供商的餘額、配額窗口、支出限制和提供商端使用量。本地核算集成支持 Moonshot、Zhipu、Alibaba Bailian、Volcengine Ark、Together AI 和 Fireworks AI 等平臺，無需額外憑證即可統計使用量。
- 數據遷移與持久化：插件會自動遷移 v0.6 之前的瀏覽器聚合數據，避免升級後重復計數。它還支持導出 CSV，並允許在瀏覽器設置中編輯每個模型的 CNY-per-million-Token 價格。
- 可視化儀表盤：提供可拖動的懸浮小部件，支持圖標模式、隱藏和位置重置。儀表盤包含無間隙的 7 天趨勢圖和 30 天細分，並支持桌面抽屜和移動端底部表單。
安裝與啓用¶
插件以預構建存檔形式提供，無需本地 TypeScript 構建。安裝命令如下：
dsh plugin --profile web add "https://github.com/Lottle7/dsh-quota/releases/download/v0.8.0/dsh-quota.tgz"
dsh web
配置與使用¶
Host 設置命名空間爲 dsh-quota。主要配置項包括 enabled、refreshIntervalMs、warningBalanceBelow（餘額低於此值警告）和 usageRetentionDays（數據保留天數，範圍 30-3650）。
本地核算與自定義提供程序¶
對於本地核算，無需提供額外憑證，插件根據配置的價格表報告 DSH 投供的 Token 投影。對於自定義提供程序，可以使用 kind: local（無遠程請求）或 kind: http-json（映射公共 HTTPS JSON 結算端點）。
路線映射¶
當自定義路線名稱無法被自動識別時，可以通過配置 routeMappings 來明確指定路由與計費提供商的對應關係。
注意事項¶
- 本地核算集成不會捏造餘額，僅報告 Token 投影和用戶配置的價格。
- 安裝預構建存檔後，無需執行本地構建步驟。
- 插件提供無憑據的診斷報告，用於檢查路由解析和緩存狀態。
總結¶
dsh-quota 爲 DSH 用戶提供了從路由層到計費層的完整視圖。通過持久化日誌、預算管理、趨勢分析以及 CSV 導出功能，它幫助開發者更清晰地掌握多提供商環境下的資源消耗與成本。
