前言¶

使用 DSH 做智能體開發時，常見的問題不只是“這一次會話用了多少 token”，而是多個 workspace、多個項目、多個模型同時存在時，用量分佈、緩存命中、成本趨勢和官方餘額如何一起看。

dsh-pulse 是面向 DSH 的 web UI 插件，把這些信息放在同一個觀察臺裏。它主要解決三類問題：

1、跨會話的 token 用量趨勢；
2、按模型、項目維度的用量與成本拆分；
3、DeepSeek 官方餘額與成本估算的對照查看。

下面介紹它的定位、功能、安裝方式、典型用法和注意事項。

這是什麼¶

dsh-pulse 是一個 DSH 插件，維護者爲 Enc-hanted，許可證爲 MIT。

它運行在 DSH 的 UI 平面上，不提供模型可見工具，不額外消耗 token。插件本身不保存密鑰。

它提供的是一張跨會話用量與成本觀察臺，包含：

• daily token charts；
• cache hit ring；
• 90 天 / 1 年熱力圖；
• 模型與項目拆分；
• 自適應顏色主題；
• CSV 導出。

核心功能¶

1、用量趨勢¶

dsh-pulse 的用量趨勢支持多個時間窗口：

• 今天的小時級折線圖；
• 7 天 / 30 天的每日柱狀圖；
• 90 天 / 1 年的 GitHub-style heatmap；
• 最多 30 天的自定義日期範圍。

這個部分適合先看整體趨勢，再縮小到某一天或某一週。

2、項目與模型過濾¶

儀表盤提供兩個可搜索下拉框，可以按 workspace 和模型過濾。

選擇其中一個 workspace，或同時選擇一個 workspace 和一個模型後，整個儀表盤的數據都會收斂到對應範圍。

3、跨 provider 模型區分¶

模型標籤來自 Models 配置，格式爲：

provider · display name

當多個 provider 提供同名模型時，可以通過 provider 前綴區分它們。

4、模型分佈與項目排名¶

dsh-pulse 會展示：

• 模型 share bars；
• 項目 ranked table。

這兩部分適合回答“哪個模型用得最多”和“哪個項目消耗最多”的問題。

5、會話詳情與 subagent 歸因¶

會話會按項目分組，並提供：

• subagent subtotal；
• per-session break analysis。

這有助於把一次任務裏的研究、思考、總結等階段拆開來看。

6、成本估算¶

成本估算基於 per-model rates，並區分 peak / off-peak tiers。

沒有匹配規則的模型會顯示爲 unpriced。

需要說明的是，成本估算使用手動匯率 usdToCny，默認值爲：

6.8

它是一個估算器，不是賬務口徑。

如果不想顯示成本數字，可以設置：

costEnabled: false

這會隱藏成本相關數字，但保留其他用量數字。

7、成本趨勢¶

成本趨勢提供每日 sparkline。

在積累滿一天 snapshots 後，會在同一張圖裏疊加官方餘額對賬線。

8、官方餘額¶

如果已經保存了 DEEPSEEK_API_KEY，dsh-pulse 可以查詢 DeepSeek 平臺餘額，並支持手動刷新。

查詢使用的是 host 已經保存的 key，插件本身不保存密鑰。

9、CSV 導出¶

在 dashboard header 裏可以一鍵導出當前加載窗口。

導出內容爲 UTF-8 CSV daily table。

安裝與啓用¶

dsh-pulse 要求：

node >=22.15

安裝命令：

dsh plugin --profile web add -w dsh-pulse

安裝後，重啓 dsh web，然後打開：

Settings → Usage Pulse

安裝完成後，可以在 DSH 的 web UI 裏使用 dsh-pulse 的儀表盤。

典型用法¶

1、在會話中查看文本摘要¶

在任意 DSH 會話中輸入：

/pulse

它會打印一個文本摘要。

2、打開浮動面板¶

在 DSH web 側邊欄底部按鈕處，可以打開 dsh-pulse 的浮動面板。

3、查看官方餘額與對賬線¶

如果已保存 DEEPSEEK_API_KEY，儀表盤會顯示官方餘額。

當 snapshots 積累滿一天後，成本趨勢圖裏會出現官方餘額對賬線。

配置與限制¶

dsh-pulse 的本地保存位置是：

$DSH_HOME/settings.yaml

具體寫入其中的 pulse: section。

配置修改會立即生效，並能在重啓後保留。

需要注意的是：

• 沒有 llm service 時，沒有可編輯的行；
• 沒有 settings service 時，頁面爲只讀；
• 成本數字是估算值，不適合作爲賬務依據；
• 未配置規則的模型會顯示爲 unpriced。

卸載與殘留¶

卸載命令：

dsh plugin --profile web remove -w dsh-pulse

卸載後，以下內容可以安全刪除：

~/.dsh/settings.yaml 中的 pulse section
~/.dsh/storages/pulse_balance.json

適用場景與注意¶

dsh-pulse 適合需要長期觀察 DSH 用量的開發者，尤其是同時使用多個項目、多個模型、多個 provider 的場景。

它適合用來回答這些問題：

• 今天 token 消耗集中在哪個時間段？
• 最近 7 天、30 天的用量趨勢如何？
• 哪個項目或哪個模型消耗最多？
• 官方餘額還能支撐多久？
• 成本估算和官方餘額之間有什麼差異？

使用前需要注意：

• dsh-pulse 作爲 DSH 插件運行，會訪問 DSH 本地配置與已保存的 key；
• 插件以當前 dsh 進程權限運行；
• 安裝前應檢查源碼與 MIT 許可證；
• 成本估算不等於官方賬務結果；
• 插件本身不保存密鑰。

鏈接¶

GitHub 倉庫：

https://github.com/Enc-hanted/dsh-pulse