前言¶

DeepSeek Harness（DSH）處於 developer preview，Web UI 默認不直接展示會話上下文佔用和 token 使用歷史。做會話調試時，經常要確認當前窗口由 system、tools、messages 各佔多少，KV-cache 命中率如何，以及過去若干周的 token 消耗集中在哪些天。

dsh-scope 是一個面向 dsh Web UI 的插件，提供 Codex 風格 /context 會話上下文佔用視圖，以及 GitHub 貢獻圖風格的滾動 53 周 token 使用熱力圖。下面介紹它的核心功能、安裝方式、典型用法和注意事項。

這是什麼¶

dsh-scope 由 helloxkk 維護，許可證爲 MIT，package.json 中聲明客戶端平臺爲 web。

它主要提供兩個界面能力：

1、在 dsh Web UI 中顯示當前會話的上下文窗口占用，並展示 system / tools / messages 的組成佔比、各桶會話總量和 KV-cache 命中率。

2、在 sidebar footer 提供 GitHub 貢獻圖風格的滾動 53 周 token 使用熱力圖；點擊某個日期，可查看四桶 token、cache 命中率、會話數與模型排名。

插件通過官方 token-meter session projections 讀取數據，使用 useProjection，不使用 RPC 或自定義 wire protocol。宿主側提供只讀、loopback-only 的聚合端點 /api/dsh-scope/days。

核心功能¶

會話上下文視圖¶

dsh-scope 在 dsh Web UI 中提供會話上下文佔用視圖，可查看：

• 當前會話的上下文窗口占用；
• system / tools / messages 的組成佔比；
• 各桶會話總量；
• KV-cache 命中率。

這些數據通過官方 token-meter session projections 讀取，並使用 useProjection 獲取，不引入自定義 RPC 或 wire protocol。

53 周 token 使用熱力圖¶

插件在 sidebar footer 提供一個 GitHub 貢獻圖風格的滾動 53 周 token 使用熱力圖。

點擊熱力圖中的某個日期後，可以看到當天的：

• 四桶 token；
• cache 命中率；
• 會話數；
• 模型排名。

本地聚合與主題適配¶

宿主端提供 /api/dsh-scope/days 端點，用於讀取按天聚合的數據。該端點只讀，且僅允許 loopback 調用者和 GET 方法。

聚合支持增量計算，狀態會緩存到內存，並持久化到：

~/.dsh/storages/dsh-scope-cache.json

插件使用 dsh 的平臺設計變量適配淺色/深色主題。

安裝與啓用¶

先確認本機已有 dsh >= 0.1.0-rc.6 在 PATH 中。然後安裝插件到 web profile，再啓動或重啓 dsh web 加載插件：

dsh plugin --profile web add dsh-scope
dsh web

如果從源碼安裝，先構建，再安裝到 web profile：

git clone https://github.com/helloxkk/dsh-scope.git
cd dsh-scope
npm install && npm run build
node scripts/install.mjs web
dsh web

其中 node scripts/install.mjs web 用於把插件裝入 web profile，最後的 dsh web 用於重啓 dsh 以加載插件。

典型用法¶

經過上面的安裝步驟，打開 dsh Web UI 後可以看到：

1、在會話上下文中查看窗口占用、system / tools / messages 佔比、各桶會話總量和 KV-cache 命中率。

2、在 sidebar footer 查看滾動 53 周 token 使用熱力圖。

3、點擊熱力圖中的某個日期，查看四桶 token、cache 命中率、會話數和模型排名。

這些數據來自 dsh 已計算的 session projections，並通過插件提供的只讀端點聚合返回。插件不讀取 provider credentials，也不對外發送數據。

卸載與清理¶

移除 web profile 下的插件目錄：

rm -rf ~/.dsh/profiles/web/node_modules/dsh-scope

然後打開 ~/.dsh/profiles/web/cordis.patch.yml，刪除其中的 dsh-scope 塊。

如果還想清掉聚合緩存，可執行：

rm -f ~/.dsh/storages/dsh-scope-cache.json

該文件保存 dsh-scope 的聚合狀態，刪除後隻影響緩存，不再保留該聚合狀態。

適用場景與注意¶

適合在 dsh Web UI 中查看上下文佔用、token 歷史、模型排名和 KV-cache 命中率的開發者或調試場景。需要注意：

• dsh-scope 要求 dsh >= 0.1.0-rc.6 在 PATH 中。
• DeepSeek Harness 處於 developer preview，後續可能有兼容性破壞變化。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• /api/dsh-scope/days 僅允許 loopback 調用者和 GET 方法，不讀取 provider credentials，不對外發送數據。
• 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應理解成官方應用商店。

鏈接¶

• GitHub：https://github.com/helloxkk/dsh-scope
• 目錄頁（插件線索提供）：https://www.skillhub.cn/plugins/helloxkk/dsh-scope