DSH 的插件生態允許對桌面端界面進行擴展。默認的對話區底部統計行功能有限，難以滿足精細化成本控制和數據查看的需求。dsh-desktop-statusbar 插件通過替換默認統計行，提供了一套高度可配置的狀態欄方案。
這是一個由 raphael-y7 維護的客戶端插件。它將原本固定的統計行替換爲包含 10 個可選字段的狀態欄，支持按官方峯谷口徑估算費用，並允許自定義模型單價、計價單位和賬戶餘額。
安裝¶
通過命令行安裝：
dsh plugin --profile desktop add dsh-desktop-statusbar
插件面板與命令行兩種方式均可使用，安裝源默認爲 npm registry。網絡受限時，可在同一對話框內將安裝源切換爲「中國大陸鏡像源」，亦支持直接通過 GitHub 倉庫地址安裝。
核心功能¶
- 10 個可選字段：上下文佔用（欄首圓環）、峯谷判斷、輪次＆步數、緩存命中率、輸出速度、首字平均、運行用時、本輪費用、總計費用、賬戶餘額。
- 點擊查看詳情：點擊任意字段可展開下鑽查看。例如，上下文佔用可查看系統提示詞、工具定義與對話消息；輪次＆步數可查看上下文壓縮、技能注入與工具調用詳情。
- 版本自檢與更新：DSH 啓動時自動檢測最新版本，發現新版時會在「狀態欄」導航項旁顯示提示，並在設置頁提供一鍵更新按鈕。
- 費用估算：按官方峯谷口徑計價，每條調用按其發生時刻與所用模型分別計算。
- 價格庫：支持自定義模型單價、峯谷分檔，以及 CNY 或 USD 計價單位切換。
- 其他功能：節假日日曆一鍵更新、賬戶餘額每分鐘自動刷新、中英雙語界面。
配置與使用¶
打開 設置 → 狀態欄：
- 控制顯示與順序：勾選控制字段顯示，取消勾選僅隱藏；拖動右側把手調整順序；點擊「恢復默認設置」可重置。
- 自定義模型價格：輸入模型名並「添加」以新增條目；點擊「修改」展開編輯區保存；需區分峯谷時段時勾選「峯谷計價」。
- 切換計價單位：價格編輯區右上角可選 CNY 或 USD。切換時內置模型改用對應幣種官方參考價，已修改條目保留。
- 節假日：點擊「更新節假峯谷」獲取下一年的放假安排。
- 餘額：餘額信息每分鐘自動刷新。
注意事項¶
- 數據統計依賴 Host：最快 / 最慢首字與速度來自 host 新增的投影，升級後需完全退出並重啓 DSH 纔開始統計。
- 費用計算條件：價格庫中缺少單價的模型不計費，補充單價後自動補算。
- 更新依賴：一鍵更新依賴 pnpm 可執行文件。桌面端使用宿主隨包提供的 pnpm，命令行 / 網頁端使用 PATH 上的 pnpm。
- 目錄探測：插件目錄位置自動探測，順序爲環境變量
DSH_STATUS_BAR_PLUGIN_DIR→~/.dsh下的已知安裝佈局 → 由tools/位置推導。
生態背景¶
DSH 理念是「一切皆插件」。本插件收錄於社區目錄，與 DeepSeek / 幻方無官方從屬關係。它通過 MIT 協議開源，允許自由使用、修改與再分發。
- GitHub 倉庫：raphael-y7/dsh-desktop-statusbar
- 社區目錄：dsh-desktop-statusbar
