前言¶

在 DeepSeek Harness（DSH）裏用 Web GUI 對話時，官方 usage 行會彙報 token 用量，但不會按 DeepSeek 公佈的 Peak/Off-Peak 時段和區域價目表，把「當前屬於哪個計費窗口、本會話大概花了多少錢」擺在 composer 下方。若你關心官方 Flash/Pro 在 USD 或 CNY 表下的分時單價，或者想在不離開界面時覈對 cache hit/miss 與 output 是否分開計價，單靠 Harness 自帶 UI 往往不夠直觀。

下面介紹社區插件 dsh-token-pricing（維護者 kachanov-e-v，分類：模型推理）。它在 composer dock 增加一行摘要，並在點擊後展開明細；不替代 Harness 自帶的 usage 行，也不改動其邏輯。

這是什麼¶

dsh-token-pricing 是面向 DeepSeek Harness Web GUI 的 bundle 插件（MIT，當前資料中的版本 1.0.4）。它在 composer 下方顯示：

• 當前 Peak 或 Off-Peak 模式（顏色與文案）；
• 瀏覽器識別的本地時間與 IANA 時區；
• 按官方區域價目表估算的當前會話 token 費用。

點擊該行可打開 popover：下一次模式切換時間、區域/貨幣、Peak/Off-Peak 與 Flash/Pro 拆分、未計費 token 說明，以及文檔鏈接。Popover 可用 ×、點擊面板外或 Escape 關閉，焦點會回到該行。

插件僅在客戶端根據已有 session 事件與 provider 上報的 usage 做投影計算，不發起網絡請求、不讀取 credentials、不向外發送 usage。

核心功能¶

界面與交互¶

收攏時一行大致形如（時區因環境而異）：

● OFF-PEAK · 19:44 GMT+3 · Расход сессии: $0.0123 · ▾

（界面文案隨 locale 資源變化；邏輯相同。）

計費與數據範圍¶

• Peak / Off-Peak：按 UTC 窗口、工作日/週末及中國法定節假日判斷；當地時區只用於顯示時間與「下次切換」，不改變模式判定。
• 區域與貨幣：由瀏覽器 IANA 時區與 locale 推斷；大陸常用時區走 CNY 表，其餘走 USD 表；不做匯率換算，兩表獨立。
• 價目來源：DeepSeek 官方文檔（USD 與 CNY 各一頁）；插件內費率在資料中標註爲截至 2026-11-05。
• 用量粒度：每個 usage 樣本單獨計價，綁定 step 開始時間；區分 cache miss、cache hit、output；Flash、Pro 與未計費 token 不混算。
• 會話範圍：只統計當前會話且 provider 上報的 usage；不含 Search/Fetch、子會話等；這是估算，不是 DeepSeek 賬單。

自動隱藏¶

在以下情況插件故意不顯示該行：

• 會話尚未有確定的模型選擇（modelSelection.next 爲空）；
• 非支持的模型或第三方 provider；
• 模型無官方公開價目。

不支持模型的費用不會被猜測或填充。

架構概要¶

Session log
   │  existing events only
   ▼
tokenPricing projection (Host)
   │  buckets + costs.intl + costs.cn + schedule + supportedModels
   ▼
Client dock row
   │  modelSelection.next → gating
   │  timezone/locale → region + local time
   ▼
Row + click popover

Host 側通過 ctx.sessionProjections.register() 註冊投影；客戶端注入 Web 對話 UI，無需單獨構建步驟（ESM/JS）。

環境與兼容性¶

• 需要帶 Web GUI 的 DeepSeek Harness；資料記載在 0.2.2-rc.1 上驗證過。
• Profile 需具備 sessionProjections、conversation.composer.dock 及標準 projection modelSelection。
• Node.js 僅用於本地測試與開發；安裝 bundle 本身不要求構建。
• 依賴 zod（install_bundle 時會安裝）。

安裝與啓用¶

插件通過 profile 的 plugin_manager 從 GitHub 安裝，無需 clone 倉庫或本地打包。

最新 main（指向倉庫默認分支最新提交）：

plugin_manager install_bundle target=https://github.com/kachanov-e-v/dsh-token-pricing

固定發行版本（資料中的示例爲 v1.0.4）：

plugin_manager install_bundle target=https://github.com/kachanov-e-v/dsh-token-pricing/archive/refs/tags/v1.0.4.tar.gz

安裝後 profile 中會保留依賴項 github:kachanov-e-v/dsh-token-pricing 並綁定到對應 commit。重複安裝同一版本或同一鏈接會被拒絕爲 already-installed。

本地開發目錄安裝（將路徑換成你的絕對路徑）：

plugin_manager install_bundle target=<絕對路徑到插件目錄>

更新時先移除再安裝：

plugin_manager remove_bundle target=@local/dsh-token-pricing
plugin_manager install_bundle target=https://github.com/kachanov-e-v/dsh-token-pricing

更新客戶端部分後需刷新 Web GUI 頁面。

DSH 生態理念是「一切皆插件」；SkillHub 目錄頁爲社區收錄站點，與 DeepSeek / 幻方無官方從屬關係。安裝前請自行審閱倉庫源碼與 MIT 許可證——插件以當前 DSH 進程權限運行。

典型用法¶

1. 在 composer 中選擇支持的官方 DeepSeek 模型，例如：
   - deepseek-flash；
   - 舊版 deepseek-v4-flash、deepseek-v4-flash-vision-exp；
   - deepseek-v4-pro。
2. Provider 須爲 deepseek-account 或 deepseek-official。
3. composer 下方出現模式、時間與會話費用摘要。
4. 點擊該行查看 popover 明細。

尚無 usage 時顯示「無數據」而非 $0；全部 token 未計價時顯示「無費率」；部分未計價時會顯示合計與警告。

Peak/Off-Peak 窗口（判定規則）¶

Peak：UTC 01:00–04:00 與 06:00–10:00，週一至週五，且非中國法定節假日。其餘時間（含週末與節假日）爲 Off-Peak。Off-Peak 單價在官方表上爲 Peak 的一半（插件內對 USD/CNY 兩表均有測試校驗）。

節假日按 Asia/Shanghai 日曆與國務院公佈的 2026 年安排計算；資料中列出具體日期區間及來源鏈接。模式判定使用絕對 UTC 區間，與用戶顯示的本地時區無關。

價目表示例（資料摘錄）¶

以下爲 README 中的公開單價（每 1M tokens）：

完整說明與鏈接見倉庫 README 中的「Тарифы」一節。

適用場景與注意¶

適合誰：在 DSH Web GUI 里長期使用官方 DeepSeek Flash/Pro，希望在對話界面實時對照 Peak/Off-Peak 與區域官方價目、並復盤當前會話 token 花費的開發者。

需要注意：

• 費用估計依賴 session 內已有事件與 provider usage；日誌被截斷或缺少 step 時會回退到 event.time，可能與賬單有偏差。
• 同一 turn/step 上較新的 usage 會覆蓋較早記錄；llm/retry-started 後的重試單獨累加。
• 插件不覆蓋 RUB 等其他貨幣，也不使用第三方匯率。
• 僅當模型與 provider 匹配且存在公開費率時才展示；第三方模型或無費率模型不會出現「假零元」。

結尾¶

經過上面的步驟，你可以在 DSH Web GUI 的 composer 旁獲得 Peak/Off-Peak 狀態、本地時間與基於官方 USD/CNY 表的會話 token 費用摘要，並在 popover 中查看拆分細節——全程不額外聯網、不碰憑證。

• 目錄頁：https://www.skillhub.cn/plugins/kachanov-e-v/dsh-token-pricing
• 源碼與安裝說明：https://github.com/kachanov-e-v/dsh-token-pricing