# General Translation Platform: Locadex PR 自动合并
URL: https://generaltranslation.com/zh/docs/platform/locadex/guides/auto-merging-prs.mdx
---

title: Locadex PR 自动合并
description: 如何配置 Locadex，使其在检查通过时自动合并拉取请求。
related:
  links:
    - /docs/platform/locadex/guides/configuring-workflows
    - /docs/platform/locadex/guides/viewing-workflow-history
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/using-in-monorepos

---

自动合并可免去对 Locadex 生成的 PR 进行人工审核。启用后，Locadex 创建的 PR 会在检查通过后自动合并。

自动合并可在各个工作流的配置页面中使用，包括 Codegen、Translation 和 Locales。 

## 设置自动合并 [#set-up-auto]

打开 **Locadex > Configuration**。选择你要配置的工作流：

* **Codegen** 用于代码国际化。自动使用国际化库调用 (如 `t()` 或 `T` 组件) 包装源代码。
* **Translation** 用于内容更新。自动将新增或更新的源内容翻译为目标语言。
* **Locales** 用于区域设置更新。如果添加或移除了语言，则自动更新你项目中的文件。

如需了解更多工作流程相关信息，请参阅[配置工作流程](/docs/platform/locadex/guides/configuring-workflows)。

对于 Mintlify Projects，自动合并默认已启用。

## 配置 GitHub 权限 [#configure-github-permissions]

如果你的默认 branch 启用了保护规则，Locadex 仍会继续创建 PR，但无法自动 merge。请配置 GitHub，允许 Locadex 绕过 branch 保护：

1. **打开 repository rulesets**：在 GitHub repository 的设置中，从 Rules 部分选择“Rulesets”。
2. **找出阻止规则**：找到阻止自动合并 的规则。你可能需要更新多条规则。常见的阻止项包括：**“merge 前必须先创建 拉取请求”，**必需的状态检查，以及必需的审核批准。
3. **添加绕过 permissions**：选择阻止 自动合并 的规则，然后点击 **“Add Bypass”**，并从 dropdown 中选择“Locadex Agent”。
4. **保存更改**：请务必点击页面底部的“Save”来应用更改 (这一步很容易漏掉！)

## 保留手动修改 [#preserve-manual-edits]

如果希望在 Locadex 运行前保留人工进行的翻译修改，请启用 **保存本地编辑**。

当你的团队会在仪表板中审核或修改生成的译文时，这个选项会很有用。

## 添加验证命令 [#add-validation-commands]

如果需要让 Locadex 在创建 拉取请求 之前先运行构建、lint 或测试命令，请添加一个**后处理命令**。 (预处理命令会在 Locadex 处理文件之前运行，后处理命令会在 Locadex 处理文件之后运行。) 

例如：

```bash
npm run lint
```

请在仓库根目录运行命令。对于 monorepo，请在 General 设置中设置 **应用根目录**，以便 Locadex 知道应用所在位置。

## 何时不应使用 自动合并 [#not-use-auto]

在以下情况下，请不要启用 自动合并：

* 你希望每个 Locadex 拉取请求 都由人工审核。
* 生成的更改需要产品或法务审核。
* 你的仓库没有可靠的必需检查项。
* 你仍在测试 Locadex 的设置流程。

*注意：自动合并 不适用于 Setup 或 Re-run Setup 的 PR。*
## Next steps

- /docs/platform/locadex/guides/configuring-workflows
- /docs/platform/locadex/guides/viewing-workflow-history
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/using-in-monorepos