前言¶
在 DSH（DeepSeek Harness）里跑模型，token 消耗往往分散在多次调用里：对话流里看不到单次明细，输入区也没有会话累计，账户余额还要另开页面查。对需要控制成本、观察缓存命中效果的开发者来说，这些信息分散在不同位置，很难形成即时反馈。
下面介绍 dsh-damage-pulse（维护者 wssfk12138）。它在 DSH Web 客户端内提供扣血式余额动画、峰谷计费、会话费用统计，以及可选的鲸鱼娘桌面伙伴，把 token 消耗和账户余额拉到同一视野里。
这是什么¶
dsh-damage-pulse 是 DSH 的客户端插件，分类为「客户端」。项目当前版本 0.3.2，MIT 许可证，GitHub 仓库 wssfk12138/dsh-damage-pulse 约 107 stars。
插件监听会话事件，按实际模型名和缓存命中情况精确计费，在界面上展示：
- 每次调用的 token 明细与金额
- 当前会话累计消费
- DeepSeek 账户实时余额
- 扣费时的受击回弹与飘字动画
项目公开品牌为 dsh-damage-pulse，内部目录名、API 路径和设置命名空间仍沿用 dsh-token-monitor，已安装用户无需迁移配置。
核心功能¶
单次用量与会话累计¶
每次模型调用结束后，对话流内插入一行 token 明细，包含输入、缓存命中、输出、思考（reasoning）分项及精确金额。
输入框上方持续显示当前会话累计 token 与金额，数据来自 tokenCost session projection。标准包在输入区展示；若使用完整 DSH 源码并执行侧边栏集成脚本，还可选在左侧原生会话列表显示累计金额。
缓存感知扣血动画¶
余额数字在每次 token 消耗时受击回弹，并飘出红色扣费数值：
- 纯缓存命中：普通红色
-x.xx¥脉冲 - 存在缓存未命中输入或缓存写入：更大的「未命中 -x.xx¥」、短促横向抖动和更强回弹
同一秒合并的多笔扣费中，只要有一次未命中，整组按未命中播放。连续扣费最多保留三组飘字。
余额悬浮窗¶
余额卡片支持拖动，位置自动记忆（localStorage）。主要能力包括：
- 充值检测：余额变多时飘出绿色
+x.xx¥ - 峰谷标识：余额栏右侧显示「峰」（红 / 高峰）或「谷」（绿 / 谷时），带红绿灯发光效果
- 未配置 API Key 时显示引导态，token 计量仍正常进行
峰谷计费与价格表¶
内置 DeepSeek 2026-08-23 定价规则。工作日按峰谷时段计费，周末全天统一按谷价；历史费用按每条调用发生的北京时间自动判定，涨价前已算的费用不会重算。
默认峰谷时段（北京时间，周一至周五）：
- 峰价：
9:00–12:00、14:00–18:00 - 其余时间为谷价
- 周六、周日无论时段均按谷价
按每次调用的实际模型名计价，支持 deepseek-v4-pro、deepseek-v4-flash、deepseek-v4-flash-vision-exp 及版本后缀最长前缀匹配。缓存命中与未命中分别计价。
可通过 settings namespace dsh-token-monitor 的 priceTable 字段覆盖价格和工作日高峰时段。
鲸鱼娘¶
鲸鱼娘是余额悬浮框上的桌面伙伴：
- 模型运行时用啃手指、眨眼等待机动作
- 根据 token 扣费强度做出对应反应
- 连续扣费、余额耗尽、从非正余额充值恢复时有独立动作反馈
可随余额框拖动，也可在余额框右键菜单中隐藏。
HTTP 端点¶
插件注册以下 HTTP 端点，供客户端组件读取：
| 端点 | 说明 |
|---|---|
GET /api/token-monitor/balance |
DeepSeek 账户余额（含 currency / 总余额 / 赠送余额） |
GET /api/token-monitor/usage?sessionId= |
用量明细历史（可过滤会话） |
GET /api/token-monitor/charge-events?since=<seq> |
扣费事件增量（含 damageKind，驱动缓存感知扣血动画） |
安装与启用¶
插件从 0.2.0 起为标准 DSH Host + Client 组合包，已提交预编译产物。要求 DSH 0.1.1-rc.2 或更高兼容版本，无需复制源码、修改 tsconfig、手动传入 --patch 或重建 Client bundle。
1、安装插件：
dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse
2、重启 Web profile：
dsh --profile web
安装后标准包直接提供余额悬浮栏、余额实时扣减、缓存命中/未命中动画、单次用量行和输入区会话累计。
若从早期源码集成版升级，请移除原有手工 --patch 或重复挂载项，避免同一插件加载两次。
注意： 插件以当前 dsh 进程权限运行。安装前应检查 GitHub 仓库 源码与 MIT 许可证，确认符合你的使用场景。
配置¶
API Key¶
通过 DSH 的 credentials 机制配置 DEEPSEEK_API_KEY，写入 ~/.dsh/.credentials.yaml。未配置时余额卡片显示引导态，token 计量不受影响。
微信通知（可选）¶
0.3.2 起内置轻量 ClawBot 适配器，按优先级选择通知 provider：新版外部 wechat-notify 能力对象 → 旧版 send() / status() 接口 → 内置适配器。若已安装独立 dsh-wechat-notify，本插件会复用其发送能力；未安装时，配置 WECHAT_NOTIFY_CLAWBOT_INDEX 后内置适配器可开箱发送。微信未登录或发送失败不会阻塞余额监控与动画。
典型用法¶
安装并重启后，正常使用 DSH 对话即可，无需额外命令。每次模型调用结束，对话流内自动出现用量行；输入区上方显示会话累计；余额悬浮窗实时反映扣费与峰谷状态。
需要查看账户余额时，观察余额悬浮窗，或通过 HTTP 端点查询：
GET /api/token-monitor/balance
需要拉取某会话的用量历史：
GET /api/token-monitor/usage?sessionId=<会话ID>
适用场景与注意¶
适合谁：
- 在 DSH Web 客户端日常跑 DeepSeek 模型，希望即时看到每次调用花了多少 token 和金额
- 需要观察缓存命中效果，并通过动画区分命中与未命中扣费
- 使用 DeepSeek 峰谷定价，希望按北京时间自动判定每条调用的计费时段
常见问题：
- 余额卡片显示「未配置」：未配置
DEEPSEEK_API_KEY，token 计量仍正常 - 左侧原生会话行没有金额：属于源码增强功能，需完整 DSH 源码并执行
scripts/apply-sidebar-integration.ps1；输入区会话累计不受影响 - 窗口启动后仍无动画：确认已重启安装目标 profile；若曾使用源码集成版，先删除旧的手工 patch 和重复挂载
链接¶
- SkillHub 目录页：wssfk12138/dsh-damage-pulse
- GitHub 仓库：github.com/wssfk12138/dsh-damage-pulse
dsh-damage-pulse 把 token 消耗、会话累计和账户余额收进 DSH 界面，用扣血动画和峰谷标识给出即时反馈。若你正在 DSH 里控制模型成本，可以按上述步骤安装试用。
