底栏信息定制 kc0ed/dsh-bottom-bar

@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. 装完（两种方式都一样）

1. 彻底退出 DSH 再重启（dsh web 前老进程得死透，刷新页面不算）
2. 浏览器 Ctrl+Shift+R 硬刷新——不是没装上，是缓存记性好
3. 想装到别的 profile（如 headless）就把 web 换成 profile 名

卸载：dsh plugin --profile web remove @kc0ed/dsh-bottom-bar（依赖和层栈一起清）

常见坑

1. 'pnpm' 不是内部或外部命令 → pnpm 没装，或装完没重开终端。先 npm i -g pnpm，重开终端，pnpm -v 验证再继续。
2. 命令报「不是内部或外部命令」且命令看起来残缺 → 大概率是终端粘贴把长命令拆碎了。一行一行手敲，注意：@kc0ed 中间是数字 0（不是字母 O）。
3. pnpm failed + 提示 allowBuilds（git 方式常见） → pnpm 10 默认拦截 git 依赖的构建脚本，需要显式批准：
1. 看报错里打印的 exact key（引号里那串，形如 github.com/kc0ed/dsh-bottom-bar）
2. 编辑 ~/.dsh/profiles/web/pnpm-workspace.yaml，加：

allowBuilds:
: "dsh"

3. 保存后重跑第 1/2 步的 add 命令。
4. 装完底栏没变化 → 先 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 中辅助开发完成。