前言¶

DeepSeek Harness（DSH）的擴展方式以插件爲主，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

智能體開發者在使用 DSH 時，通常會遇到幾個實際問題：本月消耗量到了什麼量級、估算花費是多少、8-17 DeepSeek 調價前後差異如何、緩存節省了多少、哪個模型或會話消耗更多。

dsh-whale-meter 是一個社區插件，用於把這些信息集中在一個用量與費用面板裏。

這是什麼¶

dsh-whale-meter 的定位是 DSH 用量與費用面板，由 Shiye-10Pages 維護，許可證爲 MIT。

它支持本地計算與零上報，所有數據都在本機。除配置 API key 後的餘額查詢外，不發出任何網絡請求。

核心功能¶

用量與花費估算¶

• 本月消耗量段位（五檔）與估算分位
• 今日、昨日、本月、累計花費估算
• 每日預算線提醒

價格與調價對比¶

• 8-17 DeepSeek 漲價前後對比
• 高峯/空閒兩檔峯谷計價
• 跨調價日按價格生效區間分別計價
• 緩存命中率與節省金額展示

多模型與賬單¶

• DeepSeek、Anthropic、OpenAI、Google、智譜 GLM、月之暗面 Kimi 共 46 個模型計價
• 國內廠商分檔計價
• 分模型、分會話賬單
• 安裝前歷史會話回填
• 近 14 天趨勢
• 配置 API key 後查詢賬戶餘額
• 一鍵生成賬單分享卡片

安裝與啓用¶

1、運行安裝命令。命令中的 <你的profile> 爲佔位符，需要按實際 profile 填寫。

dsh plugin --profile <你的profile> add dsh-whale-meter

2、安裝完成後重啓 dsh web。會話頁頂部會出現花費徽章。

如果從源碼安裝：

dsh plugin --profile <你的profile> add github:Shiye-10Pages/dsh-whale-meter

從源碼首次安裝時，需要在 profile 的 pnpm-workspace.yaml 裏授權構建，建議鎖定 commit。

配置¶

零配置即可用。

需要調整時，可在 profile 的 cordis.patch.yml 中覆蓋 whale-meter 的相關配置項：

• currency
• budgetDaily
• apiKey
• usdToCny
• backfill
• pricingUpdate
• prices

其中 apiKey 用於餘額查詢；缺省讀 DEEPSEEK_API_KEY 環境變量。

價格默認使用內置表；遠程表可選，拉取失敗會回退內置表。未知模型不會編造價格，會標記爲「未定價」。

典型用法¶

查看彙總¶

在 TUI 場景中，可以直接請求以下接口：

curl http://127.0.0.1:3080/whale-meter/api/summary

更新價格數據¶

更新價格時，先修改 src/pricing.data.ts，然後運行：

npm run gen:pricing

完成後再提交 PR。

適用場景與注意¶

dsh-whale-meter 適合需要查看 DSH 用量、估算花費、對比調價影響，以及按模型或會話拆分賬單的開發者。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• dsh 處於 developer preview，接口變動時插件會跟進適配。
• 餘額查詢需要配置 API key；除該查詢外，不發出任何網絡請求。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/Shiye-10Pages/dsh-whale-meter
• GitHub：https://github.com/Shiye-10Pages/dsh-whale-meter