前言¶

在 DSH 的日常使用中，近 90 天的提交、Token 用量和估算花費可能分散在不同來源，臨時查一次很容易，但長期觀察還不夠方便。dsh-heatmap 是一個 DSH 插件，把這類活動信息常駐到 DSH Web GUI 左側欄，便於查看近 90 天趨勢和今日明細。

DSH 生態強調「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。下面介紹 dsh-heatmap 是什麼、能做什麼，以及如何安裝和配置。

這是什麼¶

dsh-heatmap 是由 283Gawin 維護的 DSH Web GUI 左側欄活動熱力圖插件，許可證爲 MIT。倉庫名爲 dsh-heatmap，npm 包名爲 @linxin666/dsh-client-ui-activity-heatmap。

它解決的問題是：在 DSH Web GUI 中常駐顯示近 90 天 GitHub 風格活動熱力圖，並支持在提交次數、Token 用量、估算花費之間切換。熱力圖下方還提供今日所有會話 Token 總量、緩存命中率、今日花費，以及今日按模型的花費細分。

核心功能¶

下面列出的功能均來自已覈實信息：

• 在 DSH Web GUI 左側欄常駐顯示近 90 天 GitHub 風格活動熱力圖。
• 支持提交次數、Token 用量、估算花費三個維度切換，選擇保存在瀏覽器 localStorage。
• 鼠標懸停顯示當日提交數、Token 和花費明細。
• 顯示今日所有會話 Token 總量、緩存命中率和今日花費。
• 顯示近 90 天窗口的 Token、提交、花費合計，以及今日按模型的花費細分。
• 面板常駐左側欄底部，支持摺疊、狀態持久化和 React 重渲染後自動復位。
• 設置頁插件分區提供 theme、enabled、includeMerges、usdCnyRate、priceOverrides 配置。
• 數據由 host 進程通過官方 SDK 讀取會話 durable 日誌和 git log，經 GET /activity-heatmap/stats 提供，TTL 緩存 60 秒。
• 內置模型定價表，支持價格覆蓋和模型 id 前綴匹配。

安裝與啓用¶

先做最簡安裝：從 npm 包安裝，然後重啓 dsh web。

dsh plugin --profile web add @linxin666/dsh-client-ui-activity-heatmap

重啓後，左側欄即出現熱力圖面板：

dsh web

如果需要本地 link 安裝，需要先構建產物。link 安裝需要構建產物 lib/。

git clone https://github.com/283Gawin/dsh-heatmap
cd dsh-heatmap
pnpm install && pnpm build # link 安裝需要構建產物（lib/）
dsh plugin --profile web add link:$PWD

經過上面的步驟後，重啓 dsh web，左側欄即出現熱力圖面板。

設置頁暴露¶

設置頁暴露需要把 namespace activity-heatmap 加入 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名單。

dsh-host-apiproxy
WEB_SETTINGS_NAMESPACES
activity-heatmap

注意：升級 dsh 後該修改會被覆蓋，需要重新打補丁。修改後重啓 dsh web 生效。

典型用法與配置¶

插件安裝後，在設置頁「插件 → 活動熱力圖」卡片配置。修改後重啓 dsh web 生效。

已覈實的配置項包括：

插件行 config 可配置 id、name、theme、usdCnyRate、priceOverrides。下面是一個簡例，其中 priceOverrides 的具體覆蓋內容按實際模型和定價填寫：

- insert:
    - id: ui-activity-heatmap
      name: '@linxin666/dsh-client-ui-activity-heatmap'
      config:
        theme: green
        usdCnyRate: 7.2
        priceOverrides: {}

定價與模型覆蓋¶

dsh-heatmap 內置模型定價表，並支持價格覆蓋。模型 id 支持前綴匹配；priceOverrides 同樣支持前綴匹配。

未收錄的模型默認按 0.27 / 0.07 / 1.10 計價，可用 priceOverrides 做覆蓋。

usdCnyRate 默認 0。0 表示不顯示人民幣。

適用場景與注意¶

適合希望把 DSH 近 90 天提交、Token 用量和估算花費常駐在 Web GUI 左側欄的使用者。

使用前注意以下幾點：

• includeMerges 默認 false，默認提交數不含 merge 提交。
• usdCnyRate 默認 0，0 表示不顯示人民幣。
• 設置頁暴露依賴 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名單；升級 dsh 後該修改會被覆蓋，需要重新打補丁。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• peerDependencies 要求 @deepseek-ai/cordis ^4.0.1、多個 @deepseek-ai/dsh-client-* 包以及 React ^18.2.0。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/283Gawin/dsh-heatmap
• GitHub：https://github.com/283Gawin/dsh-heatmap