前言¶
DeepSeek Harness (dsh) 会为每个会话写入日志。读取这些日志是回答“这台机器实际花费了多少，在什么上”的唯一方法—— harness 自身的投影仅覆盖它运行的主机。此插件在数据层合并了两个之前的插件，因此一个索引驱动一个仪表板，且数字在各处一致。
核心功能¶
该插件提供机器级 token 账目：
- 每个 dsh 家目录：扫描
~/.dsh、~/.dsh_desktop/<version>、$DSH_HOME。读取旧版session.jsonl[.zstd]和版本化日志。 - 一个范围控制：今天 / 7 天 / 14 天 / 30 天 / 全部时间 / 自定义。该范围控制标题卡片、趋势、模型面板、会话排名、调用表和成本。
- 一个模型面板：每行显示份额、堆叠输入/缓存读/缓存写/输出条、调用数和（如果定价）成本。
- 会话排名：按 token 排序；点击行以筛选调用表。
- 平滑多系列趋势：总/输入/输出/缓存读，带可切换图例和悬停读出。
- 调用详情：时间、响应时间、输入、输出、缓存率、模型、思考 effort。带筛选器（模型/提供商/阈值）和分页。
- 导出：当前窗口的 CSV / JSON。
- UI 功能：可折叠面板、中/英支持、浅色/深色主题。打开的面板每 60 秒自动刷新。
- 可选成本估算：本地定价表，带高峰/非高峰加权。
安装与启用¶
使用官方命令安装：
dsh plugin --profile web add github:satan9394/dsh-usage-unified
安装后重启 Web 配置文件。仪表板显示在侧边栏页脚的“使用统计 / Usage Stats”中，或作为设置下的一个部分。
注意：插件在市场被阻止（需要文件系统/网络访问），但支持手动安装。
典型用法¶
- 打开侧边栏页脚条目（或设置 -> 使用统计）。
- 选择日期范围（今天/7天/14天/30天/全部时间/自定义）以筛选数据。
- 点击会话排名行以筛选调用表。
- 在调用详情表中使用筛选器（模型/提供商/阈值）。
- 通过 loopback API 端点访问数据：
/usage-unified/v1/snapshot,/calls,/export.csv,/export。
适用场景与注意¶
- 版本要求：需要 DeepSeek Harness (dsh) 0.1.5-rc.1 或更新。
- 运行时：需要 Node.js ^22.19.0 || >=24.0.0。
- 隐私：完全在本地运行，浏览器端无网络调用。
- 安装：由于文件系统访问要求，插件在市场被阻止，但支持手动安装。
短结尾¶
该工具为 DSH 提供了一个统一的视图，用于跨不同会话日志进行成本分析和使用模式追踪。更多详情请访问 GitHub。
