# gt: General Translation CLI tool: 管理翻译
URL: https://generaltranslation.com/zh/docs/cli/guides/managing-translations.mdx
---

title: 管理翻译
description: "如何使用 General Translation CLI 管理翻译：本指南介绍如何将工作流拆分为 upload、加入队列 和 download 三个阶段、将翻译暂存以供审核，以及同步本地修改。"
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

[`gt translate`](/docs/cli/reference/commands/translate) 命令可一步完成整个翻译流程。当你需要更细粒度的控制时——例如拆分 CI 阶段或加入人工审核步骤——CLI 会将该流程的各个部分分别提供为独立命令。

*注意：这些命令需要生产环境 API 密钥。请将 `GT_API_KEY` 和 `GT_PROJECT_ID` 设置为环境变量。*

## 在 CI 各阶段拆分翻译流程 [#split]

在 CI 流水线中，你通常会希望在不同的 job 中分别上传内容、发起翻译并下载结果。这三个命令分别对应这几个阶段。

1. [`gt upload`](/docs/cli/reference/commands/upload) 将源文件 (以及任何现有译文) 上传到平台。
2. [`gt enqueue`](/docs/cli/reference/commands/enqueue) 会将已上传的文件加入翻译队列，并立即返回，不等待结果。
3. [`gt download`](/docs/cli/reference/commands/download) 会下载已完成的译文，并将其保存到配置中指定的路径。

```bash
# 阶段 1：上传源文件
npx gt upload

# 阶段 2：将翻译加入队列
npx gt enqueue

# 阶段 3：准备就绪后下载
npx gt download
```

由于 `enqueue` 不会等待完成，因此你可以等翻译准备就绪后，再在后续的 job 中运行 `download`。这样可以避免在翻译处理期间一直让构建 job 挂起。

## 将译文暂存以供审核 [#review]

如果你的项目启用了人工审核，请使用 [`gt stage`](/docs/cli/reference/commands/stage)，而不要直接翻译。它的用法与 [`translate`](/docs/cli/reference/commands/translate) 类似，但会将结果保留为待批准状态，而不是下载或发布。

```bash
npx gt stage
```

运行 `stage` 会将你的 `gt.config.json` 中的 `stageTranslations` 设为 `true`。翻译获批后，运行 `gt translate` 即可下载。启用 `stageTranslations` 后，`translate` 只会下载你已暂存的版本；如果尚未暂存任何内容，就没有可下载的内容。

## 保存本地修改 [#save-local]

当你或译者手动编辑已下载的翻译文件时，使用 [`gt save-local`](/docs/cli/reference/commands/save-local) 将这些修改同步回平台。

```bash
npx gt save-local
```

该命令会将你的本地文件与上次下载的版本进行比较，对所有变更内容计算 diff 并提交。它不会将任何新的翻译加入队列。如果你想在一次翻译运行中一并保存本地修改，请向 `translate` 传递 `--save-local`。
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/branching
- /docs/cli/guides/configuring
- /docs/cli/guides/using-autoderive