前言¶
DeepSeek Harness (DSH) 採用插件化架構，但在 Web 端缺乏官方用量查詢接口。開發者需要實時追蹤 Token 消耗、費用與模型構成時，往往需要依賴第三方工具或手動計算。dsh-mimo-quota 插件通過監聽本地流式事件，爲 DSH Web 端提供實時用量面板。
安裝¶
在 DSH 插件管理器或設置中，使用以下任一方式安裝：
# 通過 git URL 安裝
git https://github.com/hbgdjb/dsh-mimo-quota.git
# 或通過 registry 包名安裝
npm install dsh-mimo-quota
安裝後需重啓應用，插件將自動寫入 manifest 並在當前 profile 生效。
環境要求與配置¶
本插件需運行在 DeepSeek Harness 0.1.x Web 端。安裝成功後，可在 profile 的 cordis.patch.yml 中配置以下參數：
| 字段 | 說明 | 默認 |
|---|---|---|
storageFile |
用量記錄 JSON 路徑 | <profile>/mimo-quota-usage.json |
currency |
展示貨幣符號 | ¥ |
pricing |
牌價覆蓋（default + models，單位 ¥ / 百萬 tokens） |
內建小米牌價 |
數據存儲文件採用 v2 結構：{ version: 2, records: [...], sessions: { id: { title, dir } } }。
核心功能¶
- 實時用量面板：展示 Token 用量、消費金額、API 請求數、輸入/輸出 tokens，並提供趨勢圖與模型構成。
- 交互控制：支持切換模型、統計粒度、時間範圍（如 30 秒自動刷新或手動刷新）及統計範圍（全部/項目/對話）。
- 定價系統：內置可編輯定價面板，支持修改默認價及各模型價（輸入/緩存命中/緩存寫入/輸出），支持一鍵重置。
- 分時段計價：針對
deepseek-flash和deepseek-v4-pro內建峯谷價。北京時間 09:00–12:00、14:00–18:00 爲峯時，其餘時段與週末爲谷時。消費金額按記錄時間自動套算。 - 歷史數據導入：支持將 CSV 文件導入，文件需置於
<profile>/mimo-quota-import.csv，刷新頁面即可合併（自動去重與去重計數）。
使用示例¶
- 修改定價：在面板中直接修改四個定價字段，保存即時生效。若需調整特定模型價格，可在 pricing 配置中添加對應模型。
- 導入歷史數據：準備 CSV 文件，表頭需包含
會話ID、標題、原始輸入tokens、輸出tokens等字段，放置於指定路徑後刷新頁面。
注意事項¶
- 數據來源：消費金額爲按牌價與分時段規則的估算值，並非官方賬單，準確金額請以官方控制台爲準。
- 版本兼容：插件數據結構爲 v2，且依賴 Harness 的
llm/stream流式事件本地測量。 - 日誌記錄：會話事件日誌採用“重建 + 實時 + 60s 文件輪詢”三通道記賬。
參考資料¶
- GitHub 倉庫：https://github.com/hbgdjb/dsh-mimo-quota
