返回目录

dsh-usage-panel

精选清单收录维护状态: 活跃

alfredchaos/dsh-usage-panel

DeepSeek Harness 消耗统计插件:设置页 Token 用量 KPI、半年活跃热力图、按模型堆叠柱状图与模型环形图(dsh-plugin)

前往 GitHub
$ dsh plugin --profile web add dsh-usage-panel

14

星标

2

Fork

TypeScript

语言

MIT

许可证

2026-08-15

创建于

2026-09-15

最近推送

MIT 许可的 dsh bundle 插件:从会话日志做只读 token 计账,含 fork 去重、UTC 日桶、10 分钟新鲜度窗口与 JSON / CSV 导出。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-10

许可证

MIT

01它能帮你完成什么?

  • 看清一套 DeepSeek Harness 实际烧掉了多少 token,并按模型、provider 与日期拆开看

    设置 → Usage 页面:全时段总计、缓存命中率、半年活跃热力图、每日堆叠柱、Top 会话、provider 条形图、模型环形图,以及 JSON / CSV 导出

    想掌握成本、又不想加代理或改动会话日志的 DeepSeek Harness 用户与团队

  • 把用量数据导出,用于结算、预算或表格分析

    完整 JSON、按日 CSV、按模型 CSV——已做公式注入防护,遵循 RFC 4180,带 UTF-8 BOM

    需要在 DSH 之外核对 token 开销的人

02如何接入 DeepSeek Harness?

前置条件

  • 一个 `web` profile——页面在 设置 → Usage 下
  • README 的实现说明:对照 DeepSeek Harness `0.1.5-rc.1` 开发

安装步骤

  1. 01

    从 npm 安装(推荐):`dsh plugin --profile web add dsh-usage-panel`

    $ dsh plugin --profile web add dsh-usage-panel

  2. 02

    或从 GitHub 安装:`dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel`

    $ dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel

  3. 03

    或从本地 checkout 安装:`dsh plugin --profile web add ./dsh-usage-panel`

    $ dsh plugin --profile web add ./dsh-usage-panel

  4. 04

    重启 `dsh --profile web`,打开 设置 → Usage

    $ dsh --profile web

验证接入成功

  • 首次加载时 Usage 页面通常直接从缓存渲染出 KPI 卡片与热力图
  • 刷新按钮会强制发起一次同步扫描

回滚

  • `dsh plugin --profile web remove dsh-usage-panel`

03DSH 适配与能力边界

DSH 适配原生运行时

原生 dsh bundle 插件:`dsh plugin add` 会把它加入 profile 的 bundle 名单,patch 行激活宿主半;宿主半在共享 `/api` 传输上提供 `/api/usage-stats/overview`,客户端半则渲染 设置 → Usage 页面。

  • 增量会话投影

    已提交的会话事件→四个互斥桶(未缓存输入、输出、缓存读、缓存写),外加按模型、按 provider、按日(UTC)的映射

    检查点持久化,重启与 keep-warm 几乎不需要重放插件从不向会话日志写回任何内容
  • 计费口径

    `request/header`、`request/context`、`assistant/message`、`llm/retry`、`compaction/summary` 事件→模型归属取 context 基线 / header 覆盖,步骤用量替换流式临时用量,重试计为次数而非 token,压缩用量归到自己的模型

    reasoning token 已包含在 output 里,不会重复相加
  • Fork 去重

    落在持久化 seed 前缀(`inheritedEventCount`)内的事件→fork 出来的会话不会把父会话的用量重复计一遍

    `session/end-seed` 标记只用来划分 resume/fork 的计费纪元
  • 带过期标记的缓存载荷

    浏览器的载荷请求→10 分钟内视为新鲜;更旧的立即返回并带 `stale` 标记,同时后台重扫刷新缓存

    keep-warm 定时器每 10 分钟重扫一次浏览器另把最近一次成功载荷存进 localStorage,带版本与结构校验

04适合谁?何时不该用?

适合

  • 想掌握成本、又不想加代理或改动会话日志的 DeepSeek Harness 用户与团队
  • 需要在 DSH 之外核对 token 开销的人

不适合

  • README 说明插件是对照 DeepSeek Harness `0.1.5-rc.1` 开发的;README 里没有声明兼容性矩阵。

05兼容性、维护与安全提示

  • README 说明插件是对照 DeepSeek Harness `0.1.5-rc.1` 开发的;README 里没有声明兼容性矩阵。
  • 按日分桶与导出使用 UTC 日历日(`YYYY-MM-DD`),热力图副标题也会标明口径(“last 6 months · UTC”)。
  • 投影服务不可用时,插件会退回通过只读的 `sessionQuery` 服务重放全部会话日志,比增量路径慢。
  • 统计只覆盖已持久化的会话日志;README 并未声明这是账单级准确数据,也不承诺与 provider 账单对账。
2026-08-152026-09-15v0.2.3

MIT · 持续维护(最新 release v0.2.3,2026-09-15)

06常见问题

插件会改动我的会话日志吗?

不会。它通过会话投影(不可用时退回全量重扫)聚合已持久化的会话日志,从不写回,因此统计能跨重启保留,也覆盖插件安装之前的会话。

缓存命中率怎么算?

`cache read ÷ (uncached input + cache read + cache write)`,旁边同时给出读与写的量级。

fork 出来的会话会重复计吗?

不会。落在持久化 seed 前缀(`inheritedEventCount`)内的事件永不计入,所以 fork 会话不会把父会话的用量重复计一遍;`session/end-seed` 标记只用来划分 resume/fork 的计费纪元。

为什么有时数字显示为过期?

载荷在 10 分钟内算新鲜;更旧的会立即返回并带 `stale` 标记,同时在后台重扫刷新缓存。keep-warm 定时器每 10 分钟重扫一次,刷新按钮则始终强制同步扫描。

每日分桶用的是哪个时区?

分桶与导出都用 UTC 日历日(`YYYY-MM-DD`);热力图副标题会标明口径为 “last 6 months · UTC”。

08数据与来源

  • 作者声明github.comf77e7f4a6f15…

    The plugin aggregates persisted session logs (incrementally, via the session-projection mechanism) and never writes anyt…

  • 作者声明github.comf77e7f4a6f15…

    The plugin ships as a bundle: `dsh plugin add` appends it to the profile's bundle list

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-10。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。