dsh-damage-pulse

DSH（DeepSeek Harness）扣血式 Token 余额监控插件：每次产生 token 消耗，余额数字都会受击回弹，并飘出红色扣费数值；同时提供会话用量、精确金额和 DeepSeek 账户实时余额。

功能特性

• 单次用量行：每次模型调用结束，在对话流内插入一行 token 明细（输入 / 缓存命中 / 输出 / 思考 reasoning）与精确金额。
• 会话累计条：输入框上方显示当前会话累计 token 与金额（基于 tokenCost session projection）。
• 会话累计金额：输入区持续显示当前会话累计消费；源码集成版还可选在左侧原生会话列表显示累计金额。
• 缓存感知扣血动画：纯缓存命中使用普通红色 -x.xx¥ 命中脉冲；存在缓存未命中输入或缓存写入时，显示更大的红色「未命中 -x.xx¥」、短促横向抖动和更强的余额回弹。同一秒合并的多笔扣费中只要有一次未命中，整组即按未命中播放；连续扣费最多保留三组飘字。
• 余额悬浮窗：
  • 充值动画：检测到余额变多，飘出绿色 +x.xx¥；
  • 可拖动：按住卡片可随意移动，位置自动记忆（localStorage）；
  • 峰谷标识：余额栏最右侧显示「峰」（红 / 高峰）或「谷」（绿 / 谷时），带红绿灯发光效果。
• 价格表：内置 DeepSeek 2026-08-23 定价规则；工作日按峰谷时段计费，周末全天统一按谷价，历史费用按每条调用发生的北京时间自动判定，涨价前已算的费用不会重算。
• 精确计费：按每次调用的实际模型名计价（deepseek-v4-pro、deepseek-v4-flash、deepseek-v4-flash-vision-exp，支持版本后缀最长前缀匹配），缓存命中与缓存未命中分别计价。视觉模型的图片按 DeepSeek 返回的 usage.prompt_tokens（图片已按尺寸折算并与文本合并）计费，不重复估算。

鲸鱼娘

鲸鱼娘是余额悬浮框上的桌面伙伴。她会在模型运行时用啃手指、眨眼等待机动作陪你等待，也会根据 Token 扣费强度做出对应反应；连续扣费、余额耗尽，以及从非正余额充值恢复时，都有独立且已实装的动作反馈。鲸鱼娘可以随余额框一起拖动，也可在余额框右键菜单中隐藏。

  <img src="docs/assets/readme/whale-girl-idle-bite-finger.png" alt="鲸鱼娘啃手指待机原画" width="260"><br>
  <sub><b>等待任务时：啃手指待机</b></sub>
  <img src="docs/assets/readme/whale-girl-critical-damage.png" alt="鲸鱼娘严重扣费原画" width="260"><br>
  <sub><b>缓存未命中时：严重扣费反应</b></sub>

架构

项目公开品牌为 dsh-damage-pulse。为兼容已安装用户，下列目录名、包名、API 路径、设置命名空间和本地存储键仍沿用 dsh-token-monitor / token-monitor，无需迁移已有配置与历史数据。

部分	位置	职责
Host 插件	plugins/dsh-token-monitor	监听 session/event，精确计费（token × 单价），注册 tokenCost session projection、余额轮询服务、HTTP 端点（balance / usage / charge-events / stats）
Client 包	packages/client/ui-token-monitor	Web GUI 组件：余额悬浮窗（BalanceWidget）、单次用量行、会话累计条，读投影与 HTTP 端点渲染

安装

本仓库从 0.2.0 起是标准 DSH Host + Client 组合包，已提交预编译产物。当前版本要求 DSH 0.1.1-rc.2 或更高兼容版本。无需复制源码、修改 DSH tsconfig、手动传入 --patch 或重建 Client bundle。

dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse

安装后重启 Web profile：

dsh --profile web

标准包直接提供余额悬浮栏、余额实时扣减、缓存命中/未命中动画、单次用量行和输入区会话累计。升级自早期源码集成版时，请移除原有手工 --patch 或重复挂载项，避免同一插件加载两次。

可选：原生侧边栏金额源码增强

DSH 当前没有开放“左侧会话行尾部信息”的第三方 slot，因此标准包不会修改宿主 DOM，也不会强行注入左侧会话列表。标准包内的输入区会话累计不受影响。

只有在使用完整 DSH 源码且确实需要原生左侧会话行金额时，才运行：

.\scripts\apply-sidebar-integration.ps1 -HarnessRoot 'C:\path\to\deepseek-harness'
$env:DSH_BUILD_FACE = 'client'
corepack pnpm --dir 'C:\path\to\deepseek-harness\packages\client\ui-workspace' exec tsdown

脚本会先备份三个目标文件，并以幂等方式读取 projectionValues.tokenCost.cost。上游结构不匹配时会停止，不会猜测写入。

源码开发

corepack pnpm install
corepack pnpm build
corepack pnpm run check:bundle

配置

API Key

通过 DSH 的 credentials 机制配置 DEEPSEEK_API_KEY（~/.dsh/.credentials.yaml），未配置时余额卡片显示引导态，token 计量不受影响。

价格表（可选覆盖）

价格表默认内置（见 src/pricing.ts），可通过 settings namespace dsh-token-monitor 的 priceTable 字段覆盖价格和工作日高峰时段。周一至周五默认按北京时间 9:00–12:00、14:00–18:00 为峰价，其余时间为谷价；周六、周日无论时段均按谷价。官方依据：模型与价格、图像理解 Token 用量。

HTTP 端点

端点	说明
GET /api/token-monitor/balance	DeepSeek 账户余额（含 currency / 总余额 / 赠送余额）
GET /api/token-monitor/usage?sessionId=	用量明细历史（可过滤会话）
GET /api/token-monitor/charge-events?since=<seq>	扣费事件增量（含 damageKind，驱动缓存感知扣血动画）

常见问题

…