# Locadex: Localization AI Agent: 适用于 Next.js App Router 的 Locadex
URL: https://generaltranslation.com/zh/docs/locadex/next.mdx
---
title: 适用于 Next.js App Router 的 Locadex
description: 自动为你的 Next.js 应用完成翻译
---

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

**Locadex 是一款 AI 智能体，专为替你处理 100% 的国际化 (i18n) 工作而打造。**
安装只需 5 分钟。

{/* ![Locadex 安装界面](/images/screenshots/locadex-install.png) */}

Locadex:

* 将你的项目配置为使用 gt-next i18n 库
* 调整你的 React 组件和字符串，以支持多语言内容
* 将你的应用翻译成所需的任意语言
* 随着你不断推送新内容，持续完成国际化与翻译


### 第 1 步：登录 General Translation 仪表板

前往你的[仪表板](https://dash.generaltranslation.com)并登录账户。

### 第 2 步：连接 GitHub

1. 前往仪表板中的 GitHub 集成部分
2. 点击“连接 GitHub”，关联你的 GitHub 账户
3. 系统会将你重定向到 GitHub 以授权此连接

### 第 3 步：安装 GitHub 应用

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

### 第 4 步：将仓库关联到项目

1. 返回 GT 仪表板，选择你要进行国际化的仓库
2. 这会将你的仓库与翻译设置和目标语言关联起来
3. 一个项目只能关联一个仓库，但你可以创建多个项目，每个项目对应不同的仓库

### 第 5 步：配置

在配置页面中，设置：

* **目标语言**：选择要翻译为哪些区域设置

![Locadex installation screen](https://assets.gtx.dev/locadex-screenshots/locadex-installation.png)

### 第 6 步：完成安装

1. 检查配置设置
2. 点击 "Install" ，为你的仓库启用 Locadex
3. 你将进入概览页面，页面会显示已连接的 GitHub 仓库

## 接下来是什么？

### 初始设置

完成安装后：

1. **立即创建 PR**：Locadex 会在你的主分支上创建一个拉取请求
2. **完整设置**：此 PR 会运行完整的 Locadex 设置命令，执行以下操作：
   * 安装 GT 库
   * 为你的项目配置国际化
   * 搭建翻译基础设施
3. **审查并合并**：审查该 PR 并将其合并，以完成 i18n 设置

### 持续国际化

在初始设置合并后：

1. Locadex 会监控你的主分支或指定分支上的拉取请求
2. 当你推送包含可翻译内容的新代码时，等待 Locadex 将其提交添加到该 PR 中
3. 一旦 Locadex 向该 PR 提交了更改，就可以安全地合并——你的新代码已完成国际化
4. 你的应用会持续保持翻译状态，无需手动干预

## 监控仓库

![Locadex GitHub 连接面板](https://assets.gtx.dev/locadex-screenshots/locadex-github-connection.png)

![Locadex 配置面板](https://assets.gtx.dev/locadex-screenshots/locadex-config.png)

### 仪表板状态

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

* **仓库状态**：活动监控状态指示
* **配置**：当前设置和目标语言

### GitHub 应用

* **状态检查**：Locadex 会在拉取请求中添加状态更新
* **检查运行**：GitHub 会显示 Locadex 的处理状态

## 故障排查

### 常见问题

**Locadex 未创建 PR**

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

**需要更改配置**

* 在 GT 仪表板中更新分支设置
* 更改会在更新后的新提交中生效