侧栏余额 yang-zhenchen/dsh-balance

dsh-balance

把 DeepSeek 账户余额 固定在 DeepSeek Harness（DSH）侧边栏底部——账号头像的正上方一行。

给 DeepSeek Harness 侧边栏加一行常驻的余额显示，窄窄一条，始终可见。

余额行预览

功能

- 显示账户充值余额；有赠金时在金额后追加 +¥x.xx。
- 页面可见时每 15 秒刷新；窗口重新获得焦点、从后台返回、账号登录状态变化、点击该行时都会立即刷新。
- 未登录显示「未登录」，读取失败显示「点击重试」；悬停可查看充值余额 / 赠金 / 更新时间。
- 收起侧边栏时按 DSH 的布局规则隐藏，不挤压头像行。
- 余额通过本机 DSH Host 的 account Remote 读取（Platform get_user_summary），账户 token 不会进入页面。

要求

- DeepSeek Harness 0.2.x（Desktop 或 Web 界面均可）
- 已登录 DeepSeek 账户（设置 → 账户）

安装

方式一：在 DSH 插件页安装（推荐）

1. 打开侧边栏的 插件 页。
2. 在安装入口填入仓库地址：https://github.com/yang-zhenchen/dsh-balance （也接受 github:yang-zhenchen/dsh-balance 这种 pnpm 写法。）
3. 安装完成后确认 dsh-plugin-balance 已启用（安装默认启用）。
4. 侧边栏底部就会出现余额行。

方式二：手动 link（适合改代码）

git clone https://github.com/yang-zhenchen/dsh-balance.git
cd dsh-balance
node scripts/enable-bundle.mjs
cd $env:USERPROFILE\.dsh\profiles\desktop
pnpm install

enable-bundle.mjs 只会把依赖和 dsh.profile.bundles 写进 profile 的 package.json（2 空格、无 BOM，并自动备份）。

⚠️ 不要用 ConvertTo-Json | Set-Content 之类的命令手动重写 profile 的 package.json：Windows PowerShell 会写入 UTF-8 BOM，导致 DSH 启动时 JSON.parse 失败、客户端直接打不开。已经遇到的话见下面的「启动失败」一节。

启动失败：Unexpected token '' ... is not valid JSON

症状：双击 DSH 客户端没有界面，日志里出现：

SyntaxError: Unexpected token '', "{ ... " is not valid JSON
at readProfileManifest (.../dsh-app-boot/lib/index.js)

原因：~/.dsh/profiles/desktop/package.json 被保存成了 UTF-8 with BOM。DSH 启动时会先读取这个 profile 清单，开头的 BOM 让 JSON.parse 直接失败，此时插件还完全没有加载——所以这不是插件运行时代码的问题。

常见来源：用 Windows PowerShell 的 ConvertTo-Json | Set-Content -Encoding utf8 手动改配置，或用带 BOM 的编辑器保存。DSH 插件页安装写入的是 2 空格、无 BOM 的 JSON，不会产生 BOM。

修复（任选一种）：

A. PowerShell（不需要 Node）：

$p = Join-Path $env:USERPROFILE '.dsh\profiles\desktop\package.json'
$t = [System.IO.File]::ReadAllText($p)
if ($t.Length -gt 0 -and $t[0] -eq [char]0xFEFF) { $t = $t.Substring(1) }
[System.IO.File]::WriteAllText($p, $t, (New-Object System.Text.UTF8Encoding($false)))

B. 用本仓库的脚本（会先校验 JSON、再移除 BOM，并备份原文件）：

node scripts/repair-profile.mjs

C. 用 VS Code 打开该文件，右下角编码选择 Save with Encoding → UTF-8（不要选 UTF-8 with BOM），保存后重启。

修复后重新启动 DSH 即可。其他 profile 把 --profile desktop 换成对应名字或目录。

遇到其他启动问题，可以在 issue #1 里补充日志。

卸载

在插件页禁用或移除该 bundle；手动安装时执行：

cd $env:USERPROFILE\.dsh\profiles\desktop
pnpm remove dsh-plugin-balance

并从 dsh.profile.bundles 中删除 dsh-plugin-balance。

实现

| 文件 | 作用 |
| cordis.patch.yml | 作为 bundle 向 profile 插入一个 ui-balance Loader 行 |
| lib/index.js | 宿主侧空插件（浏览器插件才做事） |
| lib/client.js | 浏览器插件，注册到 sidebar.footer.action 列表槽位 |

sidebar.footer.action 由 @deepseek-ai/dsh-client-ui-sidebar 渲染在 sidebar.settings（账号/头像行）的正上方，所以插件不需要改 DSH 源码，也不会和头像行抢位置。组件同时订阅账户状态流，在登录 / 登出时立即同步。

开发

没有构建步骤：lib/client.js 本身就是 lazy-CJS 包，DSH Client Modules 可以直接加载。

node test/smoke.mjs

修改 lib/client.js 后，DSH 的 Client HMR 会自动热更新（必要时刷新页面）。

已知限制

- 余额行跟随 DSH 侧边栏；侧边栏折叠时不显示。
- 轮询间隔目前固定为 15 秒（lib/client.js 顶部的 POLL_MS），尚未做成可配置项。
- 只显示账户余额，不统计 token 用量。

License

MIT