前言¶
DSH 的原生底部狀態欄把信息放在一行。窗口較窄時,部分內容會被截斷。若要在會話旁邊持續查看模型、上下文壓力、token、生成速度和費用,固定的一行不夠用。
下面介紹 dsh-status-bar。它是 DSH 客戶端插件,替換內置 stats 行,提供一條可配置的狀態欄。
這是什麼¶
dsh-status-bar 由 Starlight-bananice 維護,許可證爲 MIT,分類爲客戶端。
在 DSH 插件化生態裏,它解決的是底欄信息展示問題:17 個信息段可以開關和排序,並支持換行、即時 TPS 與費用估算。
核心功能¶
- 17 個信息段可開關、可重排,覆蓋狀態、模型、上下文壓力、token、TPS、成本、任務/隊列等。
- 即時 TPS:基於
assistant/chunk事件逐塊更新。 - 費用估算:支持用戶維護模型價格簿、峯值/谷值計價、CNY/USD 貨幣選擇。
- 多行換行,避免狀態欄被截斷。
- 零配置默認:13 個信息段默認啓用。
- 替換內置
stats行,卸載後自動恢復內置狀態欄。 - 英文/中文 UI 字符串。
Usage & cost對話框:成本趨勢圖、分頁每步用量歷史、總成本展示。- 與
@linxin666/dsh-live-stats使用不同 projection key,可共存。
關於共存,已覈實事實寫明:兩者使用不同 projection key。dsh-status-bar 使用 statusBarLiveTokenUsage,@linxin666/dsh-live-stats 使用 liveTokenUsage。
安裝與啓用¶
先確認環境。已覈實 DSH 兼容版本爲 0.1.1-rc.2(mainline master);更早 RC 可能可用但未驗證。運行時要求 Node ≥ 22(host)和現代瀏覽器(client),無外部服務。
先用 npm 安裝:
dsh plugin --profile web add @bananiceee/dsh-status-bar
然後啓動或重啓 DSH Web。無需配置即可顯示默認狀態欄。
如果 pnpm 11 因新發布包的 24h minimumReleaseAge 拒絕同日安裝,可改用追加參數的安裝命令:
dsh plugin --profile web add @bananiceee/dsh-status-bar --config.minimumReleaseAge=0
經過上面的步驟,狀態欄應替換內置 stats 行。如果只想臨時隱藏,可進入:
Settings → Plugins → Status Bar
或使用齒輪菜單立即隱藏。
典型用法¶
1、安裝後重啓 DSH Web:
dsh plugin --profile web add @bananiceee/dsh-status-bar
2、在設置頁維護每模型價格和峯值/谷值時段。
3、通過 Usage & cost 對話框查看成本趨勢、每步用量歷史和總成本。
4、升級 npm 安裝:
dsh plugin --profile web update @bananiceee/dsh-status-bar
5、卸載:
dsh plugin --profile web remove @bananiceee/dsh-status-bar
卸載後會自動恢復內置狀態欄。瀏覽器 localStorage 裏的 dsh.statusBar.v1 和 host usage 文件不會自動刪除,如需清理要手動刪除。
適用場景與注意¶
適合需要在 DSH 界面內直接查看會話運行信息的場景:狀態、模型、上下文壓力、token、即時 TPS、費用估算、任務和隊列。它不依賴外部服務。
使用前檢查源碼和許可證。插件以當前 dsh 進程權限運行,安裝前應確認你信任維護者、倉庫和依賴。
與安裝環境相關的注意事項:
- pnpm 從 GitHub 安裝時可能不讀取 git proxy 配置;網絡失敗可設置
HTTPS_PROXY/HTTP_PROXY。 - 自 v0.1.5 起,倉庫提交構建產物,git 安裝無需構建;≤v0.1.4 需要手動構建。
- 與
@linxin666/dsh-live-stats同時啓用時,兩者使用不同 projection key,可以獨立共存。
鏈接¶
- GitHub:https://github.com/Starlight-bananice/dsh-status-bar
- 社區目錄頁(獨立站點,非官方應用商店;線索給出,未在已抓取資料中獨立覈實):https://www.skillhub.cn/plugins/Starlight-bananice/dsh-status-bar