> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Bộ điều hợp cụm từ

> Cấu hình Phrase để đồng bộ dịch từ xa.

## Cấu hình bắt buộc

```jsonc theme={null}
{
  "storage": {
    "adapter": "phrase",
    "config": {
      "projectID": "project-uuid",
      "apiTokenEnv": "PHRASE_API_TOKEN",
      "mode": "strings"
    }
  }
}
```

## Các trường cấu hình tùy chọn

* `sourceLanguage`
* `targetLanguages`
* `timeoutSeconds`
* `fileFormat` (bắt buộc khi `mode` là `files`)

## Chế độ

* `strings`: kéo và đẩy bằng khóa Phrase và các API dịch thuật.
* `files`: kéo và đẩy bằng các công việc xuất/nhập Phrase.

## Các vấn đề thường gặp

* không tìm thấy token: export `PHRASE_API_TOKEN`
* lỗi xác thực chế độ: đặt `mode` thành `strings` hoặc `files`
* lỗi nhập chế độ tệp: hãy xác minh `fileFormat` khớp với cài đặt dự án của bạn

## Cấu hình Phrase CLI

Các lệnh quy trình tệp cũng có thể đọc định dạng `.phrase.yml` của Phrase:

```yaml theme={null}
phrase:
  access_token: $PHRASE_ACCESS_TOKEN
  project_id: project-uuid
  file_format: json
  host: https://api.phrase.com/v2
  locale_mapping:
    fr-FR: fr
  push:
    sources:
      - file: ./locales/en.json
        params:
          locale_id: en-US
          tags: app,source
          update_translations: true
  pull:
    targets:
      - file: ./locales/<locale_name>.json
        params:
          locale_id: fr-FR
          include_unverified_translations: false
```

Các lệnh được hỗ trợ:

* `hyperlocalise phrase config validate --config .phrase.yml`
* `hyperlocalise phrase upload sources --config .phrase.yml`
* `hyperlocalise phrase download translations --config .phrase.yml`

Nếu `--config` bị bỏ qua, Hyperlocalise sẽ kiểm tra `PHRASEAPP_CONFIG`, sau đó là `.phrase.yml` trong thư mục hiện tại, rồi đến `$HOME/.phrase.yml`.