前言¶
在 DeepSeek Harness（DSH）Web UI 裏，會話統計通常需要看緩存命中率、token 用量和費用。dsh-gauge 是一個面向 DSH Web UI 的插件，用來在這些指標上提供更細的展示和估算。下面介紹它的功能、安裝、配置與注意事項。
這是什麼¶
dsh-gauge 是 noone89A/dsh-gauge 倉庫中的 DSH 插件，許可證爲 MIT。它面向 DeepSeek Harness Web UI，提供精確緩存命中率、token 用量分桶、上下文佔用、會話費用估算，以及高峯/閒時狀態展示。適合需要在會話級別覈對用量和費用估算的開發者。
核心功能¶
- 精確緩存命中率：按
cacheRead / (cacheRead + uncached + cacheWrite)計算，小數位可配置。 - 分桶 token 明細：展示命中 / 未命中輸入 token 與輸出 token；寫入桶爲 0 時自動隱藏。
- 會話費用估算與調價對比：按實際用量 × 模型單價估算，並自動跟隨 DeepSeek 官方調價。
- 按請求時刻峯谷計價：每條 assistant 消息按自身時間戳套用高峯/閒時費率。
- 高峯時段徽標：統計行尾顯示高峯/閒時狀態。
- 用量面板：顯示模型、命中率、計費輸入、各桶總數、上下文佔用與費用估算。
- 兩行統計：第一行保留官方會話指標，第二行顯示插件精確用量。
- 雙語與貨幣自適應：UI 爲英文時文案切英文、費用按 USD 估算；其餘情況按 CNY。
安裝與啓用¶
推薦用 dsh plugin 命令安裝：
dsh plugin --profile web add dsh-gauge
這條命令用於向 Web profile 添加插件。安裝後重啓 Web UI：
dsh web
經過上面的步驟後，DSH Web UI 中會出現插件提供的統計行和用量面板。
如果選擇手動安裝，可先做以下兩步：
cd ~/.dsh/profiles/web
npm install dsh-gauge
然後把 "dsh-gauge" 加入 profiles/web/package.json 的 dsh.profile.bundles。
本地開發或調試時，也可以用源碼方式安裝：
pnpm add file:C:/Object/dsh-plugin/dsh-gauge
源碼改動後執行：
npm run build
即可生效。
配置¶
如需調整配置，可進入：
設置 → 插件 → 可配置插件
在 dsh-gauge 卡片中調整配置；除 replaceNativeStatsLine 外，保存後立即生效。
也可以直接編輯：
~/.dsh/profiles/web/cordis.patch.yml
例如：
# ~/.dsh/profiles/web/cordis.patch.yml
- id: gauge
config:
showPrice: true
注意補丁條目是扁平 {id, ...} loader 條目；寫成 - update: 會被報錯拒絕。
如果修改了 replaceNativeStatsLine，或修改了 cordis.patch.yml，需要重啓：
dsh web
配置卡片顯示需把 gauge 加入 dsh-host-apiproxy 的 WEB_SETTINGS_NAMESPACES 白名單；不加入不影響核心功能。
適用場景與注意¶
適合在 DSH Web UI 中查看精確命中率、分桶 token、上下文佔用和費用估算的人。
注意：
- 費用爲估算值，以官方實際賬單爲準。
- 插件以當前
dsh進程權限運行；安裝前應檢查源碼與許可證。倉庫使用 MIT 許可證，源碼可在此查看：
https://github.com/noone89A/dsh-gauge
- DSH 插件生態強調“一切皆插件”；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，
dsh-gauge應作爲社區插件處理。
結尾¶
dsh-gauge 把 DSH Web UI 的命中率、token 分桶、上下文佔用和費用估算放到會話統計與面板中，便於覈對會話用量。GitHub 倉庫：
https://github.com/noone89A/dsh-gauge
如需在目錄中查找，可搜索插件名 dsh-gauge。
