dsh-balance-simple

中文文档
1.0.2发布于 2026/11/03MITES Module零依赖

一个简单的,信息密集的DSH侧栏状态卡:DeepSeek平衡,每月使用,高峰/非高峰倒计时一目了然。

中文使用文档
文档目录7 节
  1. 设计
  2. 功能
  3. 安装
  4. 数据与隐私
  5. 峰谷定价依据
  6. 开发
  7. License

DSH Balance

一块常驻 DSH Web 侧边栏的 DeepSeek 状态牌:在账户头像上方集中显示余额、当月用量、费用、缓存命中率,以及峰谷状态与切换倒计时。折叠后仍保留最关键的余额、峰谷和倒计时,展开后补充用量构成与账户信息。

设计

  • 简约:没有报表式堆叠,只保留会频繁查看的状态数字;折叠态压缩成一块 44px 状态牌。
  • 直观:余额是视觉中心,峰时/谷时用颜色区分,倒计时直接回答“什么时候切换”。
  • 信息集中:余额、月度 token、费用、缓存命中率、请求数和峰谷状态在同一张卡片内完成阅读,不需要打开设置页。

功能

  • 余额优先:展开卡片以当前账户余额为主,月度 token 用量、费用和构成放在次级位置。
  • 折叠态可见:侧边栏收起时仍显示 44px 余额块,以及当前峰/谷状态和切换倒计时。
  • 真实峰谷规则:按北京时间,周一至周五 09:00–12:00、14:00–18:00 为峰时;其余时间、周末和中国法定节假日为谷时。
  • 远程节假日表:优先使用 jiejiariapi,失败时回退到 holiday-cn;未来年份暂无官方日历时回退到内置表。
  • 权威校时:按设备时区选择区域 NTP 服务器(阿里云、腾讯、NIST、Cloudflare、pool.ntp.org),失败时回退到 timeapi.io。
  • 自动刷新:余额和用量每 30 秒轮询,窗口重新聚焦或恢复可见时刷新;展开卡片支持手动刷新。

安装

要求:DSH Web 界面 + 已登录的 DeepSeek 账户。

从 dshmarket 上架后直接安装。上架前可手动安装:

# npm 发布后
dsh plugin --profile web add dsh-balance-simple

# 或直接从 GitHub 安装
dsh plugin --profile web add git+https://github.com/lamp23333/dsh-balance-simple

安装后刷新 DSH Web 页面。

数据与隐私

插件复用 DSH 已保存的 DeepSeek 账户授权,不需要额外填写 API Key 或 token。浏览器只访问 DSH 同源的 /dsh-deepseek-usage/* 接口;DeepSeek 授权 token 始终留在 Host,不会返回给浏览器。

外部请求仅用于:

  • platform.deepseek.com:读取账户余额、用量和费用
  • jiejiariapi.com / GitHub holiday-cn:读取中国法定节假日
  • 区域 NTP 服务器 / timeapi.io:校准当前时间

插件只支持 DeepSeek 账户级数据;OpenAI、Anthropic、OpenRouter 等其他供应商不在支持范围内。DeepSeek 的其他模型会自然聚合到同一账户用量中。

峰谷定价依据

DeepSeek 官方定价规则写明:峰时为 UTC 01:00–04:00 和 06:00–10:00,即北京时间 09:00–12:00、14:00–18:00,周一至周五;其中排除的是中国法定节假日,不参考其他国家节假日。

开发

无需构建步骤,源码即发布产物。修改后至少检查:

node --check index.js
node --check client.js
npm pack --dry-run

主要文件:

  • index.js:Host 端,读取账户数据、节假日和授时,提供同源 JSON 接口
  • client.js:Web 客户端,渲染侧边栏卡片和折叠余额块
  • cordis.patch.yml:DSH bundle 入口

License

MIT

版本与发布记录

dsh-balance-simple 共发布 4 个版本,首次发布于 2026/11/03;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.0.2latest2026/11/03今天
1.0.12026/11/03今天
1.0.02026/11/03今天
0.0.0-stage2026/11/03今天

关于 dsh-balance-simple 的常见问题

dsh-balance-simple 是什么?

一个简单的,信息密集的DSH侧栏状态卡:DeepSeek平衡,每月使用,高峰/非高峰倒计时一目了然。

如何安装 dsh-balance-simple?

在项目目录运行 npm install dsh-balance-simple,或使用 pnpm add / yarn add / bun add。

dsh-balance-simple 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dsh-balance-simple 是否存在。

dsh-balance-simple 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

dsh-balance-simple 可以商用吗?

dsh-balance-simple 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

dsh-balance-simple 还在维护吗?

最新版本 1.0.2 发布于 2026/11/03(今天);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。