# @goodandready/dsh-cost-meter 中文文档

规范地址：https://npmcn.com/package/%40goodandready/dsh-cost-meter/

版本：0\.8\.43
npm 元数据更新时间：2026-11-12T11:06:43.904Z
中文译文更新时间：2026-11-16T19:12:33.111Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40goodandready/dsh-cost-meter
原文对照：https://npmcn.com/package/%40goodandready/dsh-cost-meter/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：397 kB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：1 个
- 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
- 首次发布：2026-09-05T16:00:52.316Z
- 最新版本发布：2026-11-12T11:06:43.702Z
- 近 30 天下载量：5138（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：51（近 12 个月 51 个）

## 中文简介

DeepSeek Harness插件:对话头中一个会话成本芯片 - 按桶进行活的代币使用,峰值/峰值关税,再倒计时到下个关税开关.

## 安装

```sh
npm install @goodandready/dsh-cost-meter
```

也可以使用：`pnpm add @goodandready/dsh-cost-meter`、`yarn add @goodandready/dsh-cost-meter`、`bun add @goodandready/dsh-cost-meter`

## README

# 📦 @goodandready/dsh-cost-meter

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

[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-cost-meter.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b)](https://www.npmjs.com/package/@goodandready/dsh-cost-meter) [![license](https://img.shields.io/github/license/GooDAnDReaDY/dsh-cost-meter.svg?style=for-the-badge&color=10b981&labelColor=064e3b)](https://npmcn.com/package/%40goodandready/LICENSE) [![DSH Plugin](https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065)](https://github.com/topics/dsh-plugin) [![Node version](https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03)](https://nodejs.org/)

[![所有项目](https://img.shields.io/badge/%E4%BD%9C%E8%80%85%E6%89%80%E6%9C%89%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e)](https://goodandready.app/)

[**🇬🇧 English**](https://npmcn.com/package/%40goodandready/dsh-cost-meter/README.md) • [**🇷🇺 Русский**](https://npmcn.com/package/%40goodandready/dsh-cost-meter/README.ru.md) • [**🇨🇳 中文说明**](https://npmcn.com/package/%40goodandready/dsh-cost-meter/README.zh.md)

<table><tbody><tr><td align="center">⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。<br><br>🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。</td></tr></tbody></table>

* * *

## ⚡ 概述与核心痛点

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

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

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

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

* * *

## 🏛️ 架构设计

```mermaid
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.  **多币种与本地化**：支持自定义货币符号（`¥`, `$`, `€`, `₽`）、汇率换算与显示时区。

* * *

## 📦 快速安装

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

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

* * *

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

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

### 配置参数列表

| 参数项 | 类型 | 默认值 | 说明 |
| :-- | :-- | :-- | :-- |
| `currency` | `string` | `"¥"` | 显示的货币符号或代码 |
| `usdRate` | `number` | `7.2` | 美元到目标货币的换算汇率 |
| `displayTimeZone` | `string` | `"Asia/Shanghai"` | 界面中优惠时间段显示的参考时区 |
| `useOpenRouter` | `boolean` | `true` | 是否加载 OpenRouter 价格表作为备用 |
| `prices` | `object` | `{}` | 自定义每 1M Token 的费率覆盖 |
| `modelMap` | `object` | `{}` | 模型别名映射表 |

* * *

## 🧪 自动化测试

运行单元测试套件：

```bash
npm test
```

* * *

## 📄 许可证

MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

## 常见问题

### @goodandready/dsh-cost-meter 是什么？

DeepSeek Harness插件:对话头中一个会话成本芯片 - 按桶进行活的代币使用,峰值/峰值关税,再倒计时到下个关税开关\.

### 如何安装 @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 和提交记录判断。

