前言¶
如果你在用 DeepSeek Harness（DSH）的 Web UI 管理会话，常会想查看本机 DSH 会话记录里的 tokens 用量、会话数量、消息数量、活跃情况、最常用模型，以及每日 token 消耗趋势。下面介绍一个 DSH Web UI 插件：dsh-usage-lens。它安装后会在设置面板新增「用量统计」页面，用于直观展示这些本地使用数据。
这是什么¶
dsh-usage-lens 是 yokesky 维护的 DeepSeek Harness（DSH）Web UI 用量统计面板。
它对应的 npm 包名是 @yokesky/dsh-usage-lens，仓库地址是：
https://github.com/yokesky/dsh-usage-lens
资料中给出的许可证为：
MIT © 2026 yokesky
本次资料未给出星标数、目录页 URL 或完整 dsh client 配置，本文不展开这些内容。
核心功能¶
安装后，DSH 设置面板会新增「用量统计」页面。已核实的功能包括：
- 总览卡片：
tokens用量、会话数量、消息数量、活跃天数、当前连续天数、最常用模型。 - 活跃热力图：GitHub 风格的 280 天活跃热力图。
- 每日 Token 趋势：按天查看
token消耗，可切换「模型 / 厂商」视角。 - 模型用量双环饼图：支持「汇总 / 厂商 / 模型」三种查看方式。
- 面板自动跟随 DSH 的亮色 / 暗色主题。
安装与启用¶
方式一：通过 npm 包安装¶
先安装或确认已有 dsh CLI，然后执行插件安装命令。
1、安装 dsh CLI。如果已经安装，可跳过这一步：
npm install -g @deepseek-ai/dsh # 先安装 dsh CLI，然后才能执行 dsh 命令
2、给 Web 插件 profile 添加 dsh-usage-lens：
dsh plugin --profile web add @yokesky/dsh-usage-lens
3、重启 web 服务，打开设置面板即可看到「用量统计」。
方式二：通过源码安装¶
源码方式适合需要本地修改代码、重新构建后再启用的场景。资料中给出的 engines 声明为：
node >=24
请先确认本机 Node.js 版本满足要求。
1、克隆仓库并进入目录：
git clone https://github.com/yokesky/dsh-usage-lens.git
cd dsh-usage-lens
2、安装依赖并构建：
pnpm install
pnpm build
3、用 link: 方式指向本地源码安装：
dsh plugin --profile web add link:<本仓库绝对路径>
这里的 link: 方式指向本地源码。修改代码后，重新执行 pnpm build 并重启 web 服务即可生效，无需重新安装。
典型用法¶
安装完成后，先重启 web 服务，再打开 DSH 设置面板，进入「用量统计」。
下面是一些常见查看路径：
- 查看总览卡片，确认
tokens用量、会话数量、消息数量、活跃天数、当前连续天数和最常用模型。 - 打开每日 Token 趋势，按天查看
token消耗，并切换「模型 / 厂商」视角。 - 打开模型用量双环饼图，切换「汇总 / 厂商 / 模型」三种查看方式。
- 如果使用源码方式安装，修改代码后执行
pnpm build，再重启 web 服务。
适用场景与注意¶
适合以下开发者：
- 已经使用 DSH Web UI。
- 希望查看本机 DSH 会话记录中的
tokens、会话数量、消息数量和活跃情况。 - 想按天查看 token 消耗趋势。
- 想查看模型或厂商层面的用量分布。
- 想通过本地源码方式修改插件展示逻辑。
使用时注意：
- 所有数据来自你本机的 DSH 会话记录，只在本地处理，不会上传到任何地方。
- 面板自动跟随 DSH 的亮色 / 暗色主题。
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不要把它理解成官方应用商店。
链接¶
- GitHub 仓库：
https://github.com/yokesky/dsh-usage-lens
- 社区目录：本次资料未给出可核实的目录页 URL，因此这里不附目录页链接。
