前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的设计理念。在使用 Web 界面进行开发时，监控 API 账户余额通常需要切换标签页或查看命令行输出，这会打断工作流。dsh-account-balance 插件将余额信息直接集成到聊天界面中，让开发者能实时掌握账户状态。

插件介绍¶

这是一个运行在 DSH Web 客户端上的仪表盘插件，由用户 ls-cool-123 维护。它能在聊天窗口上方（会话头部的工具区）显示 DeepSeek 模型的账户余额，解决从界面层直接查询余额的需求。

核心功能¶

该插件通过 Host 与 Client 两个半部分协作，实现余额的实时查询与展示：

• 实时显示：在聊天窗口上方（会话头部的工具区）显示余额胶囊。
• 数据明细：鼠标悬停可查看「总余额 / 赠送余额 / 充值余额」的明细。
• 自动刷新：支持手动刷新，且每 60 秒自动刷新一次。
• 架构实现：
  • Host 半：在 Web 服务器上注册本地路由 /api/account-balance。它解析凭证服务（ctx.credentials）中的 API Key，代理 DeepSeek 官方 GET /user/balance 接口。
  • Client 半：在 conversation.session.header.utilities 槽位注册组件，负责轮询接口并渲染 UI。
• 安全机制：API Key 只留在本机进程里，绝不暴露给浏览器。

安装与启用¶

1. 进入插件所在目录。
2. 运行安装命令，将插件添加到 Web 服务的依赖中：

    dsh plugin --profile web add .

3. 重启 Web 服务以加载插件：

    dsh web

配置¶

插件复用 DeepSeek 官方适配器的凭证来源，无需额外配置。

• 凭证来源：使用 Web 模型设置页写入的托管凭证、.env 文件或环境变量中的 DEEPSEEK_API_KEY。
• 可选配置：DEEPSEEK_BASE_URL，用于覆盖余额接口基地址，默认为 https://api.deepseek.com。
• 接口格式：余额接口返回格式以 DeepSeek 官方文档 为准。

适用场景与注意¶

• 适用对象：需要频繁查看 DeepSeek API 余额的 DSH Web 用户。
• 权限说明：插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证（MIT）。
• 目录与源码：可前往 技能云插件目录 或 GitHub 仓库 查看详情。