MIT 协议的游戏化 DeepSeek Harness Token 余额监控插件：实时余额悬浮窗、缓存感知扣血动画、单次用量明细行，以及按北京时间峰谷与周末谷价的精确计费。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-25
许可证
MIT
01它能帮你完成什么？
在 DSH 会话中实时观察 token 消耗与 DeepSeek 余额下降
可拖动余额卡片，含受击回弹动画、红色 `-x.xx¥` 扣费飘字、缓存命中脉冲，以及会话 token 与金额累计
希望以游戏化、实时方式掌握 token 消耗与 DeepSeek 账户余额的 DSH 用户
查看按 DeepSeek 峰谷计价的单次精确花费
每次调用的 token 明细行（输入/缓存命中/输出/思考 reasoning）与精确 ¥ 金额，工作日按北京时间峰谷、周末统一谷价
按模型与北京时间的计费时段追踪开销、对成本敏感的用户
02如何接入 DeepSeek Harness？
前置条件
- DSH `0.1.1-rc.2` 或更高兼容版本（README 明确为硬性要求）
- 可选：在 DSH credentials（`~/.dsh/.credentials.yaml`）中配置 `DEEPSEEK_API_KEY` 才能显示实时余额；未配置时 token 计量仍正常
安装步骤
- 01
执行 `dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse` 添加预编译的 Host + Client 组合包
$ dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse
- 02
用 `dsh --profile web` 重启 Web profile，让余额悬浮窗加载
$ dsh --profile web
验证接入成功
作者未说明
03DSH 适配与能力边界
标准 DSH Host + Client 组合包——Host 插件监听 `session/event` 做精确计费，注册 `tokenCost` session projection、余额轮询服务与 HTTP 端点，Client 包渲染余额悬浮窗。
带扣血脉冲的余额悬浮窗
DSH `session/event` 的 token 消耗事件与 DeepSeek 余额轮询→可拖动余额卡片，含受击回弹动画、红色 `-x.xx¥` 扣费飘字、绿色 `+x.xx¥` 充值脉冲，以及峰/谷红绿灯标识
拖动位置会写入浏览器 localStorage 记忆单次用量明细行与会话累计
每次模型调用的 token 用量→在对话流内插入 token 明细行（输入/缓存命中/输出/思考 reasoning），并在输入框上方显示会话累计条
峰谷精确计费
每次调用的实际模型名与 token 数量→按内置 DeepSeek 2026-08-23 价格表计算精确金额，工作日按北京时间峰谷时段、周末统一谷价，缓存命中/未命中分别计价
可选：原生左侧会话行金额（源码增强）
完整 DSH 源码 + 运行侧边栏集成脚本→在原生左侧会话行尾部显示会话累计金额
脚本先备份三个目标文件，再以幂等方式写入 `projectionValues.tokenCost.cost`；上游结构不匹配时停止，不猜测写入仅完整 DSH 源码适用；标准包不会修改宿主 DOM
04适合谁？何时不该用？
适合
- 希望以游戏化、实时方式掌握 token 消耗与 DeepSeek 账户余额的 DSH 用户
- 按模型与北京时间的计费时段追踪开销、对成本敏感的用户
不适合
- 从早期源码集成版升级时，需先移除原有手工 `--patch` 或重复挂载项，否则同一插件可能被加载两次导致异常。
05兼容性、维护与安全提示
- 标准包不修改宿主 DOM，也无法向左侧会话列表注入金额——DSH 当前没有该区域的第三方 slot；左侧原生会话行金额需完整 DSH 源码加侧边栏脚本。
- 从早期源码集成版升级时，需先移除原有手工 `--patch` 或重复挂载项，否则同一插件可能被加载两次导致异常。
MIT · 活跃维护中（最新发布 v0.3.1，2026-08-23）
06常见问题
怎么在 DeepSeek Harness 上安装 dsh-damage-pulse？
运行 `dsh plugin --profile web add github:wssfk12138/dsh-damage-pulse`，再用 `dsh --profile web` 重启 Web profile。它作为预编译的标准 Host + Client 组合包发布，无需复制源码、改 tsconfig 或手动 `--patch`。
需要 DeepSeek API key 才能用吗？
不配置也能做 token 计量，但实时余额卡片只有设置了 `DEEPSEEK_API_KEY`（经 DSH credentials：`~/.dsh/.credentials.yaml`）才会显示真实数字；未配置时卡片显示引导态，计数不受影响。
为什么左侧会话列表不显示每会话金额？
原生左侧会话行金额属于源码增强功能，不在标准包内——DSH 当前没有该区域的第三方 slot。输入框上方的会话累计在标准包内可用；要放到左侧列表需要完整 DSH 源码并运行侧边栏集成脚本。
费用怎么算，和 DeepSeek 官方定价一致吗？
使用内置的 DeepSeek 价格表（日期 2026-08-23）：工作日按北京时间峰谷时段、周末统一谷价，按调用实际模型名做最长前缀匹配，缓存命中/未命中分别计价。可通过 `dsh-token-monitor` 设置的 `priceTable` 字段覆盖。
从旧版源码集成升级后没有动画，怎么办？
先删掉原来的手工 `--patch` 或重复挂载项；同一插件加载两次会出问题。并确认已重启目标 profile。标准包不需要 patch，也不会注入宿主 DOM。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件：Claude Code 风，鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
dsh-popout-sidebar
作者 e2mcc
将侧边栏弹出为独立浏览器标签页，可拖到另一块屏幕使用
08数据与来源
本仓库从 `0.2.0` 起是标准 DSH Host + Client 组合包，已提交预编译产物。
Host 插件 | `plugins/dsh-token-monitor` | 监听 `session/event`，精确计费（token × 单价），注册 `tokenCost` session projection、余额轮询服务、HTT…
Client 包 | `packages/client/ui-token-monitor` | Web GUI 组件：余额悬浮窗（BalanceWidget）、单次用量行、会话累计条，读投影与 HTTP 端点渲染
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-25。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。