前言¶
用 DSH（DeepSeek Harness）網頁端跑 DeepSeek 會話時，Token 用量、本次會話花費、累計花費和賬號餘額往往分散在不同位置。dsh-token-cost 是一個 DSH 網頁端插件，提供一個可拖動的 DeepSeek 鯨魚懸浮球，用於查看 Token 用量、本次會話/累計花費與 DeepSeek 賬號餘額。
它複用 DSH 已配置的 DEEPSEEK_API_KEY 查詢 DeepSeek 官方餘額，並通過 DSH 服務端按會話日誌記賬，而不是在前端做粗略估算。
這是什麼¶
dsh-token-cost 是一個 DSH 網頁端插件，由 PeterZoneZz 維護，許可證爲 MIT。
它面向 DSH 的 web profile 使用，安裝後會在瀏覽器頁面中提供一個鯨魚懸浮球，用於查看：
- 剩餘餘額百分比
- 本次會話費用
- 輸入 / 緩存讀 / 緩存寫 / 輸出四類 Token 用量
- 所有會話累計花費
- DeepSeek 官方賬號餘額
GitHub 倉庫地址爲：
https://github.com/PeterZoneZz/dsh-token-cost
核心功能¶
鯨魚懸浮球¶
插件提供一個毛玻璃質感的小圓球懸浮在頁面上。鼠標懸停時鯨魚會搖擺，外圈環形進度會顯示剩餘餘額百分比。
展開、收起與拖動¶
點擊鯨魚可以展開卡片，再次點擊鯨魚可以收起。卡片打開時也可以拖動，鯨魚和卡片會一起移動。
支持以下關閉卡片的方式：
- 點擊卡片外部
- 按
Esc - 點擊 ✕
- 再次點擊鯨魚
拖動鯨魚靠近屏幕左右邊緣時鬆手，浮窗會自動吸附到邊緣。浮窗位置會記錄在瀏覽器本地 localStorage 中。
卡片會優先在鯨魚旁空間最大的一側展開，並儘量不超出屏幕。
DeepSeek 官方賬號餘額¶
插件複用 DSH 已配置的 DEEPSEEK_API_KEY，調用 DeepSeek 官方接口：
GET /user/balance
卡片中會展示總餘額，以及贈送 / 充值構成。
如果未配置 DEEPSEEK_API_KEY，Token 用量與費用顯示不受影響，只有餘額部分會顯示降級提示。
剩餘餘額可視化¶
剩餘餘額以每次打開 DSH 頁面時查到的餘額爲基準：
剩餘 % = 當前餘額 ÷ 基準餘額
如果中途充值，基準餘額會隨之提升，剩餘百分比會重置爲 100%。
服務端精確記賬¶
插件會註冊 tokenCost 會話投影單元，在 DSH 服務端逐事件回放會話日誌。
記賬時會按每個請求實際使用的模型單價計費，因此會話中途切換模型時，費用仍然按對應模型計算，而不是用當前模型乘以總 Token 做客戶端估算。
用量明細¶
卡片會展示：
- 本次會話費用
- 輸入 Token
- 緩存讀 Token
- 緩存寫 Token
- 輸出 Token
- 所有會話累計花費
- 按模型拆分的花費明細
外觀¶
插件支持：
- 亮 / 暗主題自適應
- 中英雙語
- 數字彈跳動效
安裝與啓用¶
1. 獲取項目到本地¶
README 中的安裝步驟使用了佔位示例：
git clone <your-repo-url> dsh-token-cost
這不是可直接複製的完整安裝命令。可以先從 GitHub 倉庫獲取源碼到本地路徑：
https://github.com/PeterZoneZz/dsh-token-cost
2. 安裝進 DSH 的 web profile¶
將項目放到本地路徑後，執行：
dsh plugin --profile web add file:/path/to/dsh-token-cost
這裏的 file:/path/to/dsh-token-cost 需要替換爲本地實際路徑。該方式使用本地 file 依賴安裝插件。
3. 重啓 DSH Web¶
安裝後需要重啓 DSH Web：
dsh web
然後在瀏覽器中刷新頁面，即可在右下角看到鯨魚懸浮球。
配置餘額查詢¶
餘額查詢依賴 DEEPSEEK_API_KEY。有兩種常見配置方式：
- 在 DSH Web 的模型設置頁寫入
DEEPSEEK_API_KEY。 - 啓動 DSH 前設置環境變量：
export DEEPSEEK_API_KEY=sk-...
不配置該 Key 時，Token 用量與費用顯示仍然可用，只是餘額部分會顯示降級提示。
配置價格表與餘額查詢¶
價格表和餘額查詢可以通過 profile 的 cordis.patch.yml 覆蓋。
價格單位爲：
元 / 百萬 tokens
價格按模型 id 匹配，未匹配到具體模型時回落 default。
計費規則爲：
cacheWrite按輸入價計費cacheRead按緩存命中價計費
示例如下：
- id: token-cost
config:
prices:
deepseek-chat: { input: 2, cacheRead: 0.5, cacheWrite: 2, output: 8 }
deepseek-reasoner: { input: 4, cacheRead: 1, cacheWrite: 4, output: 16 }
deepseek-v4-flash: { input: 1, cacheRead: 0.25, cacheWrite: 1, output: 4 }
default: { input: 2, cacheRead: 0.5, cacheWrite: 2, output: 8 }
balance:
enabled: true
apiKeyEnv: DEEPSEEK_API_KEY
baseUrl: https://api.deepseek.com
pollMs: 60000
上面的價格只是配置示例，實際使用時應按 DeepSeek 官方價格調整。
典型用法¶
下面介紹安裝後的幾個常見操作。
查看剩餘餘額¶
鼠標懸停在鯨魚懸浮球上，外圈環形進度會顯示剩餘餘額百分比。
查看費用與餘額¶
點擊鯨魚展開卡片，可以看到：
- DeepSeek 賬號餘額
- 本次會話費用
- 輸入 / 緩存讀 / 緩存寫 / 輸出 Token
- 所有會話累計花費
- 按模型拆分的花費
移動懸浮球¶
按住鯨魚拖動，可以調整浮窗位置。靠近屏幕左右邊緣鬆手時，浮窗會自動吸附到邊緣。
關閉卡片¶
可以按以下任一方式關閉卡片：
- 點擊卡片外部
- 按
Esc - 點擊 ✕
- 再次點擊鯨魚
適用場景與注意¶
這個插件適合在 DSH 網頁端使用 DeepSeek 的開發者，尤其是需要頻繁確認 Token 用量、本次會話花費、累計花費和賬號餘額的場景。
使用前注意以下幾點：
- 餘額查詢依賴
DEEPSEEK_API_KEY，未配置時餘額部分會降級。 - 價格表可通過
cordis.patch.yml覆蓋，官方調價後需要同步更新。 - 浮窗位置記錄在瀏覽器本地
localStorage中。 - 插件會訪問 DSH 會話日誌並調用 DeepSeek 官方餘額接口，運行權限與當前 DSH 進程一致。安裝前應檢查源碼、配置項和許可證。
- 該插件許可證爲
MIT。
結尾¶
dsh-token-cost 的價值在於把 DeepSeek 的 Token 用量、會話花費、累計花費和賬號餘額集中到 DSH 網頁端的一個懸浮球裏，便於在實際調試和運行智能體時快速確認成本。
GitHub 倉庫地址：
https://github.com/PeterZoneZz/dsh-token-cost
