前言¶

在 DeepSeek Harness（DSH）里跑多轮对话、调用工具之后，Token 消耗、估算费用和模型分布往往散落在会话投影缓存和本地日志里，要在心里拼凑「这一段时间总共花了多少」「某一通会话每一轮发生了什么」并不轻松。下面介绍社区插件 dsh-session-dashboard（维护者 349840432m-dev，分类：客户端）：它把本机 ~/.dsh 里的数据整理成只读仪表盘，提供全量会话总览与会话内逐轮时间线，不向外部写数据、也不走网络。

这是什么¶

dsh-session-dashboard 是面向 DeepSeek Harness 的真实插件：将任意本地 DSH 会话与对话投影为只读仪表盘。当前 package 版本为 0.1.0，许可证 MIT，依赖 DSH >= 0.2.0、Node >= 20（README 记载在桌面端 0.2.2-rc.1 上验证过）。

核心功能¶

侧栏会出现 「会话仪表盘」（中文环境下为「会话仪表盘」；安装后 README 亦说明侧栏为「会话仪表盘」）。在该入口可查看：

• 全部会话汇总：Token、估算成本、轮次、工具调用、模型 mix、按日活动等；
• 可搜索、可排序的会话表。

在任意会话内，除原有视图外会多一个 「仪表盘」 View 标签，展示：

• 实时逐轮时间线；
• 每轮的 Token、成本、耗时、工具调用；
• 模型与工具分布明细。

数据来源：

• 会话投影缓存：权威的 Token 合计、标题、模型与轮次计数；
• 会话日志（多帧 zstd）：轮次 prompt/reply、单次调用用量、工具、时序与按日桶。

成本按 DeepSeek 官方价目表、结合每次调用时间戳区分峰谷计价；没有完整日志的会话会用机器级混合价估算并做标记。

插件仅在自有 data/ 下写缓存，其余对 ~/.dsh 为只读；README 明确无网络访问。

安装与启用¶

需要 DSH >= 0.2.0 与 Node >= 20。可从 DSH Plugins 页面安装，或在 shell 中执行（命令以 README 为准）：

# 从 GitHub 源码安装
dsh plugin --profile web add github:349840432m-dev/dsh-session-dashboard

# 或使用预构建 release 包（无需构建、无需构建审批）
dsh plugin --profile web add https://github.com/349840432m-dev/dsh-session-dashboard/releases/latest/download/dsh-session-dashboard.tgz

# 或本地 checkout 路径
dsh plugin --profile <profile> add link:/absolute/path/dsh-session-dashboard

安装后 重启 DSH 一次，以便 Host 侧 JavaScript 模块重新加载（Web 侧刷新页面即可）。随后侧栏出现「会话仪表盘」，每个会话增加「仪表盘」视图标签。

DSH Desktop 由应用内插件管理 profile，宜在 Settings → Plugins 安装；CLI 安装只会写入你指定的 profile。

典型用法¶

1. 完成安装并重启 DSH。
2. 打开侧栏 会话仪表盘，按需查看全部会话统计与会话表（overview 类数据对应插件只读 API，支持 range=7|30|all 等查询维度，见下文）。
3. 进入某一通会话，切换到 仪表盘 View，沿时间线查看每一轮的 Token、成本、工具与模型 breakdown。

插件对外提供只读 HTTP 端点（GET only，无 CORS 头、无写操作），便于自检或集成只读展示：

• GET /session-dashboard-api/health
• GET /session-dashboard-api/overview?range=7|30|all
• GET /session-dashboard-api/session/<sessionId>

实现要点（数据与解码）¶

桌面 Host 内置 Node 24.21，其 zstdDecompressSync 仅解压首帧；本插件按 RFC 8878 逐帧遍历 zstd，因此在 Host 与独立 Node 上均可工作，并能容忍末帧尚未写完的情况。这与「从本地日志还原完整轮次」的目标直接相关，属于客户端侧读盘逻辑，而非远端服务。

适用场景与注意¶

适合谁：在本机长期用 DSH 做智能体或对话开发、需要回顾 Token/成本/工具调用分布、又不想把会话数据发到第三方的开发者。

权限与安全：插件以当前 DSH 进程权限读取 ~/.dsh；安装前应查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，生态上 DSH 强调「一切皆插件」，目录为独立站点。

局限：纯本地、只读；无日志的会话成本为估算值；星标与发布节奏以仓库为准（当前公开资料中 GitHub 星标为 0）。

结尾¶

经过上面的步骤，你可以在 DSH 内用侧栏总览把握全局，在单会话仪表盘里对齐每一轮消耗与工具行为，且数据不离本机。更多细节见仓库 README.zh-CN.md。

• 目录页：https://www.skillhub.cn/plugins/349840432m-dev/dsh-session-dashboard
• GitHub：https://github.com/349840432m-dev/dsh-session-dashboard