@kc0ed/dsh-bottom-bar
DSH 底栏统计 + 预估费用插件:把聊天界面最底下那行统计接管过来,做成能自己组装的样子——想显示啥显示啥,还能拖拽排序,末尾缀一个预估费用,花钱心里有数。
安装
0. 前置(两条都要有,缺一不可)
# ① Node.js(用它装下面两个)
# ② pnpm —— dsh plugin 是 pnpm 转发器,没它必挂:
npm i -g pnpm
# ③ dsh 命令行(有就跳过):
npm i -g @deepseek-ai/dsh
装完重开一个新的终端(PATH 才生效),验证:
pnpm -v # 能打印版本号 = OK
dsh --version # 能打印版本号 = OK
1. 方式一:npm 稳定版(推荐,省心)
dsh plugin --profile web add @kc0ed/dsh-bottom-bar
- 跟随 npm 发布节奏(发新版才更新),稳定,不折腾
- 缺点:GitHub 有新改动时,要等发版才能拿到(可能慢一两天)
- 更新到最新版:
dsh plugin --profile web update @kc0ed/dsh-bottom-bar
2. 方式二:GitHub 直装(类似 nightly,永远最新)
dsh plugin --profile web add github:kc0ed/dsh-bottom-bar
- 直接拉仓库 main 分支,代码推到 GitHub 即可用,不等发版
- 缺点:可能吃到刚提交还没充分测试的改动;且可能触发 pnpm 的 git 构建审批(见下方「常见坑-3」)
- 更新:
git pull后重跑一次 add 即可(或cd ~/.dsh/profiles/web && pnpm update github:kc0ed/dsh-bottom-bar)
3. 装完(两种方式都一样)
- 彻底退出 DSH 再重启(
dsh web前老进程得死透,刷新页面不算) - 浏览器 Ctrl+Shift+R 硬刷新——不是没装上,是缓存记性好
- 想装到别的 profile(如 headless)就把
web换成 profile 名
卸载:dsh plugin --profile web remove @kc0ed/dsh-bottom-bar(依赖和层栈一起清)
常见坑
'pnpm' 不是内部或外部命令→ pnpm 没装,或装完没重开终端。先npm i -g pnpm,重开终端,pnpm -v验证再继续。- 命令报「不是内部或外部命令」且命令看起来残缺 → 大概率是终端粘贴把长命令拆碎了。一行一行手敲,注意:
@kc0ed中间是数字 0(不是字母 O)。 pnpm failed+ 提示 allowBuilds(git 方式常见) → pnpm 10 默认拦截 git 依赖的构建脚本,需要显式批准:- 看报错里打印的 exact key(引号里那串,形如
github.com/kc0ed/dsh-bottom-bar) - 编辑
~/.dsh/profiles/web/pnpm-workspace.yaml,加:
allowBuilds:
: "dsh"
- 保存后重跑第 1/2 步的 add 命令。
- 装完底栏没变化 → 先 Ctrl+Shift+R;还不行就彻底退出 DSH 再启动。
> ⚠️ 装了静态包之后,别再同时跑「动态插件」形态,两个实例写同一个账本会打架。
它能干点啥
底栏那行字:
- 8 个统计段:轮/步、LLM 时长、工具调用时长、首 token 平均、吞吐 tok/s、缓存命中、输入/输出 token、预估费用
- 每段可开关、可拖拽排序;按住 Ctrl 点选还能批量多选,整批拖走(全选/反选/取消都有)
- 行太长被截断?悬停出黑条看完整行(可设「始终显示」)
- 点任意分段 → 弹出明细面板:费用段是逐模型的单价 / 各桶 token / 金额 / 小计 / 总计,其他段是原始数值
设置 → 底栏(设置页那个区块):
- 预览区:改配置的同时实时看效果;悬停还能「预演」未启用的段插进去长啥样
- 价格表:内置 DeepSeek V4/V3、Claude、OpenAI、Gemini、Kimi、通义等厂商模板,新增模型只填输入价,其余按模板自动派生;也支持手动填每个桶(币种可换)
- 配置有 localStorage 水合——刷新网页不会闪回默认值
- 「客户端全量 · 权威源」卡片:当前会话四桶用量 + 命中率 + 费用拆分,1s 实时刷新
钱和账:
- 用量按「渠道@模型」记账(比如
opencode-go/deepseek-v4-flash),同一模型走不同渠道分开算,不吃亏 - 账本落盘在
~/.dsh/cost-estimate.ledger.json,只追加、永不重算,重启接着记;客户端捎带全量用量持续对账,明细面板和底栏永远一致 - 流式输出时费用实时跳,零等待
DeepSeek 峰谷定价
DeepSeek 官方 2026-08-17 起实行高峰/空闲两档价(高峰 9:00–12:00 / 14:00–18:00,北京时间,空闲约半价)。插件支持:
- 峰谷计价开关:开着就按高峰价算钱(目前对 DeepSeek 官方渠道、OpenCode 生效;其他三方网关暂不不套用)
- 峰谷提醒开关:只显示「⏱ 高峰/空闲」和时段标注,不影响算钱——两个开关互不绑定
- 时区可选:默认跟随系统,也可以固定 UTC / UTC±N
- 点底栏「⏱ 高峰」分段 → 详情弹层:当前时段、高峰/空闲窗口、三桶(输入/缓存读/输出)价格表,还能滑杆切换模型(flash/pro)比价
常见问题
- 装了但底栏没变化? 先 Ctrl+Shift+R;还不行就彻底退出 DSH 再启动——主进程没重启,新插件不会加载
- 价格显示「—」? 该渠道/模型没有内置价格,去设置页价格表补一个就行
- 费用和官方账单对不上? 这是估算——按会话 token × 单价算的参考值,不包含官方优惠/活动价
想改代码 / 反馈
仓库:https://github.com/kc0ed/dsh-bottom-bar
开发、测试、发布流程见 docs/DEVELOPMENT.md;踩坑记录见 docs/lessons.md。
官方文档参考
- 打包与安装插件(组合包 / profile /
dsh plugin/ 层顺序 / tarball 与 git 安装) - 插件配置(patch 行格式、Schema 校验约定)
- CLI 行为参考(profile 启动、层优先级、
--dump-config、插件管理 reconcile 语义)
License
MIT © kc0ed。复刻的官方 UI 零件版权归原作者(DeepSeek)所有,归属与上游版本见代码头同步块。
本项目由 DeepSeek V4 Flash 在 DeepSeek Harness 中辅助开发完成。
