概述

GT CLI 现在可以将任意已翻译的文件类型发布到 GT CDN。JSON、MDX、YAML 以及所有其他受支持的文件类型，现在都可以直接通过 translate、upload 和 save-local 命令发布。

配置

全局发布标志

为任何受支持的命令添加 --publish：

npx gt translate --publish

或者在 gt.config.json 中设置：

{
  "publish": true
}

这会将所有翻译后的文件 (包括 GT JSON) 发布到 CDN。

按文件控制发布

你可以使用 include 模式语法，单独控制某个文件是否发布。不要再使用普通的 glob 字符串，而要改用带有 publish 标志的对象：

{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": [
        { "pattern": "locales/[locale]/*.json", "publish": true },
        { "pattern": "locales/[locale]/internal/**/*.json", "publish": false }
      ]
    }
  }
}

在此示例中，locales/[locale]/ 下的所有 JSON 文件都会发布到 CDN，internal/ 子目录下的文件除外。

GT JSON 发布控制

GT 的内部格式在 gt 键下也有自己的发布标志：

{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json",
      "publish": true
    }
  }
}

判定顺序

对于任意文件，CLI 会按以下顺序判定是否发布：

1. 显式禁用 — 文件匹配某个 include 条目，且 "publish": false → 不发布，或从 CDN 中移除
2. 显式启用 — 文件匹配某个 include 条目，且 "publish": true → 发布到 CDN
3. 全局回退 — 使用顶层 publish 设置 (未设置时默认为 false)

如果任何层级都没有设置发布配置，则会完全跳过发布步骤——不会发起任何 API 调用。

支持发布的命令

链接

• CLI 配置参考
• PR #1122 — 初步支持文件发布
• PR #1132 — 修复启用问题
• PR #1133 — 在保存或执行 upload 时发布