CN-Leo/dsh-deepseek-balance

Name: CN-Leo/dsh-deepseek-balance
Author: CN-Leo

插件Plugin 原生Native ⭐ 3 MIT Web 界面Web UI

deepseek-harness 插件，实时查询 DeepSeek 账号余额。

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

DSH 插件，在 Web 输入框下方常驻显示 DeepSeek 官方账户余额，每 15 秒自动刷新，并按官网定价与北京峰谷时段实时折算本次会话消费金额（仅 deepseek-v4-flash/pro）。数据通过 Host 端 credentials 服务解析 DEEPSEEK_API_KEY 调用官方接口，密钥不进入浏览器；非 DeepSeek 模型不计入。需安装后重启 dsh web，并配置 DEEPSEEK_API_KEY（环境变量或 .credentials.yaml），且系统需有 curl。

DSH plugin that displays DeepSeek account balance under the Web composer, refreshing every 15 seconds, and computes current-session cost in real time using official pricing and Beijing peak/off-peak hours (deepseek-v4-flash/pro only). The API key is resolved by the Host's credentials service and passed only to a curl child process; the browser only receives the balance JSON. Non-DeepSeek models are skipped. Requires dsh web restart after install, DEEPSEEK_API_KEY configured (env or .credentials.yaml), and curl on PATH.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-deepseek-balance】【https://github.com/CN-Leo/dsh-deepseek-balance】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:CN-Leo/dsh-deepseek-balance

把 CN-Leo/dsh-deepseek-balance 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.0 KB · 缓存于 2026-08-25 04:53:49 · 3.0 KB

dsh-deepseek-balance

DeepSeek 账户余额实时显示插件（DeepSeek Harness / DSH）。

在 DSH Web 界面的输入框下方（conversation.composer.dock）常驻显示 DeepSeek 官方账户余额，每 15 秒自动刷新；同时按官网最新定价实时计算本次会话消费金额。数据来自官方接口 GET https://api.deepseek.com/user/balance，API Key 由 Host 端从 DSH 凭据库解析，绝不会进入浏览器。

安装

# 从 Git 仓库（发布后）
dsh plugin add https://github.com/<你的用户名>/dsh-deepseek-balance

# 或从本地目录
dsh plugin add /path/to/dsh-deepseek-balance

安装后重启 dsh web（当前进程不会热加载新插件）。

配置（必需）

插件通过 credentials 服务解析 DEEPSEEK_API_KEY，按以下顺序查找（任选其一）：

环境变量 DEEPSEEK_API_KEY
$DSH_HOME/.credentials.yaml：
```
DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx
```

配置后无需重启插件：每次请求都会重新解析凭据。

使用

余额条显示在会话输入框下方：● DeepSeek 余额 ¥71.33 ｜本会话 ¥4.85
- 绿点 = 正常，黄点 = 加载中，红点 = 获取失败
- 「本会话消费」按会话实际使用的模型分模型计价（从会话日志逐次提取每个模型调用的 token 用量），仅 deepseek-v4-flash / deepseek-v4-pro 套用官网价格，自动区分高峰/空闲时段（北京时间 9:00-12:00、14:00-18:00 为高峰，其余空闲），每 15 秒与余额一同刷新
悬停（hover）余额条可查看完整明细：
- 各币种余额：总额 / 赠送 / 充值 / 账户可用状态
- 本次会话按模型分列的 token 用量：输入（未命中/命中/写入）、输出
- 当前时段、本次会话消费金额
说明：非 DeepSeek 模型（如第三方 "…-pro"）不套用 DeepSeek 价格表、不计入消费金额；缓存写入按缓存未命中输入价计（官方价格表仅区分命中/未命中）

原理

端	职责
Host	`credentials.resolve('DEEPSEEK_API_KEY')` → `subprocess` 调用 `curl` 请求官方余额接口；同时读取本会话日志（`sessionQuery.readSession`），按 `request/header` 的模型与 `assistant/message` 的 usage 逐次配对、按模型聚合 token → 通过 `webServer` 暴露 `GET /api/deepseek-balance?session=<id>`
Client	浏览器 `fetch('/api/deepseek-balance?session=<id>')` 每 15s 轮询余额与分模型用量 → 按官网定价表 + 北京时间峰谷时段本地计价（非 DeepSeek 模型跳过）

API Key 只存在于 Host 进程的 curl 子进程参数中，浏览器端只能拿到余额 JSON。

卸载

dsh plugin remove dsh-deepseek-balance

依赖

Host：credentials、subprocess、sandboxPolicy、webServer（DSH 基础服务，Web 模式均有）
Client：slots 服务，react（由 DSH Web 模块表提供）
系统：curl（Windows 自带 curl.exe；其他平台需 PATH 中有 curl）

License

MIT

渲染基于仓库 CN-Leo/dsh-deepseek-balance 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install

READMEREADME

dsh-deepseek-balance

安装

配置（必需）

使用

原理

卸载

依赖

License

相关推荐Related

命令行安装CLI Install