前言¶
在 DSH 中接入 DeepSeek 會話後，常見需求是看清當日到底消耗了多少 Token、按峯谷計價大約花了多少錢、當前是否處於谷時段。dsh-monitor 是 DSH 原生插件，直接在 DSH 內部事件流上累計數據，不需要瀏覽器擴展，也不經過頁面網絡層。
DSH 生態強調「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。本文只介紹已覈實資料中的能力與接入步驟。
這是什麼¶
dsh-monitor 是一個 DSH 原生插件，定位是「即時 API 用量監控與峯谷價格提示懸浮窗」。
插件倉庫路徑爲 iambbp/dsh-monitor，許可證爲 MIT。
它解決的核心問題是：在 DSH 會話界面裏直接顯示當日真實 Token 消耗、按 DeepSeek 官方峯谷定價計算的費用、峯谷狀態、交互次數、平均消耗和配額進度，並提供數據 API 與持久化記錄。
核心功能¶
下面按能力列：
- 即時累計當日全部會話的真實 Token 消耗，包括輸入、緩存命中和輸出。
- 按 DeepSeek 官方峯谷定價計算今日費用，谷時段自動半價。
- 按
turn/start事件統計今日交互次數。 - 顯示今日平均每次交互的 Token 數。
- 顯示峯谷狀態圈和即時北京時間。
- 顯示今日費用與配額上限的進度條。
- 顯示峯谷圖例和官方時段說明。
- 一鍵複製今日用量文字報告到剪貼板。
- 支持立即刷新，默認每 2 秒自動輪詢。
- 懸浮窗可拖拽、摺疊成小藥丸或隱藏。
- 數據持久化到
~/.dsh/dsh-monitor.json，歷史保留 90 天。 - 提供
GET /api/dsh-monitor數據 API。
這些功能都圍繞「當日累計」展開：Token、費用、交互次數和平均消耗都針對當前統計日，歷史數據保留 90 天。
安裝與啓用¶
已覈實資料中沒有找到單一官方安裝命令原文。以下按資料給出的多步驟手動配置說明接入方式。先準備好插件源碼，並把它放到 profile 目錄下，例如 ~/.dsh/profiles/web/dsh-monitor。
1、在 ~/.dsh/profiles/web/package.json 的依賴中添加插件引用：
{
"dependencies": {
"dsh-monitor": "file:./dsh-monitor"
}
}
這一步的作用是讓 profile 通過 file: 鏈接加載本地插件目錄。
2、在 ~/.dsh/profiles/web/cordis.patch.yml 追加加載項：
- insert:
- id: dsh-monitor
name: 'dsh-monitor'
config:
quotaLimit: 10
其中 quotaLimit 用於設置今日配額上限，默認值爲 10 元。
注意：bundles 數組只放 bundle 組裝包，不要把單個插件加進 bundles，否則 DSH 啓動會卡住。
3、在 profile 目錄安裝依賴，同步本地插件鏈接：
cd ~/.dsh/profiles/web
corepack pnpm install
4、重啓 DSH，例如執行：
dsh web
5、驗證是否啓用。啓動 DSH 後打開：
http://127.0.0.1:3080/
按 F5 刷新頁面，右上角出現懸浮窗即表示頁面側已加載；也可以訪問：
http://127.0.0.1:3080/api/dsh-monitor
該接口應返回 JSON 數據。
如果後續修改了 lib/index.js，必須重新執行：
corepack pnpm install
然後重啓 DSH，使鏈接和啓動邏輯同步。
典型用法¶
下面介紹安裝後的常見操作。
1、啓動 DSH 後按 F5 刷新頁面，右上角出現懸浮窗。
2、按住面板標題欄拖動到任意位置。
3、點標題欄右側的 –，將懸浮窗摺疊成小藥丸。
4、點關閉按鈕隱藏懸浮窗，狀態會記憶在 localStorage。
5、點「複製報告」，把今日用量文字報告寫入剪貼板。
6、點「刷新」，立即重新拉取數據；平時默認每 2 秒自動輪詢。
複製報告適合在需要向他人說明今日消耗時直接粘貼；懸浮窗的摺疊和隱藏適合長時間使用時避免遮擋頁面。
數據與 API¶
插件數據來自 DSH 內部事件系統，不需要瀏覽器擴展，也不經過頁面網絡層。
前端懸浮窗通過 GET /api/dsh-monitor 獲取數據，該接口也可供其他工具調用。
持久化文件爲：
~/.dsh/dsh-monitor.json
歷史數據保留 90 天，超出部分自動裁剪。
適用場景與注意¶
適合以下使用者：
- 在 DSH 中使用 DeepSeek 會話，需要查看當日 Token 和費用的人。
- 希望按峯谷時段判斷當前計費狀態的人。
- 需要把當日用量報告複製到剪貼板的人。
- 需要調用
GET /api/dsh-monitor獲取 JSON 數據的開發者。
安裝前注意：
- 插件以當前
dsh進程權限運行，應檢查源碼與許可證。 - 許可證爲 MIT。
- 已覈實資料未提供單一官方安裝命令，本文只列出多步驟手動配置。
bundles只放 bundle 組裝包，不放單個插件。- 修改
lib/index.js後要執行corepack pnpm install並重啓 DSH。
結尾¶
dsh-monitor 的價值是把 DeepSeek 會話的當日 Token、峯谷費用和交互次數放到 DSH 頁面內直接查看，並通過持久化文件和 JSON API 提供後續使用入口。
相關鏈接：
- GitHub: https://github.com/iambbp/dsh-monitor
- 目錄頁: https://www.skillhub.cn/plugins/iambbp/dsh-monitor
