前言¶

在 DeepSeek Harness（DSH）的生态中，开发者需要频繁确认账户余额以管理资源。每次切换到账户管理页面查看金额较为繁琐。该插件旨在解决这一痛点，在 DSH Web UI 的侧边栏底部增加一个钱包余额胶囊，提供即时、低打扰的余额查询入口。

插件由 gggtmd 维护，采用 MIT 许可证。它复用宿主已有的账户服务接口，不新增 Host 层接口，通过手写 lazy-CJS bundle 实现零构建安装。

功能特性¶

• 位置固定：显示在侧边栏底部、设置按钮旁。侧边栏折叠成图标导轨时，胶囊会自动隐藏文字，仅保留金额并居中显示。
• 三态清晰：区分未登录、查询中、查询失败三种状态。任何失败状态都不会伪装成余额为 0，而是显示具体文案。
• 刷新逻辑：点击胶囊可手动刷新。在查询期间，会继续显示上一次的有效金额，并在提示中标注“查询中”，不会退化成“未登录”。
• 悬浮提示：鼠标悬浮时，使用宿主提供的 Tooltip 原语显示详情，包括充值余额、赠送余额与更新时间。支持中英双语。
• 自动刷新：插件会在挂载、窗口重新聚焦或每 5 分钟自动刷新一次余额。

安装¶

通过插件管理器安装。推荐使用方式 A，直接从 GitHub 安装，安装后无需保留源码目录。

plugin_manager action=install_bundle target=github:gggtmd/dsh-wallet-hud

使用¶

安装后刷新 Web UI 页面即可看到侧边栏底部的余额胶囊。

• 查看详情：鼠标悬浮在胶囊上，查看充值余额、赠送余额及更新时间。
• 手动刷新：点击胶囊，立即重新获取最新余额。
• 自动更新：无需操作，插件会在特定时机自动拉取余额数据。

技术细节¶

• 平台限制：仅支持 Web 平台。
• 依赖宿主：依赖宿主提供的 Tooltip 原语。如果宿主未提供该原语，插件会回退到浏览器原生的 title 属性。
• 接口复用：余额数据直接调用宿主 account.getBalance 接口，不新增任何 Host 接口。
• 零构建：插件无需打包工具，git clone 后即可通过插件管理器安装。

结尾¶

该插件通过侧边栏胶囊的方式，让余额查询变得即时且低打扰。更多细节与源码，请访问 GitHub 仓库。