前言¶
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