HaoyueQin/dsh-deepseek-monitor

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」供应商卡片内，并在输入框工具行（模型名称左侧）显示实时余额。

截图：设置 → 模型 → 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  add dsh-deepseek-monitor@latest

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

版本兼容

- 支持 DeepSeek Harness 0.1.5 与 0.1.6 版本线（dsh.plugin.json 的 engines.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.2（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