Skip to content

什么是 ai-i18n-tools? ​

您有一个应用、网站、文档站点或仓库自述文件,它只有一种语言,而您希望支持更多语言。这种语言是 sourceLocale,它可以是任何语言。在这些指南中,英语是一个常见的例子。ai-i18n-tools 会找到文本,使用您选择的 LLM 提供商上的模型进行翻译,并写入您的项目已加载的文件。它会缓存每个结果,因此重新运行时只会将新的或更改的文本发送到模型。

你做什么以及工具做什么 ​

您工具
选择要尝试的语言、提供商和模型提取文本、进行翻译、验证结果并写入目录或页面
让面向用户的文本对工具可见:应用代码中的 t() 调用、网站框架自身的 i18n,或自述文件中的语言列表标记缓存翻译并在每次重新运行时重用它们
将结果连接到应用、网站路由或 README 的语言行显示进度,并允许您在仪表板中审阅译文

该工具不会重写您的源代码,除非您使用 --write 运行 migrate-python-i18n 或 migrate-dotnet-i18n。包装步骤提供了编码代理提示。它不会安装 i18next 或您的站点框架的 i18n,也不会构建您的语言切换器,尽管为此提供了运行时帮助程序。

从何开始? ​

演练分组在为你的项目添加 i18n中,其中包含共享设置和针对每种项目的页面。请选择一行:

你有从这里开始
源代码中包含纯文本的 JS/TS 应用(React、Next.js、Node、CLI)为 JS/TS 应用添加 i18n
Python 应用(Streamlit、FastAPI、Flask、桌面应用、脚本)为 Python 应用添加 i18n
一个 .NET 应用程序 (Avalonia, WPF, MAUI, ASP.NET, Blazor, 控制台)为 .NET 应用程序添加 i18n
一个已使用 ResourceManager 或 IStringLocalizer 的 .NET 应用程序为 .NET ResourceManager 应用程序添加 i18n
Django 应用、Flask-Babel 目录或已使用 GNU gettext 的应用为 Django / Python gettext 应用添加 i18n
网站或文档站点(VitePress、Docusaurus、Starlight、Nextra、Fumadocs、Astro、纯 HTML)为网站或文档站点添加 i18n
仓库自述文件和其他 Markdown 文件,通常与应用放在一起为你的自述文件和 Markdown 文档添加 i18n
独立的嵌套 JSON 区域设置文件JSON
带有文本标签的 SVG 图表SVG 翻译
Intlayer 字典(迁出 Intlayer)从 Intlayer 迁移
Intlayer 字典(保留 Intlayer,就地翻译)就地翻译 Intlayer

工作原理 ​

  1. 安装 CLI 并设置提供商的 API 密钥:安装。
  2. 运行 init 以写入 ai-i18n-tools.config.json:快速入门。
  3. 准备项目:将字符串包装在 t() 中,启用网站框架的 i18n,或将语言列表标记添加到自述文件中。
  4. 运行 sync。它会提取文本,翻译新内容,并写入输出。
  5. 在你的应用或网站中加载输出,添加语言切换器,并在源文件更改时重新运行 sync。

翻译模式 ​

在底层,该工具运行四个流水线。你的配置会启用你需要的流水线,sync 会按顺序运行它们。

  • UI 字符串 — 从 JS/TS 和 Python 中提取 t("…") 和 _() 调用,以及从 C# 和 XAML 中提取 T("…") / {loc:Tr '…'}(包括 GNU gettext 和 .NET .resx 卫星程序集),并写入扁平的每个区域设置 JSON、.po / .mo 或 .resx。命令:extract、translate-ui、migrate-dotnet-i18n。指南:UI 字符串。Python:Python 应用程序。.NET:.NET 应用程序 和 为 .NET ResourceManager 应用程序添加 i18n。
  • 文档 — 翻译 docs[].contentPaths 中列出的 Markdown、MDX 和 .astro 页面。适用于 VitePress、Starlight、Docusaurus、Nextra、Fumadocs、Astro 和其他静态文档站点,以及存储库 README(flat 的 docsOutput.style)。命令:translate-docs。指南:文档 和 为您的 README 和 Markdown 文档添加 i18n。
  • JSON — 翻译在顶级 json[] 中定义的嵌套 JSON 区域设置包(主题标签、i18n 覆盖、不在源代码中的应用程序文本)。命令:translate-json。指南:JSON。
  • SVG — 翻译 SVG 插图(<text>、<title>、<desc>)中的可见文本,并为每个区域设置写入一个输出文件。与文档翻译分开。命令:translate-svg。指南:SVG 翻译。

许多项目会组合多种模式。常见的组合是 UI 字符串加上仓库的 README。像 VitePress 这样的文档网站是另一种常见的组合。请参阅组合管道和为您的 README 和 Markdown 文档添加 i18n。

示例 ​

该仓库在 examples/ 下提供了可运行的示例项目,每个项目都有自己的配置、已提交的本地化输出和 README。无需 API 密钥即可浏览已翻译的文件;重新运行翻译则需要提供商密钥。

如果您有示例
一个 JS/TS 应用console-app, nextjs-app
一个与应用并存的仓库 READMEconsole-app, nextjs-app
一个 Python 应用python-streamlit, python-fastapi, python-gettext
一个 .NET 帮助程序dotnet-console, dotnet-resx
一个文档网站docusaurus-docs, vitepress-docs, astro-docs
一个网站或纯 HTMLastro-website, plain-html

请参阅示例查看完整列表和 npx degit 复制命令。

后续步骤 ​

  1. 安装 — 安装 npm 包,或为 Python 项目下载独立可执行文件,并设置你的提供商 API 密钥。
  2. 快速入门 — 构建配置并运行你的首次翻译。
  3. LLM 提供商 — 选择提供商、API 密钥和 -P 覆盖。
  4. AI 模型 — 使用 suggest-models 或仪表板的 模型 选项卡对候选列表进行排序,并保留多个模型,以便在翻译失败时可以尝试下一个模型。

基于 MIT 许可证发布。