# dsh-balance-simple 中文文档

规范地址：https://npmcn.com/package/dsh-balance-simple/

版本：1\.0\.2
npm 元数据更新时间：2026-11-03T11:39:42.595Z
中文译文更新时间：2026-11-03T15:25:45.518Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/dsh-balance-simple
原文对照：https://npmcn.com/package/dsh-balance-simple/?lang=original
项目主页：https://github.com/lamp23333/dsh-balance-simple#readme
源码仓库：https://github.com/lamp23333/dsh-balance-simple

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：73.1 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-11-03T08:23:37.771Z
- 最新版本发布：2026-11-03T11:39:42.458Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

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

## 安装

```sh
npm install dsh-balance-simple
```

也可以使用：`pnpm add dsh-balance-simple`、`yarn add dsh-balance-simple`、`bun add dsh-balance-simple`

## README

# 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 上架后直接安装。上架前可手动安装：

```bash
# 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，周一至周五；其中排除的是**中国法定节假日**，不参考其他国家节假日。

-   官方文档：[https://api-docs.deepseek.com/quick\_start/pricing](https://api-docs.deepseek.com/quick_start/pricing)
-   周末即使调休上班也按谷时处理，因为官方规则只按周一至周五 + 中国法定节假日判断。

## 开发

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

```bash
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 是什么？

一个简单的，信息密集的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 和提交记录判断。