前言¶
在 DSH web 客戶端中使用 DeepSeek 時，當前會話花了多少錢、現在跑的是哪一檔資費、距離下一檔資費還有多久，這些狀態不一定會自動顯示在交互區裏。
@dshworks/dsh-meter 是一個 dsh web 客戶端插件，用來在 composer 下方增加一行計費信息，並在 hover 或 focus 時展開更多詳情，包括會話成本、資費狀態、緩存和餘額相關數據。
插件定位¶
- 包名：
@dshworks/dsh-meter - 維護者：
dshworks - 許可證：MIT
- 運行位置：作爲 dsh web 客戶端插件運行
- 核心用途：在會話界面顯示 DeepSeek 計費狀態，包括會話成本、當前資費、資費切換時間、賬戶餘額和相關費率信息
核心功能¶
composer 下方的一行¶
插件會在 composer 下方添加一行信息，顯示：
- 當前會話成本
- 當前資費
- 距離資費翻轉的時間
這一行用於快速查看當前會話的計費狀態，不需要額外打開面板。
Hover 或 focus 後打開卡片¶
當 hover 或 focus 到 composer 下方的 meter 行時，會打開一個卡片。卡片中顯示：
- 會話總額
- 請求數
- 模型
- 24 小時資費條
- 緩存命中、新鮮輸入、輸出的 token 數與金額
- 賬戶餘額及贈送信用
- 其他資費下的相同 token 價格
- 緩存節省
這部分更適合查看一次會話的構成：哪些 token 命中了緩存，哪些是新鮮輸入，輸出是多少，以及如果換成其他資費會是什麼價格。
Settings → Meter 用於冷啓動查看¶
如果還沒有會話，或者會話還沒有產生計費請求，composer 下方的 meter 行可能不會出現。
已覈實資料說明：
- meter 需要會話且已有計費請求後出現
Settings → Meter用於冷啓動查看
打開 Settings → Meter 後，可以查看：
- 當前資費
- 倒計時
- 七天資費網格
- 公開費率卡
- 賬戶餘額
兩套費率卡，不做匯率換算¶
DeepSeek 發佈 USD 和 CNY 兩套獨立費率卡，賬戶按其中一個計費。
插件會讀取賬戶幣種，並按 DeepSeek 的 USD/CNY 兩套獨立費率卡顯示 funded 行，不做匯率換算。
安裝與啓用¶
1、確認 pnpm 位於 PATH。dsh plugin 會轉發到 pnpm，因此 pnpm 必須可用。
2、添加插件：
dsh plugin --profile web add @dshworks/dsh-meter
3、啓動 web profile：
dsh --profile web
4、進入會話。meter 需要會話且已有計費請求後出現；如果需要冷啓動查看資費、費率卡和餘額，可以打開 Settings → Meter。
典型用法¶
1、安裝並啓動：
dsh plugin --profile web add @dshworks/dsh-meter
dsh --profile web
2、冷啓動查看資費信息：
打開 Settings → Meter，查看當前資費、倒計時、七天資費網格、公開費率卡和賬戶餘額。
3、查看會話詳情：
Hover 或 focus 會話下方的 meter 行，打開卡片查看資費、緩存和餘額詳情。
已覈實資料中的示例行如下：
2 turns · 2 steps | LLM 3.1s | TTFT avg 1.3s · 41 tok/s | Cache hit 50% | Input 44.3K tok ¥0.0672 | peak | off-peak in 48m
適用場景與注意¶
適合以下場景：
- 使用 dsh web 客戶端調用 DeepSeek
- 希望在 composer 下方直接看到當前會話成本
- 需要查看當前資費、資費切換時間、七天資費網格和公開費率卡
- 需要查看緩存命中、新鮮輸入、輸出、賬戶餘額及贈送信用
- 需要按賬戶幣種查看 USD 或 CNY 的獨立費率卡，而不希望插件做匯率換算
使用前注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼和 MIT 許可證。
- 插件需要 pnpm 位於 PATH。
- meter 行需要會話且已有計費請求後出現；
Settings → Meter用於冷啓動查看。 - 已覈實資料只說明兩個配置項位於插件自身配置中，未給出具體配置項名稱。
- 餘額通過 host 路由讀取；已覈實資料提到
/dsh-meter/balance返回currency信息，但憑據與權限細節未完全確認。 - 已覈實資料未給出完整 dsh 兼容版本範圍，不能據此判斷具體版本要求。
鏈接¶
- GitHub：https://github.com/dshworks/dsh-meter
