前言¶

DSH 的理念是「一切皆插件」。對 DSH 用戶來說，API 費用統計可以做成一個獨立插件：在會話底部顯示當前會話費用，在設置頁顯示全局累計費用。

下面介紹 fflow2023/dsh-usage-cost。它是一個輕量的 DeepSeek Harness 插件，用於會話級與全局的 API 費用統計。

這是什麼¶

dsh-usage-cost 由 fflow2023 維護，許可證爲 MIT。它把“當前會話累計花了多少錢”併入會話底部統計行，並在設置頁提供“費用統計”面板。

它是一個只讀費用估算插件：數字基於持久會話日誌重放得出，重啓、冷讀可恢復。插件不向模型注入提示、schema、工具或消息，零直接 token 影響，不影響 KV Cache。

核心功能¶

啓用後，可見的功能包括：

1、會話底部與 token 統計同一行顯示費用，幷包含高峯/閒時價格。

2、設置 → 費用統計：展示全局累計費用、高峯/閒時拆分、按模型拆分（V4 Pro / V4 Flash），以及按會話降序列表。

計費範圍只覆蓋 deepseek-v4-pro 與 deepseek-v4-flash。其它模型計入 unpricedTokens，不靜默按錯價。

實現上，插件爲純 JS、零構建、零運行時依賴；Host 側爲 1 個 projection 單元，每個事件 O(1)。

計費口徑¶

費用單位爲元 / 百萬 tokens。插件按 2026-08-17 00:00 北京時間生效的峯谷價計費。

高峯時段爲北京時間 9:00–12:00、14:00–18:00；其餘爲空閒時段，價格按高峯的一半計算。

價格相關配置集中在 index.js 的 PRICES。價格變動時，只改 index.js 並 bump 版本號即可。

安裝與啓用¶

從 GitHub 安裝：

dsh plugin --profile web add github:fflow2023/dsh-usage-cost

使用包名安裝：

dsh plugin --profile web add @fflow2023/dsh-usage-cost

源碼 checkout 環境中，將上述 dsh 安裝命令替換爲 pnpm dsh plugin --profile web add ... 的對應命令。

第一次從 git 安裝時，pnpm 會提示把生成的 allowBuilds 鍵複製進該 profile 的 pnpm-workspace.yaml，然後重跑一次。從 GitHub 安裝需要爲構建授權一次。

插件的 peer dependencies 爲：

{
  "@deepseek-ai/cordis": "^4.0.1-rc.1",
  "react": "^18.2.0"
}

典型用法¶

安裝並啓用後，按界面查看：

1、在會話底部，和 token 統計同一行查看當前會話費用，以及高峯/閒時價格。

2、在“設置 → 費用統計”中查看全局累計費用、高峯/閒時拆分、按模型拆分和按會話降序列表。

它不向模型注入提示、schema、工具或消息。

適用場景與注意¶

適合在 DSH web profile 中查看 deepseek-v4-pro 與 deepseek-v4-flash 會話級、全局 API 費用的使用場景。

使用注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼、MIT 許可證和依賴。
• 它是隻讀投影，不改變模型輸入，不影響 KV Cache。
• 非計費模型會進入 unpricedTokens，不要將其誤讀爲已計價費用。
• 價格規則基於 2026-08-17 00:00 北京時間峯谷價；若價格更新，需要同步更新插件版本。

鏈接¶

GitHub：https://github.com/fflow2023/dsh-usage-cost