@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] | 扫描硬编码可转换字符串的本地目录 |
projects | CRUD,同步,洞察,元数据,下载,品牌语音,存档 |
run start 编号 : status 编号 : analyze | 翻译管道引擎(start 支持 --no-poll, (中文(简体) ), --no-pr, (中文(简体) ), --json(中文(简体) ) |
babels | 查看翻译工作历史 |
pr | GitHub 公关一体化 |
billing | 计划、使用、发票 |
subscriptions | 列出计划, 显示默认计划和当前计划 |
checkout | 购买计划 |
languages | 系统和项目一级语言管理,ISO QQ FLORES-200代码转换 |
members | 小组成员管理 |
tm | 翻译内存(所有者范围,在您的项目中共享:视图、添加、更新、导出为TMX、清晰) |
glossary | 翻译词汇表(列表、添加、更新、删除、导入、导出) |
api-keys byok | BYOK 提供者密钥( OpenAI、 Anthropic、 Groq等) |
api-keys babelize | Babelize API 密钥 (bblz sk MCP/ 外部访问的前缀) |
comments | 翻译评论和讨论 |
notifications | 通知收件箱 |
analytics | 使用历史、活动记录、审计记录 |
account | 外交部、会议、删除账户 |
privacy | GDPR 数据输出和去除 |
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_KEY | Babliize API 密钥 (bblz_sk_…),用于主机翻译 babelize start 编号 : babelize translate 当没有设置 LLM 密钥时 |
BABELIZE_TELEMETRY | 0 关闭匿名使用数据( 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) , 或在非交互模式下无法回答的提示 |
3 | Auth 错误 | 未登录、 会话已过期、 登录失败、 符号被拒绝 |
4 | 配置错误 | 无法翻译( 没有密钥且没有签名), 没有支持的工程, 没有本地文件 check |
5 | 网络错误 | API 无法获取, 速度有限, DNS 失败, 超时 |
6 | API 错误 | 服务器返回 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 设置 |