前言¶
在 DSH（DeepSeek Harness）裏跑模型，token 消耗往往分散在多次調用裏：對話流裏看不到單次明細，輸入區也沒有會話累計，賬戶餘額還要另開頁面查。對需要控制成本、觀察緩存命中效果的開發者來說，這些信息分散在不同位置，很難形成即時反饋。
下面介紹 dsh-damage-pulse（維護者 wssfk12138）。它在 DSH Web 客戶端內提供扣血式餘額動畫、峯谷計費、會話費用統計，以及可選的鯨魚娘桌面夥伴，把 token 消耗和賬戶餘額拉到同一視野裏。
這是什麼¶
dsh-damage-pulse 是 DSH 的客戶端插件，分類爲「客戶端」。項目當前版本 0.3.2，MIT 許可證，GitHub 倉庫 wssfk12138/dsh-damage-pulse 約 107 stars。
插件監聽會話事件，按實際模型名和緩存命中情況精確計費，在界面上展示：
- 每次調用的 token 明細與金額
- 當前會話累計消費
- DeepSeek 賬戶即時餘額
- 扣費時的受擊回彈與飄字動畫
項目公開品牌爲 dsh-damage-pulse，內部目錄名、API 路徑和設置命名空間仍沿用 dsh-token-monitor，已安裝用戶無需遷移配置。
核心功能¶
單次用量與會話累計¶
每次模型調用結束後，對話流內插入一行 token 明細，包含輸入、緩存命中、輸出、思考（reasoning）分項及精確金額。
輸入框上方持續顯示當前會話累計 token 與金額，數據來自 tokenCost session projection。標準包在輸入區展示；若使用完整 DSH 源碼並執行側邊欄集成腳本，還可選在左側原生會話列表顯示累計金額。
緩存感知扣血動畫¶
餘額數字在每次 token 消耗時受擊回彈，並飄出紅色扣費數值：
- 純緩存命中：普通紅色
-x.xx¥脈衝 - 存在緩存未命中輸入或緩存寫入：更大的「未命中 -x.xx¥」、短促橫向抖動和更強回彈
同一秒合併的多筆扣費中，只要有一次未命中，整組按未命中播放。連續扣費最多保留三組飄字。
餘額懸浮窗¶
餘額卡片支持拖動，位置自動記憶（localStorage）。主要能力包括：
- 充值檢測：餘額變多時飄出綠色
+x.xx¥ - 峯谷標識：餘額欄右側顯示「峯」（紅 / 高峯）或「谷」（綠 / 谷時），帶紅綠燈發光效果
- 未配置 API Key 時顯示引導態，token 計量仍正常進行
峯谷計費與價格表¶
內置 DeepSeek 2026-08-23 定價規則。工作日按峯谷時段計費，週末全天統一按谷價；歷史費用按每條調用發生的北京時間自動判定，漲價前已算的費用不會重算。
默認峯谷時段（北京時間，週一至週五）：
- 峯價：
9:00–12:00、14:00–18:00 - 其餘時間爲谷價
- 週六、週日無論時段均按谷價
按每次調用的實際模型名計價，支持 deepseek-v4-pro、deepseek-v4-flash、deepseek-v4-flash-vision-exp 及版本後綴最長前綴匹配。緩存命中與未命中分別計價。
可通過 settings namespace dsh-token-monitor 的 priceTable 字段覆蓋價格和工作日高峯時段。
鯨魚娘¶
鯨魚娘是餘額懸浮框上的桌面夥伴：
- 模型運行時用啃手指、眨眼等待機動作
- 根據 token 扣費強度做出對應反應
- 連續扣費、餘額耗盡、從非正餘額充值恢復時有獨立動作反饋
可隨餘額框拖動，也可在餘額框右鍵菜單中隱藏。
HTTP 端點¶
插件註冊以下 HTTP 端點，供客戶端組件讀取：
| 端點 | 說明 |
|---|---|
GET /api/token-monitor/balance |
DeepSeek 賬戶餘額（含 currency / 總餘額 / 贈送餘額） |
GET /api/token-monitor/usage?sessionId= |
用量明細歷史（可過濾會話） |
GET /api/token-monitor/charge-events?since=<seq> |
扣費事件增量（含 damageKind，驅動緩存感知扣血動畫） |
安裝與啓用¶
插件從 0.2.0 起爲標準 DSH Host + Client 組合包，已提交預編譯產物。要求 DSH 0.1.1-rc.2 或更高兼容版本，無需複製源碼、修改 tsconfig、手動傳入 --patch 或重建 Client bundle。
1、安裝插件：
dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse
2、重啓 Web profile：
dsh --profile web
安裝後標準包直接提供餘額懸浮欄、餘額即時扣減、緩存命中/未命中動畫、單次用量行和輸入區會話累計。
若從早期源碼集成版升級，請移除原有手工 --patch 或重複掛載項，避免同一插件加載兩次。
注意： 插件以當前 dsh 進程權限運行。安裝前應檢查 GitHub 倉庫 源碼與 MIT 許可證，確認符合你的使用場景。
配置¶
API Key¶
通過 DSH 的 credentials 機制配置 DEEPSEEK_API_KEY，寫入 ~/.dsh/.credentials.yaml。未配置時餘額卡片顯示引導態，token 計量不受影響。
微信通知（可選）¶
0.3.2 起內置輕量 ClawBot 適配器，按優先級選擇通知 provider：新版外部 wechat-notify 能力對象 → 舊版 send() / status() 接口 → 內置適配器。若已安裝獨立 dsh-wechat-notify，本插件會複用其發送能力；未安裝時，配置 WECHAT_NOTIFY_CLAWBOT_INDEX 後內置適配器可開箱發送。微信未登錄或發送失敗不會阻塞餘額監控與動畫。
典型用法¶
安裝並重啓後，正常使用 DSH 對話即可，無需額外命令。每次模型調用結束，對話流內自動出現用量行；輸入區上方顯示會話累計；餘額懸浮窗即時反映扣費與峯谷狀態。
需要查看賬戶餘額時，觀察餘額懸浮窗，或通過 HTTP 端點查詢：
GET /api/token-monitor/balance
需要拉取某會話的用量歷史：
GET /api/token-monitor/usage?sessionId=<會話ID>
適用場景與注意¶
適合誰：
- 在 DSH Web 客戶端日常跑 DeepSeek 模型，希望即時看到每次調用花了多少 token 和金額
- 需要觀察緩存命中效果，並通過動畫區分命中與未命中扣費
- 使用 DeepSeek 峯谷定價，希望按北京時間自動判定每條調用的計費時段
常見問題：
- 餘額卡片顯示「未配置」：未配置
DEEPSEEK_API_KEY，token 計量仍正常 - 左側原生會話行沒有金額：屬於源碼增強功能，需完整 DSH 源碼並執行
scripts/apply-sidebar-integration.ps1；輸入區會話累計不受影響 - 窗口啓動後仍無動畫：確認已重啓安裝目標 profile；若曾使用源碼集成版，先刪除舊的手工 patch 和重複掛載
鏈接¶
- SkillHub 目錄頁：wssfk12138/dsh-damage-pulse
- GitHub 倉庫：github.com/wssfk12138/dsh-damage-pulse
dsh-damage-pulse 把 token 消耗、會話累計和賬戶餘額收進 DSH 界面，用扣血動畫和峯谷標識給出即時反饋。若你正在 DSH 裏控制模型成本，可以按上述步驟安裝試用。
