前言¶

在 DeepSeek Harness（DSH）裏用 Web 聊天跑多輪對話時，token 用量分散在會話事件裏，官方控制台也要另開頁面才能對賬。若你關心單次任務花了多少錢、高峯時段是否被翻倍計費，單靠肉眼估算並不靠譜。dsh-deepseek-cost 是社區維護的 DSH 插件，掛在輸入框下方的統計行裏，對當前會話做實時費用匯總，並可展開模型與峯谷明細。下文介紹它的能力、安裝方式與使用注意點。

這是什麼¶

dsh-deepseek-cost 面向 DSH 的 web profile：從會話日誌摺疊 provider 上報的 token 用量，按 DeepSeek 官方價目（CNY / 百萬 tokens）計算輸入（緩存未命中 / 命中）與輸出費用，並區分北京時間下的高峯、低谷時段。維護者 miaoxintechnology，源碼與文檔在 GitHub，社區目錄見 SkillHub。分類上常歸在 admin-security 一類，側重用量可見性與賬戶相關查詢。

當前 package 版本爲 0.3.2，許可證 MIT。插件以 Cordis bundle 形式注入 Web 客戶端，依賴 zod@4 與 @deepseek-ai/cordis。

核心功能¶

從會話事件自動歸集用量¶

宿主側註冊會話投影單元 deepseekCost，對事件日誌做純函數摺疊，不向頁面額外發統計類請求。主要事件來源包括：

同一步驟按「後到替換」合併，避免重複計數。

峯谷時段與節假日¶

每個用量樣本按事件時間戳（北京時間）歸入高峯或低谷桶：

• 工作日高峯：9:00–12:00、14:00–18:00，價格爲低谷價 × 2（與官方高峯檔一致）。
• 其餘時段、週六日、中國法定節假日全天按低谷價計費。

節假日表採用三層策略：內置 2026 年國務院安排、2027–2099 年農曆算法兜底、每 24 小時從 CDN 拉取 holiday-cn 覆蓋；拉取失敗時靜默回退內置數據。未在價目表中的模型會顯示「未定價 / 部分未定價」，不會靜默按錯誤單價計費。

界面與賬戶餘額¶

輸入框下方 composer dock 顯示累計費用與當前時段徽標（峯 / 谷文案隨北京時間每分鐘刷新）。點擊後展開明細：總計及峯谷拆分、按模型表格、計費起止時間、官方定價頁鏈接。

展開明細時會調用 DeepSeek 官方 GET /user/balance，複用 DSH 已配置的 API Key 顯示餘額與可用狀態，支持一鍵刷新；查詢失敗只提示錯誤，不影響會話內費用統計。

版本兼容¶

投影定義同時兼容 DSH ≥ 0.1.1 與 0.1.0-rc.7 的會話投影契約。README 註明：0.1.1 起宿主側契約變更，若僅安裝舊式 schema/view 可能導致快照校驗失敗、頁面無顯示。

安裝與啓用¶

環境要求：本機已安裝 DSH（dsh 可用），且使用 web profile；方式一、二需要系統內有 pnpm（Node 22+ 可通過 corepack enable pnpm 獲得）。

從本地目錄安裝（推薦）¶

拿到插件文件夾後執行：

dsh plugin --profile web add /path/to/dsh-deepseek-cost
dsh web   # 重啓後生效

dsh plugin 會在 web profile 目錄用 pnpm 安裝依賴，並把 dsh-deepseek-cost 寫入 dsh.profile.bundles。

從 Git 倉庫安裝¶

dsh plugin --profile web add github:miaoxintechnology/dsh-deepseek-cost
dsh web

無法訪問 GitHub 時，可改用 Gitee 等鏡像 URL，或按 README「方式四」離線拷貝目錄。本插件無 prepare/build 腳本，通常不需要 allowBuilds；若 pnpm 仍提示，按文檔把對應 key 加入 ~/.dsh/profiles/web/pnpm-workspace.yaml 後重試。

驗證與卸載¶

驗證：

dsh --profile web --dump-config | grep deepseek-cost

應看到 id: deepseek-cost、name: dsh-deepseek-cost。任意會話產生一次模型回答後，輸入框下方應出現 DeepSeek ¥… 統計行。

卸載：

dsh plugin --profile web remove dsh-deepseek-cost
dsh web

無 pnpm 或純離線場景，README 還描述了手動複製到 ~/.dsh/profiles/web/node_modules/dsh-deepseek-cost 並在 package.json 的 dsh.profile.bundles 中追加條目的步驟；跨設備時不要直接拷貝整份 profile 的 package.json（可能含本機絕對路徑）。

典型用法與價格維護¶

日常使用無需額外配置：打開 dsh web，在會話中對話即可看到累計費用；需要覈對模型分項或餘額時點開展開面板。

官方默認定價寫在 lib/pricing.js 的 DEFAULT_PRICING 中，例如低谷價（元 / 百萬 tokens）：

models: {
  'deepseek-flash':       { input: 1,   cacheHit: 0.02, output: 4 },
  'deepseek-v4-pro':      { input: 4.5, cacheHit: 0.15, output: 13.5 },
  'deepseek-chat':        { input: 2,   cacheHit: 0.5,  output: 8 },
  'deepseek-reasoner':    { input: 4,   cacheHit: 1,    output: 16 },
},

若官方調價或出現新版本模型名，可改 lib/pricing.js，或在 cordis.patch.yml 的 config.pricing 下覆蓋 peak 與 models 字段。README 提醒 deepseek-chat / deepseek-reasoner 條目可能仍爲較早佔位價，應以官方定價頁爲準更新。

本地改摺疊邏輯時可跑冒煙測試：

node test/fold.test.js

適用場景與注意¶

適合：長期在 DSH Web 裏調試智能體、需要按任務看清 API 花費、或要在高峯 / 低谷策略下規劃調用時間的開發者。

安裝前建議自行瀏覽倉庫源碼與 MIT 許可證。DSH 插件在 當前 dsh 進程權限 下運行；本插件會讀取會話事件並在展開明細時用已配置的 API Key 請求餘額接口，屬 admin / 安全相關能力，僅在可信環境安裝。

社區插件目錄（SkillHub）與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文事實均來自項目 README 與 package 元數據。

結尾¶

dsh-deepseek-cost 把單次 Web 會話的模型用量、峯谷規則與官方單價收成一條可點擊的統計行，適合在對賬和控費場景裏與 DSH 同時使用。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。