用 dsh-cost-meter 给 DeepSeek Harness 网页界面补上会话费用账本

DeepSeek Harness 插件 DeepSeek DSH dsh-cost-meter 费用统计 工具与能力 2026-08-17 159 阅读

前言

用 DeepSeek Harness（以下简称 DSH）写代码，账单跟的是 Token，不是会话条数。一次调用会拆成未命中输入、缓存命中、输出；子代理、压缩、标题生成这些辅助调用也会进用量。2026 年 8 月 16 日 16:00 UTC 起，官方定价又按峰时 / 谷时分档：同一段对话，上午和晚上的单价可以差一倍。只看 Token 数字，很难立刻回答「这一轮花了多少钱」「今天已经用了多少」「账户还剩多少」。

DSH 官方仓库把架构写成「一切皆插件」：界面、工具、计费展示都可以在配置层装卸，不必改 Harness 源码。社区里有人专门给 Web 界面加了一本费用账本：本会话实时累计、当日合计、预算进度、官方余额，以及和官方定价页对齐的价格表。这个插件叫 dsh-cost-meter，收录在独立的社区插件目录 deepseek-harness-plugin.com 中。该目录与 DeepSeek / 幻方没有官方从属关系，不是官方应用商店。

本文按插件目录页、GitHub 仓库 README、package.json、CHANGELOG，以及 DeepSeek 官方定价页交叉核对后整理：它是什么、装哪条命令、网页里怎么看账，以及安装前要看清的权限边界。

这是什么

dsh-cost-meter 是一款面向 DeepSeek Harness Web UI 的会话费用统计插件，目录分类为「工具与能力」，由 GitHub 用户 Han-1413141 维护，仓库地址为 Han-1413141/dsh-cost-meter。许可证为 MIT，主要语言是 JavaScript。目录页收录日期为 2026-08-15。仓库 package.json 与 README 徽章、CHANGELOG 均标明当前版本为 1.3.1（发布于 2026-08-16）。截至 2026-08-17 查询 GitHub API，仓库显示 58 stars；目录页当时标注为 23，星标以 GitHub 一手数据为准。

package.json 里的兼容声明是：DSH >=0.1.0-rc.5、Node.js >=20。客户端声明为 "platform": "web"，也就是说它挂在网页界面上，不是终端 TUI 插件。

目录页给它的一句话是：本会话费用、当日费用、历史记录，与官方价格同步。仓库 README 把能力写得更完整：会话徽章上的实时费用和 Token 分列、侧边栏官方余额与预算图框、设置页的汇总与按天历史、峰谷计价、官方定价页一键同步，以及中英双语界面。1.3.0 起还增加了 OpenCode Go 订阅额度显示；1.3.1 又在设置页加了类 Codex 的 26 周 Token 用量热图。

它要填的坑很具体：Token 用量已经发生了，但金额要按模型、缓存是否命中、调用发生在峰时还是谷时来算。插件把每次模型调用的 usage 块记进本地账本，再按价格表折成美元；界面上的人民币等币种只是按汇率显示。

核心功能

下面几条都来自当前仓库 README、package.json 与 CHANGELOG，不额外发挥。

1. 本会话费用徽章

会话费用可以出现在两个位置，设置里切换：

  • 输入区下方
  • 会话标题栏

徽章显示本会话实时累计费用，以及输入 / 缓存 / 输出 Token。计费来源是每次模型调用的 usage 块，含子代理、压缩、标题等辅助调用。README 写明：会话徽章按当前价格档位估算；当日、本月、累计和预算则按调用实际时刻精确入账。两边不一致时，以账本为准。

2. 官方余额与当日费用

侧边栏可以显示官方开放平台余额：总余额、赠送、充值，支持自动刷新和手动刷新。位置可配在侧边栏顶部、设置页，或两处都显示。余额接口是官方 GET {baseURL}/user/balance，复用模型请求同一把 API Key。

当日费用出现在侧边栏底部（设置按钮上方），文案是「今日 ¥x」这类徽章；悬停可以看到调用次数和 Token 明细。未启用预算时，这个位置就留给当日费用。

CHANGELOG 1.3.0 还写过一个实际问题：侧边栏数据曾会冻在页面加载时刻。当前版本用约 60 秒的周期轮询（页面隐藏时跳过），切回标签页会立即刷新。

3. 预算图框：提醒，不拦截

启用预算后，侧边栏底部会出现圆角图框：预算额度、已用百分比、进度条、今日费用与占预算百分比、已用 / 额度。阈值写在 README 里：

  • 已用 ≥ 80%：预警
  • 已用 ≥ 100%：超支

预算周期可以选今日、本月、累计，或自定义日期区间。窄栏（rail）模式会收成百分比方块。

务必看清一句：预算与超支提示只提醒，不阻止调用。额度用完后，模型请求照样会发出去。

4. 设置页账本：今日、本月、历史

设置 → 费用 这一页是总览，README 列出的内容包括：

  • 汇总卡片：今日 / 本月 / 累计费用与调用次数
  • 今日会话明细：每个会话的调用次数、输入 / 缓存 / 输出 Token 与费用
  • 历史记录：按天汇总，保留天数可配，默认 180 天
  • 价格表：每个模型三档价格（基础 / 谷时 / 峰时），可增删改
  • 显示设置：徽章位置、语言、图框详细信息等

账本存在 $DSH_HOME/storages/cost-meter/ledger.json，原子写入并带防抖。设置修改即时自动保存（README 写的是 600ms 防抖），没有单独的「保存」按钮。清零可以删这个文件，也可以用设置页的「清除全部历史」。每日最多保留 200 条会话明细。

5. 峰谷计价与官方价格同步

价格单位与官方文档一致：美元 / 1M tokens。成本公式按 README：

未命中输入 × cache-miss + 输出 × output +（缓存读 + 缓存写）× cache-hit。

缓存写入沿用官方历史规则，按命中价计费。账本金额恒以美元存储；币种和汇率只影响显示，默认 1 USD = 7.2 CNY，可改。

峰谷门控的默认生效时间是 peakEffectiveAt：2026-08-16 16:00 UTC。生效前一律按基础价；生效后：

  • 峰时段：01:00–04:00、06:00–10:00 UTC，用峰时价
  • 其余时间用谷时价

这与 2026-08-17 打开的 DeepSeek 官方定价页 一致：谷时为峰时的一半，峰时段同样是上述两个 UTC 窗口。设置页会显示当前档位（未生效 / 峰时段 / 谷时段）。

「从官方文档同步价格」会抓取官方定价页（Docusaurus 服务端预渲染），解析基础表、峰谷表、生效时间和峰时段窗口，再写入本地价格表。页面结构改版时同步会报错并保留原价格，可以手动改表兜底。同步会覆盖官方页面列出的同名模型价格，自定义模型条目不受影响。

仓库另外提供 docs/AI-PRICE-SYNC-PROMPT.md（及英文版）：把提示词交给任意 AI，让它读取官方定价后输出多模型、分时价格 JSON，人工核对后再应用到设置页、RPC 或文件。这是备用同步路径，不是自动扣费。

6. 中英双语界面

界面（会话徽章、侧边栏、设置页全部文案）支持简体中文、English，以及跟随浏览器。默认跟随浏览器：zh* 走中文，其余走英文，探测结果会写回配置。服务端提示（余额刷新、价格同步、校验错误）跟界面语言一致。切换入口在 设置 → 费用 → 显示设置 → 界面语言，即时生效并自动保存。

7. OpenCode Go 额度与 Token 热图

这两项是较新的能力，目录页短简介没有展开，仓库 README 与 CHANGELOG 写得很清楚。

OpenCode Go 订阅额度（1.3.0）：读取 opencode.ai 的滚动 5 小时 / 本周 / 本月用量百分比和重置时间。Key 按「显式配置 → DSH 凭据库 OPENCODE_GO_API_KEY → 环境变量 → opencode 登录态」自动发现，也可以手动填写。侧边栏图框、设置页面板、右下角 chips 都可以显示；Go 与预算同时开启时会合并成一张卡片。未订阅或 Key 无效时给出中性提示，可在设置里关掉，避免一直报错。接口被 README 标明为「opencode.ai 官方端点（社区文档）」；结构变化时设置页会报错。

Token 用量统计（1.3.1）：设置页展示历史累计 Token（输入 / 缓存 / 输出 / 调用次数），以及类 Codex 的 26 周每日用量方格热图。无用量日是半透明格子，有用量按四档蓝色着色，悬停看当日明细。

没有 OpenCode Go 订阅、也不需要热图时，这两块可以忽略；会话费用、余额、预算和官方价格同步仍然可用。

安装与启用

插件目录页给出的安装命令是：

dsh plugin add github:Han-1413141/dsh-cost-meter

目录页同时提醒：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。若需要可复现安装，固定 commit 哈希：

dsh plugin add github:Han-1413141/dsh-cost-meter#<commit>

把 <commit> 换成仓库里实际的提交哈希，不要照抄占位符。

仓库 README 把安装目标写成 Web profile，并推荐钉到发布 tag v1.3.1（与当前 package.json 版本一致）。机器上需要已有 pnpm 与 git：

dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.3.1

没有 git 时，README 给出 GitHub tag 打包直链：

dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.3.1.tar.gz

环境要求按 README：Node.js ≥ 20，以及带 dsh plugin 命令的 DeepSeek Harness（npm install -g @deepseek-ai/dsh）。DSH 本体当前仍是 developer preview，官方 README 写明会有破坏性变更。

安装后必须重启 dsh web。README 的原因是：插件行、Typert 清单和客户端 bundle 都在启动时扫描。

dsh web

卸载按 README：

dsh plugin --profile web remove dsh-cost-meter

Windows 用户还可以看到仓库里的 install.ps1 一键脚本（irm … | iex，脚本内固定到 tag）。README 自己写了「建议先下载审阅再运行」。能用上面的 dsh plugin 命令时，不必走远程管道执行。

开发者本地调试用符号链接，改 lib/client.js 后刷新页面即可：

git clone https://github.com/Han-1413141/dsh-cost-meter.git
cd <克隆目录的父目录>
dsh plugin --profile web add link:./dsh-cost-meter

典型用法

下面步骤均来自仓库 README 的界面说明，不另编操作。

1. 看本会话花了多少

重启 Web UI 后打开一个会真实打模型的会话。输入区下方或标题栏应出现费用徽章。发几轮请求后，费用和 Token 分列会跟着 usage 更新。若徽章位置不合适，到 设置 → 费用 → 显示设置 里改到另一个位置，或关掉。

2. 看余额、今日消耗和预算

主页面侧边栏底部，README 给出的默认顺序是：官方余额 → 额度 / 预算图框 → 设置按钮。

  1. 确认本机可以访问 api.deepseek.com，并且 DSH 里已配置有效的官方 API Key。
  2. 余额行悬停可看赠送 / 充值拆分；需要立刻刷新时，到设置页余额面板点手动刷新。
  3. 若要控制开支，在设置页顶部打开预算，填额度、选周期。图框出现后，已用百分比会随账本增长；≥80% 和 ≥100% 只改变提示样式，不会切断对话。

3. 把价格表对齐官方文档

DeepSeek 调价或峰谷窗口变化后，不要只改自己的心理价位。设置页「数据与同步」里可以一键抓取官方定价页。成功后，价格表里的同名模型会换成页面上的基础 / 谷时 / 峰时三档。解析失败时保留旧表，再按官方文档手工改。自定义加进去的模型不会被这次同步清掉。

4. 查今天哪些会话在烧钱

打开 设置 → 费用：

  • 汇总卡片看今日 / 本月 / 累计
  • 「今日会话」表看每一会话的调用次数和三类 Token
  • 「历史记录」按天回溯

Token 热图适合看过去几周的疏密，不适合替代官方账单。需要换界面语言时，同一页的显示设置里切换即可。

使用 OpenCode Go 的人，可以在设置页最顶部看三档额度，或打开右下角 chips。没有订阅就关掉该面板，避免无效请求。

适用场景与注意事项

比较适合这些情况：

  • 已经在用 DSH 的 Web UI，希望会话进行中就能看到金额，而不只是 Token
  • 需要把今日、本月、累计和按天历史留在本地，方便自己做预算
  • 官方峰谷计价已经生效，希望价格表能跟定价页同步，而不是手抄一份过期数字
  • 同时看官方账户余额，确认赠送额度还没用完

使用前注意下面几条，均来自目录页或仓库 README，不是额外发挥：

  1. 先看源码和许可证再装。 目录页写明：插件以当前 dsh 进程权限运行，安装时可能执行代码。这是社区插件，不是 DeepSeek 官方组件。
  2. 它只覆盖 Web profile。 package.json 声明客户端平台为 web；不要按网页截图去终端 TUI 里找徽章和图框。
  3. 徽章是估算，账本才是精确口径。 会话上的数字按当前档位估；跨峰时的会话以按调用时刻入账的 ledger 为准。官方扣费仍以 DeepSeek 账单为准。
  4. 预算不会停机。 超支只变色提醒。真正要停调用，得自己停手或改 Harness 侧策略，这个插件不做闸门。
  5. 余额查询有域名限制。 API Key 只会发往官方域名 api.deepseek.com。baseURL 指到非官方地址时，余额查询会拒绝，模型请求不受影响。本机还要能访问该域名。
  6. 官方页面解析会过期。 定价页改版后，「从官方文档同步价格」可能失败。手动改价格表，或用仓库提供的 AI 同步提示词，再人工核对。
  7. OpenCode Go 是可选项。 额度接口走 opencode.ai，结构变化时会报错，设置里可以关闭。没有 Go 订阅不必开。
  8. 装完要重启。 只 plugin add 不重启 dsh web，界面扫描不到新 bundle。
  9. 不要把目录页当成官方商店。 deepseek-harness-plugin.com 是社区目录；DSH 本体以 deepseek-ai/deepseek-harness 为准。安装命令以目录页原文和仓库 README 为准，不要凭插件名自行拼接路径。

小结

dsh-cost-meter 做的事情很集中：在 DSH 网页界面里把 Token 用量折成钱，并留下本会话、当日、历史和预算。价格按官方的美元 / 1M tokens 和峰谷窗口计算，也可以从定价页一键同步；余额走官方 user/balance 接口。它提醒超支，但不拦截请求。当前仓库版本是 1.3.1，界面中英双语，账本在本地 $DSH_HOME/storages/cost-meter/ledger.json。

目录页与仓库：

  • 插件目录：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-cost-meter/
  • GitHub：https://github.com/Han-1413141/dsh-cost-meter
  • DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness
  • 官方定价：https://api-docs.deepseek.com/quick_start/pricing

相关文章

快速从零部署一个DeepSeek-R1服务 2025-04-05 使用 dsh-anchored-standard 为 DeepSeek Harness 配置两阶段 Agent 预设 2026-08-17 用 dsh-web-ui 把 DeepSeek Harness 网页界面补成工作台 2026-08-17 用 modlens 给 DeepSeek Harness 的纯文本模型补上视觉 2026-08-17 用 dsh-TUI 给 DeepSeek Harness 补上全屏终端界面 2026-08-17
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜