跳到正文
跳到正文

文档

配置 verbatra,让每个语言环境保持同步。

CLI、SDK、Studio 和 MCP 服务器的指南与参考:从快速上手开始,或者让你的编码智能体来配置 verbatra。

从你的目标开始

选择你要做的事;每张卡片都会打开对应的页面。

选择技术栈

标有“快速上手”的卡片会打开该技术栈的分步指南;其他卡片会打开它的 init 命令和文件布局。

每次运行都是差异比对,而不是重写。

运行 verbatra translate 时会发生什么。

手动维护一个源语言环境,意味着其他每个语言文件都会漂移:新键在目标文件中缺失,编辑过的字符串留下过期的译文,删除的键则作为孤立的键留着。verbatra 把每个目标与已提交的锁文件 verbatra.lock.json 比对,只把已更改的内容发给你配置的提供商,从而消除这种差距;没有新内容可翻译时,再运行一次根本不会调用提供商。每条结果在写入之前都会经过检查,因此损坏的占位符会被搁置并重试,绝不会发布出去。完整流程见运行的工作原理。

  1. 1. 检查

    verbatra check 比对源文件、目标文件和锁文件。它不调用任何提供商,也不需要密钥。

  2. 2. 翻译

    verbatra translate 只发送缺失和已更改的键,并拒绝任何占位符不匹配、内联标记损坏或 ICU 语法无效的结果。

  3. 3. 在 CI 中设门禁

    GitHub Action 在每个 pull request 上运行 check,只要有语言环境不同步就让它失败。

verbatra 读写常见的语言文件格式,从 JSON 和 YAML 到 XLIFF、gettext,以及 Android 和 Apple 的消息目录,并通过统一的接口,使用任何受支持的 LLM 或机器翻译提供商进行翻译(也可以一个都不用,见不用机器翻译运行);verbatra 未内置的格式,可以写成自定义适配器加入(见编写自定义格式适配器)。完整的列表见格式和提供商。

软件包

一个引擎,四种使用方式。