在使用 DeepSeek Harness (DSH) 進行智能體開發或日常對話時，實時監控 token 用量與成本至關重要。DeepSeek 官方提供峯谷定價策略，手動計算容易出錯且不直觀。下面介紹一個插件，它能夠實時監聽會話 token 用量，嚴格對齊官方定價計算費用，並在 TUI 狀態行或通過 /billing 命令生成鯨魚 ASCII 賬單小票。
插件介紹¶
該插件由 ethanz11-creat 維護，核心價值在於將 DeepSeek 的峯谷計費邏輯落地到 DSH 環境中。它不僅能實時顯示費用，還能生成可視化的收銀臺風格賬單，支持 Agent 工具調用。
核心功能¶
- 峯谷分時計費：嚴格對齊 DeepSeek 官方計價頁，高峯時段收全價，空閒時段打五折。
/billing命令：在 TUI 對話流中持久打印鯨魚 ASCII 賬單小票。- TUI 狀態行：狀態欄實時顯示當前會話累計費用與高峯/空閒狀態。
- Agent 工具：提供
show_billing（查費用）與check_pricing_period（查當前峯谷時段）。 - 會話繼承：切換模型 fork 出新會話時繼承父會話用量。
- 去重防堆疊：連續多次
/billing若沒有新的輸入/輸出，不會重複貼票。 - 只計 DeepSeek 模型：僅識別
deepseek-v4-flash/deepseek-v4-pro，其它模型返回 null。
安裝與啓用¶
插件通過 dsh plugin 的 bundle 機制安裝，安裝後開箱即用，無需額外配置。
dsh plugin --profile demo add dsh-billing-tui
使用方式¶
安裝完成後，可以通過以下方式使用：
1. 在對話流中運行 /billing 打印賬單小票。
2. 查看 TUI 狀態行實時顯示的費用。
3. Agent 調用 show_billing 工具查詢費用。
4. Agent 調用 check_pricing_period 工具查詢當前時段。
定價與規則¶
插件嚴格對齊 DeepSeek 官方定價頁，單位爲 元 / 百萬 tokens。高峯時段爲北京時間 9:00–12:00、14:00–18:00（每天，含週末），其餘時間爲空閒時段，價格爲高峯的 50%。
計費邏輯包含：
* 緩存命中：對應 DeepSeek API 返回的 prompt_cache_hit_tokens。
* 推理 token：與輸出 token 合併後按輸出檔位計費。
* 模型支持：僅 deepseek-v4-flash 和 deepseek-v4-pro 會被計費，其他模型（如 Claude、GPT）或未知型號返回 null，不計費。
注意事項¶
- 時區：時段判斷使用固定
Asia/Shanghai時區，不依賴本機時區。 - 可選配置：可在
cordis.patch.yml中配置currency（默認 CNY）和pricing_source（默認 deepseek_official）。
生態背景¶
DeepSeek Harness (DSH) 理念是「一切皆插件」。該插件屬於社區插件，與 DeepSeek 或幻方無官方從屬關係。
