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` 开发
安装步骤
- 01
从 npm 安装(推荐):`dsh plugin --profile web add dsh-usage-panel`
$ dsh plugin --profile web add dsh-usage-panel
- 02
或从 GitHub 安装:`dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel`
$ dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel
- 03
或从本地 checkout 安装:`dsh plugin --profile web add ./dsh-usage-panel`
$ dsh plugin --profile web add ./dsh-usage-panel
- 04
重启 `dsh --profile web`,打开 设置 → Usage
$ dsh --profile web
验证接入成功
- 首次加载时 Usage 页面通常直接从缓存渲染出 KPI 卡片与热力图
- 刷新按钮会强制发起一次同步扫描
回滚
- `dsh plugin --profile web remove dsh-usage-panel`
03DSH 适配与能力边界
原生 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 账单对账。
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”。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件,高性能低占用,可爱像素鲸鱼,流畅鼠标交互,npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
dsh-drawai
作者 fourzkw
DSH 右侧栏里的可编辑画布 —— 加上让模型直接改图的两个工具
08数据与来源
The plugin aggregates persisted session logs (incrementally, via the session-projection mechanism) and never writes anyt…
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 个值得优先安装的插件,覆盖各个分类。
