Passer au contenu principal
O

dsh-session-stats-panel

oblivionis7999/dsh-session-stats-panel

Le panneau « 肥魚用量分析 » dans la barre latérale gauche de DSH Web estime les tokens et les coûts. Il affiche un calendrier d’activité, les classements des outils, des commandes et des skills, une liste par session et des mesures en temps réel de l’état de DSH. Aucune dépendance tierce et tous les graphiques sont en SVG intégré.

Installer

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 associés