Francis-Xavier-code/dsh-balance-plugin

Name: Francis-Xavier-code/dsh-balance-plugin
Author: Francis-Xavier-code

插件Plugin ⭐ 54 其他Other

项目介绍Project Overview

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

DSH 余额监控插件，面向 DeepSeek Harness 用户。核心能力：自动读取 DEEPSEEK_API_KEY 并行监控 CNY/USD 双余额池，提供低余额告警、一键充值入口、Miyu 风格用量统计（贡献图日历、堆叠柱状图、模型环形图）、性能指标（首 token 延迟、tok/s、缓存命中率）及三方插件管理。适用于需要实时掌控 API 余额、用量趋势与插件清单的 DSH 用户。注意事项：npm 上存在同名包，请使用一键脚本或 github 源安装，避免装错。

DSH balance plugin for DeepSeek Harness. Core capability: auto-reads DEEPSEEK_API_KEY to monitor CNY and USD balance pools in parallel, with low-balance alerts, official top-up shortcut, Miyu-style usage statistics (contribution calendar, stacked trend bars, model donut chart), performance metrics (first-token latency, tok/s, cache hit rate), and third-party plugin management. Use when real-time visibility into API balance, usage trends, and installed plugins is needed. Caveat: avoid dsh plugin add dsh-balance-plugin; a same-name npm package exists. Use the one-click installer or github: source.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-balance-plugin】【https://github.com/Francis-Xavier-code/dsh-balance-plugin】

把上面这条消息直接发给当前会话里的 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:Francis-Xavier-code/dsh-balance-plugin

把 Francis-Xavier-code/dsh-balance-plugin 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

5.9 KB · 缓存于 2026-08-23 03:40:52 · 5.9 KB

💰 DeepSeek 余额监控与用量统计

DeepSeek Harness（DSH）插件 —— 余额监控 · 官方充值入口 · Miyu 风格用量统计 · 三方插件管理

✨ 功能 · 📥 安装 · 🖼 界面预览 · ❓ FAQ · 📖 文档 · 🌐 English

✨ 功能

模块	能力
余额监控	监控 DeepSeek API 余额（CNY / USD 双余额池），支持多账户并行查询；自动读取 DSH 凭据 `DEEPSEEK_API_KEY`，无需手动填写
低余额告警	CNY / USD 独立阈值（默认 ¥10 / $2，可配置），低于阈值时余额条标红提醒
一键充值	直达 DeepSeek 官方充值页 `platform.deepseek.com/top_up`，另有用量明细页入口
用量统计	1:1 复刻 Miyu WebUI 用量页：统计瓦片 / GitHub 贡献图风格用量日历 / 三段堆叠趋势柱状图 / 模型消耗环形图与明细表 / 最近 50 条调用记录
性能指标	轮次 · 步数 · LLM 时长 · 工具调用时长 · 首 token 平均延迟 · tok/s · 缓存命中率
三方插件管理	非官方（非 `@deepseek-ai`）Web 插件清单：包名 / 本地路径 / Bundle rev / 依赖，一键「打开目录」定位源码
模型工具	注册 `query_api_quota` 工具，直接问"DeepSeek 余额还剩多少"即可得到余额摘要
设置持久化	配置自动保存到插件目录 `config.json`，重启后自动恢复
一键更新	在 DSH 插件面板内直接检查更新并一键更新，无需手动操作

📥 安装

前置条件

已安装并运行 DeepSeek Harness
（可选）DeepSeek API Key —— 可在 platform.deepseek.com 获取；若本机已配置 DEEPSEEK_API_KEY 凭据，插件启动时自动读取，无需手动输入

一键安装（推荐）

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex

安装完成后重启 DeepSeek Harness，输入框右侧出现三个图标按钮即生效。可用 DSH_PROFILE=<name> 指定其他 profile。

更新插件

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.sh | UPDATE=1 bash

# Windows PowerShell
irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex
# 然后在 PowerShell 中运行: $env:UPDATE='1'; irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/install.ps1 | iex

或在 DSH 面板内点击「检查更新」→「更新」（推荐）。

卸载插件

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/uninstall.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/yxxbc/dsh-balance-plugin/main/uninstall.ps1 | iex

🖼 界面预览

截图	说明
	输入框工具行右侧三个图标入口与下方常驻余额条
	余额监控面板：余额表格、低余额告警、账户配置、阈值与刷新间隔、充值入口
	用量统计页顶部：范围切换、统计瓦片、live 性能指标条、GitHub 风格用量日历
	用量统计页底部：趋势柱状图、模型消耗明细、调用记录明细
	三方插件管理：统计徽章、插件清单、「打开目录」操作

❓ 常见问题

Q：重启后设置还在吗？ A：设置自动持久化到插件目录的 config.json 文件中，重启后自动恢复。

Q：重启后插件还在吗？ A：静态插件持久安装，重启后仍在。自动读取的 DEEPSEEK_API_KEY 无需重配，重启后自动恢复。

Q：侧边栏底部看不到入口按钮？ A：DSH 侧边栏底部插槽会被官方 Cordis 面板插件独占整行。本插件入口固定在输入框工具行右侧，不依赖该插槽。

Q：Key 会泄露吗？ A：不会。Key 只保存在本机插件目录 config.json 中，界面仅显示掩码；源码与 README 中不含任何密钥。

Q：为什么不用 dsh plugin add dsh-balance-plugin？ A：npm 上存在他人同名包（dsh-balance-plugin@0.1.0），裸包名会装错。请使用一键脚本或 github: 源。

更多问题请查看完整 FAQ。

📖 文档

文档	说明
配置说明	详细配置项说明、持久化机制、更新方式
架构说明	双面架构、RPC 路由、持久化机制
常见问题	完整 FAQ、故障排查、安装问题
贡献指南	如何参与贡献

💬 社区交流

👥 贡献者

Made with contrib.rocks.

📄 许可

渲染基于仓库 Francis-Xavier-code/dsh-balance-plugin 的 README.md。在 GitHub 查看原文 →

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