前言¶
在 DSH 中接入 DeepSeek 会话后，常见需求是看清当日到底消耗了多少 Token、按峰谷计价大约花了多少钱、当前是否处于谷时段。dsh-monitor 是 DSH 原生插件，直接在 DSH 内部事件流上累计数据，不需要浏览器扩展，也不经过页面网络层。
DSH 生态强调「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系。本文只介绍已核实资料中的能力与接入步骤。
这是什么¶
dsh-monitor 是一个 DSH 原生插件，定位是「实时 API 用量监控与峰谷价格提示悬浮窗」。
插件仓库路径为 iambbp/dsh-monitor，许可证为 MIT。
它解决的核心问题是：在 DSH 会话界面里直接显示当日真实 Token 消耗、按 DeepSeek 官方峰谷定价计算的费用、峰谷状态、交互次数、平均消耗和配额进度，并提供数据 API 与持久化记录。
核心功能¶
下面按能力列：
- 实时累计当日全部会话的真实 Token 消耗，包括输入、缓存命中和输出。
- 按 DeepSeek 官方峰谷定价计算今日费用，谷时段自动半价。
- 按
turn/start事件统计今日交互次数。 - 显示今日平均每次交互的 Token 数。
- 显示峰谷状态圈和实时北京时间。
- 显示今日费用与配额上限的进度条。
- 显示峰谷图例和官方时段说明。
- 一键复制今日用量文字报告到剪贴板。
- 支持立即刷新，默认每 2 秒自动轮询。
- 悬浮窗可拖拽、折叠成小药丸或隐藏。
- 数据持久化到
~/.dsh/dsh-monitor.json，历史保留 90 天。 - 提供
GET /api/dsh-monitor数据 API。
这些功能都围绕「当日累计」展开：Token、费用、交互次数和平均消耗都针对当前统计日，历史数据保留 90 天。
安装与启用¶
已核实资料中没有找到单一官方安装命令原文。以下按资料给出的多步骤手动配置说明接入方式。先准备好插件源码，并把它放到 profile 目录下，例如 ~/.dsh/profiles/web/dsh-monitor。
1、在 ~/.dsh/profiles/web/package.json 的依赖中添加插件引用：
{
"dependencies": {
"dsh-monitor": "file:./dsh-monitor"
}
}
这一步的作用是让 profile 通过 file: 链接加载本地插件目录。
2、在 ~/.dsh/profiles/web/cordis.patch.yml 追加加载项：
- insert:
- id: dsh-monitor
name: 'dsh-monitor'
config:
quotaLimit: 10
其中 quotaLimit 用于设置今日配额上限，默认值为 10 元。
注意：bundles 数组只放 bundle 组装包，不要把单个插件加进 bundles，否则 DSH 启动会卡住。
3、在 profile 目录安装依赖，同步本地插件链接：
cd ~/.dsh/profiles/web
corepack pnpm install
4、重启 DSH，例如执行：
dsh web
5、验证是否启用。启动 DSH 后打开：
http://127.0.0.1:3080/
按 F5 刷新页面，右上角出现悬浮窗即表示页面侧已加载；也可以访问：
http://127.0.0.1:3080/api/dsh-monitor
该接口应返回 JSON 数据。
如果后续修改了 lib/index.js，必须重新执行：
corepack pnpm install
然后重启 DSH，使链接和启动逻辑同步。
典型用法¶
下面介绍安装后的常见操作。
1、启动 DSH 后按 F5 刷新页面，右上角出现悬浮窗。
2、按住面板标题栏拖动到任意位置。
3、点标题栏右侧的 –，将悬浮窗折叠成小药丸。
4、点关闭按钮隐藏悬浮窗，状态会记忆在 localStorage。
5、点「复制报告」，把今日用量文字报告写入剪贴板。
6、点「刷新」，立即重新拉取数据；平时默认每 2 秒自动轮询。
复制报告适合在需要向他人说明今日消耗时直接粘贴；悬浮窗的折叠和隐藏适合长时间使用时避免遮挡页面。
数据与 API¶
插件数据来自 DSH 内部事件系统，不需要浏览器扩展，也不经过页面网络层。
前端悬浮窗通过 GET /api/dsh-monitor 获取数据，该接口也可供其他工具调用。
持久化文件为：
~/.dsh/dsh-monitor.json
历史数据保留 90 天，超出部分自动裁剪。
适用场景与注意¶
适合以下使用者：
- 在 DSH 中使用 DeepSeek 会话，需要查看当日 Token 和费用的人。
- 希望按峰谷时段判断当前计费状态的人。
- 需要把当日用量报告复制到剪贴板的人。
- 需要调用
GET /api/dsh-monitor获取 JSON 数据的开发者。
安装前注意：
- 插件以当前
dsh进程权限运行，应检查源码与许可证。 - 许可证为 MIT。
- 已核实资料未提供单一官方安装命令，本文只列出多步骤手动配置。
bundles只放 bundle 组装包，不放单个插件。- 修改
lib/index.js后要执行corepack pnpm install并重启 DSH。
结尾¶
dsh-monitor 的价值是把 DeepSeek 会话的当日 Token、峰谷费用和交互次数放到 DSH 页面内直接查看，并通过持久化文件和 JSON API 提供后续使用入口。
相关链接：
- GitHub: https://github.com/iambbp/dsh-monitor
- 目录页: https://www.skillhub.cn/plugins/iambbp/dsh-monitor
