dsh-damage-pulse

usagetested: passnpmMIT

Tracks DeepSeek token usage, per-call and session costs, and account balance with cache-aware charge animations in the DSH Web UI.

下载量 / Downloads

7,256

依赖体积 / node_modules

109.71 MB

测试时间 / Tested

2026-11-06

DSH 版本 / Version

0.2.2-rc.1

Install

dsh plugin --profile web add dsh-damage-pulse

Sandbox test results

Stage	Result
1 install	✓
2 list	✓
3 mount	✓
4 boot	—

Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).

README

[English](README.en.md) | 简体中文

dsh-damage-pulse

为 DeepSeek Harness 提供用量、费用与余额监控：查看单次调用、会话累计和历史统计，让鲸鱼娘陪你观察每次 Token 消耗。

[安装](#安装) · [功能介绍](#功能介绍) · [常见问题](#常见问题) · [高级配置与接口](docs/REFERENCE.zh-CN.md) · 更新记录

感谢模型赞助商 Fastai 支持开发。[赞助说明](#sponsor)

安装

当前源码版本：4.3.4，适配 DeepSeek Harness 0.2.1-rc.1 至 rc.5，以及 0.2.2-alpha.2、0.2.2-alpha.2-ce7073d-dirty、0.2.2-alpha.3、0.2.2-rc.1。 4.3.0–4.3.2 缺少新版宿主的兼容声明，会被兼容检查跳过。其中 0.2.2-alpha.3 与 0.2.2-rc.1 已在本机桌面版实机验证；0.2.2-alpha.2 及其报告的本地构建只是兼容声明放行，未取得对应桌面构建做实机验收。其它 0.2.2 版本（alpha.4、beta、preview、rc.2 与正式版）不在声明内，宿主仍会拒绝，发布后需要重新核验。4.3.4 目前只通过 GitHub Release 的完整 .tgz 提供；npm 通道仍为 4.3.3，按包名安装不会得到本次修复。

本次 4.3.4 不发布 npm。请下载 v4.3.4 Release 中完整的 dsh-damage-pulse-4.3.4.tgz，在桌面版「插件」页添加该文件路径，或用 CLI 安装该 Release 地址：

dsh plugin --profile desktop add https://github.com/wssfk12138/dsh-damage-pulse/releases/download/v4.3.4/dsh-damage-pulse-4.3.4.tgz

将 desktop 换成实际使用的 profile 名。安装后完整退出桌面程序（含托盘）再启动，在悬浮卡右键的「卸载与更新」核对版本。

需要指定版本时，使用对应 Release 的预编译 .tgz；不要直接安装仓库 URL、github: 地址、Source code 压缩包或未打包的源码目录，它们缺少运行载荷。
页面提示已安装时，先移除再添加完整包；保留配置和历史数据，不用清空账本解决启动问题。
官方 API 余额通过 DSH 凭据机制配置 DEEPSEEK_API_KEY；没有余额凭据也可记录用量和费用。

<summary>旧版宿主兼容说明</summary>

保留 0.1.0-rc.5、0.1.1-rc.2、Desktop 2.0.4（0.1.2-alpha.1）、0.1.5-alpha.2 等旧版兼容段，实际范围见 [package.json](package.json)。声明兼容不等于每个版本都逐一实机验收；本次验收使用 0.2.2-rc.1 与 0.2.2-alpha.3 桌面版。

标准包自带会话金额：优先使用 conversation.session.header.actions；宿主提供 sidebar.workspaces.sessionRow.trailing 时追加注册。旧客户端使用严格 fail-closed 的兼容桥，只有唯一匹配原生会话行时才显示，检测到已有金额或正式席位即停用，避免重复。

旧宿主沿用自身 lock 与依赖，不混装不同预发行版本。更多恢复与源码部署说明见[参考文档](docs/REFERENCE.zh-CN.md)。

</details>

功能介绍

本轮 rc.5 桌面截图使用合成示例数据；Plan 额度与部分 Token 概览使用接口替身展示，不代表真实供应商查询结果。

余额悬浮卡与鲸鱼娘

显示余额、本次输入/输出/缓存 Token、首字与总耗时，以及峰谷状态。余额每 60 秒校准；查询不可用时不显示金额，本地统计继续工作。支持拖动、键盘移动和位置记忆，右键进入各功能面板。

鲸鱼娘会待机、眨眼，并对扣费、缓存未命中、余额耗尽和充值恢复作出反应；可以单独隐藏。动画默认按卡片宽度的 80% 显示，已有自定义比例保留。

<summary>查看无余额状态、右键菜单、工作区与角色细节</summary>

</details>

用量明细、历史统计与 Plan 额度

对话流显示单次用量，输入区显示会话累计；独立明细窗口支持拖动、缩放、时间/模型/项目/对话筛选、列选择及费用构成查询。统计概览提供今日、近 7 天、近 30 天与全部历史的消费、请求、Token 和缓存指标。

「Plan 额度」显示订阅的 5 小时/每周窗口、剩余额度和下次刷新时间；只有确认存在套餐时才出现，仅有 API key 不会显示空页签。

<summary>查看统计概览、列设置、费用构成与 Plan 额度</summary>

费用浮层为便于阅读已展开完整内容，日常界面内可滚动查看。

</details>

计费规则与供应商余额

按 provider + model 判断计费资格，未知模型不套用 Flash 价格；输入、缓存与输出分项计费，推理 Token 不重复叠加。历史保存在本地持久账本，重启后恢复，事件重放不会重复扣费。

可编辑固定价、峰谷价、阶梯与倍率，也可为第三方供应商配置余额查询脚本，显示金额、自定义文字或额度窗口。DeepSeek 默认高峰为北京时间工作日 09:00–12:00、14:00–18:00；周末（含调休上班）与法定节假日全天按谷价。内置价格按生效时间分段，具体价格以官方说明及已加载规则为准。

<summary>查看余额脚本与高级设置</

…(truncated)

Rendered from the README published on npm. Formatted only, not edited.

Versions

Published on npm:：26，最后更新 2026-11-06

Links

GitHub · Homepage · npm

dsh-damage-pulse

Install

Sandbox test results

README

dsh-damage-pulse

安装

功能介绍

余额悬浮卡与鲸鱼娘

用量明细、历史统计与 Plan 额度

计费规则与供应商余额

Versions

Links

Same category