Sutera-Diffusus/dsh-statusbar

dsh-statusbar

DeepSeek Harness（DSH）Web GUI 的状态栏扩展包：把会话统计行（StatsLine）
整合为一套模块化、可装配、带账户余额的状态栏。

一个补丁脚本、三个阶段、幂等可重打；与 DSH 的 UI 设计令牌 / 设置面板风格完全一致。

功能

Phase 1 · 花费估算（cost）

统计行末尾追加 花费 ¥X，悬停显示分桶明细与三套价目：

会话花销估算 · deepseek-v4-pro
输入·缓存命中 7.2M tok（¥0.15/M）→ ¥1.08
输入·未命中 73K tok（¥4.5/M）→ ¥0.33
输出 118K tok（¥13.5/M）→ ¥1.59
现行价 ¥1.11 · 新价空闲 ¥3.01 · 新价高峰 ¥6.01

计价覆盖 deepseek-v4-pro / deepseek-v4-flash 的现行价与峰谷新价，
浏览器控制台可用 localStorage["dsh.statsCost.model"] 切换模型。

Phase 2 · 状态栏模块（statusbar）

「设置 → 通用设置」底部新增 状态栏 分组，七个模块各配一个开关，
顶部提供「全部开启 / 全部关闭」快捷操作；统计行按勾选结果实时装配：

| 模块 | 状态栏显示 | 说明 |
|---|---|---|
| 会话进度 | 9 轮 · 84 步 | 轮数与步数 |
| 耗时 | LLM 32m22s · 工具调用 6m49s | LLM 与工具调用时长 |
| 性能 | 首 token 平均 1.6s · 82 tok/s | TTFT 平均与生成速度 |
| 缓存命中 | 缓存命中 99% | 输入缓存命中率 |
| Token 用量 | 输入 11.4M tok · 输出 148K tok | 输入与输出 token 数 |
| 花费估算 | 花费 ¥1.42 | 会话花销估算 |
| 账户余额 | 余额 ¥4.36 | 账户余额（总 / 赠送 / 充值） |

- 开关状态存于浏览器 localStorage（键 dsh.statusbar），刷新后保留；
- 默认全部开启；全部关闭时统计行整体隐藏；
- 中英文词典均已补齐；开关为品牌色圆角滑钮，role="switch" / aria-checked
无障碍语义，UI 与 DSH 设置面板一致（Setting-Cell 行 + --dsw-alias- 令牌）。

Phase 3 · 账户余额（balance）

经本地余额代理读取 DeepSeek 官方 GET /user/balance：

- 统计行显示 余额 ¥X，悬停显示 总余额 / 赠送 / 充值 明细；
- 设置分组里「账户余额」行说明实时显示当前余额（当前 ¥X）；
- 约每分钟刷新（TTL 60s）；代理不可用 / 无 key / 超时 → 模块自动隐藏，
统计行不显示任何错误。

安装

powershell -ExecutionPolicy Bypass -File apply-patch.ps1
目标文件非默认位置时：
powershell -ExecutionPolicy Bypass -File apply-patch.ps1 -Target

- 默认目标：$env:DSH_HOME\profiles\node_modules\@deepseek-ai\dsh-client-ui-conversation\lib\client.js
（DSH 的 profile 树指向安装树，打补丁即生效）；
- 脚本幂等：三阶段分别检测，已打补丁自动跳过；
- 打前自动备份到 %TEMP%，打后自动 node --check；锚点失效时报错而非静默破坏；
- DSH 升级覆盖 node_modules 后重跑本脚本即可；
- 文件含中文，须以 UTF-8 BOM 保存（仓库内已保证）。

刷新浏览器即可生效（服务器按内容哈希提供 client.js）。

余额代理（balance-proxy.js）

浏览器不能跨域直连 api.deepseek.com（CORS），也不应持有 API key。
balance-proxy.js 是零依赖的 localhost 小服务：

- 只监听 127.0.0.1:3020（环境变量 DSH_BALANCE_PORT 可覆盖，
浏览器侧 localStorage["dsh.balance.port"] 同步覆盖）；
- API key 按与 dsh-credentials-local 相同的顺序解析
（DEEPSEEK_API_KEY 环境变量 → $DSH_HOME/.credentials.yaml），绝不回显，上游走 HTTPS；
- CORS 仅允许 http://127.0.0.1: 来源，恶意来源得到 null；非 /balance 路径一律 404；
- 结果缓存 60 秒；端口被占时静默退出（防重复拉起）；
- 日志写到 %TEMP%\dsh-balance-proxy.log。

启动方式（任选）：

node balance-proxy.js

随 DSH 自动拉起：在 start-dsh.bat 中 DSH 命令前加一行

start "" /b node "\balance-proxy.js" >nul 2>nul

或在 DeepSeekHarness-Launcher.cfg 中加一行（需要启动器支持该配置项）

balanceProxy=\balance-proxy.js

兼容性与限制

- 针对 @deepseek-ai/dsh-client-ui-conversation@0.1.0-rc.6 的编译产物；
上游结构调整时锚点检测会明确报错（而非静默破坏），届时需更新锚点；
- 可与其他直接补丁（如已应用的花费估算旧补丁）共存；
- 余额模块依赖本机可访问 api.deepseek.com。

已验证

- 对原版 0.1.0-rc.6 包做全新三阶段补丁：全部锚点命中、node --check 通过；
- 无头 Chrome 实测（0 报错）：七个开关渲染与持久化、逐模块开关实时作用于统计行、
余额数值实时更新（余额 ¥4.36）、代理安全项（CORS 收紧 / 404 / 无密钥回显 /
仅回环监听 / 重复拉起自愈）全部通过。

License

MIT