dsh-damage-pulse 使用指南

监控 DSH 每次模型调用的 Token 用量与金额，在余额悬浮卡上以扣血动画呈现每笔扣费，并自动校准 DeepSeek 账户实时余额。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

— 源: plugin_wiki.readme_zh (fallback readme_raw)

余额卡片显示「未配置 API Key」怎么办？

需要在 DSH 凭据系统里配置 DEEPSEEK_API_KEY（写入 ~/.dsh/.credentials.yaml）。未配置只会让余额卡片显示未配置态，不会影响 Token 计量和扣血动画。

每次扣费会立刻从余额里扣掉吗？

余额是按本地精确扣减的：每次模型调用结束后立刻减去精确金额并触发扣血动画；同时每 60 秒拉取一次 DeepSeek 官方余额进行校准。如果官方余额比你本地显示的多，会自动出现绿色「加费」动画。

缓存命中和缓存未命中有什么区别？

纯缓存命中只显示普通红色扣费数字；只要一次调用中存在缓存未命中输入或缓存写入，就会触发更强的红色「未命中 -x.xx¥」动画，并伴随短促横向抖动和更大的余额回弹。同一秒内合并的多笔扣费，只要有一笔属于未命中，整组按未命中播放。

安装后看不到任何动画怎么办？

确认已用「dsh --profile web」重启安装目标的 profile。如果以前用过源码集成版，请先移除手工 patch 与重复挂载，避免同一插件加载两次。

旧会话为什么一开始没有金额？

插件启动时会自动为缺失 Token 金额投影的历史会话触发一次冷读 fold，几秒后页面就会显示金额。投影一旦写入 checkpoint，下次启动无需再次补齐。

左侧会话列表为什么没有累计金额？

DSH 目前没有开放「左侧会话行尾部信息」的第三方 slot，因此标准包不会修改宿主 DOM。如果使用完整 DSH 源码并确实需要该功能，可以运行仓库里的侧边栏集成脚本修改源码，但这不是标准包的能力。

可以自己覆盖价格表吗？

可以。在 settings namespace「dsh-token-monitor」的 priceTable 字段填入自定义价格即可覆盖内置表；旧价（2026-08-17 涨价前）的费用会按当时时间戳自动使用旧价，不会重算。

数据存在哪里？怎么卸载？

单次用量明细以 JSONL 追加到 ~/.dsh/data/dsh-token-monitor/usage.jsonl，冷启动自动回读；会话累计由 DSH 自身的 session projection 持久化。用「dsh plugin --profile web remove」即可卸载。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则