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

# trạng thái

> Báo cáo trạng thái bản dịch theo từng khóa/namespace/ngôn ngữ trong CSV, với bảng điều khiển TTY tương tác tùy chọn.

## Cách sử dụng

```bash theme={null}
hyperlocalise status [--config <path>] [flags]
```

## Cờ

* `--config`: đường dẫn đến tệp cấu hình
* `--locale`: bộ lọc locale đích (có thể lặp lại)
* `--output`: định dạng đầu ra (`csv`)
* `--group`: lọc theo tên nhóm
* `--bucket`: lọc theo tên bucket
* `-i`, `--interactive`: hiển thị bảng điều khiển tương tác trong TTY (yêu cầu `--output csv`)

## Giá trị trạng thái

* `translated`: giá trị không rỗng và không được đánh dấu là bản nháp
* `needs_review`: tính nguồn gốc là `origin=llm` và `state=draft`
* `source_match`: phân đoạn markdown/mdx không rỗng nhưng giống hệt văn bản nguồn
* `untranslated`: giá trị trống

## Lược đồ CSV

`status --output csv` luôn luôn phát ra tiêu đề này:

```csv theme={null}
key,namespace,locale,status,origin,state
```

Ý nghĩa cột:

* `key`: mã định danh khóa dịch
* `namespace`: không gian tên logic để nhóm khóa
* `locale`: ngôn ngữ đích
* `status`: phân loại trạng thái đã tính toán
* `origin`: nguồn giá trị (`llm`, `human`, hoặc nguồn gốc xuất xứ từ adapter)
* `state`: trạng thái quy trình làm việc (ví dụ `draft` hoặc trạng thái tương đương đã được tuyển chọn)

## Ánh xạ nhãn sẵn sàng cho CI (thử nghiệm)

Sử dụng ánh xạ này khi quy trình của bạn mong đợi nhãn ở cấp sản phẩm:

| CSV `status`   | nhãn sẵn sàng cho CI |
| -------------- | -------------------- |
| `translated`   | `ready`              |
| `needs_review` | `needs review`       |
| `source_match` | `needs review`       |
| `untranslated` | `missing`            |

## Ví dụ về cổng CI

Chặn khi có bất kỳ mục nào `missing`:

```bash theme={null}
hyperlocalise status --output csv > status.csv
awk -F, 'NR>1 && $4=="untranslated"{bad=1} END{exit bad}' status.csv
```

Chặn khi `needs review` vượt quá `20` hàng:

```bash theme={null}
hyperlocalise status --output csv > status.csv
awk -F, 'NR>1 && $4=="needs_review"{count++} END{exit(count>20)}' status.csv
```

## Ví dụ

```bash theme={null}
hyperlocalise status --locale es-ES --output csv
```

```bash theme={null}
hyperlocalise status --group default --output csv -i
```

## Xem thêm

* [chạy](/commands/run)
* [eval](/commands/eval)
* [sync pull](/commands/sync-pull)
* [sync push](/commands/sync-push)
* [Định dạng đầu ra](/reference/output-formats)