dsh-session-stats-viewer

📊 DSH Session Stats Viewer

[English](https://github.com/Bright9025/dsh-session-stats-viewer/blob/main/README.en.md) | [简体中文](https://github.com/Bright9025/dsh-session-stats-viewer/blob/main/README.md)

为 DeepSeek Harness（DSH） 的 Web 侧边栏增加一个「会话统计」页：汇总全部会话的 Token 消耗、预估成本、缓存命中、每日用量、会话排行、对话性能与 DSH 运行时状态。

> DSH 插件 · 只读统计 · 无额外服务 · 无第三方依赖

✨ 功能特点

• 📈 总览指标 – 总 Token、预估成本、会话数、缓存命中率，支持近 24 小时 / 7 天 / 14 天 / 30 天 / 所有。
• 💰 可读的均价 – 按已用量自动选择 1M / 10M / 100M / 1B tokens 单位，避免出现 ¥0.00 这类无意义数字。
• 💱 默认货币跟随语言 – 中文界面默认人民币，其他语言默认美元；手动切换后本次停留期间保持手动选择。
• 🗓️ 每日消耗 – 输入 / 缓存读取 / 缓存写入 / 输出四类 Token 堆叠柱状图，悬停查看完整日期与拆分。
• 🏆 会话消耗排行 – 按 Token、按耗时、按金额三种排序；主数字跟随所选指标，并显示所属工作区与轮次。
• ⚡ 对话性能 – 平均每轮耗时、平均首字延迟、输出速度、工具错误率。
• 🖥️ DSH 运行状态 – 进程 CPU（单核与整机）、内存 RSS / 堆、事件循环 p99、运行时长、PID 与 Node 版本，每 5 秒采样。
• 🎯 标题与侧边栏一致 – 标题取自 DSH 的 title 投影，而不是原始日志或首条消息。
• 🌐 跟随 DSH 语言 – 侧边栏入口与页面文案跟随「设置 → 通用设置 → 语言」，内置中文、English、日本語、Español、Français、Deutsch、Русский、Português 八种字典。
• 🚀 缓存先行 + 增量刷新 – 首屏直接显示上次快照，后台只重读有变化的会话。

🖼️ 界面

| 浅色 | 深色 |

| --- | --- |

| | |

📁 项目结构

dsh-session-stats-viewer/
├── src/
│   ├── index.js            # Host：日志折叠、快照缓存、运行时采样、/api 路由
│   └── client.js           # Client：侧边栏图标与统计页面（单文件浏览器模块）
├── test/
│   └── stats.test.js       # 折叠、范围、均价、工作区映射的单元测试
├── locale/
│   ├── en.json             # 插件展示元数据（英文）
│   └── zh.json             # 插件展示元数据（中文）
├── docs/
│   └── screenshots/        # README 截图
├── cordis.patch.yml        # 插入 Host 插件行
├── icon.svg                # 插件图标
├── package.json
├── LICENSE
├── README.md
├── README.en.md
└── CONTRIBUTING.md

• 无构建步骤：Host 与 Client 都是可直接加载的纯 JavaScript。
• 无运行时依赖：只使用 Node 内置模块与 DSH 提供的服务。
• 只读：不会写入、修改、归档或删除任何会话数据。

🚀 安装

环境要求

• DeepSeek Harness（DSH）Desktop 或 Web GUI，且当前 profile 具备 Web 界面
• 无需额外服务或 API Key
• 仅开发/测试需要 Node.js ≥ 20

方式一：从 npm 安装（推荐）

dsh plugin --profile  add @bright9025/dsh-session-stats-viewer

包地址：

也可以在 DSH 对话里直接说：

> 安装 npm 包 @bright9025/dsh-session-stats-viewer

安装完成后刷新 DSH 页面。左侧边栏「自动化任务」下方会出现 会话统计。

方式二：从源码安装（开发）

1. 克隆仓库到一个固定目录（不要放在临时下载目录）：

git clone https://github.com/Bright9025/dsh-session-stats-viewer.git

2. 在 DSH 对话中发送（把路径换成你的实际路径）：

> 把这个目录安装为本地 bundle：C:\path\to\dsh-session-stats-viewer

智能体会调用 plugin_manager install_bundle。本地源码安装适合调试，npm 安装适合日常使用；两者不要同时装。

安装后检查

• 左侧边栏出现「会话统计」；
• 设置 → 插件中能看到该插件；
• 打开页面后能看到总 Token、预估成本与最近的会话数据。

如果入口没有出现：先刷新页面；仍然没有就重启 DSH。

升级与卸载

• 升级：有新版后重新安装（先卸载旧版，再执行上面的安装命令）；源码方式则 git pull 后重装。
• 卸载：设置 → 插件 → 会话统计 → 卸载。卸载只移除插件，不会删除任何会话数据。

> 已发布到 npm；使用和安装不需要 Node.js，Node.js 仅用于跑测试。

🧭 使用

1. 点击左侧边栏的 会话统计。

2. 顶部切换时间范围与货币（人民币 / 美元）。人民币界面默认人民币，其他语言默认美元。