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
