前言¶

在 DeepSeek Harness（dsh）裏跑長會話時，官方統計行會給出活動與用量，但不會把「當前是峯時還是谷時、賬戶還剩多少錢、這一會話大概花了多少」合成一處展示。開發者若要對齊官方計費規則（峯谷半價、2026 年調價與 pro→flash 路由），往往得自己查文檔或事後對賬。

下面介紹社區插件 dsh-cost（npm 包名 dsh-cost-pill，倉庫 Arun1016/dsh-cost）。它在會話輸入框下方官方統計行最右側增加一顆 cost pill，合併展示計費時段、賬戶餘額（可選）和當前會話費用；點擊可展開按桶與按模型的明細。費用側不需要憑據；餘額側需要 DeepSeek API key，且插件不把 key 寫入磁盤。

社區插件，與 DeepSeek 無隸屬或背書關係。

這是什麼¶

dsh-cost 由維護者 Arun1016 發佈，分類爲 客戶端（Web GUI 注入）。它註冊到 conversation.composer.dock，order: 2，排在官方 activity（0）與 usage（1）兩顆 pill 之後。

核心能力概括如下：

• 統計行最右側 pill：峯時顯示 Peak、谷時顯示 Off-peak，並用紅/綠點區分；同時展示餘額與會話費用（無 key 時僅缺餘額段）。
• 彈層明細：計費時段、餘額、會話總費用，以及 cache-hit 輸入、cache-miss 輸入（含 cache write）、輸出各桶費用；主機可按模型摺疊時還提供按模型拆分。
• 計價表隨插件發佈內置，覆蓋 2026-09-10 降價與 pro→flash 路由；會話 attach 期間按請求摺疊用量，跨調價、路由或峯谷邊界不會混用兩套費率。
• 中英雙語：cost-stats 命名空間下 14 條字典項，隨應用 locale 切換。

環境與依賴¶

• DeepSeek Harness >= 0.2.1-rc.2（見 package.json 的 engines.dsh）。
• 要看餘額：需要 DeepSeek API key。經 dsh 的 credentials seam 解析；僅當 credentials 服務本身不可用時 纔回退到環境變量 DEEPSEEK_API_KEY——若 credentials 存在但沒有 key，不會讀環境變量。僅用 DeepSeek 賬號登錄、無 key 時，pill 仍顯示峯谷與會話費用，餘額段不出現。

安裝與啓用¶

插件市場可搜 dsh-cost；終端安裝命令以 README 爲準：

dsh plugin --profile <profile> add dsh-cost-pill

從 GitHub 源安裝：

dsh plugin --profile <profile> add github:Arun1016/dsh-cost

說明：裸 npm 名 dsh-cost 屬於無關項目；本插件發佈在 @arun_1016/ 作用域下，與前者不混淆。當前資料中 package 版本爲 1.0.2，許可證 MIT。

安裝前請自行查看倉庫源碼與許可證；插件在 當前 dsh 進程權限 下運行，與所有 DSH 插件一樣，信任邊界取決於你對維護者與代碼的審查。

配置¶

唯一配置項爲 holidays，用於替換內置的 2026 年中國法定節假日表（國辦發明電〔2025〕7 號，北京本地 YYYY-MM-DD）。跨年後改 Config 即可，不必改代碼。

- id: cost-stats
  name: dsh-cost
  config:
    holidays: ['2026-01-01']   # statutory holidays bill off-peak all day

峯谷時鐘：工作日 09:00–12:00、14:00–18:00 爲峯時，其餘爲谷時；週末與法定假日全天按谷時。時鐘取 運行 dsh 的機器本地時間；官方窗口按北京時間定義，只有主機爲北京時間時讀數才與官方完全一致。

典型用法與界面行爲¶

1. 安裝並啓用插件後，打開 dsh Web GUI，在會話 composer 下方統計行最右側可見 cost pill。
2. 無 API key 時仍可看峯谷與會話費用；配置 key 後 pill 會帶上餘額。
3. 點擊 pill 打開彈層，查看各 token 桶與會話內按模型費用（主機支持摺疊時）。
4. 瀏覽器端只請求宿主路由 /api/dsh-balance（每個 session step 一次，另加 60 s 輪詢），不直連第三方；餘額查詢由宿主側訪問 https://api.deepseek.com/user/balance（15 s 超時），key 僅進程內使用，不落盤。

計費模型（資料摘要）¶

價格爲 CNY / 百萬 token；下表均爲 峯時 單價，谷時爲一半。

適用場景與注意事項¶

適合：在 dsh Web 里長時間調試智能體、需要對照官方峯谷與調價規則看「這一會話花了多少」、並可選地盯賬戶餘額的開發者。

隱私與網絡（README Privacy）：無遙測、無第三方端點；瀏覽器不直連外網查餘額。餘額失敗（無 key、無效 key、網絡錯誤、超時）靜默返回無 balance_infos 的 200，並緩存 30 s；充值後最多約 30 s 才刷新。進程級餘額緩存按 key 失效。

已知限制（節選）：

• 已 detach 的會話由宿主按當前 Flash 費率聚合計價，無估算標記；瀏覽器側 fallback 估算會標 (估) / (est)。
• 宿主路由缺失或報錯時，整顆 pill 靜默隱藏，無佔位與錯誤提示；失敗後停止 per-step 輪詢，僅保留 60 s 輪詢。
• 費用精確到 ¥0.01 以下爲 4 位小數；展示一律帶 ¥ 前綴。
• 內置假日表僅覆蓋 2026；未識別 model id 按 Flash 表計價；彈層無高度上限，且不與官方 pill 彈層互斥。
• 按請求累加費用，四捨五入可能與賬單略有差異。

結尾¶

dsh-cost 把峯谷、餘額與會話費用收到統計行一顆 pill 裏，並按官方規則做分桶與分模型展示；無 key 也能看時段與會話成本，有 key 則補餘額，且不把憑據寫入磁盤。

• 社區目錄頁：https://www.skillhub.cn/plugins/Arun1016/dsh-cost
• 源碼與說明：https://github.com/Arun1016/dsh-cost