# @fluid-app/fluid-cli-billing 中文文档

规范地址：https://npmcn.com/package/%40fluid-app/fluid-cli-billing/

版本：0\.1\.671
npm 元数据更新时间：2026-11-15T00:20:09.228Z
中文译文更新时间：2026-11-15T01:37:44.766Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40fluid-app/fluid-cli-billing
原文对照：https://npmcn.com/package/%40fluid-app/fluid-cli-billing/?lang=original

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

- 包体积（解压后）：128 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：3 个
- 首次发布：2026-10-10T05:03:58.562Z
- 最新版本发布：2026-11-15T00:20:09.032Z
- 近 30 天下载量：131840（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：673（近 12 个月 673 个）

## 中文简介

用于公司账单的流体CLI插件——发票、付款、信贷和支出限额

## 安装

```sh
npm install @fluid-app/fluid-cli-billing
```

也可以使用：`pnpm add @fluid-app/fluid-cli-billing`、`yarn add @fluid-app/fluid-cli-billing`、`bun add @fluid-app/fluid-cli-billing`

## README

# @fluid-app/fluid-cli-billing (英语)

用于公司账单的流体CLI插件:发票、付款、信贷和支出 限制.

```bash
npm install -g @fluid-app/fluid-cli @fluid-app/fluid-cli-billing
fluid login
fluid billing show                              # invoices, upcoming charge, payment method
fluid billing update --email ap@example.com --yes
fluid billing standing
fluid billing payments --limit 20
fluid billing payments invoice 512 --open       # fresh Stripe link; they expire
fluid billing documents
fluid billing documents link 409 --open
fluid billing credits                           # balance, plan, prices
fluid billing credits quote 1000                # whole dollars
fluid billing credits buy 1000 --yes            # spends real money
fluid billing credits purchases
fluid billing credits movements --limit 50
fluid billing credits pay-now --yes             # spends real money
fluid billing credits plan growth --interval annual --yes
fluid billing limits
fluid billing limits set --limits on --ai-monthly 1500 --ai-daily 100 --yes
fluid billing usage record --sku sms_send --quantity 42 --dedup-key batch-7 --yes
```

每个命令打印 JSON; 金额是 API 的整数分数, 如它发送的 他们。 打印 JSON 失败 `error` (和API's `code`,例如 `quote_changed`)在Stderr上并退出非零. 任何改变账单或 保存的支付方法要求确认或需要 `--yes` 何时 没有终点站. `buy` 财务报告和审定财务报表 `pay-now` 显示引用的总额, 纸牌费 (a) 在该问题中列入; `buy` 将引号发回服务器拒绝 如果价格、条件或支付方法发生变化. `credits plan` 询问与 每月总计划从1号收费,按流利价格计价 (目录或选定的价格、年折扣和卡费),以及 当它不能给选择定价时 什么都改变不了 月费寄出 并显示总计,所以如果另一个管理员改变计划,或者保存 支付方法变成卡,同时服务器拒绝选择 (单位:千美元)`code: "plan_charge_changed"`)而一无所救. 虽然保存的卡片型号仍在检查中,但无法制定计划 所选(`code: "card_funding_pending"`);再试几分钟. 如果有的话 `buy` 没有失败 明确答案, 重试 `--purchase-key` 打印而不是购买 再来一次.

`buy` 财务报告和审定财务报表 `pay-now` 打印返回的 API 购买 。 API 答案 所以CLI读到它的 `status`。 。 。 . 除了成功或未完成的打印之外 任何其他结果 stderr 上的错误 `charge_status` (单位:千美元) `code`,并退出非零: `charge_declined` 页:1 `failed` (随着下降) `reason` 当花纹给 一个, `charge_refunded` 页:1 `refunded`, (中文(简体) ), `charge_reversed` 页:1 `reversed`,以及 `charge_<status>` 为任何其他地位(`charge_unknown` 当没有的时候, A 类 `pending` 或者说 `processing` 收费(银行借项约需4个工作日) `pending: true` 和一张纸条; `fluid billing credits purchases` 显示 稍后结果.

`--open` 只打开 Stale https 链接(主机发票页面和 发票和信用证PDF). `opened` 实值 `true` 一旦系统打开器 完成干净, `"attempted"` 如果它还在运行 几秒钟后, 财务报告和审定财务报表 `false` 带有 `open_error` 当没有打开器( 无头框) 无 `xdg-open`,说)或失败;链接是任意打印的.

## 需要的图标 `fluid login`

更改记录谁做他们需要一个登录用户。 公司(`C-`(中文(简体) ) 即使其作用是 `billing.update`数字 :

-   `fluid billing credits buy`
-   `fluid billing credits pay-now`
-   `fluid billing credits plan`
-   `fluid billing limits set`

运行 `fluid login` 作为他们的管理者 阅读账单,信用, 限制、支付和文件与公司标志有关,公司标志的作用是: `billing.view`。 。 。 .

数额参数和旗帜为美元(`1000`, (中文(简体) ), `19.99`) (中文(简体) ). 采购和 自动重载阈值和金额必须是整美元.

支出限制:AI限制在到达后停止新的AI工作;命令和托管 限制只通知; 工作室限制被记录和通知,但没有执行. 转动 `--auto-reload on` 接受它打印的重装授权.

`usage record` 需求 `billing.create_usage` 和公司经理或 公司自己的代币; Droplet代币被拒绝, 和雾AI的使用报告 转而通过雾.

设置新卡或银行账户需要浏览器在管理员中流出; `fluid billing instrument <bank-account-id>` 只有切换回银行 已获得ACH授权的账户.

## 常见问题

### @fluid-app/fluid-cli-billing 是什么？

用于公司账单的流体CLI插件——发票、付款、信贷和支出限额

### 如何安装 @fluid-app/fluid-cli-billing？

在项目目录运行 npm install @fluid-app/fluid-cli-billing，或使用 pnpm add / yarn add / bun add。

### @fluid-app/fluid-cli-billing 支持 TypeScript 吗？

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

### @fluid-app/fluid-cli-billing 支持 ESM 还是 CommonJS？

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

### @fluid-app/fluid-cli-billing 需要什么版本的 Node\.js？

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

### @fluid-app/fluid-cli-billing 可以商用吗？

@fluid-app/fluid-cli-billing 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @fluid-app/fluid-cli-billing 的下载量有多少？

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

### @fluid-app/fluid-cli-billing 还在维护吗？

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