前言¶
使用 DeepSeek Harness（DSH）网页界面调用 DeepSeek API 时，剩余额度、当前对话费用和今日消费往往需要另行查看。dsh-deepseek-quota 是一个 DSH web GUI 插件，把这些信息放到页面右下角的悬浮卡片中。下面介绍它的功能、安装方式和典型配置。
这是什么¶
dsh-deepseek-quota 由 yingjunnan 维护，是一个面向 DSH 网页界面的插件，许可证为 MIT。它在 shell.overlay 槽位注册一个悬浮卡片，用于显示 DeepSeek API 剩余额度、当前对话费用与今日消费。插件需要 pnpm，通过凭证服务读取 DEEPSEEK_API_KEY，浏览器只访问本地路由。
核心功能¶
悬浮卡片显示内容¶
卡片显示：
- 总余额
- 可用状态
- 当前对话费用
- 今日已消费
- 赠送余额
- 充值余额
自动与手动刷新¶
- 余额每 60 秒自动刷新
- 当前对话费用每 5 秒自动刷新
- 支持手动刷新
峰谷计价时段提示¶
插件显示 DeepSeek 的高峰、空闲或常规峰谷计价时段提示。峰谷计价自 2026-08-17 起，高峰时段为北京时间 09:00–12:00 与 14:00–18:00。
当前对话费用¶
当前对话费用按每条 assistant/message 以 DeepSeek 官方价格表计价，并支持 2026-08-17 起的峰谷定价。
今日消费来源¶
- 配置
DEEPSEEK_PLATFORM_TOKEN时，可获取官方今日消费 - 未配置时，按余额差值估算，并在界面上标注约消费
路由与错误状态¶
插件注册宿主路由：
GET /api/deepseek-balanceGET /api/deepseek-session-cost
它会提供未配置 Key、网络失败、接口报错等错误状态，并自动跟随应用浅色或深色主题。
安装与启用¶
安装前需要 pnpm。
已安装 dsh CLI：
dsh plugin --profile web add dsh-deepseek-quota
未安装 dsh CLI：
npx @deepseek-ai/dsh plugin --profile web add dsh-deepseek-quota
安装后按下面步骤启用：
1、重启网页应用：
dsh web
或使用：
npx @deepseek-ai/dsh web
2、打开 http://127.0.0.1:3080 并刷新页面。
完成后，右下角会出现额度卡片。
也可以使用手动方式：把包放入 profile 的 node_modules，并在 ~/.dsh/profiles/web/cordis.patch.yml 添加：
- insert:
- id: deepseek-quota
name: dsh-deepseek-quota
典型用法¶
配置 DeepSeek API Key¶
在“设置 → 模型”页面配置 DEEPSEEK_API_KEY，或写入 ~/.dsh/.credentials.yaml：
DEEPSEEK_API_KEY: <你的 API Key>
插件通过凭证服务读取该 Key；API Key 不出本机，浏览器只访问本地路由。
查看额度与费用¶
打开 http://127.0.0.1:3080 后，右下角卡片会显示总余额、可用状态、当前对话费用、今日已消费、赠送余额与充值余额。余额和当前对话费用会按上述周期自动刷新，也可以手动刷新。
可选：启用官方今日消费¶
如需读取官方今日消费，配置 DEEPSEEK_PLATFORM_TOKEN，例如写入 ~/.dsh/.credentials.yaml：
DEEPSEEK_PLATFORM_TOKEN: <令牌>
配置后，插件读取 platform.deepseek.com/api/v0/usage/cost 的官方今日消费。未配置该令牌时，仍会按余额差值估算并标注约消费。
适用场景与注意¶
适合以下使用方式：
- 在 DSH 网页界面中使用 DeepSeek API
- 希望常驻显示剩余额度、当前对话费用和今日消费
- 需要查看当前峰谷计价时段
- 希望浏览器只访问本地路由
注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 许可证为 MIT。
- 需要
pnpm。 - 修改
lib/client.js后，需重启dsh web，重新生成引导哈希并强制刷新页面。 - 本地开发可用：
dsh plugin --profile web add .
相关链接¶
目录页：https://www.skillhub.cn/plugins/yingjunnan/dsh-deepseek-quota
