# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/zh/docs/cli/reference/commands/stage.mdx
---

title: gt stage
description: 将项目提交到 General Translation，并要求进行人工审核。gt stage 命令的 API 参考。

---

提交项目进行翻译，并将结果保留待人工审核，而不是直接下载或发布。当你的项目启用了人工审核时，请使用此命令。有关审核工作流，请参阅[管理翻译](/docs/cli/guides/managing-translations#review)。

运行 `stage` 会在你的 `gt.config.json` 中将 `stageTranslations` 设为 `true`。启用后，如果某个版本在暂存前就运行 [`gt translate`](/docs/cli/reference/commands/translate)，CLI 会报错并退出。翻译获批后，运行 [`translate`](/docs/cli/reference/commands/translate) 下载译文。

*注意：仅限生产环境使用。需要生产环境的 `GT_API_KEY` 和 `GT_PROJECT_ID`。*

```bash
npx gt stage
```

## 工作方式 [#how-it-works]

1. 读取 `gt.config.json`，扫描框架项目中的源代码以查找内联内容，并收集文件——与 [`gt translate`](/docs/cli/reference/commands/translate) 的处理方式相同。
2. 将内容发送到 General Translation API，并将结果保留用于人工审核，而不是下载或发布。
3. 在 `gt.config.json` 中设置 `stageTranslations: true`，使后续运行都必须先进行暂存。

启用 `stageTranslations` 后，如果未先暂存该版本就运行 `translate`，CLI 会报错并退出。翻译获批后，运行 `translate` 即可将其下载。

## 标志 [#flags]

`stage` 接受与 [`gt translate`](/docs/cli/reference/commands/translate#flags) 相同的标志，包括框架项目的源扫描标志。下面列出的是最常用的几个；完整列表请参阅上方链接的参考文档。

| 参数                          | 说明                          | 类型         | 可选 | 默认值              |
| --------------------------- | --------------------------- | ---------- | -- | ---------------- |
| `--api-key <key>`           | 生产 API 密钥。                  | `string`   | 是  | `GT_API_KEY`     |
| `--project-id <id>`         | 项目 ID。                      | `string`   | 是  | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | config file 的路径。            | `string`   | 是  | `gt.config.json` |
| `--locales <locales...>`    | 额外的目标区域设置，会追加到配置中的 locales。 | `string[]` | 是  | —                |
| `--default-locale <locale>` | 项目的源区域设置。                   | `string`   | 是  | `en`             |
| `--dry-run`                 | 仅解析并验证，不调用 API。             | `boolean`  | 是  | `false`          |
| `--tag [value]`             | 为此次运行添加标签；未提供值时会自动从 git 解析。 | `string`   | 是  | —                |
| `-m, --message <message>`   | 附加到翻译标签上的消息。                | `string`   | 是  | —                |

## 示例 [#example]

```bash
# 暂存翻译以供人工审核
npx gt stage

# 暂存并为本次运行添加标签，以便在仪表板中追踪
npx gt stage --tag v2.1.0 -m "Q3 release"

# 翻译审核通过后，下载翻译内容
npx gt translate
```

## 其他说明 [#notes]

* 只有在你的 Project 启用了人工审核时，`stage` 才有用。
* 执行暂存会设置 [`stageTranslations`](/docs/cli/reference/config#stage) 配置键。参见[将翻译暂存以供审核](/docs/cli/guides/managing-translations#review)。