# 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-automations
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/viewing-automation-activity

---

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。以下三个自动化模板会让你的本地化始终保持最新：

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

每个自动化都可以手动运行，也可以在拉取请求发生变化时或在提交被推送时运行。你可以自行选择触发设置。

## 快速开始 [#quickstart]

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

1. **连接 GitHub。** 在[仪表板](https://dash.generaltranslation.com)中打开你的**项目**，前往 **项目 > Integrations > Catalog**，然后连接 GitHub。选择 Locadex 应用于此项目的仓库。
2. **创建自动化。** 打开 **项目 > Automations**。在 **Start with a template** 下，选择 **Generate code**、**Generate translations and push** 或 **Keep locales in sync**。
3. **选择目标。** 选择已连接的仓库、目标目录和检测到的框架。如果应用位于代码仓库根目录，请使用 `.`。
4. **检查自动化配置。** 选择目标分支、触发器、创建的分支前缀、自动合并行为、变更文件过滤规则，以及是否保留本地编辑。点击 **Create automation**。
5. **运行设置。** 打开自动化并点击 **Run setup**。选择源区域设置和目标语言。Locadex 会准备仓库，并创建一个设置拉取请求。
6. **审查并合并。** 在自动化页面中打开设置拉取请求，审查更改，并在运行自动化之前将其合并。

设置 PR 合并后，每个自动化都会按其配置的触发器运行。自动运行时，Locadex 会复用同一源分支和自动化对应的未关闭拉取请求；该拉取请求被合并或关闭后，它会再新建一个。审查 PR，或**启用 [auto-merge](/docs/platform/locadex/guides/auto-merging-prs)**，你的应用就能始终保持翻译更新，无需手动操作。

打开一个自动化并点击 **Run now** 以手动触发它。
## Next steps

- /docs/platform/locadex/guides/configuring-automations
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/viewing-automation-activity