前言¶
在 DeepSeek Harness (DSH) 的智能體開發與日常使用中，prompt 生成、推理以及上下文緩存會消耗大量 token。如果沒有實時的財務反饋，開發者可能面臨意外的賬單激增、錯失夜間折扣窗口，或者無法發現失控的子代理費用。dsh-cost-meter 插件旨在解決這些問題，它將高精度成本遙測芯片直接嵌入到 DeepSeek Harness 對話頭部，提供實時會話成本顯示、分時電價切換以及 Token 定價功能。
插件定位¶
該插件由 GooDAnDReaDY 維護，遵循 MIT 協議。它通過增量流式遙測技術，無需輪詢即可實時計算 prompt、completion 和緩存讀寫的 token。插件支持雙檔位（高峯/非高峯）電價引擎，能夠自動識別官方 DeepSeek 高峯時段（提供 50% 非高峯折扣），並確保歷史會話支出永久錨定於執行時的費率。
核心功能¶
- 增量流式遙測：實時計算 token 消耗，包含 prompt、completion 和緩存讀寫，避免 UI 卡頓。
- 雙檔位電價引擎：支持 DeepSeek 官方高峯時段，自動檢測 50% 非高峯折扣。
- UTC 半小時時段不可變性：歷史支出數據永久綁定到執行時的費率檔位。
- 提供商感知路由：區分直連提供商與託管網關（如 OpenRouter）。
- 交互式 UI 與設置：支持自定義貨幣符號、匯率和時區配置。
- 性能與緩存：採用 O(K) 次變更計算優化，支持服務器緩存與 ETag。
- 目錄同步與導出：支持手動目錄同步（API 或 UI），並提供快速摘要導出。
- 預算與建議：提供預算閾值警告和省錢建議。
- 狀態與多模型：原生圓點狀態指示器（支持脈衝警告），支持多模型摺疊面板。
- 上下文緩存節省：自動計算並高亮緩存帶來的財務節省。
安裝與啓用¶
安裝該插件需要使用官方安裝命令：
dsh plugin --profile web add @goodandready/dsh-cost-meter
安裝完成後，重啓 DeepSeek Harness 實例並刷新瀏覽器即可加載插件。
配置與使用¶
配置分爲 GUI 設置和 YAML 高級設置兩部分。
基礎配置（GUI）¶
主要標量參數（如 currency、usdRate、displayTimeZone、useOpenRouter、refreshHours）可在界面 Settings → Plugins → Plugin Settings → Cost Meter 中直接編輯。
高級配置（YAML）¶
複雜的字典或數組結構配置（如 prices、modelMap、deepseekPeakPrices、manualPeakWindowsUtc、manualOffPeakMultiplier）需在 settings.yaml 中配置。
配置項說明：
* currency: 顯示貨幣符號（如 $, ₽, €）。
* usdRate: 匯率乘數（每 1 USD 對應的貨幣單位）。
* displayTimeZone: IANA 時區，用於格式化高峯/非高峯窗口。
* useOpenRouter: 是否自動從 OpenRouter 獲取費率與折扣窗口。
* prices: 手動費率配置（每百萬 token 的輸入、輸出、緩存命中/寫入價格）。
* modelMap: 模型路由覆蓋（"provider/model" -> OpenRouter model id）。
* manualPeakWindowsUtc: 手動定義高峯時段（HH:MM-HH:MM UTC）。
* manualOffPeakMultiplier: 手動非高峯倍率。
數據同步¶
- API 同步:
POST /dsh-cost-meter/refresh - UI 同步: 點擊界面上的 “Sync Now” 按鈕。
運行環境與依賴¶
- Node.js: 需要版本 >= 20。
- 依賴庫:
zod。 - Peer Dependencies:
@deepseek-ai/cordis(版本 >= 4.0.1)@deepseek-ai/schemastery(版本 >= 3.18.1)
總結¶
dsh-cost-meter 通過在頭部集成實時成本芯片，解決了 AI 開發中費用不可見的問題。開發者可以基於實時數據調整策略，利用非高峯時段降低成本。插件遵循 DSH Locale Standards，支持中英文本地化。
