dsh-model-usage

DeepSeek Harness（DSH）的本地模型用量统计插件。插件在 DSH 设置页中增加“模型用量”页面，用于查看 Token 活动、模型调用次数、缓存命中和成本估算。

所有用量记录均保存在本机，不上传聊天内容、API Key 或统计数据。

功能

• 统计输入、输出、缓存读取、缓存写入和推理 Token
• 按 provider/model 汇总模型用量
• 展示累计 Token、单次峰值、最长调用时长和连续使用天数
• 提供近半年和近一年的 Token 活动视图
• 支持每日、每周和累计三种活动展示方式
• 展示总 Token、总请求数、缓存命中、缓存命中率和总成本
• 支持人民币与美元切换，固定汇率为 1 美元 = 6.8 人民币
• 支持全部模型或指定模型筛选
• 页面加载时刷新，并每 60 秒自动刷新；也可手动刷新
• 每次调用结束后立即写入本地 JSONL（包括失败和取消），重启 DSH 后自动恢复统计
• 采集 DSH web_search 产生的 DeepSeek Flash 用量，并合并到现有 Flash 统计中

环境要求

• DeepSeek Harness，且已安装 web profile
• Node.js（版本以当前 DSH 的运行要求为准）
• pnpm

源码安装

克隆项目并安装依赖：

git clone https://github.com/Timmononon/dsh-model-usage.git
cd dsh-model-usage
pnpm install
pnpm build

将项目以本地链接方式加入 DSH Web profile：

dsh plugin --profile web add "link:D:/path/to/dsh-model-usage"

然后启动 DSH：

dsh web

默认访问地址为：

http://127.0.0.1:3080

打开 DSH 设置页后，可以在“模型用量”分区中查看统计。

本地开发挂载

也可以直接编辑 Web profile 的配置文件：

~/.dsh/profiles/web/package.json

在 bundles 中加入插件，并在 dependencies 中设置本地路径：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-model-usage"
      ]
    }
  },
  "dependencies": {
    "dsh-model-usage": "link:D:/path/to/dsh-model-usage"
  }
}

修改后在 profile 目录刷新依赖：

cd $HOME\.dsh\profiles\web
pnpm install

Host 端代码变更需要重新构建并重启 dsh web；前端代码变更需要重新构建并刷新浏览器页面。

数据采集方式

普通模型请求通过 DSH 的 llm/stream 流采集。插件原样透传响应，并在正常完成、失败或取消时各写入一条记录，不改变模型输出。异常仍会继续抛给原调用方；若中断前已经收到 usage，则保留该用量，否则 Token 记为 0。

DSH 的 DeepSeek 网页搜索不会经过 llm/stream。插件会透明观察模型名确认为 DeepSeek、且带有 web_search_20250305 工具标识的搜索请求，克隆成功响应并读取其中的 usage。搜索用量使用 deepseek-official/deepseek-v4-flash 标识，因此会与普通 DeepSeek Flash 请求合并显示；其他提供商使用同名工具时不会被计入。

记录结构如下：

{
  ts: number       // 开始时间
  provider: string
  model: string
  inp: number      // 非缓存输入 Token
  out: number      // 输出 Token
  cr: number       // 缓存读取 Token
  cw: number       // 缓存写入 Token
  rsn: number      // 推理 Token
  dur: number      // 调用耗时，单位毫秒
  status: 'completed' | 'cancelled' | 'failed'
}

页面中的总 Token 为输入、输出、缓存读取和缓存写入之和。推理 Token 通常属于输出 Token 的细分，因此不会再次加入总量，避免重复计算。

旧版本写入的记录没有 status 字段，读取时会自动按 completed 兼容。

本地存储

默认数据文件：

~/.dsh/storages/model-usage.jsonl

如果设置了 DSH_HOME，则使用：

$DSH_HOME/storages/model-usage.jsonl

每次调用结束后追加一行记录。插件启动时从文件尾部最多回放最新 50,000 条有效记录；达到该上限后无需继续读取更早的数据。磁盘文件保持追加写入。

每日活动和连续天数统一按北京时间自然日计算。

不要将该 JSONL 文件提交到代码仓库，其中可能包含模型名称、调用时间和用量信息。

成本估算

价格配置位于 src/report.ts。当前对以下模型使用专用价格表：

• GPT-5.6 Luna
• GPT-5.6 Terra
• GPT-5.6 Sol
• DeepSeek V4 Flash
• DeepSeek V4 Pro

GPT-5.6 分别计算非缓存输入、输出、缓存读取和缓存写入；单次计费输入超过 272,000 Token 时使用长上下文价格。

DeepSeek V4 分别计算缓存命中、缓存未命中输入和输出，并按北京时间使用峰谷定价：

• 高峰：09:00–12:00、14:00–18:00
• 空闲：其他时段

未配置专用价格的模型使用通用美元单价估算。页面显示的成本仅用于本地参考，不代表服务商最终账单。

HTTP 接口

插件在本地 DSH Web 服务中注册以下接口：

开发命令

pnpm typecheck
pnpm test
pnpm build
pnpm watch

• pnpm typecheck：执行 TypeScript 类型检查
• pnpm test：执行价格、缓存、日期、热力图、流式异常、搜索归属和持久化行为测试
• pnpm build：生成 Host、浏览器端代码和类型声明
• pnpm watch：监听源码变化并重新打包

构建产物位于 lib/，不会提交到代码仓库。

项目结构

src/index.ts                         Host 插件、持久化、聚合与 HTTP 接口
src/search-usage.ts                  DeepSeek 网页搜索用量采集
src/storage.ts                       JSONL 尾部读取与记录校验
src/stream-usage.ts                  模型流透传、结束状态与用量落盘
src/usage-math.ts                    价格、缓存与北京时间统计逻辑
src/activity-grid.ts                 活动图日期窗口计算
src/report.ts                        数据类型和模型价格表
src/client/index.ts                  设置页注册入口
src/client/UsageSection.tsx          模型用量页面
src/client/UsageSection.module.css   页面样式
test/                                行为回归测试
cordis.patch.yml                     DSH bundle 注册配置

License

MIT