# @dougen/dsh-deepseek-usage 中文文档 规范地址：https://npmcn.com/package/%40dougen/dsh-deepseek-usage/ 版本：0\.20\.0 npm 元数据更新时间：2026-11-05T09:47:15.816Z 中文译文更新时间：2026-11-12T18:51:29.958Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dougen/dsh-deepseek-usage 原文对照：https://npmcn.com/package/%40dougen/dsh-deepseek-usage/?lang=original 项目主页：https://github.com/dougen/dsh-deepseek-usage 源码仓库：https://github.com/dougen/dsh-deepseek-usage ## 关键信息（来自 npm 元数据） - 包体积（解压后）：229 kB，15 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：0 个 - peer 依赖：@deepseek-ai/schemastery ^3\.18\.0，@deepseek-ai/dsh-credentials ^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.2，@deepseek-ai/dsh-host-webserver ^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.2 - 首次发布：2026-08-18T01:37:53.167Z - 最新版本发布：2026-11-05T09:47:15.078Z - 近 30 天下载量：15572（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：45（近 12 个月 45 个） ## 中文简介 一个 DeepSeek Harness 侧边栏插件: 活动提供者的账户余额或订阅用法( DeepSeek, Moonshot/Kimi, GLM, OpenRouter, Kimi Coding, OpenCode, MiniMax, 外加 Claude 代码和 Codex OAuth 令牌),第三方提供的提供者- id映射 ## 安装 ```sh npm install @dougen/dsh-deepseek-usage ``` 也可以使用：`pnpm add @dougen/dsh-deepseek-usage`、`yarn add @dougen/dsh-deepseek-usage`、`bun add @dougen/dsh-deepseek-usage` ## README ![dsh-deepseek-usage icon](https://cdn.jsdelivr.net/npm/@dougen/dsh-deepseek-usage/icon.svg) # dsh-deepseek-usage [![npm version](https://img.shields.io/npm/v/@dougen/dsh-deepseek-usage)](https://www.npmjs.com/package/@dougen/dsh-deepseek-usage) [![CI](https://github.com/dougen/dsh-deepseek-usage/actions/workflows/ci.yml/badge.svg)](https://github.com/dougen/dsh-deepseek-usage/actions/workflows/ci.yml) [English](https://npmcn.com/package/%40dougen/dsh-deepseek-usage/README.md) | 中文 一个 **DeepSeek Harness（DSH）** 的侧边栏插件：在 DSH 主界面就能看到**当前选中模型背后的账户还剩多少钱 / 多少额度**、**这个模型此刻什么价**。覆盖九家提供商。 ![侧边栏卡片：余额、当前单价与计费时段指示灯](https://cdn.jsdelivr.net/npm/@dougen/dsh-deepseek-usage/screenshot.png) _余额形态（DeepSeek、Kimi、Z.ai、OpenRouter 等）：账户余额、当前模型的输入 / 输入缓存 / 输出单价，右上角是峰谷时段指示灯。_ ![订阅用量：各计费窗口的剩余额度](https://cdn.jsdelivr.net/npm/@dougen/dsh-deepseek-usage/screenshot2.png) _订阅形态（Kimi For Coding、OpenCode、MiniMax、Claude Code / Codex 等）：每个用量窗口一个 D 形仪表盘——中间的数是剩余额度，灰色弧是已用量，绿色弧是剩余量（已用达到 80% 时转红），底部徽章标出窗口（`5H` = 5 小时、`7D` = 周、`1M` = 月）。_ ## 这个插件是干嘛的 DSH 可以切换很多家模型提供商，但每家的账户状况藏在不同的网站后台。这个插件会解析你在 DSH 里当前选中的模型属于哪家提供商，把那个账户的实时状态卡片放进 DSH 主界面侧边栏底部： - **账户读数**，按提供商公开的内容分两种形态： - _余额类_（DeepSeek、Moonshot / Kimi、智谱 Z.ai、OpenRouter）公开账户余额，卡片直接显示带币种符号（`¥` / `$`）的余额。 - _订阅类_（Kimi For Coding、OpenCode、MiniMax、Claude Code、OpenAI Codex）没有余额可查，只公开用量窗口。卡片按接口返回的窗口各画一个仪表盘——5 小时、周、月，返回几个画几个——显示每份额度还剩多少，已用达到 80% 时剩余弧变红。 - 卡片始终跟随当前选中的模型，切换提供商即切换读数；除凭据外不需要针对某家提供商再做任何配置。 - **当前模型的单价**。卡片列出输入 / 输入缓存 / 输出的单价，按此刻生效的计费时段取值，币种跟该提供商保持一致。有的提供商按时段计价——DeepSeek 官方峰谷（北京时间周一至周五 09:00–12:00、14:00–18:00 为高峰，夜间、周末、节假日为空闲）或 OpenRouter 的分时定价——卡片会用一枚橙 / 绿指示灯标出当前时段，悬浮可见距下次切换还剩多久。 ## 如何安装和使用 **第 1 步——配置提供商的凭据。** 插件用你给该提供商配的那把 Key 查询：在 DSH 设置的**模型页**填好，或导出为环境变量（`DEEPSEEK_API_KEY`、`MOONSHOTAI_API_KEY`、`ZAI_API_KEY`、`OPENROUTER_API_KEY`、`KIMI_CODING_API_KEY`、`OPENCODE_API_KEY`、`MINIMAX_API_KEY` 等）。`deepseek-account` 是例外：它不需要密钥——在 DSH 里登录 DeepSeek 账号即可，卡片读的是登录留下的授权。 **第 2 步——把插件装进 `web` profile：** ```sh dsh plugin --profile web add @dougen/dsh-deepseek-usage ``` **第 3 步——重启 `dsh web`**，打开它打印的地址。卡片位于侧边栏底部、Cordis 面板按钮下方；点击卡片可立即刷新。提供商映射与订阅令牌在**设置 → DeepSeek 用量**里配置；当前模型背后的路由不被支持时，卡片上会给出「去映射」按钮，点击直接打开这一页。 使用 Claude Code / OpenAI Codex 订阅（OAuth） API Key 读不到这两种订阅——它们走 OAuth 令牌。当 DSH 检测到 Claude Code 或 OpenAI Codex（或有映射目标指向其中之一），**设置 → DeepSeek 用量** 的提供商映射下方会出现令牌填写框。把令牌粘贴进去，侧边栏卡片即可开始显示该订阅的余量： - **Claude Code**——在已登录 Claude Code 的机器上，从 `~/.claude/.credentials.json` 复制 `claudeAiOauth.accessToken`（macOS 在钥匙串项 `Claude Code-credentials` 里）。`claude setup-token` 产生的令牌也能用。 - **OpenAI Codex**——从 `~/.codex/auth.json` 复制 `tokens.access_token` 填进令牌框，`tokens.account_id` 填进账号 ID 框。 令牌经 DSH 的凭据服务保存在本机（`~/.dsh/.credentials.yaml`），任何响应、日志、页面元素都不会把它带出去；点**清除**按钮即可删除。 卸载 ```sh dsh plugin --profile web remove @dougen/dsh-deepseek-usage ``` 然后重启 `dsh web`。 ## 支持的 DSH 版本 插件版本要与 DSH 版本相配： | DSH 版本 | 应安装的插件版本 | | --- | --- | | `0.2.x`（`0.2.0-rc.1` 起） | `0.11.0` 及以后 | | `0.1.x`（`0.1.0-rc.6` 起） | `0.10.x`，或 `0.11.0` 及以后 | 运行 `dsh --version` 查看你的 DSH 版本。不带版本号安装会自动取最新的兼容版本；最新版与你的 DSH 不匹配时，指定确切版本，例如 `@dougen/dsh-deepseek-usage@0.10.2`。 ## 常见问题 ### @dougen/dsh-deepseek-usage 是什么？ 一个 DeepSeek Harness 侧边栏插件: 活动提供者的账户余额或订阅用法\( DeepSeek, Moonshot/Kimi, GLM, OpenRouter, Kimi Coding, OpenCode, MiniMax, 外加 Claude 代码和 Codex OAuth 令牌\),第三方提供的提供者- id映射 ### 如何安装 @dougen/dsh-deepseek-usage？ 在项目目录运行 npm install @dougen/dsh-deepseek-usage，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/schemastery（^3\.18\.0）、@deepseek-ai/dsh-credentials（^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.2）、@deepseek-ai/dsh-host-webserver（^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.1 \|\| ^0\.2\.1-rc\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @dougen/dsh-deepseek-usage 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dougen\_\_dsh-deepseek-usage 是否存在。 ### @dougen/dsh-deepseek-usage 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @dougen/dsh-deepseek-usage 可以商用吗？ @dougen/dsh-deepseek-usage 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @dougen/dsh-deepseek-usage 的下载量有多少？ 根据 npm 官方下载统计，@dougen/dsh-deepseek-usage 在 2026/10/13 – 2026/11/11 这 30 天内被下载 15,572 次，日均约 519 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dougen/dsh-deepseek-usage 还在维护吗？ 最新版本 0\.20\.0 发布于 2026/11/05（8 天前）；至今共发布 45 个版本，其中过去 12 个月发布了 45 个；首次发布于 2026/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。