@b4run/cli

中文文档
0.15.8发布于 2026/10/31MITTypeScriptES Module构建来源已验证近 30 天下载 4221

B4.run应用程序的指令行开发,测试,构建和运行时间工具.

中文使用文档
文档目录8 节
  1. 安装
  2. 示例
  3. 运行时间和稳定性
  4. 用法报告
  5. 相关
  6. 成熟和支持
  7. 许可证
  8. 共享 Postgres 执行

B4.run

@b4run/ cli (英语)

B4.run应用程序的命令行开发工具和运行时间嵌入切入点.

当 : 您正在开发,检查,测试, 建造,服务, 或嵌入 B4 运行时间.

The B4.run navlog demo: a VFR flight plan with its navlog sheet in the Workbench. Opens the demo video.
观察50秒的导航演示

安装

需要节点.js 24或后. create-b4-app 将 CLI 添加到您的新应用程序中 。 要添加到已有的应用程序中, 将它安装为常规依赖, 而不是 dev 依赖, 因为服务器 b4 build 出口进口 @b4run/cli 运行时间 :

npm install @b4run/cli

示例

运行本地 b4 二进制通过 npx 或一个 package.json 脚本 :

npx b4 dev
npx b4 check
npx b4 test
npx b4 build
命令它会做什么
b4 dev启动本地开发运行时间, 启动热重装 127.0.0.1。 。 。 .
b4 check验证应用程序的结构和配置.
b4 verify在运行或部署前检查应用程序、路由、生成的类型、依赖性、提供者密钥和节点版本.
b4 typegen重生成路由和工具类型 .b4/。 。 。 .
b4 test运行应用程序的同地位置 run.test.ts 路由设置。 开始者 npm test 运行vitest代替.
b4 build生成部署文物:一个节点服务器,Dockerfile和LangSmith配置默认.
b4 start在制作中为应用程序服务,在 0.0.0.0:8000 默认.
b4 docs打印装有 CLI 的 B4. 运行文件 .

这个 CLI 指南 列出每个命令和旗帜.

b4 start 为应用程序服务时没有自己的代码。 要让应用程序代码拥有生产节点收听器, 导入 serveRuntime 从软件包根 :

import { serveRuntime } from "@b4run/cli"

const runtime = await serveRuntime({
  appRoot: process.cwd(),
  host: "0.0.0.0",
  port: 8000,
})

console.log(runtime.url)
// Call await runtime.close() during your host's ordered shutdown.

运行时间和稳定性

  • @b4run/cli 联 合 国 b4 命令被支持的只有节点应用程序和工具表面.
  • @b4run/cli/fetch 是一个支持的边缘安全集成表面,用于生成抓取部署.
  • @b4run/cli/runtime 只有节点和低级.
  • @b4run/cli/workspace 是节点和低级:一个主机进程的管理-工作空间生命周期,没有命令程序.
  • @b4run/cli/testing 是一个已贬值的、只与节点相匹配的、仅与节点相匹配的别名 @b4run/sdk/testing;它仍然只支持现有的进口,新的情景代码应当使用SDK子路径.

serveRuntime() 启动一次, 不在启动时查看文件或运行类型生成 。 使用 b4 dev 用于开发监视器和生成类型.

用法报告

开发时间命令( :dev, (中文(简体) ), build, (中文(简体) ), add, (中文(简体) ), check, (中文(简体) ), typegen, (中文(简体) ), verify, (中文(简体) ), eval)在完成时报告一个匿名使用信号:命令名,CLI版本,节点主版本,操作系统,结果,粗长桶,失败时错误分类. b4 dev 还报告一个激活信号,这是AG-UI第一次在会话中运行完成,只携带CLI版本和路由类型. b4 start,运行时间软件包,以及 create-b4-app 永远不要报告, 没有任何关于你的路线,模型,提示,路径, 或身份。 第一个报告命令会打印一次性通知来打印 Stderr , 并在 ~/.b4/usage-id. CI 和主机的构建环境( GitHub Actions, Vercel, Render, Cloudflare Pages等) 自动无声; 见 b4. 运行/空闲 详细情况.

变量效果
B4_TELEMETRY_DISABLED=1关闭用户报告.
DO_NOT_TRACK=1关闭用户报告.
B4_SIGNALS_URL覆盖张贴到的 URL 信号 .

B4_SIGNALS_URL 在启动时从 shell 环境读取, 从未从工程读取 .env。两个选择退出变量在事发前就从壳中以及从一个项目中被尊重 .env 每次发送; 项目 .env 命令启动后加载, 因此在第一个运行时, id 文件和通知仍然可以在生效前出现 .

成熟和支持

B4.run为1.0前置,其公用地表可以改变. 所有可公布的 B4. 运行包作为一个固定组一起发布; 审查 @b4run/cli 更改日志 财务报告和审定财务报表 升级指南 升级前。 用于支持, 使用 GitHub 讨论; 报告缺陷 GitHub 问题。 。 。 .

许可证

麻省理工学院. 见 仓库许可证。 。 。 .

共享 Postgres 执行

生成Vercel和Hono Postgres 部署协调 管理所有性 实例。 另一个执行同一线程的请求收到 HTTP 409 run_in_flight 与 Retry-After: 1; 浏览器工具续作维持不变 属性边界,同时接受结果并恢复图表。 成功 终端事件在最终写作和所有权发布后发送, 所以客户端 可以立即提交下一个回合.

对于自定义取入嵌入器,请提供一种 RequestStores.runAdmission 每个请求 并建造其检查站、线程、许可和客户端工具商店 入住所入有栅栏池. 见 Postgres 存储包 用于API和交易限制。 单凭共享耐用商店并不能 协调执行; 默认的记忆内注册为本地到一个处理器. 这并不会添加分布式AP取消或完全即时的外部工具效果.

版本与发布记录

@b4run/cli 共发布 23 个版本,首次发布于 2026/09/09;过去 12 个月发布了 23 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.15.8latest2026/10/317 天前
0.15.72026/10/2810 天前
0.15.52026/10/2712 天前
0.15.42026/10/2612 天前
0.15.22026/10/2514 天前
0.15.12026/10/2414 天前

关于 @b4run/cli 的常见问题

@b4run/cli 是什么?

B4.run应用程序的指令行开发,测试,构建和运行时间工具.

如何安装 @b4run/cli?

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

@b4run/cli 支持 TypeScript 吗?

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

@b4run/cli 支持 ESM 还是 CommonJS?

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

@b4run/cli 需要什么版本的 Node.js?

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

@b4run/cli 可以商用吗?

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

@b4run/cli 的下载量有多少?

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

@b4run/cli 还在维护吗?

最新版本 0.15.8 发布于 2026/10/31(7 天前);至今共发布 23 个版本,其中过去 12 个月发布了 23 个;首次发布于 2026/09/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。