前言¶
在 DeepSeek Harness（DSH）中使用 DeepSeek API 时，账户余额与到服务商的网络延迟是两个关键指标。现有 UI 并未在侧边栏底部提供常驻显示，需要切换到浏览器开发者工具或外部监控工具才能查看，在长时间运行会话中频繁查看会打断工作流。下面介绍一个 DSH 插件，在侧边栏底部常驻一个小挂件，同时显示账户可用余额和到模型服务商的实时网络延迟。
这是什么¶
xuezhining/dsh-deepseek-balance 是 DeepSeek Harness 的一个客户端插件，由维护者 xuezhining 开发。它通过 Host 进程提供两条同源路由，Client 半注册到 sidebar.footer.action，在侧边栏底部展示余额与延迟，无需额外配置即可使用。
核心功能¶
Host 半路由¶
Host 半负责数据获取，两条同源路由都保留在 Host 进程中：
| 路由 | 内容 | 缓存 |
|---|---|---|
GET /deepseek-balance |
DEEPSEEK_API_KEY 账户余额（api.deepseek.com/user/balance） |
10s |
GET /deepseek-balance/ping |
对各服务商 origin 的 HEAD 往返耗时 | 2s |
两条路由都接受 ?refresh=1 参数绕过缓存。
延迟探测目标¶
延迟探测的目标自动从当前 provider 配置发现，优先级为：
llm-deepseek的baseURLllm-pi-ai的providers.*.baseURL- 默认
https://api.deepseek.com
也可通过环境变量覆盖：
DSH_BALANCE_PING_URLS=https://a.example,https://b.example
Client 半行为¶
Client 半注册到 sidebar.footer.action，负责前端展示与轮询：
- 余额每 30 秒轮询一次，延迟每 5 秒轮询一次
- 页面重新可见时立即刷新
- 点击挂件可强制刷新余额与延迟
- 延迟颜色：
≤400ms为常规，>400ms为警告，>900ms或不可达为红色报错 - 悬停可见：总余额 / 充值 / 赠金 / 各目标 host 的延迟 / 更新时间
- 若延迟路由尚未就绪（例如 Host 未重启），挂件自动只显示余额，不显示红杠
显示规则¶
| 情况 | 挂件显示 |
|---|---|
| 正常 | ● ¥19.21 · 178ms |
| 余额读取中 | ● ··· · 178ms（黄点） |
| 缺少 API Key | ● 未配置 DEEPSEEK_API_KEY · 178ms（红点） |
| 余额失败 / Key 无效 | ● — · 178ms（红点） |
| 服务商不可达 | ● ¥19.21 · —（延迟变红） |
| 侧边栏收起 | 只显示 ¥19.21（56px 窄栏放不下延迟） |
配置¶
无需额外配置项。余额读取使用环境变量 DEEPSEEK_API_KEY，该变量在 ~/.ds-harness-desktop/dsh-home/.credentials.yaml 的 refs 下维护。每次查询都会重新解析，更换 API Key 无需重启 DSH。
安装与启用¶
使用官方安装命令：
plugin_manager install_bundle target=<本目录绝对路径>
安装后插件行 id 为 deepseek-balance，可在「设置 → 插件」中启用或停用。
典型用法¶
安装后无需配置，在 DSH Web UI 中打开任意对话或设置页面，侧边栏底部会自动出现挂件，显示当前账户余额和到服务商的延迟。点击挂件可立即刷新，悬停可查看更详细的余额构成与各目标 host 的延迟信息。
适用场景与注意¶
适合需要长时间运行会话、关注 API 账户余额与网络延迟的开发者。插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。该插件由社区维护，与 DeepSeek 或幻方无官方从属关系。
短结尾¶
该插件通过两条同源路由与轮询机制，在 DSH 侧边栏底部提供余额与延迟的常驻显示，减少切换工具查看指标的操作。更多细节可访问插件目录页与 GitHub 仓库。
- 插件目录：https://www.skillhub.cn/plugins/xuezhining/dsh-deepseek-balance
- GitHub：https://github.com/xuezhining/dsh-deepseek-balance
