dsh-account-glance：DSH Web GUI 侧边栏账户余额与计费概览

在 DeepSeek Harness (DSH) 的 Web GUI 中，账户余额和计费周期通常隐藏在设置菜单的账户行中。开发者需要频繁切换上下文来监控消耗和剩余额度。dsh-account-glance 在侧边栏账户行上方提供了一个紧凑的预览卡片，将关键信息集中展示，减少操作跳转。

这是 faith372 维护的一个 DSH 客户端插件。它是一个自包含的组件，直接在 Web 界面的侧边栏显示 DeepSeek 账户余额、当前高峰/非高峰计费倒计时以及今日的代币消耗和调用次数。该插件不依赖其他插件，且不需要构建步骤。

核心功能¶

1. 账户余额显示：直接探查 DeepSeek 的 /user/balance 接口获取余额，并在鼠标悬停时显示来源。
2. 高峰/非高峰倒计时：根据北京时间显示当前计费周期，倒计时在最后一分钟会切换为秒级显示。非高峰时段享受 50% 折扣。
3. 今日消耗统计：展示今日的消费金额、消耗代币数和调用次数，并提供手动刷新按钮。
4. 智能互操作：与 @linxin666/dsh-usage 互操作。如果已安装该插件，此卡片会优先读取其路由并自动隐藏 dsh-usage 自带的预览卡片，两者保留各自的账本记录。
5. React 平台注入：基于 React 平台进行组件注入，适配 Web GUI 渲染。

安装与启用¶

安装此插件需要 DSH 版本 0.2.0-rc.1 或更高版本。

1. 克隆仓库代码：

    git clone https://github.com/faith372/dsh-account-glance.git

2. 通过 CLI 添加插件：

    dsh plugin --profile desktop add link:./dsh-account-glance

3. 在 Web GUI 中启用：
   点击侧边栏的 Plugins 图标，切换至 Installed 标签，找到 dsh-account-glance，开启对应的开关即可。

典型用法¶

• 计费周期判断：
  • 高峰时段：周一至周五 09:00-12:00 和 14:00-18:00（原价）。
  • 非高峰时段：其他所有时间（含周末），享受 50% 折扣。
• 与 dsh-usage 共存：
  • 如果安装了 @linxin666/dsh-usage，此插件会读取其路由配置，并利用特定的 DOM 属性（data-dsh-plugin 和 data-dsh-part）自动隐藏 dsh-usage 自带的卡片，避免界面重复。
  • 两者各自维护独立的账本，因此总金额可能存在细微差异。
• 数据刷新：
  • 点击卡片上的刷新按钮可强制重新探查余额和今日数据。

适用场景与注意¶

• 数据范围：余额仅对 DeepSeek 官方路由显示金额，其他路由（如兼容 DashScope 的第三方提供商）仅显示令牌和调用次数，不显示金额。
• 安全性：API 密钥仅通过 loopback-only 路由传输，不会暴露给浏览器。
• 界面适配：当侧边栏折叠至 56px rail 时，卡片会自动隐藏，以匹配 Shell 的折叠状态。
• 许可证：部分文件采用 MIT 许可证，部分文件（lib/host/* 和 lib/index.js）改编自 @linxin666/dsh-usage v0.4.4，采用 Apache-2.0 许可证。

通过在侧边栏提供实时的余额和计费概览，该插件减少了查看账户状态的交互步骤。所有代码自包含，遵循 MIT 和 Apache-2.0 许可证。更多信息请访问 GitHub。