@babelize/cli

中文文档
1.3.17发布于 2026/11/02Apache-2.0ES Module近 30 天下载 4152

Babelize AI-powered i18n 平台的官方CLI

中文使用文档
文档目录15 节
  1. 安装
  2. 快开始
  3. 用你自己的 LLM 键,或者在 CI
  4. 快速启动( 平台)
  5. 图标
  6. 贝壳补全
  7. 配置
  8. 环境变量
  9. CI / 非交互模式
  10. 退出代码
  11. JSON 模式
  12. 遥测
  13. 更新通知
  14. 解决问题
  15. 链接

@babelize/ cli (英语)

以贝贝化CLI ——AI-动力i18n平台管理您终端的翻译.

安装

npm install -g @babelize/cli

快开始

在您的工程文件夹中 :

npx babelize        # or: npx @babelize/cli

它检查出价 git init 在您的机器上找到您的框架, i18n 库和源语言, 并在需要时在您签名( GitHub 或 Google 在浏览器中, 或电子邮件和密码), 询问您想要哪种语言( 记得在 .babelize/config.json),然后写出地方文件和i18n代码,以便与 git diff。签名后,不需要 API 密钥: 翻译用 Babelize 信用记账,摘要显示使用了多少.

完成后,添加一个语言切换器(即: https://elements.babelize.co 互联网档案馆的存檔,存档日期2013-12-02,或建立自己的)。 运行 npx babelize 更改后再次:只翻译新文本或已修改文本。 对于拉动请求,请在 https://app.babelize.co (英语) 运行 babelize run start。 。 。 .

没有终端,通过语言: babelize start --to fr,de --yes. (交互式命令菜单现在 babelize shell. ) (中文(简体) )

用你自己的 LLM 键,或者在 CI

babelize translate 是同一地方译名,带有旗帜而不是问题。 使用您自己的 LLM 密钥( 不需要账户) , 您的签名会话, 或 Babelize API 密钥 :

export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, OPENROUTER_API_KEY
npx babelize translate --to fr,de,ja
git diff

或使用 Babelize 托管翻译: 在 https://app.babelize.co/api-keys (英语) (包括自由等级),然后

export BABELIZE_API_KEY=bblz_sk_...
npx babelize translate --to fr,de,ja
  • 框架: React, Next.js (App Router), Django和静态 HTML 支持. Vue和React Independent(Expo和裸体)属于β.
  • 键 : 使用上面顺序中发现的第一个 LLM 键; 无, BABELIZE_API_KEY 选择 Babelize 托管的翻译, 并且没有键入您的签名会话会做( 字符串, 从未编码; 在 Babelize 中计费) 。 再选一个 --provider (单位:千美元)babelize ),或与 --model。 。 。 .
  • 输出 : --json 打印 QA 报告,此报告也写到 .babelize/local/report.json (单位:千美元)--report <path> 移动它。 一些密钥退出失败的运行 6 除非 --allow-partial。 。 。 .
  • 安全性: 需要用一棵干净的工作树来回收--force (原始内容存档于2017-03-25). overse. 如果运行失败,它只能做一个临时的复制件,没有任何触摸. --dry-run 打印 diff 不写.
  • 重运行 : 承诺 .babelize/local/babelize-lock.json 而后运行只翻译出新的或已更改的字符串.

全向导 : https://docs.babelize.co/cli/ translate (中文(简体) )

快速启动( 平台)

# Log in to your Babelize account
babelize auth login

# Initialize a new project
babelize init

# Start a translation run
babelize run start

图标

命令说明
(无命令) 编号 : start在此文件夹中逐个翻译工程( git, sign- in, languages)
translate --to <locales>本地翻译此重播: 已签名, 您自己的 LLM 密钥, 或 BABELIZE_API_KEY (写到工作树上)
check [path]QA 本地端文件( 丢失密钥、 占位符、 ICU、 复数); 出错 1, 用于 CI
shell交互命令菜单
init启动新的 Babelize 项目
auth login 编号 : signup 编号 : logout 编号 : whoami认证管理
auth reset-password发送密码重置电子邮件
auth provider-tokens管理 OAuth 提供者令牌( GitHub等)
status请检查API 健康及您的账户状况
scan [directory]扫描硬编码可转换字符串的本地目录
projectsCRUD,同步,洞察,元数据,下载,品牌语音,存档
run start 编号 : status 编号 : analyze翻译管道引擎(start 支持 --no-poll, (中文(简体) ), --no-pr, (中文(简体) ), --json(中文(简体) )
babels查看翻译工作历史
prGitHub 公关一体化
billing计划、使用、发票
subscriptions列出计划, 显示默认计划和当前计划
checkout购买计划
languages系统和项目一级语言管理,ISO QQ FLORES-200代码转换
members小组成员管理
tm翻译内存(所有者范围,在您的项目中共享:视图、添加、更新、导出为TMX、清晰)
glossary翻译词汇表(列表、添加、更新、删除、导入、导出)
api-keys byokBYOK 提供者密钥( OpenAI、 Anthropic、 Groq等)
api-keys babelizeBabelize API 密钥 (bblz sk MCP/ 外部访问的前缀)
comments翻译评论和讨论
notifications通知收件箱
analytics使用历史、活动记录、审计记录
account外交部、会议、删除账户
privacyGDPR 数据输出和去除
admin平台管理(仅所有者)
invitations团队邀请
roles角色管理
users用户列表

运行 babelize <command> --help 用于子命令细节.

贝壳补全

生成 bash 或 zsh 补全脚本 :

babelize completion bash > /usr/local/etc/bash_completion.d/babelize
babelize completion zsh > /usr/local/share/zsh/site-functions/_babelize

脚本动态地反映了生成时所有已注册的命令.

配置

全权证书和首选权存放于:

  • 马可斯: ~/Library/Preferences/@babelize/cli-nodejs/config.json
  • 林纳: ~/.config/@babelize/cli-nodejs/config.json
  • 窗口 : %APPDATA%\@babelize\cli-nodejs\Config\config.json

API URL按此顺序解决 :

  • --api-url 旗帜 ——每个命令覆盖
  • BABELIZE_API_URL 环境 var - 比如说. http://localhost:3001/api 用于本地 dev
  • 存储配置 —— 由 : babelize auth login --api-url <url> 或“自行托管的”登录选择(包括本地主机 URL) 。 URL只有在您要求时才被存储 .
  • 默认 : https://api.babelize.co/api

环境变量

变量说明
BABELIZE_API_URL覆盖 API URL
BABELIZE_TOKEN认证符( 选项为 babelize auth login 或者说 --token)——建议为CI. 也用于签名翻译
BABELIZE_NON_INTERACTIVE强制非交互模式( N)1 或者说 true(中文(简体) )
CI设定时( 非) "false"),CLI从不提示——缺少旗下退出并出现使用错误
NO_COLOR禁用彩色输出( 任何非空值)
ANTHROPIC_API_KEY, (中文(简体) ), OPENAI_API_KEY, (中文(简体) ), GEMINI_API_KEY, (中文(简体) ), GROQ_API_KEY, (中文(简体) ), OPENROUTER_API_KEY您的 LLM 密钥用于 babelize translate (第一组胜出; --provider 选择)
BABELIZE_API_KEYBabliize API 密钥 (bblz_sk_…),用于主机翻译 babelize start 编号 : babelize translate 当没有设置 LLM 密钥时
BABELIZE_TELEMETRY0 关闭匿名使用数据( e)DO_NOT_TRACK=1 工作也一样。 见 遥测

CI / 非交互模式

CLI是CI安全。 设定 CI=true (大部分管道是自动的),设置 BABELIZE_NON_INTERACTIVE=1,或通过 --non-interactive 编号 : --yes并且CLI 永远不会阻止一个迅速. --yes 也回答“ 是” 到删除等确认; 没有它, 非交互模式的确认失败 退出代码 2数字 :

CI=true babelize run start -p <project-id> -l es,fr --no-poll --json

在非交互模式下,缺少所需的旗帜退出 2 (使用)和可操作的信息而不是提示。 闭塞stdin(非TTY)也被视为非互动.

在 CI 中以符号而不是存储会话认证 :

export BABELIZE_TOKEN=bblz_sk_xxxxxxxx

CI 本地翻译, 设置 BABELIZE_API_KEY (或你自己的 LLM 密钥)并运行 npx babelize start --to fr,de --yes。 。 。 .

见 CI/CD 文档 gitHub 动作秘方.

退出代码

代码含义当它发生时
0成绩命令完成
1内部错误意外失败
2使用错误未知的命令、 不好的旗帜、 缺少或无效的参数( 如 ID) , 或在非交互模式下无法回答的提示
3Auth 错误未登录、 会话已过期、 登录失败、 符号被拒绝
4配置错误无法翻译( 没有密钥且没有签名), 没有支持的工程, 没有本地文件 check
5网络错误API 无法获取, 速度有限, DNS 失败, 超时
6API 错误服务器返回 4xx/5xx; 失败的运行( N)run start, (中文(简体) ), run status --watch(中文(简体) )
128已取消交互提示已取消, 或未完成的运行已取消

已取消的快速退出 128, (中文(简体) ), 永远 0 ——当缺少必要的输入时,管道步骤不能默默地通过.

脚本可以为条件逻辑使用这些代码 :

babelize run start --no-poll || exit_code=$?
if [ $exit_code -eq 3 ]; then
  babelize auth login
fi

JSON 模式

附录 --json 用于机器可读 JSON 输出的命令 。 覆盖率为每 子命令:如果子命令不执行, --json 被忽略 普通可读输出被打印出(例如:. babelize projects list --json 返回 JSON,但有些 members 财务报告和审定财务报表 notifications 子行动不).

与 --json,旋转器和其他进步输出从不触摸出出(错误和 通知会到stderr,所以 babelize --json auth whoami | jq 工作时 当stdout是 不是终点站,旋转器被平板线路所取代.

遥测

CLI发送匿名使用数据:命令,CLI/Node/OS版本,框架,翻译类型,目标地盘,计数以及运行是否成功. 永远不要你的代码,字符串,文件名或账户细节. babelize check 财务报告和审定财务报表 --provider pseudo 发送什么。 通知是第一次打印的.

把它关掉 babelize telemetry disable, (中文(简体) ), BABELIZE_TELEMETRY=0 或者说 DO_NOT_TRACK=1细节 : docs.babelize.co/cli/遥测。 。 。 .

更新通知

CLI每会话检查 npm 注册一次新版本(非屏蔽). 更新:

npm update -g @babelize/cli

解决问题

问题解决方案
Not authenticated运行 babelize auth login
Directory not found 打开 scan确保路径存在并且是一个目录
EPERM 安装时使用 sudo npm install -g @babelize/cli
完成不工作确保脚本来源: source /usr/local/etc/bash_completion.d/babelize
费率有限等60秒再试
BABELIZE_API_URL 没有被尊重运行命令前, 要确保 env var 设置

版本与发布记录

@babelize/cli 共发布 41 个版本,首次发布于 2026/07/02;过去 12 个月发布了 41 个版本。

版本发布日期距今
1.3.17latest2026/11/025 天前
1.3.162026/11/016 天前
1.3.152026/11/016 天前
1.3.142026/11/016 天前
1.3.132026/11/016 天前
1.3.122026/11/016 天前

关于 @babelize/cli 的常见问题

@babelize/cli 是什么?

Babelize AI-powered i18n 平台的官方CLI

如何安装 @babelize/cli?

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

@babelize/cli 支持 TypeScript 吗?

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

@babelize/cli 支持 ESM 还是 CommonJS?

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

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

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

@babelize/cli 可以商用吗?

@babelize/cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

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

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

@babelize/cli 还在维护吗?

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