# @braintrust/bt 中文文档

规范地址：https://npmcn.com/package/%40braintrust/bt/

版本：0\.29\.0
npm 元数据更新时间：2026-11-04T16:09:01.313Z
中文译文更新时间：2026-11-08T13:55:44.654Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：30.6 kB，7 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-09-24T18:44:15.420Z
- 最新版本发布：2026-11-04T16:09:00.881Z
- 近 30 天下载量：5945（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

Braintust 命令行接口

## 安装

```sh
npm install @braintrust/bt
```

也可以使用：`pnpm add @braintrust/bt`、`yarn add @braintrust/bt`、`bun add @braintrust/bt`

## README

# 人才信任中心(CLI)`bt`(中文(简体) )

在全球安装CLI:

```bash
npm install -g @braintrust/bt
bt --version
```

或者把它加到一个项目上:

```bash
npm install --save-dev @braintrust/bt
npx bt --help
```

在不添加项目依赖性的情况下运行 :

```bash
npx @braintrust/bt --help
```

使用 `@braintrust/bt@<version>` 以选择特定的稳定 CLI 释放. CLI 与 `braintrust` JavaScript SDK (英语). 见 [CLI 文档](https://github.com/braintrustdata/bt#readme) 用于命令和配置.

## 安装行为

软件包安装匹配 `@braintrust/bt-*` 二进制作为可选依赖. 预建二进制可供macOS arm64/x64,Linux glibc arm64/x64,Linux musl x64,和Windows arm64/x64使用. `bt eval` 目前只支持Linux和macOS.

如果省略了可选的依赖性,后置脚本试图从公共 npm 注册中下载匹配的二进制. 倒置后二进制通过SHA-256检查和验证,在安装之前与这个包一起装运. 下载,校验和,以及文件写入失败 安装失败,使用非零退出代码. 不支持的平台和缺失的放出元数据也安装失败. 如果引用时没有二进制可用, 发射台会报告错误 . 当安装脚本被禁用时,CLI必须安装可选的依赖性才能工作.

| 可选依赖关系 | 安装脚本 | 结果 |
| --- | --- | --- |
| 已启用 | 已启用 | 使用平台软件包;不进行倒计时下载. |
| 已启用 | 已禁用 | 使用平台软件包. |
| 已禁用 | 已启用 | 下载并验证倒计时二进制 . |
| 已禁用 | 已禁用 | 安装成功, 但正在运行 `bt` 报告缺少的二进制. |

如果这两个特性都禁用,则重新安装 `npm install --include=optional @braintrust/bt` (编) `--global` 全球安装. 在操作系统或架构之间移动项目时, 重新安装对目的地的依赖, 而不是复制 `node_modules`。 。 。 .

发射器和安装器保留了JavaScript SDK的两个相容性覆盖:

-   `BT_BINARY_PATH` 选择一个已有的可执行文件,而不是被打包的二进制,并跳过邮购下载.
-   `BT_SKIP_DOWNLOAD=1` 禁用邮站倒置下载 .

这些在本地CLI运行前适用;本地CLI配置仍然通过其旗帜和环境变量提供.

## 更新和卸载

更新全局安装 :

```bash
npm install -g @braintrust/bt@latest
```

项目安装,使用 `npm install --save-dev @braintrust/bt@latest`。 。 。 . 使用 npm来更新 npm 安装; `bt update` 用于正式安装装置.

在全球卸载 `npm uninstall -g @braintrust/bt`,或来自与 `npm uninstall @braintrust/bt`。 。 。 .

## 常见问题

### @braintrust/bt 是什么？

Braintust 命令行接口

### 如何安装 @braintrust/bt？

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

### @braintrust/bt 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/braintrust\_\_bt 是否存在。

### @braintrust/bt 可以商用吗？

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

### @braintrust/bt 的下载量有多少？

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

### @braintrust/bt 还在维护吗？

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