# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/zh/docs/cli/reference/commands/stage.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 提交项目进行异步翻译，并在稍后下载。gt stage 命令的 API 参考。

提交项目进行异步翻译，而不会在同一次运行中下载或发布结果。当你的项目启用了人工审校，或者 Lottie 等格式无法在单次 [`gt translate`](/docs/cli/reference/commands/translate) 运行中完成时，请使用此命令。有关这两种工作流，请参阅[管理翻译](/docs/cli/guides/managing-translations)。

运行 `stage` 会在你的 `gt.config.json` 中将 `stageTranslations` 设为 `true`。启用后，[`gt translate`](/docs/cli/reference/commands/translate) 仅下载已暂存的版本。如果没有暂存任何版本，它会完成运行而不下载文件。翻译准备就绪后——如需审校，则须待其获批——运行 [`gt download`](/docs/cli/reference/commands/download)。[`gt 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`](/docs/cli/reference/commands/translate) 只会下载已暂存的版本。如果没有已暂存的版本，它会完成但不会下载文件。使用 [`gt download`](/docs/cli/reference/commands/download) 下载已完成的翻译，或者使用 [`gt translate`](/docs/cli/reference/commands/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`                     | 仅解析并验证，不上传或排入翻译队列。                                                                          | `boolean`  | 是  | `false`          |
| `--save-local, --no-save-local` | 启用或禁用在排入队列前保存 local edits。会覆盖 [`options.saveLocal`](/docs/cli/reference/config#save-local)。 | `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 download
```

## 其他说明 [#notes]

* 启用人工审校或翻译 [Lottie](/docs/cli/reference/formats/lottie-files) 等异步格式时，请使用 `stage`。

- 执行暂存会设置 [`stageTranslations`](/docs/cli/reference/config#stage) 配置键。参见[将翻译暂存以供审校](/docs/cli/guides/managing-translations#review)。

## Sitemap

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