HaoyueQin/dsh-deepseek-monitor 预览 preview

HaoyueQin/dsh-deepseek-monitor

Plugin插件 Native原生 ⭐ 2 MIT Usage & Cost用量与计费

DeepSeek Harness web plugin: DeepSeek balance & platform usage monitoring inside the official Settings-Models-DeepSeek card, plus a live balance chip left of the model name in the composer tool row. Ported from DeepSeekMonitorWindows.

Project Overview项目介绍

DSH DeepSeek Monitor is a DeepSeek Harness web plugin that ports balance and usage monitoring into dsh. It injects an Account Details panel into the Settings → Models → DeepSeek provider card, showing balance, daily spend, per-model usage rows, a stacked daily bar chart, and platform token configuration, while rendering a live balance chip beside the model name in the input toolbar (turning red when low). Use it to track official DeepSeek account consumption in real time. Note: the input-bar chip only appears when the active session is routed to the built-in official DeepSeek provider, not third-party models named with the deepseek- prefix.

DSH DeepSeek Monitor 是一款 DeepSeek Harness Web 插件,将 Windows 桌面版的余额与用量监控移植进 dsh。它在「设置 → 模型 → DeepSeek」供应商卡片内提供账户明细面板(余额、今日消耗、模型用量、每日堆叠柱状图、Token 配置),并在输入框模型名称左侧显示实时余额 chip,低余额变红。适用于需要实时跟踪官方 DeepSeek 账户消耗与配额的用户。注意:仅当会话路由至内置官方供应商时显示,第三方 DeepSeek 命名模型不触发。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-deepseek-monitor@latest

HaoyueQin/dsh-deepseek-monitor 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH DeepSeek Monitor

English | 简体中文

DSH DeepSeek Monitor

npm version npm downloads License: MIT TypeScript 5.6 dsh plugin · web node >=20 Commit activity Last commit

DeepSeek Harness(dsh)Web 插件:把 DeepSeekMonitorWindows余额与用量监控能力移植进 dsh —— 集成到「设置 → 模型 → DeepSeek」供应商卡片内,并在输入框工具行(模型名称左侧)显示实时余额。

demo

账户明细面板预览

截图:设置 → 模型 → DeepSeek 卡片展开的「账户明细」面板(余额卡 / 模型用量行 / 每日堆叠柱状图),以及名称旁的余额 chip 与「账户明细」按钮。

功能特性

设置 · 模型 · DeepSeek 行内增强

  • 「账户明细」按钮:位于「编辑」左侧,克隆宿主按钮样式,视觉完全一致
  • 余额 chip:模型名称旁实时显示余额(按币种渲染符号,如 ¥/$),低于阈值变红
  • 展开面板(点击按钮在卡片容器内展开):
    • 账户余额:官方 GET /user/balance API,复用 dsh 已配置的密钥;今日消耗 / 本月费用 mini 格(按账户币种渲染,无余额快照时回退 ¥);低余额警示
    • 模型用量行:平台返回的模型 id 各自成行,显示官方产品名(DeepSeek-V4.1-Flash / V4-Flash / V4-Pro / V4-Flash-Vision-Exp),顺序 V4.1 Flash → V4 Flash → Pro → Vision;lucide SVG 图标(闪电 / 照片 / 大脑)、独立柔和配色、进度条 + 缓存命中率 + 费用,行高恒定。同一模型的多个账期 id(如 V4.1 Flash 的到期 id 与正式 id)合并为一行,因此行内数字与平台账单逐项对得上
    • 每日堆叠柱状图:DSM 原版配色(命中绿 / 未命中橙 / 输出紫),逐行分桶(未单列行的模型 id 归入「其他」桶,因此柱高始终等于当日总量)、月份切换,稀疏日期标注保证不重叠,自绘悬浮卡(悬停查看明细)
    • 平台 Token 配置:双通道获取——①一键复制控制台抓取脚本(登录平台页粘贴回车即捕获);②手动 F12 粘贴。保存前先经平台接口验活,凭据只写不读回
    • 设置:输入框余额显示开关、自动刷新开关与间隔(≥60s)、低余额提醒与阈值、重载缓存 / 清除缓存

输入框工具行余额项

  • 挂载于官方 conversation.input.right 槽位,渲染在模型名称左侧、发送键之前,与模型选择等控件同排版(28px 行高 / 13px 字号 / medium 字重)
  • 仅当当前会话最近一次路由的供应商为内置官方 DeepSeek 供应商(设置→模型列表固定第一位,provider 路由 id 为 deepseek-official)时显示,与模型名称无关(第三方供应商即使提供 deepseek-* 命名的模型也不显示);新会话首屏(无会话)自动隐藏
  • 可在「账户明细 → 设置」卡片通过开关随时打开 / 关闭该余额显示,保存后输入框立即响应
  • 配色策略:币种符号保持默认灰色;余额数字 > 0 显示绿色state-success-primary)、≤ 0 显示红色state-error-primary
  • 余额 chip 固定每 60 秒轮询一次宿主缓存;展开面板按设置的刷新间隔轮询;上游 API 的实际刷新节奏由设置中的自动刷新间隔统一驱动(≥60s,仅宿主侧定时器会请求上游)

数据与安全

  • API Key 通过 dsh 凭据缝每次操作现解析,插件不存储、不上屏、不入日志
  • 平台 Token 经自有 fenced 路由写入 dsh 凭据缝(write-only),任何接口不回显
  • 全部路由位于浏览器信任围栏之后(loopback / trustedHosts,拒绝跨站)
  • 抓取脚本纯本地运行于平台页自身上下文,不向任何第三方发送数据
  • 偏好与缓存持久化于 storage-domain deepseek_monitor

安装

dsh plugin --profile <name> add dsh-deepseek-monitor@latest

已在 npm 发布:dsh-deepseek-monitor。也可以从 GitHub Releases 下载 dsh-deepseek-monitor-<version>.tgz,通过本地 profile / 注入器方式装载。

版本兼容

  • 支持 DeepSeek Harness 0.1.5 与 0.1.6 版本线dsh.plugin.jsonengines.dsh 与此声明一致,peer 范围为 ^0.1.5-alpha.1 || ^0.1.6-alpha.1)。按 node-semver 规则,每个分支覆盖其 alpha.1 起的 pre-release 与后续正式版;地板值刻意保持在 alpha.1(alpha.x 内核同样受支持,收窄它没有收益)。构建基线固定在 0.1.6-alpha.1(devDependencies),即按当前受支持内核的最新 pre-release 编译。
  • 旧版 DeepSeek Harness 用户(0.1.2-rc.x / 0.1.3-alpha.x 及更早):请安装本插件的旧版本(0.1.2/0.1.3 内核请用 v0.1.5,更早内核请用 v0.1.4)。
  • 模型行口径不随 dsh 内核版本变化:面板的行只由平台用量接口返回的模型 id 决定。平台把一个模型的多个账期 id 映射到同一行(例如 V4.1 Flash 的到期 id 与 deepseek-flash 合并),把已退役的 id 排除在行外(其用量仍计入总额与图表),未识别的 id 则原样成行 —— 因此升级 dsh 不会改写你看到的历史账单口径。

开发

pnpm install
pnpm typecheck   # tsc --noEmit
pnpm test        # vitest run
pnpm build       # tsc declarations + tsdown (host ESM + 双通道 client bundle)
pnpm watch       # tsdown --watch

GUI 取证脚本(无头浏览器验证面板挂载与样式):node scripts/probe-gui.mjs

致谢

本插件的余额 / 平台用量后端与面板结构,移植自作者自己的 HaoyueQin/DeepSeekMonitorWindows(Windows 桌面版);移植所依据的实现沿其自述谱系继续向上追溯:

项目 关系 许可证
HaoyueQin/DeepSeekMonitorWindows 直接移植来源do_fetch_balance / do_fetch_usage / token 口径与仪表盘结构的 TypeScript 移植底本 MIT
Joyi-code/DeepSeekMonitorWindows 上述桌面版的直接上游(Windows Tauri 2 重构),移植逻辑的最终出处 MIT
JayHome137/DeepSeekMonitor 谱系起点(macOS 菜单栏 + WidgetKit 版),开创了「DeepSeek 余额与用量监控」这一形态 MIT
lucide SVG 图标库 ISC

本项目基于 MIT 发布,上述 MIT 项目许可声明随分发一并保留。

Activity

HaoyueQin/dsh-deepseek-monitor GitStock K-Line Chart

License

MIT

上一个 Prev dsh-files-git 下一个 Next dsh-form-fill-agent