将你的 Next.js 应用翻译成法语 🇫🇷、西班牙语 🇪🇸、日语 🇯🇵 或任何其他语言，既繁琐又耗时。

Locadex 是一款可为你承担 100% 国际化（i18n）工作的 AI 代理。 安装仅需 5 分钟。

Locadex：

• 为你的项目配置 gt-next i18n 库
• 修改 React 组件与文案以支持多语言内容
• 将你的应用翻译成所需的任意数量的语言
• 随着你推送新内容，持续进行国际化与翻译

设置过程

步骤 1：登录 General Translation 控制台

前往你的控制台并登录你的账户。

步骤 2：连接 GitHub

1. 在你的 dashboard 中进入 GitHub 集成部分
2. 点击“Connect GitHub”以连接你的 GitHub 账户
3. 系统会将你重定向到 GitHub 以授权连接

步骤 3：安装 GitHub 应用

1. 连接 GitHub 后，系统会重定向至安装 Locadex GitHub 应用的页面
2. 选择要授予 Locadex 访问权限的仓库：
   • 安装到所有仓库，或
   • 仅选择特定仓库
3. 点击“Install”完成 GitHub 应用安装

第 4 步：将代码仓库链接到项目

1. 回到你的 GT 控制台，选择你要进行国际化的代码仓库
2. 这会将你的仓库与翻译设置和目标语言关联
3. 每个项目只能链接一个仓库，但你可以创建多个项目，每个项目对应不同的仓库

步骤 5：配置参数

在配置界面中，设置：

• 目标语言：选择要翻译的 locales

步骤 6：完成安装

1. 查看你的配置
2. 点击“Install”以在你的仓库中启用 Locadex
3. 你将被带到一个概览页面，显示你已连接的 GitHub 仓库

接下来会怎样

初始设置

完成安装后：

1. 即时创建 PR：Locadex 会在你的主分支上创建一个 pull request
2. 完整设置：该 PR 将运行完整的 Locadex 设置命令，具体包括：
   • 安装 GT 库
   • 为你的项目配置国际化
   • 搭建翻译基础设施
3. 审阅并合并：审阅该 PR 并将其合并，以完成你的 i18n 设置

持续国际化

在完成初始设置并合并后：

1. Locadex 会监控你的主分支或指定分支上的 pull request
2. 当你推送包含可翻译内容的新代码时，等待 Locadex 将其提交附加到该 PR
3. 一旦 Locadex 提交更新到该 PR，即可安全合并——你的新代码已完成国际化
4. 你的应用将无需人工干预即可持续保持已翻译状态

监控你的仓库

仪表盘状态

在仪表盘中，你可以查看：

• 仓库状态：实时监控指示
• 配置：当前设置与目标语言

GitHub 集成

• 状态检查：Locadex 会在 Pull Request 上添加状态更新
• 检查运行：GitHub 会显示 Locadex 的处理进度

故障排查

常见问题

Locadex 未创建 PR

• 确认 GitHub 应用已获得仓库访问权限
• 检查提交中是否包含可翻译内容

需要修改配置

• 在你的 GT 仪表盘中更新分支设置
• 更改将从更新后产生的新提交开始生效

支持的框架

目前，Locadex 仅支持基于 Next.js App Router 的应用。