deepseekplugins

DeepSeek Harness 插件

dsh-token-usage-joyiok

DeepSeek Harness Token 用量统计插件：聚合全部会话日志的 input/output/cache token，注册 token_usage 工具，并在 Web 侧边栏提供统计面板（英文原文）

界面增强
跳到安装方式

来源信息

GitHub 仓库
joyiok/dsh-token-usage
最近更新
2026年8月15日
分类
界面增强
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/joyiok/dsh-token-usage
插件名：dsh-token-usage-joyiok
作者：joyiok

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-token-usage

DeepSeek Harness（DSH）Token 用量统计插件。

  • Web 侧边栏：底部新增 Tokens 按钮，点击查看全部累计 / 今日 / 每个会话的

input / output / cache-read token（数据通过 Typert RPC 从宿主聚合）。

  • Agent 工具：注册 token_usage 工具，headless / Web 会话里直接问

「我一共用了多少 token」即可得到权威统计。

  • 权威计数：读取 $DSH_HOME/sessions/**/session.jsonl(.zstd)，对每个

(turn, step) 只计一次（优先 assistant/message 的 data.usage）， 不做字符估算；内置多帧 zstd 解码，无需外部 zstd 二进制。

安装

cd /home/joy/Documents
dsh plugin --profile web add /home/joy/Documents/token-usage-dsh-plugin
dsh plugin --profile headless add /home/joy/Documents/token-usage-dsh-plugin

安装完成后重启 dsh web（客户端扫描与 Typert 清单按包缓存）：

dsh web

验证：dsh --profile web --dump-config 应出现：

# == dsh-token-usage
- id: token-usage
  name: dsh-token-usage

使用

Web 侧边栏

打开任意会话 → 左下角点击 Tokens 图标 → 面板展示：

  • 全部累计 / 今日：输入、输出、输入+输出、缓存读取、含缓存总计、LLM steps；
  • 会话明细表：标题、模型、输入 / 输出 / 缓存读取、最近活动时间。

Agent 工具（headless / Web 均可）

用户：我一共用了多少 token？
Agent：调用 token_usage(scope: "all") 后回答

工具参数：

参数说明
scopeall（默认，全部会话）/ today（今日）/ current（当前会话）
includeSessions是否包含逐会话明细；默认 current/today 为 true，all 为 false

配置

可在 profile 的 cordis.patch.yml 覆盖（注意：覆盖整行 config）：

- id: token-usage
  config:
    cacheTtlMs: 8000        # 聚合缓存毫秒数
    maxToolSessions: 20     # token_usage 工具最多返回的会话数

禁用插件：

- id: token-usage
  disabled: true

结构

src/index.js               # 宿主半体：Typert RPC + token_usage 工具
src/usage.js               # 零依赖聚合核心（多帧 zstd + 会话日志扫描）
lib/client.js              # 浏览器半体：侧边栏按钮 + 统计面板
lib/typert.host.js         # Typert host 清单（token-usage/aggregate）
lib/typert.remote-client.js# Typert remote 描述符（参考）
cordis.patch.yml           # dsh bundle 补丁：插入 token-usage 行
scripts/build.mjs          # esbuild 构建脚本（node scripts/build.mjs）

说明

  • totalTokens = inputTokens + outputTokens；totalWithCache 额外计入

cacheReadTokens + cacheWriteTokens。

  • 会话日志正在写入时，内置解码失败会自动回退到 zstd CLI（PATH 可用时）。
返回搜索打开 GitHub 仓库

更多相关插件

查看分类