1841220388zzzcccxxx-star/dsh-token-stats 预览 preview

1841220388zzzcccxxx-star/dsh-token-stats

DeepSeek Harness 的令牌使用与成本统计插件——按模型/日期/会话统计,成本估算(美元/人民币),CSV/JSON 导出 | DeepSeek Harness 令牌用量统计插件:按模型/日期/会话统计用量与费用,支持 CSV/JSON 导出

Project Overview项目介绍

dsh-token-stats is a token usage and cost tracking plugin built exclusively for DeepSeek Harness (DSH). It tracks token consumption grouped by model, date, and individual session, and calculates estimated costs in both USD and CNY using built-in model pricing data. To install it, you first clone the repository to a local folder, then add it as a file dependency to your DSH profile’s package.json, include it in the profile’s bundle list, run pnpm install, and restart DSH. Once installed, it automatically loads on DSH startup and adds a dedicated native page under the Settings menu labeled “Token Stats”, so no manual activation is required.

This plugin is intended for any DSH user who wants to keep track of their total token consumption and associated API costs across all their chat sessions. When you first start DSH after installing the plugin, it automatically runs a one-time backfill of all your existing persisted session logs to build its aggregated statistics. This ensures that even your older chat history is included in the final stats, so you don’t only get data starting from when you installed the plugin. After the backfill completes, you can view daily, weekly, and monthly consumption trends directly on the stats page.

The plugin is released under the open source MIT license, so it is free to use and modify for any purpose. The SVG line chart used for displaying trends has no external dependencies, and the author has implemented multiple performance optimizations to keep the plugin fast even with large amounts of history. On a test dataset with 10,000 records, most API endpoints respond in under 20 milliseconds, thanks to batching, in-memory caching, and memoized cost calculations. It also supports exporting filtered statistics as CSV or JSON files for further analysis if needed.

这是一个专为DeepSeek Harness(DSH)打造的原生令牌使用统计插件,核心功能是追踪不同模型、日期和会话维度下的令牌消耗量,同时提供美元和人民币两种货币的成本估算。插件支持中英双语,适配DSH的深浅色主题,安装后会在DSH的设置菜单下新增一个原生的令牌统计页面。它作为外部DSH插件安装,会在DSH启动时自动加载,不需要用户手动激活。

该插件面向所有需要掌握自身令牌消耗和成本支出的DSH用户,使用流程非常简洁。完成安装并重启DSH后,插件会在首次启动时自动扫描所有已持久化的会话日志,回填历史统计数据,保证统计结果覆盖所有使用记录。用户进入设置页面的令牌统计面板后,即可查看按日、周、月维度生成的消耗趋势,还可以按模型或会话筛选后导出CSV或JSON格式的数据。

该插件前端图表部分无额外外部依赖,内置了DeepSeek、GPT、Claude、Gemini、Qwen等主流大模型的定价表,成本估算直接基于内置定价完成。整个插件采用MIT许可协议开源,完全免费使用,作者对批量读取会话数据做了性能优化,万级记录下接口响应也能保持在数十毫秒内,使用体验流畅。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:1841220388zzzcccxxx-star/dsh-token-stats

把 1841220388zzzcccxxx-star/dsh-token-stats 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-token-stats

Token usage & cost statistics plugin for DeepSeek Harness (DSH).

Tracks token consumption per model, per date, and per session with cost estimation in USD / CNY, served as a native page under Settings → 📊 Token Stats. Installed as an external DSH plugin, it loads automatically at DSH startup — no manual activation needed.

中文说明

Features

  • 📊 Native settings page (dark/light aware, follows DSH theme tokens, i18n zh/en)
  • 📈 Daily / weekly / monthly trends with an SVG line chart (zero dependencies)
  • 💰 Cost estimation (USD & CNY) from a built-in pricing table for DeepSeek, GPT, Claude, Gemini, Qwen…
  • 🔁 History backfill: scans all persisted session logs at startup, so stats survive restarts
  • ⚡ Fast: batched session-title reads with an in-memory cache (TTL 5 min), single-pass summaries, memoized pricing
  • 📤 CSV / JSON export, filterable by model and session

Screenshot

Token Stats dashboard

Installation

The plugin is installed as an external DSH profile dependency.

  1. Clone this repository to a local folder, e.g. D:\dev\dsh-token-stats

  2. In your DSH profile manifest (~/.dsh/profiles/web/package.json):

    {
      "dependencies": {
        "dsh-token-stats": "link:D:/dev/dsh-token-stats"
      },
      "dsh": {
        "profile": {
          "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-token-stats"]
        }
      }
    }
    
  3. cd ~/.dsh/profiles/web && pnpm install

  4. Restart DSH web. Open Settings → 📊 Token Stats.

cordis.patch.yml declares the bundle-layer mount point so the plugin auto-loads at startup. With a link: dependency the profile mounts the source folder directly — after editing the plugin, just restart DSH web (no copy step). file: also works but needs a re-copy per change (.\sync-deploy.ps1 automates that). Alternatively, dsh plugin --profile web add link:<path> forwards the install to pnpm; the dsh.profile.bundles entry still needs adding by hand.

Compatibility

Declared per the official plugin contract and enforced by DSH ≥ 0.2.0 at install/startup preflight:

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev work-charter-dsh 下一个 Next dsh-editor →