# General Translation Platform: 配置
URL: https://generaltranslation.com/zh/docs/platform/locadex/reference/config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 配置 Locadex 自动化的目标、触发器、命令、拉取请求和仓库设置。Locadex 自动化和仓库配置参考。

打开 **项目 > Automations**，然后选择一个自动化以编辑其配置。

| 设置组                          | 包含内容                   |
| ---------------------------- | ---------------------- |
| [目标](#target)                | 仓库、目标目录、框架、包管理器和代码检查工具 |
| [触发器和分支](#trigger-branches)  | 目标分支、触发器和创建的分支前缀       |
| [命令和拉取请求](#commands-prs)     | 命令、拉取请求文案、提交消息和行为开关    |
| [自动化状态](#automation-state)   | 启用状态和删除                |
| [密钥](#secrets)               | 组织级环境变量                |
| [仓库设置](#repository-settings) | 电子邮件提醒、监控、设置和仓库连接      |

## 目标 [#target]

* **仓库** — 自动化运行所针对的已关联 GitHub 仓库
* **目标目录** — Locadex 工作的文件夹，相对于代码仓库根目录；默认为 `.`
* **框架** — Locadex 在目标目录中预期使用的框架
* **包管理器** — 依赖安装工具；默认为 **自动检测**
* **代码检查工具** — 编辑后的代码风格检查工具；默认为 **无**

更改仓库会保留该自动化，并将其指向链接到同一项目的另一个仓库。

## 触发条件和分支 [#trigger-branches]

* **目标分支** — Locadex 以此分支为起点，并向其发起拉取请求；默认为仓库中检测到的默认分支或 `main`
* **运行条件** — **拉取请求有变更时**、**提交被推送时** 或 **手动启动**
* **创建的分支前缀** — Locadex 分支使用的前缀；默认为 `locadex/`

新的 **生成代码** 和 **生成翻译并推送** 自动化默认使用 **拉取请求有变更时**。**保持区域设置同步** 默认使用 **手动启动**。

## 命令和拉取请求 [#commands-prs]

* **预处理命令** — 在 Locadex 启动前，从代码仓库根目录运行
* **后处理命令** — 在 Locadex 完成后，从代码仓库根目录运行
* **拉取请求标题** — 自定义标题；留空时使用 Locadex 默认值
* **拉取请求描述** — 自定义正文；留空时使用 Locadex 默认值
* **提交信息** — 自定义提交信息；留空时使用 Locadex 默认值
* **自动合并** — 检查通过后自动合并拉取请求；默认关闭
* **仅限已更改文件** — 将 **生成代码** 相关性检查限制为已更改的行，而不是已修改文件的完整内容；**生成代码** 和 **生成翻译并推送** 默认开启，**保持区域设置同步** 默认关闭，但只有 **生成代码** 会使用该筛选器
* **保留本地编辑** — 保留对之前生成文件的手动修改；默认开启

## 自动化状态 [#automation-state]

关闭 **Active** 可暂停自动触发，无需删除配置或历史记录。

**删除自动化** 会停止后续运行，并保留现有运行历史记录。断开 GitHub 连接也会保留该自动化，但会将其暂停，直到重新连接或重新选择某个仓库。

## 密钥 [#secrets]

密钥在 Organization 层级统一管理，而不是在某个自动化中。打开 `/org/{orgId}/locadex/secrets`，将 `{orgId}` 替换为你的 Organization ID。该页面当前未列在仪表板侧边栏中。

添加、编辑或删除密钥需要 **Manage Locadex secrets** 权限。默认的 Admin 和 Developer 角色拥有此权限。

密钥是在 Locadex 运行自动化时注入沙箱的环境变量。

请将密钥用于 API 密钥、token 或预处理和后处理命令配置。

## 仓库设置 [#repository-settings]

仓库级控制项仍可通过 `/project/{projectId}/locadex/configuration` 访问，请将 `{projectId}` 替换为你的项目 ID。此页面目前未显示在仪表板侧边栏中。

* **电子邮件提醒** — 在 Locadex 拉取请求保持打开状态达到 6 小时、12 小时、1 天、2 天、1 周或 2 周后发送提醒；默认为 1 天
* **禁用监控** — 在保留设置和运行历史记录的同时，停止自动化触发器；使用 **启用监控** 可恢复
* **重新运行设置** — 重新检测框架、locales 和配置，并创建一个新的 设置 拉取请求
* **断开仓库连接** — 解除项目与其 GitHub 仓库之间的关联，同时保留自动化设置和运行历史记录

## Sitemap

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