# General Translation Knowledge Base: Locadex 智能体能做什么？ URL: https://generaltranslation.com/zh/kb/what-is-locadex.mdx Docs index: https://generaltranslation.com/llms.txt Description: Locadex 是 General Translation 推出的 AI 智能体，可在你的 GitHub 代码仓库中对代码进行国际化处理并翻译内容。它的自动化流程会在创建拉取请求、推送提交或你手动启动时运行，所有更改都以拉取请求的形式交付。 Category: 工作流工具 Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Locadex 是 General Translation 推出的 AI 智能体，可在你的 GitHub 代码仓库中对代码进行国际化处理并翻译内容，并以拉取请求的形式交付所有更改。在多语言应用中，新增的界面文本需要用国际化 (i18n) 调用包裹，并翻译成每种目标语言；添加或移除语言时还要更新配置。如果手动完成，这些工作总是滞后于代码更改，导致功能先以源语言上线，译文之后才能跟上。 | 方案 | 优势 | 何时翻译 | 需要你自己完成的工作 | | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | -------------------------------------------------------------------------- | ------------------------------- | | 仅使用国际化库 (`i18next`、`react-intl`、`next-intl`) | 成熟的运行时，可渲染译文并格式化值 | 每当有人更新语言文件时 | 将每个字符串替换为键、将其添加到每个语言文件中，并自行提交更改 | | 由你操控的编程智能体，例如搭配 General Translation [启动提示词](/docs/overview/for-coding-agents#start-prompt)使用的 Cursor 或 Claude Code | 在你监督的会话中完成 i18n 初始化设置 | 当你或你的 CI 运行 [`npx gt translate`](/docs/cli/reference/commands/translate) 时 | 监督会话，然后审查并提交其修改 | | General Translation (Locadex) | 其 **Generate code** 自动化流程会在每次运行时用 i18n 调用包裹文本，所有更改都以拉取请求的形式交付 | 由你选择触发时机：拉取请求、推送或 **Run now** | 审查每个拉取请求，或开启 **Auto-merge** | 如果语言文件由译者负责，且每次发布都能等译文就绪，那么仅使用国际化库即可。如果你想亲自监督一次性的初始化设置，可以使用编程智能体，之后在每次构建前于 CI 中运行 [`npx gt translate`](/docs/cli/reference/commands/translate)。如果大多数拉取请求都会改动应用或文档，而你希望每次更改的译文都通过拉取请求交付、又不想维护流水线步骤，请使用 Locadex。对于 Locadex 支持范围之外的技术栈 (例如 Vue 或 Node.js) ，请使用 General Translation 的库和 `gt` CLI。 ## Video The video is narrated in English, with English captions. [What does the Locadex agent do?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-what-is-locadex.mp4) (49秒) General Translation uses its AI agent Locadex to open pull requests that translate your app. Connect GitHub in the Dashboard and create an automation from a template: Generate code wraps untranslated text in the right i18n calls, Generate translations and push translates each change into every target language, and Keep locales in sync updates the project when languages change. Run setup with your target languages, merge its pull request, and review Locadex's pull requests or turn on auto-merge. ## Locadex 能自动完成哪些工作 团队可以配置每个 Locadex 自动化的运行时机、修改范围，以及在 GitHub 中交付变更的方式。每个自动化都基于 **Project > Automations** 下的三个模板之一创建： * **Generate code**：查找未翻译的界面文本，并用 i18n 调用将其包裹，例如 [``](/docs/react/reference/components/t) 组件。 * **Generate translations and push**：将新增或更新的源内容翻译为所有目标语言。 * **Keep locales in sync**：在添加或移除语言时更新项目文件。 Locadex 支持 Next.js；使用 Vite、Gatsby、Redwood、React Router、TanStack Start (其 `gt-tanstack-start` 库尚处于实验阶段) 等构建的 React 应用；以及 Mintlify、Fern 和 Docusaurus 这几款文档框架。 ## 工作原理 使用 Locadex 需要 Starter 或 Enterprise 方案，其运行次数按 Locadex 计算单位 (LCU) 计量；当前费率请参阅[定价页面](https://generaltranslation.com/pricing)。在 **Project > Integrations > Catalog** 下连接 GitHub，创建一个自动化流程，然后点击 **Run setup**，选择源区域设置和目标语言，例如将英语翻译为西班牙语、法语和日语。在 React 应用中，初始化设置会创建一个拉取请求，用于配置翻译加载，但不会改动你的字符串。合并该拉取请求后，**Generate code** 会用 [``](/docs/react/reference/components/t) 等调用包裹这些字符串。在 Next.js 页面中，效果如下： ```tsx title="app/page.tsx" import { T } from 'gt-next'; export default function Home() { return (

Welcome to my app

This content will be translated automatically.
); } ``` **Run when** 用于设置每个自动化的触发条件。选择 **A pull request changes** 时，Locadex 会在拉取请求被打开、重新打开或标记为可供审查时运行，随后另行创建一个拉取请求，并在你的拉取请求下发表评论附上链接。选择 **A commit is pushed** 时，Locadex 会在有提交推送到目标分支 (通常为 `main`) 时运行。选择 **Started manually** 时，只有在你点击 **Run now** 后才会运行。 **Auto-merge** 默认关闭；开启后，Locadex 拉取请求会在检查通过后自动合并。 Locadex 的翻译会遵循分配给你的 General Translation 项目的[上下文组](/docs/platform/dashboard/guides/defining-context-for-translations) (包括用于固定产品术语的词汇表，以及用于设定语气的自定义提示词) 。在仪表板中所做的编辑也会通过同样的方式同步到 GitHub：下一次 Locadex 翻译运行时，会将这些编辑纳入拉取请求。 ## 配置代码仓库 使用 [预处理命令](/docs/platform/locadex/guides/configuring-automations) 在 [Locadex 沙箱](/docs/platform/locadex/reference/vm-image) 中安装项目所需的依赖和工具。如果是 monorepo，请将 **Target directory** 设置为应用所在的文件夹，并在预处理命令开头先用 `cd` 进入该目录。 初始化设置生成的拉取请求请手动审查。对于之后由自动化创建的拉取请求，启用 **Auto-merge** 需要检查全部通过，并具备 [配置自动化](/docs/platform/locadex/guides/configuring-automations) 中所述的代码仓库权限。 如需针对拉取请求的当前修订版本触发一次运行，请评论 `/locadex`。自动化指南介绍了触发行为和代码仓库设置，完整步骤请参阅 [Locadex 快速入门](/docs/platform/locadex/quickstart)。 ## Related questions - [如何使用 Cursor 或 Claude Code 为应用实现国际化？](https://generaltranslation.com/zh/kb/ai-agent-i18n-setup.mdx): 在 Cursor 或 Claude Code 中使用 General Translation 的 Setup for Agents 提示词，选定一个功能和目标语言，然后让智能体完成实现并验证结果。借助浏览器登录、机器可读文档和 MCP 工具，初始化设置可以与翻译和审校环节无缝衔接。使用 Locadex，即可通过拉取请求自动完成后续的持续本地化工作。 - [如何为 Next.js App Router 应用添加 i18n？](https://generaltranslation.com/zh/kb/add-i18n-to-nextjs.mdx): 首先在受支持的 App Router 项目中运行 gt init 来配置 General Translation，然后标记源内容、生成译文并验证语言切换。gt-next 将文案与翻译上下文一同保留在 JSX 中；CLI、仪表板编辑器和 Locadex 负责生成、审阅和持续更新。本指南还演示了如何显式配置本地文件。 - [如何翻译 Mintlify 文档站点？](https://generaltranslation.com/zh/kb/translate-mintlify-docs.mdx): 为每种语言创建一个文件夹，在其中存放每个页面的译文副本，并将每种语言添加到 docs.json 导航中。General Translation 的 AI 智能体 Locadex 会提交一个拉取请求，添加翻译后的页面和各语言的导航，之后还会持续翻译后续变更。 - [如何在每次部署时保持译文同步更新？](https://generaltranslation.com/zh/kb/translations-in-ci.mdx): 在每次生产环境构建之前，将翻译作为流水线中的一个步骤运行，这样新增文案就会在引入它的那次部署中以翻译好的形式一同上线。General Translation 的 gt CLI 通过 npx gt translate 实现这一点，所需的项目 API 密钥和项目 ID 以 CI 密钥的形式存储。 - [不使用翻译文件能实现 i18n 吗？](https://generaltranslation.com/zh/kb/i18n-without-translation-files.mdx): 可以。借助 General Translation 的 gt-react 和 gt-next 库，你可以为 React 和 Next.js 实现 i18n，既无需翻译键，也不用为每种语言维护 JSON 文件。文案以内联方式写在 JSX 的 `` 组件中，gt translate 命令会在构建时结合代码中的上下文，为每种语言生成译文。Locadex 还能通过拉取请求让译文保持最新。 ## Previous and next questions - Previous question: [应该自建 i18n，还是使用 General Translation？](https://generaltranslation.com/zh/kb/general-translation-vs-in-house-i18n.mdx) - Next question: [如何为 Next.js App Router 应用添加 i18n？](https://generaltranslation.com/zh/kb/add-i18n-to-nextjs.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/zh/kb/sitemap.md) for every article.