前言¶
DSH 的理念是“一切皆插件”。在 DSH web 中調用 DeepSeek API 時，當前會話花了多少、今天累計多少、賬戶還剩多少，通常分散在不同位置。bobcat848/dsh-calculator 解決的是這個顯示問題：把 DeepSeek API 費用和賬戶餘額放在 DSH web GUI 右上角的浮層卡片裏，並且可以摺疊成膠囊。
這是什麼¶
下面介紹 bobcat848/dsh-calculator。
- 維護者：
bobcat848 - 許可證：
MIT - 當前版本：
1.3.4 - 定位：一個 DSH web 插件，在 DSH web GUI 右上角顯示 DeepSeek API 費用和賬戶餘額，可摺疊爲膠囊。
核心功能¶
- 在 DSH web GUI 右上角顯示 DeepSeek API 費用卡片，點擊
×可摺疊爲膠囊，點擊膠囊可展開。 - 顯示當前會話費用，按模型展示。
- 顯示當天全部會話累計費用，按模型展示；按本地時區計算，當地午夜重置。
- 顯示 DeepSeek API 賬戶餘額，通過
GET /user/balance獲取，30 秒緩存。 - 只對
deepseek-official路由計費，其他provider/model顯示爲未計費。 - 按北京峯谷計價；2026-08-23 起，週六、週日全天按半價計費。
- 跟隨瀏覽器語言提供中英文界面（
zh/en）。
安裝與啓用¶
安裝會寫入插件目錄：
~/.dsh/profiles/node_modules/dsh-calculator
並追加 loader 行到：
~/.dsh/profiles/web/cordis.patch.yml
macOS / Linux¶
在線安裝：
curl -fsSL https://raw.githubusercontent.com/bobcat848/dsh-calculator/main/install.sh | bash
Windows PowerShell¶
在線安裝：
irm https://raw.githubusercontent.com/bobcat848/dsh-calculator/main/install.ps1 | iex
本地克隆安裝¶
先克隆倉庫：
git clone https://github.com/bobcat848/dsh-calculator.git
進入倉庫後，運行本地安裝腳本：
bash install.sh
Windows PowerShell 中使用：
.\install.ps1
重啓並查看¶
安裝後執行以下命令重啓 DSH web：
dsh web --port 3080
cordis.patch.yml 改動通常可通過 HMR 熱更新。
打開或刷新：
http://127.0.0.1:3080
在右上角查看費用卡片。點擊 × 摺疊爲膠囊，點擊膠囊展開。
缺少 API key 時的行爲¶
插件需要 DeepSeek API key，不需要額外配置。如果缺少 key，餘額卡片會顯示友好錯誤，費用面板繼續工作。
卸載¶
刪除插件目錄：
rm -rf ~/.dsh/profiles/node_modules/dsh-calculator
並從：
~/.dsh/profiles/web/cordis.patch.yml
刪除對應 insert 行。
適用場景與注意¶
適合在 DSH web 中使用 DeepSeek API，並希望在一個位置查看會話費用、當天累計費用和賬戶餘額的開發者。
需要注意：
- 費用爲估算值，與官方賬單可能存在差異。
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼與許可證。 v1.2.0+只兼容提供shell.overlay插槽的 DSH 版本；舊版 DSH（含aside插槽）請使用v1.1.x。z-index修復將[data-shell-overlay]設置爲z-index:60，低於模態/彈層。- 瀏覽器實測範圍：
Chrome 151（Chromium）；Safari/Firefox 未驗證。 - 社區目錄是獨立站點，與 DeepSeek 官方無從屬關係。
- 本項目與 DeepSeek 官方無任何關聯。
鏈接¶
社區目錄：
https://www.skillhub.cn/plugins/bobcat848/dsh-calculator
GitHub：
https://github.com/bobcat848/dsh-calculator
