# General Translation Platform: 快速开始
URL: https://generaltranslation.com/zh/docs/platform/locadex/quickstart.mdx
---

title: 快速开始
description: 了解如何使用 Locadex，这个连接你的代码库、译文和内容来源的 AI 智能体。这是使用 General Translation 全栈本地化的最快方式。
related:
  links:
    - /docs/platform/locadex/guides/configuring-workflows
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/viewing-workflow-history

---

Locadex 是 General Translation 的 AI 智能体，可连接你的代码库、译文和内容来源。

只需 **5 分钟**即可完成设置，之后你的项目就会完成配置，并**自动**翻译成你选择的任意语言。Locadex 可为你处理 100% 的国际化 (i18n) 和翻译工作。

Locadex 目前支持 **Next.js**、**Mintlify**、**Fern** 和 **Docusaurus** 项目，以及其他 React 框架，包括 Vite、Gatsby、React、Redwood、React Router 和 TanStack Start。

## Locadex 的工作原理 [#locadex-works]

Locadex 在你的 GitHub 代码仓库中运行，并会为每项生成的更改自动创建 PR。以下三个工作流会让你的所有翻译始终保持最新：

* **Codegen** 会用正确的国际化 (i18n) 库调用包装源代码，例如 `t()` 和 `T` 组件。
* **Translation** 会将源内容翻译成每一种目标语言，并更新翻译文件。
* **Update Locales** 会在添加或移除语言时更新项目文件。

每个工作流都可以手动运行，也可以在拉取请求或提交时运行。你可以自行选择触发设置。

## 快速开始 [#quickstart]

设置 Locadex 只需 5 分钟。你需要一个 [General Translation](https://dash.generaltranslation.com) 项目，以及一个 GitHub 仓库，其中包含一个基于 Locadex 所支持框架构建的项目。

1. **连接 GitHub。** 在[仪表板](https://dash.generaltranslation.com)中打开你的项目，然后在侧边栏前往 **Locadex > 智能体**。连接你的 GitHub 账户并完成授权。按照流程操作，它会引导你为 Locadex 需要访问的仓库设置权限 (所有仓库，或指定的部分仓库) 。
2. **关联你的仓库。** 回到仪表板，选择要进行国际化的仓库。每个项目对应一个仓库；如果还有其他仓库，请为其创建额外的项目。
3. **配置项目。**

* **设置应用根目录** (适用于 monorepo) 。如果应用位于仓库根目录，请使用 `.` 或将该字段留空。
  * **可选：**设置 **package manager**，以便 Locadex 在沙箱中安装依赖；设置 **linter**，以便 Locadex 在修改后保留代码风格。
  * **选择语言**：你的源 (默认) 区域设置，以及应用要翻译到的目标语言。目标语言可从 General Translation 支持的全部 120 种区域设置中选择。

4. **审核并合并。** Locadex 会自动运行其设置工作流，以安装 i18n 库、配置你的项目并添加翻译基础设施。这可能需要几分钟才能完成。打开 PR (使用 **View on GitHub**) ，审核更改，然后合并以完成设置。

就是这样！设置 PR 合并后，Locadex 会监控你的主分支提交，并在需要时更新翻译。你可以审核新的 PR，或**启用[自动合并](/docs/platform/locadex/guides/auto-merging-prs)**，让应用无需手动操作也能持续保持翻译最新。

你也可以随时使用 **Run 智能体** 手动触发一次运行。
## Next steps

- /docs/platform/locadex/guides/configuring-workflows
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/viewing-workflow-history