@goodandready/dsh-cost-meter

中文文档
0.8.43发布于 2026/11/12MITES Module近 30 天下载 5138

DeepSeek Harness plugin: a session cost chip in the conversation header - live token usage by bucket, peak/off-peak tariff, and a countdown to the next tariff switch.

原始使用文档
文档目录9 节
  1. 面向 DeepSeek Harness 的会话实时花费计费芯片、波峰/波谷阶梯电价与 Token 监控插件
  2. ⚡ 概述与核心痛点
  3. 🏛️ 架构设计
  4. ✨ 核心特性
  5. 📦 快速安装
  6. ⚙️ 配置项说明 ( settings.yaml )
  7. 配置参数列表
  8. 🧪 自动化测试
  9. 📄 许可证

📦 @goodandready/dsh-cost-meter

面向 DeepSeek Harness 的会话实时花费计费芯片、波峰/波谷阶梯电价与 Token 监控插件

npm version license DSH Plugin Node version

所有项目

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明

⭐ 如果您喜欢这个插件,请在 GitHub 上为它点亮 Star — 这能让我知道插件对您有用,并鼓励我继续开发和维护它。

🐛 如果您发现 Bug 或希望增加功能,请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议,并在后续版本中实现有价值的改进。

⚡ 概述与核心痛点

在使用智能体与大语言模型编程时,模型推理、长上下文以及缓存读写会产生大量 Token 消耗。如果缺乏实时的财务监控,开发者容易错过官方 50% 闲时折扣窗口,或因死循环导致账单超出预算。

@goodandready/dsh-cost-meter 在 DeepSeek Harness 会话顶部工具栏(conversation.session.header.utilities)无缝嵌入高精度花费微件芯片:

● ≈ ¥0.85  0:17     ← 会话顶部实时花费芯片与换价倒计时

点击芯片可展开交互式详情面板:按每 1M Token 展示峰谷两档费率表格(高亮显示当前激活档位)、UTC 优惠时间段状态以及各模型在当前会话中的累计消费明细。


🏛️ 架构设计

graph TD
    subgraph StreamTelemetry ["DSH 流式遥测运行时"]
        Req["LLM 请求 / 报头<br/>(provider, model)"]
        StreamHook["增量流式分片 Hook"]
        Proj["costByModel 会话投影<br/>(半小时 UTC 时隙)"]
    end

    subgraph PricingCatalog ["费率解析引擎"]
        Manual["自定义费率配置<br/>(settings.yaml: prices)"]
        DeepSeekTier["DeepSeek 官方费率<br/>(高峰 / 闲时 50% 折扣)"]
        OpenRouterTier["OpenRouter 公开目录<br/>(每日自动缓存)"]
    end

    subgraph UI ["用户交互界面"]
        Chip["顶部花费芯片<br/>(实时计费 + 换价倒计时)"]
        Modal["消费明细抽屉面板<br/>(1M 单价表, UTC 时段, 模型清单)"]
        Settings["设置卡片<br/>(币种符号, 汇率, 时区)"]
    end

    Req --> Proj
    StreamHook --> Proj
    Proj --> Chip
    PricingCatalog --> Proj
    Manual --> PricingCatalog
    DeepSeekTier --> PricingCatalog
    OpenRouterTier --> PricingCatalog
    Chip --> Modal

✨ 核心特性

  1. 增量流式实时计算:在模型打字生成过程中毫秒级更新 Prompt、Completion 和 Cache 费用,无轮询无卡顿。
  2. 两级阶梯电价引擎:支持 DeepSeek 官方高峰时段(UTC 01:00–04:00 与 06:00–10:00)及闲时 50% 优惠折扣自动匹配。
  3. UTC 半小时时隙不可变性:历史消费严格锁定在消耗发生时刻的时隙费率,切换费率不溯及既往。
  4. 服务商智能路由:精准区分直连 DeepSeek 服务商与 OpenRouter 等代理网关。
  5. 多币种与本地化:支持自定义货币符号(¥, $, €, ₽)、汇率换算与显示时区。

📦 快速安装

dsh plugin --profile web add @goodandready/dsh-cost-meter

重启 DeepSeek Harness 实例并刷新浏览器页面。


⚙️ 配置项说明 (settings.yaml)

dsh-cost-meter:
  currency: "¥"
  usdRate: 7.2
  displayTimeZone: "Asia/Shanghai"
  useOpenRouter: true
  prices: {}
  modelMap: {}

配置参数列表

参数项类型默认值说明
currencystring"¥"显示的货币符号或代码
usdRatenumber7.2美元到目标货币的换算汇率
displayTimeZonestring"Asia/Shanghai"界面中优惠时间段显示的参考时区
useOpenRouterbooleantrue是否加载 OpenRouter 价格表作为备用
pricesobject{}自定义每 1M Token 的费率覆盖
modelMapobject{}模型别名映射表

🧪 自动化测试

运行单元测试套件:

npm test

📄 许可证

MIT © GooDAnDReaDY

版本与发布记录

@goodandready/dsh-cost-meter 共发布 51 个版本,首次发布于 2026/09/06;过去 12 个月发布了 51 个版本。

版本发布日期距今
0.8.43latest2026/11/124 天前
0.8.422026/11/097 天前
0.8.412026/11/097 天前
0.8.402026/11/097 天前
0.8.392026/11/098 天前
0.8.382026/11/098 天前

关于 @goodandready/dsh-cost-meter 的常见问题

@goodandready/dsh-cost-meter 是什么?

DeepSeek Harness plugin: a session cost chip in the conversation header - live token usage by bucket, peak/off-peak tariff, and a countdown to the next tariff switch.

如何安装 @goodandready/dsh-cost-meter?

在项目目录运行 npm install @goodandready/dsh-cost-meter,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(^4.0.1)、@deepseek-ai/schemastery(^3.18.1)、@deepseek-ai/dsh-settings(>=0.1.7-rc.2 || >=0.2.0-rc.1)、@deepseek-ai/dsh-host-webserver(>=0.1.7-rc.2 || >=0.2.0-rc.1)、@deepseek-ai/dsh-session-projection(>=0.1.7-rc.2 || >=0.2.0-rc.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 dsh-cost-meter,可以用 npx dsh-cost-meter 直接运行。

@goodandready/dsh-cost-meter 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/goodandready__dsh-cost-meter 是否存在。

@goodandready/dsh-cost-meter 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@goodandready/dsh-cost-meter 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@goodandready/dsh-cost-meter 可以商用吗?

@goodandready/dsh-cost-meter 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@goodandready/dsh-cost-meter 的下载量有多少?

根据 npm 官方下载统计,@goodandready/dsh-cost-meter 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,138 次,日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@goodandready/dsh-cost-meter 还在维护吗?

最新版本 0.8.43 发布于 2026/11/12(4 天前);至今共发布 51 个版本,其中过去 12 个月发布了 51 个;首次发布于 2026/09/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。