whale-purse：住在 DSH 網頁裏的鯨魚娘桌寵，幫你盯餘額和花費

前言¶

用 DeepSeek Harness（DSH）跑任務時，有一個常見的不便：你想知道賬戶還剩多少錢、今天花了多少、當前會話燒了多少 token，就得離開網頁去官方平臺翻用量頁面。任務一多，這種來回切換很打斷思路。

whale-purse 把這件事放回了 DSH 網頁內部：一隻鯨魚娘桌寵懸浮在頁面上，點開就能看餘額、官方「今日已消費」、當前會話的用量和花費，以及近 7 天的歷史趨勢。下面介紹它的功能、安裝方法和配置項。

這是什麼¶

一句話定位：住在 DSH 網頁裏的鯨魚娘桌寵，盯 DeepSeek 賬戶餘額、官方「今日已消費」、當前會話用量/花費與近 7 天曆史趨勢。

核心功能¶

桌寵與提醒¶

透明立繪懸浮在 DSH 網頁上，隨波搖擺、腳底投影，點擊會做 squash 彈跳回應
可拖拽換位，位置記在 localStorage，刷新或重開後保持
後臺會話跑完時，鯨魚娘彈跳並在頭頂冒泡「任務完成啦」，點氣泡可直達完成的會話
有任務運行時忙碌抖動，並顯示「忙…」標籤
外接大屏和筆記本切換時，自動把桌寵夾回視口內

餘額與「今日已消費」¶

餘額來自 DeepSeek 官方 Get User Balance 接口（GET https://api.deepseek.com/user/balance），每 30 秒輪詢一次，帶併發去重。「今日已消費」調用 platform.deepseek.com/api/v0/usage/cost，顯示與官方 usage 頁面一致的數據，這一項需要單獨配置平臺 token（見下文）。

會話用量與歷史趨勢¶

會話用量讀 sessionProjections 的 tokenUsage 投影，按官方價格對輸入、緩存讀、緩存寫、輸出分桶折算：已落盤的消息按各自發生時的峯谷檔計價，進行中的增量按當前檔計價。這部分是本機記賬（sessionProjections 加會話日誌回放加官方價格），不需要額外憑證。

點桌寵打開雙 Tab 面板：「當前」Tab 看餘額、今日已消費和即時花費；「歷史」Tab 看近 7 天花費柱狀圖，以及本會話每條提問的花費明細。

峯谷定價與界面適配¶

北京時間 9:00-12:00 / 14:00-18:00 的高峯價會自動切換，官方定價頁每 6 小時自動抓取一次。面板顏色和柱狀圖通過 --dsw-alias-* token 跟隨 DSH 淺色/深色主題切換。

安裝與啓用¶

前置條件：Node.js 與 pnpm，並已安裝 dsh：

npm i -g @deepseek-ai/dsh

方式一：一條命令（推薦）¶

dsh plugin --profile web add github:liuherong808-dev/dsh-whale-purse

該包聲明瞭 dsh.bundle，dsh plugin 會自動把它加進 profile 的 bundle 層。然後重啓 dsh web 並刷新頁面。

方式二：手動安裝¶

先把倉庫軟鏈進 web profile 的依賴目錄：

ln -s "$(pwd)" ~/.dsh/profiles/web/node_modules/whale-purse

再在 ~/.dsh/profiles/web/cordis.patch.yml 里加一條 insert：

- insert:
    - id: whale-purse
      name: 'whale-purse'
      config:
        model: pro
        refreshIntervalSeconds: 30

最後重啓 dsh web 並刷新瀏覽器。

配置項¶

字段	默認值	說明
`model`	`pro`	計價模型：`pro` / `flash`
`refreshIntervalSeconds`	`30`	餘額輪詢間隔（秒）
`apiKeyEnv`	`DEEPSEEK_API_KEY`	API key 的憑據引用名
`baseUrl`	`https://api.deepseek.com`	餘額接口 base URL
`pricingRefreshHours`	`6`	官方定價頁抓取間隔（小時）
`enabled`	`true`	是否啓用餘額查詢

餘額接口需要能解析到 DEEPSEEK_API_KEY，解析順序是憑據縫、啓動環境、process.env 逐層回退。

「今日已消費」需要平臺會話 token：登錄 https://platform.deepseek.com 後，在 DevTools Console 執行：

JSON.parse(localStorage.getItem('userToken')).value

把得到的值寫入憑證 DEEPSEEK_PLATFORM_TOKEN（~/.dsh/.credentials.yaml 或啓動環境）。未配置時這一項顯示「需配置平臺 token」，其餘功能不受影響。

適用場景與注意¶

適合長期用 DSH 網頁跑任務、想隨手掌握餘額和花費的人，尤其是開着多個後臺會話、需要任務完成提醒的場景。

安裝前有兩點要注意：

插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼與許可證（MIT）。
「今日已消費」要用到平臺會話 token，這個憑證權限不低，自己權衡是否配置；不配置也不影響餘額和本地記賬功能。

結尾¶

whale-purse 把餘額、消費和會話花費這些原本要切頁面才能看到的信息，收進了一隻可拖拽的桌寵裏，本地記賬部分不需要任何額外憑證，裝完即用。

插件目錄頁：https://www.skillhub.cn/plugins/liuherong808-dev/dsh-whale-purse
GitHub 倉庫：https://github.com/liuherong808-dev/dsh-whale-purse

需要說明的是，插件目錄是社區獨立維護的站點，與 DeepSeek、幻方沒有官方從屬關係。