dsh-session-dashboard

会话统计 · DSH Session Dashboard

DSH Session Dashboard 是 DeepSeek Harness Web GUI 的会话统计插件。它在本机读取

DSH 会话日志，提供 Token 用量、费用估算、每日趋势、Token 构成、会话排行和宿主

运行状态，并从左侧栏的「会话统计」进入。

界面使用 DSH 的主题变量，支持浅色、深色和窄屏布局。切换统计范围时，页面保留

现有结构，各区域显示与真实内容尺寸一致的加载占位，避免整页闪烁和布局跳动。

界面预览

预览使用仓库内的合成测试数据，不含真实会话内容。

| 浅色 · 1440 | 深色 · 1440 |

| --- | --- |

| | |

| 平板 · 1024 | 手机 · 390（无横向滚动） |

| --- | --- |

| | |

切换范围时的加载占位：

功能

| 区域 | 内容 |

| --- | --- |

| 左侧栏入口 | sidebar.panellist 的 session-stats 入口，同时对应 main 面板 key |

| 全局范围 | 全部时间（默认）、今日、近 7 天、近 14 天、近 30 天 |

| 今日口径 | 按用户浏览器所在时区的自然日统计当天 0 点到现在，对比上一日 |

| 概览指标 | 总 Token、估算花费、平均每会话、缓存命中率；选择范围时显示与上一周期的变化（无上期数据时以所选窗口起始日期为基线），全部时间显示历史起始日期等基线信息 |

| 每日消耗 | 按 Token 类型堆叠的柱状图；虚线表示上一周期，图表底部显示日均值 |

| Token 构成 | 环形图，中心显示占比最高的类别；图例列出各项精确值与占比 |

| 会话排行 | 按 Token 或活跃时长排序；每行底部显示占比条，列出 Token、占比、花费、活跃时长和总时长，两张时长列悬停可看首末活动时间 |

| 运行状态 | CPU 单核/整机占用、RSS、事件循环 p99、运行时长、PID、Node 版本和最近 5 分钟 CPU 曲线 |

| 刷新机制 | 页面打开时每 5 秒刷新；页面隐藏时暂停，恢复可见后立即刷新；失败后逐步退避；支持手动刷新 |

| 加载状态 | 切换范围时保留页面布局，各区域显示与真实内容尺寸一致的占位；图表不重播入场动画 |

环境要求

• DeepSeek Harness 0.2.1-rc.5 或兼容版本。
• Node.js >= 22.15（CI 覆盖 Node 22 和 24）。
• 本机存在 DSH 会话目录，默认位于 ~/.dsh/sessions。
• 仓库内包含预构建的 client.js，插件管理器安装时需要该文件。

安装

从 npm 安装

plugin_manager install_bundle -> dsh-session-dashboard

DSH 会从已配置的 npm registry 解析最新版本。以 registry 包安装后，插件管理页会在

有新版本时显示「可更新」，并可直接更新到最新版本。

从源码或本地 checkout 安装（开发）

git clone https://github.com/starriv/dsh-session-dashboard.git
cd dsh-session-dashboard
npm ci
npm run build

然后在插件管理器中执行 install_bundle，目标选择该仓库的绝对路径。安装完成后，

左侧栏会出现「会话统计」入口；首次打开或插件更新后刷新一次 Web GUI。

Host 侧代码（index.js、host/）修改后需要重启 DSH 宿主。Client 侧由插件管理器

加载 client.js。本地 link: 或路径安装属于开发方式，DSH 不会为其提供 registry

更新徽标；需要自动更新能力时请使用 npm 安装。

npm test 会先通过 pretest 重新生成 client.js。提交源码变更时请一并提交构建

产物；CI 会校验构建结果是否与仓库中的文件一致。

配置

cordis.patch.yml 中的 row config 均可选：

| 键 | 默认值 | 说明 |

| --- | --- | --- |

| scope | all | Host 侧默认统计范围；页面打开时仍从「全部时间」启动，以选择器为准 |

| trendDays | 30 | 全部时间模式下趋势图显示的天数，范围 1–90 |

| timeZone | Asia/Shanghai | 峰谷计价窗口使用的 IANA 时区；也是浏览器未上报时区或上报非法时区时的日历日兜底 |

| refreshMs | 1500 | 同一份快照的最小重新扫描间隔 |

| backgroundScanMs | 60000 | 后台增量扫描间隔 |