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

快速上手

dsh-usage-dashboard

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @cassius0924/dsh-usage-dashboard

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

— 源: plugins.install

关键要点

• 余额 + 今日消耗，一眼就够。
• 可拖动，松手自动吸附四角；边界避开侧边栏、右侧详情面板、会话顶栏和输入框——不会挡住发送按钮。
• 可收起成一行；显示/隐藏、所在角落、收起状态都会记住，刷新页面后原样回来。
• 余额跌破预警线时，状态点和余额数字一起转成警示色。
• 60 秒自动刷新余额。今日消耗读共享缓存，点 ↻ 同时刷新两者。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后看不到「额度」标签怎么办？

该 tab 挂在单个会话顶栏上，请先进入任意一个已有会话（非 New Session 首页）刷新页面就能看到 Chat / Trajectory / 额度 三标签；右键首屏没有 tab 栏的入口。余额窗口则常驻在右下角，不必开会话也会出现（README.md:130 / src/client/index.tsx:50-90）。

余额不准或显示「未配置 DEEPSEEK_API_KEY」怎么办？

本插件复用模型设置里那把 DeepSeek API Key，余额走官方 /user/balance 端点。请在 DSH 「设置 → 模型」里把 Key 填好，或放在 $DSH_HOME/.credentials.yaml 里的 DEEPSEEK_API_KEY，重启 dsh 后生效（README.md:127 / src/usage.ts:20-63）。

显示的「费用」是按什么算的、为什么和官方账单不一致？

是估算。规则全部集中在 src/pricing.ts：按「模型 + 时间是否落在高峰窗口」逐条计费；2026-08-17 之前的用量按旧固定价，之后按北京时区 09:00-12:00、14:00-18:00 为高峰、其余为闲时（闲时为高峰的一半）。未识别的模型按 deepseek-v4-pro 较贵一侧估算。不含平台折扣、赠金消耗顺序，以 DeepSeek 官方账单为准（README.md:134-149 / src/pricing.ts:1-110）。

首次打开仪表盘要等很久？

因为「用量」是重放本机全部 DSH 会话日志聚合出来的，本机实测约 5 秒。因此服务端把这次结果记忆化 5 分钟、客户端也在加载时即发起预取；空数据时界面显示骨架占位而非空文案。若想立刻看到最新数字，点右上↻按钮即可（README.md:195 / src/index.ts:30-31 / src/client/index.tsx:46-48）。

这里是本机数据，那其他设备/多账号会一起算进来吗？

不会。覆盖度卡里明确写出数据范围是「当前设备上的 DSH 会话日志」，不含其他设备、DeepSeek 平台直调或已被删除的本地日志。翻页前会显示：扫描了多少会话、跳过多少条损坏记录、最早/最近一次记录的覆盖时间（README.md:193 / src/contract.ts:161-176 / src/client/locales.ts:65-66）。

余额预警线怎么调？

在「额度」tab 末卡「设置」里改，默认 ¥10，填 0 即关闭。跌破时同时在仪表盘顶部和悬浮窗状态点出现警示，连「按近期用量还能撑 X 天」也会算给用户看（README.md:100-105 / src/client/store.ts:39-52 / src/client/dashboard.tsx:1097-1100）。

卸载要注意什么？

dsh plugin --profile web remove @cassius0924/dsh-usage-dashboard 之后重启 dsh web 即可。插件不写自己的文件、不引后台进程；唯一的痕迹是浏览器 localStorage 里前缀为 dsh-usage-dashboard:pref: 的一组偏好键与 dsh-usage-dashboard:balance / :usage 两份缓存，清缓存或下次安装同位置会再见到。

改了内置价格表能跟上 DeepSeek 调价吗？

DeepSeek 再调价时，只改 src/pricing.ts 一张表即可（pro / flash 两档 × 缓存命中 / 未命中 / 输出三栏）。本插件没有「一键同步官方定价」功能，若想跟官方账单对齐，请在更新时同步修改该文件后重 build（src/pricing.ts:13-14）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=20
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则