譯者 · 资源译器

完全向后兼容:provider默认为azure,故既有Azure工作流程不变,无需更改。

選擇供應者

设provider输入为azure(默认)、aws或google,继而提供该供应商之凭证。每次操作调用仅用一提供者; 此動作決定性地委派予工廠後之匹配SDK。

提供者比較

Azure AI 译者

提供者价值: Azure(默认)
SDK: @azure-rest/ai-translation-text

subscriptionKey, endpoint, region(可选)

AWS翻譯

提供者价值: AWS
SDK: @aws-sdk/client-translate

OIDC / 默认链,或 awsAccessKeyID + awsSecretAccessKey; awsRegion

谷歌云译

提供者价值: 谷歌
SDK: @google-cloud/translate

googleApiKey 或 googleCredentials(service-account JSON)

Azure AI 翻译器(默认)

預設供應者。设Azure AI翻译资源,转subscriptionKey、endpoint及可选region。此配置與現有工作流程相同。

Official Azure docs

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            azure:
              subscriptionKey: ${{ secrets.TRANSLATOR_KEY }}
              endpoint: ${{ secrets.TRANSLATOR_ENDPOINT }}
              region: ${{ secrets.TRANSLATOR_REGION }}
          sourceLocale: en
          toLocales: '["es","fr","de"]'

AWS翻譯

用@aws-sdk/client-translate。宜以aws-actions/configure-aws-credentials方式启用OIDC,以免长存秘密——动作读取AWS SDK默认凭证链。或可awsAccessKeyId明示awsSecretAccessKey。區域必由awsRegion或AWS_REGION環境變數而定。

Official AWS docs

OIDC(荐)

permissions:
  id-token: write # for aws-actions/configure-aws-credentials OIDC
  contents: write
  pull-requests: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/gh-actions-translate
          aws-region: us-east-1

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            aws:
              region: us-east-1 # or rely on AWS_REGION from the step above
              formality: FORMAL
              brevity: true
          sourceLocale: en
          toLocales: '["es","fr","de"]'

欲用静态键代OIDC,去aws-actions/configure-aws-credentials步,传awsAccessKeyId/awsSecretAccessKey(经secrets)加awsRegion。

谷歌云译

用@google-cloud/translate(v2)。以API密钥(googleApiKey)或服务账户JSON凭证(googleCredentials)认证。仅供一枚; 若遺漏憑證,則可推斷可選googleProjectId。

Official Google docs

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: translator
        uses: IEvangelist/resource-translator@v3
        with:
          provider: |
            google:
              # Provide EITHER a service-account JSON credential...
              credentials: ${{ secrets.GCP_TRANSLATE_CREDENTIALS }}
              # ...OR an API key:
              # apiKey: ${{ secrets.GCP_TRANSLATE_API_KEY }}
              model: nmt
          sourceLocale: en
          toLocales: '["es","fr","de"]'

意图-指定映射

提供者专属之指定符,映射于有等价者处。余皆归于合理默认,故行为恒一。

textType

Azure: textType(純/html)
AWS: 忽略(无开关)
谷歌: 格式(文本/HTML)

profanityAction

Azure: 全力支持
AWS: 标记/删除→掩蔽
谷歌: 被忽视

categoryId

Azure: 定制译者
AWS: 被忽视
谷歌: 被忽视

allowFallback

Azure: 支持者
AWS: 被忽视
谷歌: 被忽视

awsFormality

Azure: Ignored
AWS: Formality setting
谷歌: Ignored

awsBrevity

Azure: Ignored
AWS: Brevity mode
谷歌: Ignored

awsTerminologyNames

Azure: Ignored
AWS: Custom terminology
谷歌: Ignored

awsParallelDataNames

Azure: Ignored
AWS: Parallel data
谷歌: Ignored

googleModel

Azure: Ignored
AWS: Ignored
谷歌: Translation model

googleApiEndpoint

Azure: Ignored
AWS: Ignored
谷歌: API endpoint override

各地代碼因供應商而異

各供应商用其本地码(如简体中文Azure zh-Hans,AWS zh,Google zh-CN)。代码依原样传递,驱动输出文件名,故择所选供应商支持之toLocales值。