# @envarai/envarpay 中文文档

规范地址：https://npmcn.com/package/%40envarai/envarpay/

版本：2026\.1108\.2
npm 元数据更新时间：2026-11-07T19:11:14.848Z
中文译文更新时间：2026-11-14T06:27:06.265Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40envarai/envarpay
原文对照：https://npmcn.com/package/%40envarai/envarpay/?lang=original
项目主页：https://github.com/EnvarAI/EnvarPay#readme
源码仓库：https://github.com/EnvarAI/EnvarPay

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

- 包体积（解压后）：45.3 MB，8155 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.14\.0
- 运行依赖：9 个
- 首次发布：2026-10-02T02:39:56.642Z
- 最新版本发布：2026-11-07T19:11:14.425Z
- 近 30 天下载量：2252（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

免费A2A服务和Envar账户余额销售门

## 安装

```sh
npm install @envarai/envarpay
```

也可以使用：`pnpm add @envarai/envarpay`、`yarn add @envarai/envarpay`、`bun add @envarai/envarpay`

## README

# @envarai/envarpay (英语)

当前 TypeScript 包服务免费的 A2A 能力并验证 Envar 已付款服务账户余额索赔。 它不签署买方付款. 以Envarpay命名的 Python 分布 [mCP/x402执行](https://github.com/EnvarAI/EnvarPay/blob/main/docs/legacy/python.md)。 。 。 .

## 尝试本地免费服务

从安装此软件包的目录中 :

```sh
node "$(npm root)/@envarai/envarpay/examples/local-free-service/demo.mjs"
```

从此源目录 :

```sh
npm ci --ignore-scripts
npm run build
node examples/local-free-service/demo.mjs
```

演示不需要Envar帐户,集成证书或付款. 它创造了 两个回回A2A服务和私有 SQLite 状态,然后验证一个正本 任务/ 结果交叉重放并重新启动 。 预期能力 执行: 1, 已支付操作: 0并匹配任务 id, 重放 task id, 重新启动 get task id 并重新启动 replay task id 。 这是一个决定性合同的例子,而不是AI 推断或飞行中恢复原生处决.

[完整的本地指南](https://github.com/EnvarAI/EnvarPay/blob/main/docs/local-free-service.md) • 妇女 [云商业指南](https://envar.ai/guide/commerce)

## 本地代理连接

新设施使用情况 [`@envarai/connect`](https://github.com/EnvarAI/EnvarConnect) 编辑 `envar-connect` 命令。 此软件包将命令保存在下方和 `@envarai/envarpay/connector` 通过其被绑定的连接依赖导出为相容性条目。 两者都使用现有的 `~/.envarpay/connectors/AGENT_UUID` ; 在切换命令前停止当前接收器.

从Envar的设置页面复制特工特定命令. 运行它与现有的Hermes/OpenClaw进程相同用户,然后批准浏览器中的打印短码:

```sh
envarpay connector connect --agent AGENT_UUID --framework hermes
envarpay connector run --agent AGENT_UUID
```

选择 `--framework openclaw` 为OpenClaw服务. 当本地配置文件有多个代理时, 添加 `--native-agent ID`启用 `--home PATH` 特定简介。 设置会保存提供者证书,不相关的同级/工具以及私人备份;它会打印现有的网关是否需要重启. 正常接收需要只输出出HTTPS.

对于正式的Hermes Docker图像,请使用 `docker exec --user hermes -e HOME=/opt/data -it CONTAINER sh`。对于官方 OpenClaw 图像使用 `docker exec --user node -e HOME=/home/node -it CONTAINER sh`。在该 shell 内安装和运行连接器;其私人文件必须保持为同一本地运行时间用户所访问.

```sh
envarpay connector doctor --agent AGENT_UUID
envarpay connector status --agent AGENT_UUID
envarpay connector disconnect --agent AGENT_UUID
```

已安装的本地 MCP 工具发送免费任务,以明确允许收件人并获取原始结果. 他们还发现了文本工作流程服务,创建了原始引文并仅在单独所有者核准的服务预算下确认购买. 他们不允许全账户的钱包访问。 Connector杂志声称,承认,本土任务参考和待报. 丢失的本地启动响应仍然未知, 而且永远不会自动重新提交 。 恢复时保留原始的私人目录 .

在Envar断开后,停止旧接收器并运行原机 `connect` 命令为 `--new-pairing`,然后批准新的代码。 当地 `disconnect` 已经做了下一个 `connect` 请重新批准。 旧日记仍然完好无损. 这是一种新的连接,而不是恢复以前承认的工作.

## 现有公共A2A销售商

高级设置继续接受 `envarpay setup --file /private/path/envar-setup.json`它创建了原来的卖方大门和 `connection.json` 一个公开的A2A终点。 它所安装的Skill服务在本土行刑前验证了最初的Envar平衡令. 这个路径的公用HTTPS和Skill-selection要求与本地收件箱分开.

## 手工销售命令

```sh
envarpay init --directory /private/envarpay
envarpay validate --config /private/envarpay/seller.json
envarpay card --config /private/envarpay/seller.json --service SERVICE --offer OFFER --origin https://seller.example
envarpay serve --config /private/envarpay/seller.json --credentials /private/envarpay/credentials.json --state /private/envarpay/seller.sqlite3 --origin https://seller.example --envar-config /private/envarpay/envar.json --envar-credentials /private/envarpay/envar.token
envarpay inspect --state /private/envarpay/seller.sqlite3
```

`init` 创建一个样品销售商配置和金库钥匙;它不授权支付工作。 只将秘密放入只包含所有者的文件( E)`chmod 600`),保留国家目录的私密性,每个分类账使用一个运行的过程. 运行时间验证了配置的服务修改,原始的A2A Task和一份在给私人代理打电话之前捕获了Envar的余额索赔. 它存储了原始索赔和"任务"手柄,这样就能够不收两次费就收回丢失的响应.

销售者配置方案 [`schemas/envarpay.config.schema.json`](https://npmcn.com/package/%40envarai/envarpay/schemas/envarpay.config.schema.json)。支付金额为整数 **微额** (单位:千美元)`100000` =0.10美元;免费报价没有付款情况。 一个 `envar_balance` 配置文件只包含 `{ "adapter": "envar_balance", "currency": "usd", "accountRef": "envar" }`私人恩瓦尔政策必须允许这种确切的账户参考.

为了发展,运行 `npm ci --ignore-scripts`, (中文(简体) ), `npm run build`,以及 `npm test` 从此目录。 需要22.14+节点;建议24号节点.

## 代理服务订单

需要同伴Envar商业部署. `list_services` 返回准确公布的修订和价格. `quote_service` 创建一个原引号,而不执行或支付。 保留其请求的UUID;用同样的UUID和输入回收丢失的响应. `list_orders` 重启后恢复特工坚持引用/命令.

店主为这名代理创造恩瓦尔支出赠款 确切的服务修改 订单和总额 到期. `list_spending_grants` 只读了这位探员的赠款. `confirm_order` 保留该赠款下的原始数额;没有赠款,它就返回第一当事方链接,以确认同一报价。 卖家招生一次. 使用 `wait_order`编号 :`get_order` 和原始工作身份证,直到实际结果到达为止. `recover_order` 无法创建替换购买。 没有上调、提款、商业或账户管理工具.

更新软件包会更改本地的 MCP 工具集 。 重新运行原连接命令并遵循其网关重启指导;即使MCP可执行路径保持不变,设置也会检测到软件包的版本变化.

## 常见问题

### @envarai/envarpay 是什么？

免费A2A服务和Envar账户余额销售门

### 如何安装 @envarai/envarpay？

在项目目录运行 npm install @envarai/envarpay，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 envarpay，可以用 npx envarpay 直接运行。

### @envarai/envarpay 支持 TypeScript 吗？

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

### @envarai/envarpay 支持 ESM 还是 CommonJS？

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

### @envarai/envarpay 需要什么版本的 Node\.js？

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

### @envarai/envarpay 可以商用吗？

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

### @envarai/envarpay 的下载量有多少？

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

### @envarai/envarpay 还在维护吗？

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