# @agentpos/measure 中文文档

规范地址：https://npmcn.com/package/%40agentpos/measure/

版本：0\.1\.5
npm 元数据更新时间：2026-10-29T15:44:15.424Z
中文译文更新时间：2026-11-08T01:06:51.457Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40agentpos/measure
原文对照：https://npmcn.com/package/%40agentpos/measure/?lang=original
项目主页：https://agentposhq.com/
源码仓库：https://github.com/NovaCorpAI/agentpos

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

- 包体积（解压后）：68.5 kB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.5
- 运行依赖：0 个
- 首次发布：2026-10-26T21:01:59.029Z
- 最新版本发布：2026-10-29T15:44:07.545Z
- 近 30 天下载量：1950（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

AgentPOS的用法测量:每个模型调用一个用法 事件行,带有符号,耐用性,以美元微分表示的整数成本及其运行的痕迹. 价格表作为配置, CSV 导出和读取器.

## 安装

```sh
npm install @agentpos/measure
```

也可以使用：`pnpm add @agentpos/measure`、`yarn add @agentpos/measure`、`bun add @agentpos/measure`

## README

# @ agentpos/ 计量

一个 `usage_events` 每个模型调用一行: 代号,如提供商所报告, 时间,模型, 美元微观单位的整数成本和 `traceId` 运行。 价格是配置,不是代码.

为什么它存在: AgentPOS 销售辅助设置和托管的购买代理,直到这个包 后面也没有号码 一个模型的呼叫,没有人衡量 是一个代价,没有人可以解释 等会.

```ts
import {
  MemoryUsageEventsRepo,
  measured,
  loadPriceTable,
  usageEventsToCsv,
} from "@agentpos/measure";

const repo = new MemoryUsageEventsRepo(); // SqliteUsageEventsRepo(path) in production
const ctx = { repo, prices: loadPriceTable() };

const { value } = await measured(
  ctx,
  {
    traceId: "scan-7f3",
    stage: "extract",
    provider: "anthropic",
    modelId: "claude-opus-5",
    simulated: false,
  },
  async () => {
    const result = await callTheModel();
    return { value: result, usage: { inputTokens: 1_200, outputTokens: 340 } };
  },
);

console.log(usageEventsToCsv(repo.list()));
```

在此寄存器中,您通常想要的包装是 `measuredLlm` 从 `@agentpos/core`,哪个 将上述内容适用于任何 `LlmProvider`。 。 。 .

## 它的保证

-   **一个失败的呼叫也是一行.** `measured` 写入 `outcome: "error"` 错误的代码和 重新删除未更改的错误 。 失败的尝试是真正的花费.
-   **入入灭相.** 价格在装货时一次折算为每百万令牌美元微分; 之后的每一个成本都是整数算术, 整数为整数的一半。 没有 浮起触取出钱来.
-   **未知的模型是可见的,而不是免费的.** 价格表中缺少的模型 成本为 0 `costKnown: false`,所以它显示为未知 而不是隐藏为0.
-   **`simulated` 是写着的,从不推断.** 一行从记录固定说.
-   **一个畸形的物价表响亮地失败了.** 忽略 `MODEL_PRICES_JSON` 将公布数字 价格不对,所以价值差 `MEASURE_INVALID_PRICE_TABLE` 换句话说.

## 价格

`MODEL_PRICES_JSON` 内置 JSON 或 JSON 文件路径, 单位为每百万个令牌美元 :

```json
{ "claude-opus-5": { "inputPerMillionUsd": 5, "outputPerMillionUsd": 25 } }
```

`cacheReadPerMillionUsd` 财务报告和审定财务报表 `cacheWritePerMillionUsd` 可选和默认输入 因此,未经核实的缓存折扣绝不能使运行看起来比以前便宜.

内置默认涵盖推理买方使用的Nemotron模型,并且是 **二手笔 和未经证实**:对照提供者的操纵台检查,并记录出版前的日期 任何来自他们的数字.

## 存储

在存储适配器的后面,寄存器已经使用: `MemoryUsageEventsRepo` 测试, `SqliteUsageEventsRepo` (单位:千美元)`node:sqlite`,无本地依赖性)用于跑步. 打开 SQLite 适配器应用自己的DDL,所以没有迁移步骤.

`usageEventsToCsv` 财务报告和审定财务报表 `csvToUsageEvents` 绕行桌来回,这样一个承诺的CSV就可以重建 每一个数字 READEME 或赠款报告引用.

## 与兄弟般的寄存器共享

同一个表格存在于 `agentpos-alexa` 财务报告和审定财务报表 `agentpos-doorstep`,并首先为 推理买方(`agentpos-buyer`) (中文(简体) ). 这包是四个消耗的单一执行, 所以四个报告的数字是相同的。 舞台是封闭的结合:新消费者将自己加入 `UsageStage` 而不是传递一个字符串.

## 常见问题

### @agentpos/measure 是什么？

AgentPOS的用法测量:每个模型调用一个用法 事件行,带有符号,耐用性,以美元微分表示的整数成本及其运行的痕迹\. 价格表作为配置, CSV 导出和读取器\.

### 如何安装 @agentpos/measure？

在项目目录运行 npm install @agentpos/measure，或使用 pnpm add / yarn add / bun add。

### @agentpos/measure 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agentpos/measure 支持 ESM 还是 CommonJS？

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

### @agentpos/measure 需要什么版本的 Node\.js？

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

### @agentpos/measure 可以商用吗？

@agentpos/measure 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @agentpos/measure 的下载量有多少？

根据 npm 官方下载统计，@agentpos/measure 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,950 次，日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agentpos/measure 还在维护吗？

最新版本 0\.1\.5 发布于 2026/10/29（9 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。