# General Translation Platform: 快速开始
URL: https://generaltranslation.com/zh/docs/platform/locadex/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 使用 Locadex，这个连接你的代码库、译文和内容来源的 AI 智能体。这是使用 General Translation 全栈本地化的最快方式。

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

完成设置后，Locadex 可以配置你的项目，并自动将其翻译成你选择的语言。

Locadex 目前支持 **Next.js**、**Mintlify**、**Fern** 和 **Docusaurus** 项目，以及使用 Vite、Gatsby、Redwood、React Router、TanStack Start、Bazel、esbuild、Rollup、Rolldown 或 webpack 构建的 React 应用。

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

Locadex 在你的 GitHub 仓库中运行，并会根据生成的更改自动创建或更新 PR。以下三个自动化模板会让你的本地化始终保持最新：

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

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

## 快速开始 [#quickstart]

开始之前，你需要一个使用 Starter、Team 或 Enterprise 方案的 [General Translation](https://dash.generaltranslation.com) 项目，以及一个 GitHub 仓库，其中包含一个使用 Locadex 支持的框架构建的项目。创建和运行项目自动化需要 `project:locadex:write` 权限。

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

设置 PR 合并后，每个自动化都会按其配置的触发器运行。自动运行时，Locadex 会复用同一源分支和自动化对应的未关闭 PR；该 PR 被合并或关闭后，它会再新建一个。审查 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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.