HaoyueQin/dsh-deepseek-monitor

English | 简体中文

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 <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 与 0.2.0 版本线（dsh.plugin.json 的 engines.dsh 与此声明一致，peer 范围为 ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.2.0-rc.1）。按 node-semver 规则，每个分支覆盖其首个 pre-release 起的同线版本与后续正式版（0.2.0 分支同时覆盖 0.2.0 正式版与 rc.x）；地板值刻意保持在各线首个 pre-release（早期内核同样受支持，收窄它没有收益）。构建基线固定在 0.2.0-rc.1（devDependencies），即按当前受支持内核的最新 pre-release 编译。0.1.7 内核（alpha.1–rc.2）落在 0.1.6 分支的匹配区间内、DSH 的兼容门禁同样放行，其内核差异已包含在 0.2.0-rc.1 的契约审计中。
• 旧版 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 图标库：面板内模型行图标，以及插件卡片图标 icon.svg（摄像头几何改编自其 cctv，ISC 声明随文件保留）	ISC

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

Activity

License

MIT