Pular para o conteúdo principal
O

dsh-session-stats-panel

oblivionis7999/dsh-session-stats-panel

O painel «肥魚用量分析» na barra lateral esquerda do DSH Web estima tokens e custos e mostra um calendário de atividade, rankings de ferramentas, comandos e skills, sessões e amostras do estado do DSH em tempo real. Sem dependências de terceiros, com gráficos em SVG inline.

Instalar

dsh plugin --profile web add github:oblivionis7999/dsh-session-stats-panel

README

简体中文 | English

肥鱼用量分析

肥鱼用量分析

DeepSeek Harness 左侧栏的用量统计页面。
看 token 和钱花在哪、今天比昨天多还是少,还有 DSH 自己吃多少 CPU 和内存。

零第三方依赖 · 图表全是手写 SVG · 只读本机会话日志,不上传

Version DSH License Stars Issues Node

这是什么 • 效果 • 核心特性 • 安装 • 配置 • 页面速览 • 数据与隐私 • 开发与自检 • 常见问题

这是什么

一个 DSH 插件。装上之后左侧栏会多一个「肥鱼用量分析」页面,点开就是本机会话的用量统计。名字来自社区对 DeepSeek 的叫法:小鲸鱼,也叫蓝色大肥鱼。

页面上能看到这些:

  • 一共用了多少 token、大概花了多少钱、缓存命中率多少(复用了多少之前读过的内容)
  • 每个模型占多少,每天用了多少
  • 今天比昨天多还是少,月底大概会花多少
  • 最近 8 周哪几天忙,哪些工具和命令用得最多
  • 每个会话花了多少、最后在问什么

数据全部从本机的会话日志算出来。宿主那边只开几个只读接口,浏览器那边只负责画图。图都是手写的 SVG,没有图表库,包也没有第三方依赖。

它不上传数据,不改会话日志,也不联网。价格是打包在里面的官方价目表快照。

3.0 去掉了 2.x 的 K 线模式,面板只剩统计这一个视图,接口也精简了。

效果

浅色主题下的肥鱼用量分析页面 深色主题下的肥鱼用量分析页面
浅色主题,近 7 天 · 示例数据(已脱敏) 深色主题,跟着宿主走 · 示例数据(已脱敏)

肥鱼用量分析整页

整页:分模型明细、热力日历、三个排行和会话列表 · 示例数据(已脱敏)

核心特性

特性说明
四个指标卡总 token、预估成本、会话数、缓存命中率。时间档和币种在右上角切,切币种不发新请求
今日概览今天和昨天比:涨了 ▲、跌了 ▼、昨天没数据就是 —。今天还没用过,四个都是 —,不报错
每日消耗一天一根柱子,按模型分颜色。柱子的总和跟指标卡的总数对得上
Token 与成本环图两个圈:一个看 token 怎么分的(未缓存输入、输出、缓存读、缓存写),一个看钱花在哪个模型上。颜色和下面的明细表对得上
成本预测拿最近 30 天的日成本算一条直线,虚线画到月底,标个大概值。有效天数不够 7 天就不画
活跃度热力日历最近 8 周,一天一格,颜色越深用量越大。能在 token 和会话数之间切,鼠标停上去看那天的数字。没活动的日子是浅色,不是空着
工具 / 命令 / 技能排行三个榜,按调用次数从多到少排。命令看的是 shell 里跑的第一个词,像 cd、git;工具那栏还带成功率和平均耗时。名字太长会截断,鼠标停上去看全名
分会话列表一个会话一张卡:标题、轮数、步数、token、成本、最后一句提示词。能按标题和提示词搜,能按最近、token、成本排。子会话默认藏起来,可以打开
分块加载打开先出指标卡,热力、排行、会话列表后到。切时间档时旧数据不消失,顶上一条进度条
运行状态采样DSH 自己的 CPU、内存、卡不卡(事件循环延迟)、运行了多久。每 5 秒采一次,下面是最近 5 分钟的 CPU 曲线
主题跟随颜色跟着 DSH 的深浅主题走,不另配一套色板
原厂价目只按各家官网的价目算。查不到官方价的模型标「未计价」,不猜

本机实测(约 170 个会话、约 375 MB 日志):冷启动全量扫描约 2.4 秒,这一步在 DSH 启动 2 秒后由后台预热跑掉,所以第一次打开面板不用等;overview 响应约 17 kB(15–18 kB 之间浮动),heavy 约 48 kB,heavy 复用同一轮扫描、只多花 3 ms。3.0 之前一次响应 62.8 kB,其中 72% 是已经删掉的 K 线数据。

安装

装的是 DSH 插件,不是独立软件。dsh plugin add 会把依赖写进 profile,把包里的 cordis.patch.yml 叠进 bundle 层,不用手改配置。

# 方式一:从 npm 装(推荐)
dsh plugin --profile web add dsh-session-stats-panel

# 方式二:直接从 GitHub 装
dsh plugin --profile web add "git+https://github.com/Oblivionis7999/dsh-session-stats-panel.git"

# 方式三:本地开发,link 进 profile,不复制文件
dsh plugin --profile web add "link:E:\path\to\dsh-session-stats-panel"

# 卸载
dsh plugin --profile web remove dsh-session-stats-panel

npm 上已经有 3.1.x,可以直接装;想跟最新提交,用方式二。

装完按这个顺序走:

  1. 先把正在跑的 DSH 停掉。跑着的时候依赖会被锁住,装完再起
  2. 用上面任意一条命令安装
  3. 重启 DSH。bundle 列表变了不会热重载
  4. 浏览器 Ctrl+Shift+R 强刷一次。客户端产物是打开页面的时候才取的
  5. 左侧栏的面板列表里会多一个 肥鱼用量分析(在「插件」「自动化任务」上面),点进去就是

插件不占新端口,也不写你的数据。宿主那边只在本地 web 服务上挂几个只读路由。

兼容性

插件版本状态DSH
3.1.x(当前)✅ 主线:热力日历、三个排行、会话列表、今日概览、成本预测、分块加载、工具成功率>= 0.2.1-rc.5
2.x🗄 归档>= 0.2.1-rc.5

配置

所有项都有默认值,不写也能跑。要改就写进 cordis.patch.yml 的 config:

- insert:
    - id: session-stats-panel
      name: dsh-session-stats-panel
      config:
        window: 7d                # 默认时间档:24h | 7d | 14d | 30d
        usdRate: 7.1              # 美元的显示汇率,人民币才是准的
        timeZone: Asia/Shanghai   # 按哪个时区切天和小时(决定「昨天」从几点算)
        ttlMs: 60000              # overview 缓存多久(毫秒),0 表示每次重算
        # 用手机或另一台电脑通过局域网 IP 打开时才要开;
        # 公网域名一直拒,免得网页用 DNS rebinding 把本地日志读走
        allowPrivateHosts: false
键默认说明
window"7d"打开时的默认时间档:24h / 7d / 14d / 30d
usdRate7.1人民币换美元的显示汇率,只影响美元显示
timeZone"Asia/Shanghai"按哪个时区切天和小时,不在中国就改成自己的区
ttlMs60000overview 响应缓存;0 表示每次请求都重算(会话级增量缓存还生效)
sessionConcurrency3一次扫描同时读几个会话(1–16)
readTimeoutMs10000单个会话读多久算超时,超时就跳过它、记条日志
liveIntervalMs5000/live 多久采一次 CPU(1000–60000)
livePoints60CPU 曲线留多少个点(6–600),默认 5 秒 × 60 = 5 分钟
allowedHosts[]额外放行的 Host,反代域名写这里
allowPrivateHostsfalse放行私有网段、*.local、单标签主机名
holidays内置 2026 表按谷价算的北京日期,传 [] 是显式清空
makeupWorkdays内置 2026 表调休上班的周末,按工作日算峰价
debugfalse打开后打扫描明细日志

loader id 不要改,固定是 session-stats-panel。 官方的 @deepseek-ai/dsh-session-stats 用的是 session-stats,加载器按 id 建表、后加载的覆盖先加载的。撞了 id,官方的 sessionStats 投影就静默不挂载,界面上看不出来,只是流式输出的计时数据没了。

价格怎么算、峰谷怎么判,写在 docs/PRICING.md。接口和字段在 docs/API.md。

页面速览

区域内容
顶栏时间档(24h / 7d / 14d / 30d)和币种(人民币 / 美元)
指标卡总 token、预估成本、会话数、缓存命中率,每张下面一行副信息
今日概览今天的四个数跟昨天比,带 ▲ / ▼ / —
运行状态CPU(进程、整机、核数)、内存、卡不卡(事件循环延迟)、运行了多久、PID 和 Node 版本,底部一条 5 分钟 CPU 曲线
每日消耗按模型分色的日堆叠柱;开了预测会多一条虚到月底的线
构成环图token 四桶的构成,加上按模型的成本占比,中间是总量和金额
分模型明细色块、模型名(带 provider)、占比条、token、占比、成本,按 token 从多到少排
热力日历最近 8 周的活跃度,token 和会话数两种模式
排行工具、命令、技能各取前十,条形长度按最高值缩放
会话列表最多 50 张会话卡,能搜索、能排序,子会话默认藏起来

窄屏:桌面端三张图表卡并排,<1100px 变两列,<720px 变一列。卡片和热力、排行、列表都不横向溢出。

数据与隐私

  • 只读。只调 ctx.sessionQuery.listSessions() 和 readSession()。事件上只读 usage、tool/call、turn/start、step/start、user/message、session/title 这些,不写回任何东西。日志坏了、读超时、时间戳不对,就跳过那个会话,不影响别的。
  • 不上传,不联网。没有遥测,没有远程请求。价目表是打包进去的快照,不会自己去拉。
  • 只对本机开放。默认只认 127.0.0.1 / localhost / [::1],别的 Host 一律 403,响应里会直接告诉你该开哪个开关。每条响应都带 Cache-Control: no-store。
  • 增量读。每个会话有一个表示「有没有改动过」的标记(revision),由持久化后端(persistence)提供;只有变了的会话才重新读,没变的直接用内存里的结果。没有 persistence 后端时退化成每个会话按 ttlMs 过期。内存里只留最近 31 天、每小时一格的数据。
  • fork 去重。从已有会话复制出来的会话(isSeeded),开头那段事件是父会话的复制品,readSession() 的 inheritedEventCount 就是这段有多长。算之前会切掉,只算这个会话自己新增的部分。这段在本机约占 token 总量的 7.8%,旧版是重复算的,3.0 起改过来了。
  • 金额是估的。按各家官网的价目一条条算。DeepSeek 分峰谷,别的厂商是平铺价。美元价目按 usdRate 折成人民币展示。查不到官方价的模型标「未计价」,成本记 0,不猜。
  • 官方搜索按次算。每次联网搜索是一笔独立请求,¥0.005 一次,单独加在成本卡副行。搜索自己那次调用的 token 日志里没有 usage,本地还原不出来。

开发与自检

零依赖。npm install 只在要装宿主对等依赖时才需要。自检不联网、不起 DSH、不写用户数据。

# 语法检查
node --check index.js
node --check lib\index.js
node --check lib\pricing.js
node --check lib\aggregate.js
node --check client.js

# 三套自检:核心 / 宿主 / 客户端
node tools\selfcheck.mjs
node tools\selfcheck-host.mjs
node tools\selfcheck-client.mjs

# 或者一次跑完
npm run selfcheck
  • tools/selfcheck.mjs:拿假事件算 token、成本、命中率、每天的量、模型占比,还有热力、排行、会话列表这几张新卡要的数据
  • tools/selfcheck-host.mjs:拿假 ctx 跑 apply(),直接调接口处理函数(不监听端口),检查返回结构、请求来源(Host)和请求方法的限制、缓存、预热定时器
  • tools/selfcheck-client.mjs:拿假的 window / document / React 渲染一遍,检查文案、数字、热力格数、排行宽度、搜索和排序、空状态

改完怎么生效:

改了什么怎么生效
lib/*.js(宿主)重启 DSH,再强刷浏览器
client.js、locale/*.json(浏览器)刷新页面就行,客户端插件会自动热更新(HMR)
cordis.patch.yml(配置 / 挂载)重启 DSH

目录结构

dsh-session-stats-panel/
├─ package.json          # name / type: module / main: lib/index.js / dsh.bundle.patch / dsh.client
├─ cordis.patch.yml       # bundle patch:insert 本插件行(含可选 config)
├─ icon.svg               # 插件管理器 / 市场图标
├─ locale/{zh,en}.json    # 包元信息文案(插件列表用)
├─ index.js               # 宿主半的别名入口(re-export lib/index.js)
├─ lib/
│  ├─ index.js            # 宿主半:路由、增量扫描缓存、/live 采样(package main)
│  ├─ pricing.js          # 纯函数:价目表、峰谷判断、costOfUsage、美元换算
│  └─ aggregate.js        # 纯函数:事件 → 小时桶 → 窗口汇总 / 日桶 / 模型桶 / 热力 / 排行 / 会话列表
├─ client.js              # 浏览器半:__ModuleLoader__ 包装,React + 内联 SVG
├─ docs/
│  ├─ API.md              # 接口和响应字段
│  ├─ PRICING.md          # 价目快照、峰谷规则、未计价清单
│  └─ screenshots/        # README 用的截图
├─ tools/
│  ├─ selfcheck.mjs       # 核心自检
│  ├─ selfcheck-host.mjs  # 宿主路由自检
│  └─ selfcheck-client.mjs# 客户端渲染自检
├─ README.md / README_en.md
└─ LICENSE

更新日志

版本主要改动
3.1.2修全仓审计的 4 条问题:非法 window 不再返回空数据(如 ?window=__proto__ 回落到默认档);读不出来的会话会在面板上提示「N 个活跃会话暂未计入」,不再静默少算;模型超过 10 个时「其他」桶不再把搜索费重复计一次;QA 脚本落盘前对 token 打码。价目刷新到 vendor-official-2026-11-16:补上 GPT-6 Astra,以及 Claude Fable 5.2 / Mythos 5.x / Opus 5 / Opus 4.5–4.8 / Sonnet 5 / Haiku 4.5;Claude 的兜底匹配按代号收窄,避免 Opus 5 被算成 5.5 的价
3.1.1打包修复:tools/fixtures/events-sample.json 进包,从 npm 安装后自检不再缺 fixture
3.1.0删掉 K 线数据层;新增热力日历、工具/命令/技能三榜、会话列表、今日概览、成本预测、分块加载;重做品牌与图标

热更新(改代码不重启)

DSH 自带两层热更新。这个插件零构建——client.js 本身就是产物——所以界面那一半特别好换。2026-11-16 在 Windows + link: 安装上实测,结果是分开的:

改什么生效方式实测
client.js、locale/*.json存盘后自动推给已打开的页面,不用刷新,更不用重启✅ 宿主每 500 ms 比对一次产物,变了就通过 /plugins/events 推一帧 rebuilt,页面半秒内换新模块(组件内状态会重置,会话和连接不受影响)
lib/*.js默认要重启 DSH❌ 触发对账后宿主仍跑旧模块。即使改 profile patch 强制重新组合(请求会阻塞约 8 秒,说明对账确实发生了),插件被重启,但 lib/ 的代码没被替换,接口里仍是旧值

几个实测出来的、文档里没写死的点:

  • 监听的是进程启动时解析出的真实路径。用 link: 安装、之后又改过链接指向(比如从 junction 换成独立目录),正在跑的进程还盯着旧路径,重启一次才会跟到新目录。
  • 只想改界面时这套已经够用:改 client.js → 存盘 → 打开的面板自己变,不用管后端。
  • 热替换失败不回滚:起不来的版本会让插件下线,重启即恢复。所以宿主代码先在本地跑一遍 node tools/selfcheck.mjs && node tools/selfcheck-host.mjs && node tools/selfcheck-client.mjs。
  • 官方文档还支持给 hmr 条目配 root: ["<绝对路径>"] 来监听源码模块(本仓库没验证过,也不建议指到正在开发的目录,免得没测就生效)。

常见问题

打开面板时指标卡先出来,热力和排行要等一下? 对,这是分块加载。指标和图表走 /overview,先渲染;热力、排行、会话列表走 /heavy,另一个请求。切时间档时旧数据不会消失,顶上会出现一条 2px 的进度条。

改了代码没反应? 界面侧(client.js、locale/*.json)存盘就生效,不用刷新;宿主侧(lib/*.js)要重启。实测细节和原因见上面的热更新。

CPU 怎么显示 120%? 这个数按「进程花掉的 CPU 时间 ÷ 实际过了多久」算。V8 的后台编译、垃圾回收、读文件解压这些会在别的线程上跑,所以一个进程能超过 100%。120.8% 就是 1.21 个核。旁边的整机占比才是这台机器用了多少。

为什么有的模型显示「未计价」? 只认各家官网的按量价目。查不到的(下线的版本、没有公开价的模型)不估,成本记 0,明细里写「未计价」,表底会告诉你几个模型没算进去。

面板的钱和账单对不上? 两个原因。一是只算日志里带 usage 的 assistant/message,没 usage 的调用不估。二是联网搜索按次数算钱,搜索自己那次调用的 token 日志里没有。面板是估的,不是账单。

手机或者别的电脑打不开? 默认只认本机。局域网访问把 allowPrivateHosts 打开;反代域名写进 allowedHosts。公网域名一直拒。

「近 7 天」的日界不是我这边的时间? timeZone 默认 Asia/Shanghai,改成自己的区。DeepSeek 的峰谷时段是官方按北京时间定的,不跟这个走。

会和官方的 @deepseek-ai/dsh-session-stats 打架吗? 不会。这个插件的 loader id 是 session-stats-panel,官方是 session-stats,两个能一起挂。

致谢

用着顺手点个 Star ⭐。有问题去 Issues 提,每个版本的改动在 Releases。

许可证

MIT © 2026 织风裁月 (Oblivionis7999)。价目表是各厂商官网价格的快照,只用来本地估算,不是账单。

Plugins relacionados