前言¶

在 DeepSeek Harness（DSH）裏做長對話、多輪調用或子代理編排時，token 用量會散落在各次模型調用裏，官方賬單又往往滯後。單靠 API 控制台或事後對賬，很難在「當前這一輪」就判斷會話成本是否偏高。下面介紹社區客戶端插件 dsh-token-bill（維護者 leecisen）：按內置價目表與 token 用量做估算，在輸入框旁和側邊欄會話列表直接展示金額，並支持按模型、高峯/空閒時段拆分明細。

這是什麼¶

dsh-token-bill 是發佈在 npm 上的 DSH 插件（當前版本 2.1.0，許可證 MIT）。它定位是「對話費用估算」：用模型返回的 token 用量乘以各廠商官方價格（或你在配置裏補充的價格）算出參考金額，以實際賬單爲準，README 中已明確說明。

插件分類爲客戶端，通過 Cordis patch 注入會話與工作區 UI；需要 DSH ≥ 0.2.2-rc.1（package.json 中 engines.dsh 與 README 徽章一致）。

核心功能¶

界面展示¶

1. 輸入框下方：上下文圓環左側顯示當前會話的估算總費用，點擊可展開明細麪板。
2. 側邊欄：會話列表中，每個對話的時間旁顯示該對話的費用（可通過配置關閉）。

明細麪板中可查看：輸入（未命中緩存 / 命中緩存 / 輸出）的 token 數與費用佔比、緩存命中率、模型調用次數、思考 token（已含在輸出內）、最近一輪費用、上下文壓縮（compaction）產生的調用費用、DeepSeek 空閒時段相對高峯價的節省額、子代理費用及合計、按模型彙總的 token 與費用（無定價模型顯示「未定價」）。金額後帶 + 表示有部分模型未計入總額。

價目表與計價規則¶

內置 16 家廠商 主流模型的官方價格（README 截至 2026-11-08 覈對）：DeepSeek；Anthropic Claude、OpenAI GPT、Google Gemini、xAI Grok；國內月之暗面 Kimi、智譜 GLM、MiniMax、阿里通義千問、字節豆包、騰訊混元、百度文心、小米 MiMo、階躍星辰、螞蟻百靈、美團 LongCat 等，合計 100+ 模型。長上下文階梯價、官方已公佈調價日期按每次調用發生時間分別計算；未內置的模型可在配置 models 中補價。

DeepSeek 高峯 / 空閒：北京時間工作日 9:00–12:00、14:00–18:00 爲高峯，其餘時段（含週末、法定節假日全天）按半價；插件按每次調用時間計價，並展示「空閒時段節省」。內置 2026、2027 年放假安排，也可在 holidays 中追加日期。

幣種與匯率¶

明細麪板右上角可切換顯示幣種，默認提供 CNY、USD、EUR、RUB、INR、IDR、BRL、HKD；選擇會記住，側邊欄金額一併換算。官方同時有人民幣價和美元價的模型直接使用對應價目表，其餘按匯率換算。默認每天聯網更新匯率（exchangeRates: true），聯不上時使用內置匯率；懸停幣種可見匯率日期與來源。

計量範圍¶

• 上下文壓縮時的模型調用計入（README 說明內置 token 計量不含 compression 部分，插件單獨算）。
• 子代理費用單獨列出並給出合計（需側邊欄已加載子代理數據）。
• 從其他會話分叉出來的會話，不重複計算繼承部分。
• 會話內只存 token 數，價格在展示時套用；改價或改配置後歷史會話按新規則重算。

界面中英文隨 DSH 語言；隨淺色/深色主題。README 稱零依賴、無需構建。

安裝與啓用¶

環境要求：DeepSeek Harness 0.2.2-rc.1 或更新；Node ≥ 22（package.json 的 engines）。

在插件頁面安裝（推薦）¶

DeepSeek Harness 側邊欄 → 插件 → 添加插件，輸入：

dsh-token-bill

點 安裝，完成後點 立即啓用。新版本可在插件頁一鍵更新。國內 npmmirror 同步可能延遲，裝不到最新版時可把安裝源改爲 npm 官方源。

習慣命令行可執行：

dsh plugin add dsh-token-bill

需要時加上 --profile <你的 profile 名>。

其他方式¶

在「添加插件」中填寫 github:leecisen/dsh-token-bill 可安裝倉庫最新代碼，但無法插件頁一鍵更新，升級需先卸載再裝。離線可從 Releases 下載 ZIP，解壓後在「添加插件」中填寫該目錄的完整路徑。

從舊版升級：2.0.x → 2.1 可在插件頁更新（首次打開會話可能重新統計歷史用量）；舊包名 @local/token-cost 與新版可並存，啓用新版後關閉舊插件即可。npm 上的 dsh-token-cost 是他人插件，非本倉庫舊版。

配置（可選）¶

不配即可用：默認人民幣、區分時段、側邊欄顯示費用、每天更新匯率。修改時在 profile 的 cordis.patch.yml 中增加插件段（Windows 示例路徑：%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml）：

- id: dsh-token-bill
  config:
    currency: CNY
    currencies: [CNY, USD, EUR, RUB, INR, IDR, BRL, HKD]
    exchangeRates: true
    timeOfDayPricing: true
    showInSessionList: true
    holidays:
      - '2028-01-01'
    models:
      my-model:
        input: 0.8
        cacheRead: 0.2
        output: 2
        currency: CNY
    fallback:
      input: 2
      cacheRead: 0.5
      output: 8

注意：DSH 對插件 config 爲整體替換，未寫字段用 README 表格中的默認值。自定義價格查找順序：provider/模型 → 模型 → 內置價 → fallback。通過 deepseek-account 使用時按 API 價估算；走額度套餐可在 models 下用 deepseek-account/<模型> 改爲 0 或實際單價。

典型用法¶

1. 安裝並啓用後，打開任意會話，在輸入框下方圓環左側查看當前會話估算費用。
2. 點擊該金額打開明細，覈對緩存命中率、壓縮與子代理行是否出現，並在右上角切換幣種。
3. 在側邊欄瀏覽歷史會話，對比各對話旁顯示的費用，決定是否收緊上下文或換模型。
4. 使用未內置定價的私有或網關模型時，在 cordis.patch.yml 的 models 或 fallback 中補全每百萬 token 的 input / cacheRead / output 價格。

適用場景與注意¶

適合：長期在 DSH 裏調試智能體、對比多模型成本、需要即時感知 DeepSeek 峯谷差價與子代理疊加費用的開發者。

注意：

• 金額爲估算，僅供參考，以各雲廠商實際賬單爲準。
• 插件在當前 DSH 進程權限下運行（客戶端注入）；安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證。
• 匯率與官方調價會變動；內置價目表以 README 說明的核對日期爲準，過期可向倉庫提 issue / PR。

DSH 生態主張「一切皆插件」；SkillHub 目錄頁 爲社區收錄，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-token-bill 把 token 用量、多廠商官方價、DeepSeek 時段差價和子代理/壓縮調用疊在一起，落到輸入框與側邊欄兩處只讀展示，適合把「這輪對話大概花多少」當成開發時的即時反饋，而不是替代財務對賬。

• 目錄頁：https://www.skillhub.cn/plugins/leecisen/dsh-token-bill
• 倉庫：https://github.com/leecisen/dsh-token-bill