DeepSeek Balance 插件

前言¶

DeepSeek Harness（DSH）允许通过插件扩展功能。对于经常在侧边栏查看账户状态的智能体开发者来说，频繁切换到账户详情页查看余额会打断工作流。下面介绍一个客户端插件，直接在 DSH 侧边栏账户行上方显示 DeepSeek 账户余额。

是什么¶

@local/dsh-balance 是一个为 DeepSeek Harness（DSH）设计的客户端插件。它在侧边栏底部渲染一行，位于账户行（头像 + 昵称）上方，显示当前登录账户的 DeepSeek 钱包余额。

插件名：DeepSeek Balance
包名：@local/dsh-balance
行 ID：balance
维护者：ECHOUniverse
许可证：MIT

核心功能¶

余额概览¶

在账户行上方显示一个 24px 钱包图标和主币种总金额。行高 44px，使用 14px 表格数字，内边距 6px，与账户行保持像素对齐。金额左侧扩展 2px，使图标和头像左边缘对齐；右侧扩展 2px，使金额和昵称右边缘对齐。

悬停查看详情¶

鼠标悬停或聚焦该行时，弹出详情面板，显示：
- 总余额
- 充值余额
- 奖励余额（每个币种）
- 最后更新时间（相对时间，悬停时显示绝对时间）
- Usage / Top up 链接

手动刷新¶

点击该行，或按 Enter / Space（行被聚焦时），可强制刷新余额。这会绕过 20 秒的触发节流。

自动刷新机制¶

每次刷新触发都绑定在插件生命周期上，而非行组件的挂载，因此折叠侧边栏不会停止自动刷新。刷新触发包括：
- 启动时立即读取；若未就绪（未登录、失败、ok:false、超时），按 1s / 2s / 4s 重试最多 3 次，约 7 秒内完成
- 窗口获得焦点（距上次请求超过 20 秒）
- 会话状态从 running 变为 false（Turn end）
- 可配置的轮询（默认 60 秒，可调），仅在页面可见时运行
- 账户登录状态变化

状态与阈值¶

签出状态、首次加载、读取失败在视觉上区分；读取失败时保留最后一次有效值，并显示灰色 ⚠
CNY 总金额低于警告阈值时显示琥珀色，低于危险阈值时显示红色；USD 永不触发颜色变化
两者亮暗主题均适配

可配置参数¶

在插件管理器 → 插件 → DeepSeek Balance → 配置中修改（保存后下次刷新生效）：

字段	类型	默认值	说明
`pollingEnabled`	boolean	`true`	页面可见时运行轮询作为后备
`pollingIntervalMs`	number	`60000`	轮询间隔（毫秒），范围 15000–600000
`warnThresholdCny`	number	`10`	CNY 低于此值显示琥珀色
`dangerThresholdCny`	number	`1`	CNY 低于此值显示红色，必须低于 `warnThresholdCny`

初始值也存在于 cordis.patch.yml。

安装与启用¶

这是一个本地插件，需要从源码安装。

git clone https://github.com/ECHOUniverse/dsh-balance.git
cd dsh-balance
pnpm install
pnpm build

# 使用 DSH Desktop 附带的 CLI（不要使用全局 dsh）
DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$DSH" plugin --profile desktop add link:"$PWD"

安装后完全退出并重启 DSH。客户端包在 Web 前端启动时加载一次，外部插件不支持热重载。

若使用其他配置文件，安装命令中的 --profile <name> 替换为对应配置文件名。安装会在 ~/.dsh/profiles/<profile>/package.json 写入依赖和 link: 符号链接，以及 node_modules。

卸载：

DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$DSH" plugin --profile desktop remove @local/dsh-balance

重启 DSH 后该行消失。

典型用法¶

安装并重启 DSH
在侧边栏账户行上方查看余额概览
悬停查看各币种详情和链接
点击行或按空格刷新
在设置页调整轮询间隔和阈值颜色

适用场景与注意¶

适合需要频繁查看 DeepSeek 账户余额的开发者，特别是将 DSH 作为日常开发工具的场景。

插件以当前 DSH 进程的权限运行。安装前应检查源码与许可证。

已知限制：
- sidebar.footer.action 是 DSH 内部插槽，未公开为文档 API。升级 DSH（尤其是 0.3）可能改变其名称、属性或相邻元素
- 外部客户端包无热重载：修改需重建并重启 DSH
- 缓存存储在 localStorage 的 @local/dsh-balance/cache/v1 中，不会自行过期

结尾¶

这个插件在 DSH 侧边栏账户行上方提供余额概览和详情，支持手动刷新、自动轮询和阈值颜色提醒，适合需要快速了解账户状态的开发者。

目录页：https://www.skillhub.cn/plugins/ECHOUniverse/dsh-balance
GitHub：https://github.com/ECHOUniverse/dsh-balance