# General Translation Platform: 配置 Locadex 工作流
URL: https://generaltranslation.com/zh/docs/platform/locadex/guides/configuring-workflows.mdx
---

title: 配置 Locadex 工作流
description: 如何配置 Locadex 运行代码生成、翻译和区域设置更新工作流的时机。
related:
  links:
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/viewing-workflow-history
    - /docs/platform/locadex/guides/adding-environment-variables

---

使用工作流设置来控制 Locadex 更改哪些内容、何时运行，以及如何创建拉取请求。

Locadex 有三个工作流：**Codegen**、**Translation** 和 **Update Locales**。每个工作流都可以在每个拉取请求上运行、在每次提交时运行，或手动运行。

## 选择你的工作流 [#choose-workflow]

在仪表板的项目侧边栏中，打开 **Locadex > Configuration**。你可以为每个项目配置三种 Locadex 工作流：

* **Codegen**：用于代码国际化。
  * 设置 Locadex 何时使用国际化库调用 (例如 `t()` 或 `T` 组件) 来包装源代码。
* **Translation**：用于内容更新。
  * 设置 Locadex 何时将新增或更新的源内容翻译为目标语言。
* **locales**：用于区域设置更新。
  * 设置在添加或移除语言时，Locadex 何时更新项目中的文件。从智能体页面更改源语言或目标语言时，请使用此工作流。

## 配置工作流 [#configure-workflow]

### 编辑触发条件

每个工作流都可以由以下三种触发条件之一运行：

* **On pull request** 会在相关 拉取请求 创建或更新时运行。
* **On commit** 会在提交被推送到受监控的 分支 时运行。
* **Manual only** 仅会在你手动运行智能体时运行。

默认情况下，Codegen 和 Translation 使用 **On pull request**，而 locales 使用 **Manual only**。不过，对于文档框架 (Mintlify、Fern 和 Docusaurus) ，Translation 工作流默认改为 **On commit**。

### 编辑目标分支和前缀

将 **Target Branch** 设置为 Locadex 要监控变更的分支。大多数项目都使用 `main`。

为 Locadex 创建的分支设置 **Branch Prefix**。默认前缀通常是：

```txt
locadex/
```

使用固定的前缀，便于在 GitHub 中查找 Locadex 分支。

### 编辑 PR 设置

使用切换按钮来控制 Locadex 如何创建和管理 拉取请求：

* **自动合并 PR** 会在检查通过后自动合并 Locadex 的 拉取请求。更多信息请参见 [自动合并 Locadex PR。](/docs/platform/locadex/guides/auto-merging-prs)
* **仅在精确内容变更时运行** 会缩小 Locadex 对 Codegen 工作流的相关性检查范围。启用后，Locadex 只会检查 diff 中变更的行。禁用后，它可能会检查整个已修改的文件。此设置不会影响 Translation 或 locales 工作流。
* **保存本地编辑** 会在 Locadex 运行前保留手动翻译修改。

页面底部的文本框提供了更多自定义选项：

* **自定义 PR 标题** 用于设置 Locadex 拉取请求 使用的标题。
* **自定义提交消息** 用于设置 Locadex 使用的提交消息。

### 添加命令

使用命令可在你的项目中运行 setup、验证等步骤。你可以使用命令安装依赖、构建项目、检查生成的更改，或运行项目特定的检查。命令可以在 Locadex 处理文件之前或之后运行：

* **预处理命令** 会在 Locadex 处理文件之前运行。例如，运行 `npm run build`。
* **后处理命令** 会在 Locadex 处理文件之后运行。例如，运行 `npm run typecheck`。

命令会从仓库根目录运行，并在 [Locadex VM image](/docs/platform/locadex/reference/vm-image) 内执行。如果某个 工作流 因缺少 package、script 或 binary 而失败，请添加预处理命令。

如果任意检查失败，[auto-merge](/docs/platform/locadex/guides/auto-merging-prs) 就不会运行。
## Next steps

- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/viewing-workflow-history
- /docs/platform/locadex/guides/adding-environment-variables