@intlayer/docs 7.2.2 → 7.3.0-canary.0

package/docs/vi/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Điền Từ điển
+description: Tìm hiểu cách điền, kiểm tra và dịch từ điển của bạn bằng AI.
+keywords:
+  - Điền
+  - Kiểm tra
+  - Dịch
+  - Từ điển
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Điền / kiểm tra / dịch từ điển
+
+```bash
+npx intlayer fill
+```
+
+Lệnh này phân tích các tệp khai báo nội dung của bạn để tìm các vấn đề tiềm ẩn như thiếu bản dịch, không nhất quán về cấu trúc hoặc không khớp kiểu dữ liệu. Nếu phát hiện bất kỳ vấn đề nào, **intlayer fill** sẽ đề xuất hoặc áp dụng các cập nhật để giữ cho từ điển của bạn nhất quán và đầy đủ.
+
+## Bí danh:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Tham số:
+
+**Tùy chọn danh sách tệp:**
+
+- **`-f, --file [files...]`**: Danh sách các tệp khai báo nội dung cụ thể để kiểm tra. Nếu không được cung cấp, tất cả các tệp `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` được phát hiện dựa trên cấu hình của bạn sẽ được kiểm tra.
+
+  > Ví dụ: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: Lọc từ điển dựa trên các khóa. Nếu không được cung cấp, tất cả các từ điển sẽ được kiểm tra.
+
+  > Ví dụ: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: Lọc từ điển dựa trên các khóa (bí danh của --keys).
+
+  > Ví dụ: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: Loại bỏ các từ điển dựa trên các khóa. Nếu không được cung cấp, tất cả các từ điển sẽ được kiểm tra.
+
+  > Ví dụ: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: Loại bỏ các từ điển dựa trên các khóa (bí danh của --excluded-keys).
+
+  > Ví dụ: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: Lọc các từ điển dựa trên mẫu glob cho đường dẫn tệp.
+
+  > Ví dụ: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Tùy chọn xuất mục nhập:**
+
+- **`--source-locale [sourceLocale]`**: Ngôn ngữ nguồn để dịch từ đó. Nếu không được chỉ định, ngôn ngữ mặc định từ cấu hình của bạn sẽ được sử dụng.
+
+- **`--output-locales [outputLocales...]`**: Các ngôn ngữ đích để dịch sang. Nếu không được chỉ định, tất cả các ngôn ngữ từ cấu hình của bạn sẽ được sử dụng ngoại trừ ngôn ngữ nguồn.
+
+- **`--mode [mode]`**: Chế độ dịch: `complete`, `review`. Mặc định là `complete`. `complete` sẽ điền tất cả nội dung còn thiếu, `review` sẽ điền nội dung còn thiếu và xem xét lại các khóa đã tồn tại.
+
+**Tùy chọn Git:**
+
+- **`--git-diff`**: Chỉ chạy trên các từ điển có thay đổi từ cơ sở (mặc định `origin/main`) đến nhánh hiện tại (mặc định: `HEAD`).
+- **`--git-diff-base`**: Chỉ định tham chiếu cơ sở cho git diff (mặc định `origin/main`).
+- **`--git-diff-current`**: Chỉ định tham chiếu hiện tại cho git diff (mặc định `HEAD`).
+- **`--uncommitted`**: Bao gồm các thay đổi chưa được commit.
+- **`--unpushed`**: Bao gồm các thay đổi chưa được đẩy lên.
+- **`--untracked`**: Bao gồm các tệp chưa được theo dõi.
+
+  > Ví dụ: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ví dụ: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**Tùy chọn AI:**
+
+- **`--model [model]`**: Mô hình AI được sử dụng cho việc dịch (ví dụ: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Nhà cung cấp AI được sử dụng cho việc dịch.
+- **`--temperature [temperature]`**: Thiết lập nhiệt độ cho mô hình AI.
+- **`--api-key [apiKey]`**: Cung cấp khóa API riêng của bạn cho dịch vụ AI.
+- **`--custom-prompt [prompt]`**: Cung cấp một prompt tùy chỉnh cho hướng dẫn dịch của bạn.
+- **`--application-context [applicationContext]`**: Cung cấp ngữ cảnh bổ sung cho việc dịch AI.
+
+  > Ví dụ: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Ứng dụng của tôi là một cửa hàng mèo"`
+
+**Tùy chọn biến môi trường:**
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file [envFile]`**: Cung cấp một file môi trường tùy chỉnh để tải các biến.
+
+  > Ví dụ: `npx intlayer fill --env-file .env.production.local`
+
+  > Ví dụ: `npx intlayer fill --env production`
+
+**Tùy chọn cấu hình:**
+
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án.
+
+  > Ví dụ: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer build --no-cache`
+
+**Tùy chọn chuẩn bị:**
+
+- **`--build`**: Xây dựng các từ điển trước khi đẩy để đảm bảo nội dung được cập nhật. True sẽ bắt buộc xây dựng, false sẽ bỏ qua việc xây dựng, undefined sẽ cho phép sử dụng bộ nhớ đệm của lần xây dựng trước đó.
+
+- **`--skip-metadata`**: Bỏ qua việc điền các metadata còn thiếu (mô tả, tiêu đề, thẻ) cho các từ điển.
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+
+## Ví dụ:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Lệnh này sẽ dịch nội dung từ tiếng Anh sang tiếng Pháp và tiếng Tây Ban Nha cho tất cả các file khai báo nội dung trong thư mục `src/home/` sử dụng mô hình GPT-3.5 Turbo.

package/docs/vi/cli/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI
+description: Khám phá cách sử dụng Intlayer CLI để quản lý trang web đa ngôn ngữ của bạn. Làm theo các bước trong tài liệu trực tuyến này để thiết lập dự án của bạn trong vài phút.
+keywords:
+  - CLI
+  - Giao diện Dòng Lệnh
+  - Quốc tế hóa
+  - Tài liệu
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: Thêm lệnh transform
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: Thêm tùy chọn skipIfExists cho lệnh translate
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: Thêm bí danh cho các tham số và lệnh CLI
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: Thêm tùy chọn build cho các lệnh
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: Thêm lệnh version
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: Đặt tùy chọn verbose mặc định là true khi sử dụng CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: Thêm lệnh watch và tùy chọn with
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: Thêm lệnh editor
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Thêm lệnh content test và list
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: Cập nhật tài liệu tham số lệnh CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Intlayer CLI
+
+---
+
+## Mục Lục
+
+<TOC/>
+
+---
+
+## Cài Đặt Gói
+
+Cài đặt các gói cần thiết bằng npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+ yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> Nếu gói `intlayer` đã được cài đặt, cli sẽ tự động được cài đặt. Bạn có thể bỏ qua bước này.
+
+## Gói intlayer-cli
+
+Gói `intlayer-cli` nhằm mục đích biên dịch các [khai báo intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md) của bạn thành các từ điển.
+
+Gói này sẽ biên dịch tất cả các file intlayer, như `src/**/*.content.{ts|js|mjs|cjs|json}`. [Xem cách khai báo các file Intlayer của bạn](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Để diễn giải các từ điển intlayer, bạn có thể sử dụng các trình thông dịch, chẳng hạn như [react-intlayer](https://www.npmjs.com/package/react-intlayer), hoặc [next-intlayer](https://www.npmjs.com/package/next-intlayer)
+
+## Hỗ trợ Tệp Cấu hình
+
+Intlayer chấp nhận nhiều định dạng tệp cấu hình:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Để xem cách cấu hình các ngôn ngữ có sẵn hoặc các tham số khác, hãy tham khảo [tài liệu cấu hình tại đây](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md).
+
+## Chạy các lệnh intlayer
+
+### Các Lệnh Cơ Bản
+
+- **[Xây dựng Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/build.md)** - Xây dựng từ điển của bạn từ các tệp khai báo nội dung
+- **[Theo dõi Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/watch.md)** - Theo dõi các thay đổi và tự động xây dựng từ điển
+- **[Kiểm tra Phiên bản CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/version.md)** - Kiểm tra phiên bản Intlayer CLI đã cài đặt
+
+### Quản lý Từ điển
+
+- **[Đẩy Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/push.md)** - Đẩy từ điển lên trình chỉnh sửa và CMS của Intlayer
+- **[Kéo Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/pull.md)** - Kéo từ điển từ trình chỉnh sửa và CMS của Intlayer
+- **[Điền Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/fill.md)** - Điền, kiểm tra và dịch từ điển bằng AI
+- **[Kiểm tra Bản dịch Thiếu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/test.md)** - Kiểm tra và xác định các bản dịch còn thiếu
+- **[Liệt kê Tệp Khai báo Nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/list.md)** - Liệt kê tất cả các tệp khai báo nội dung trong dự án của bạn
+
+### Quản lý Thành phần
+
+- **[Chuyển đổi Thành phần](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/transform.md)** - Chuyển đổi các thành phần hiện có để sử dụng Intlayer
+
+### Cấu hình
+
+- **[Quản lý Cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/configuration.md)** - Lấy và đẩy cấu hình Intlayer của bạn lên CMS
+
+### Quản lý Tài liệu
+
+- **[Dịch Tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-translate.md)** - Tự động dịch các tệp tài liệu bằng AI
+- **[Xem lại Tài liệu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/doc-review.md)** - Xem lại các tệp tài liệu để đảm bảo chất lượng và tính nhất quán
+
+### Trình chỉnh sửa & Đồng bộ trực tiếp
+
+- **[Lệnh Trình chỉnh sửa](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/editor.md)** - Sử dụng các lệnh trình chỉnh sửa Intlayer
+- **[Lệnh Đồng bộ Trực tiếp](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/live.md)** - Sử dụng Đồng bộ Trực tiếp để phản ánh các thay đổi nội dung CMS trong thời gian chạy
+
+### Công cụ Phát triển
+
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/sdk.md)** - Sử dụng Intlayer CLI SDK trong mã của bạn
+- **[Lệnh Gỡ lỗi Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/debug.md)** - Gỡ lỗi và khắc phục sự cố Intlayer CLI
+
+## Sử dụng các lệnh intlayer trong `package.json` của bạn
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **Lưu ý**: Bạn cũng có thể sử dụng các bí danh ngắn hơn:
+>
+> - `npx intlayer list` thay vì `npx intlayer content list`
+> - `npx intlayer test` thay vì `npx intlayer content test`

package/docs/vi/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Liệt kê các tệp khai báo nội dung
+description: Tìm hiểu cách liệt kê tất cả các tệp khai báo nội dung trong dự án của bạn.
+keywords:
+  - Liệt kê
+  - Khai báo nội dung
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# Liệt kê các tệp khai báo nội dung
+
+```bash
+npx intlayer content list
+```
+
+## Bí danh:
+
+- `npx intlayer list`
+
+Lệnh này hiển thị tất cả các tệp khai báo nội dung trong dự án của bạn, cho thấy các khóa từ điển và đường dẫn tệp của chúng. Nó hữu ích để có cái nhìn tổng quan về tất cả các tệp nội dung của bạn và xác minh rằng chúng được Intlayer phát hiện đúng cách.
+
+## Ví dụ:
+
+```bash
+npx intlayer content list
+```
+
+## Ví dụ đầu ra:
+
+```bash
+npx intlayer content list
+Content declaration files:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+Tổng số tệp khai báo nội dung: 3
+```
+
+Lệnh này sẽ xuất ra:
+
+- Một danh sách được định dạng của tất cả các tệp khai báo nội dung với các khóa và đường dẫn tệp tương đối của chúng
+- Tổng số tệp khai báo nội dung được tìm thấy
+
+Kết quả đầu ra giúp bạn xác minh rằng tất cả các tệp nội dung của bạn được cấu hình đúng và có thể được hệ thống Intlayer phát hiện.

package/docs/vi/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Lệnh Live Sync
+description: Tìm hiểu cách sử dụng Live Sync để phản ánh các thay đổi nội dung CMS trong thời gian chạy.
+keywords:
+  - Live Sync
+  - CMS
+  - Runtime
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# Lệnh Live Sync
+
+Live Sync cho phép ứng dụng của bạn phản ánh các thay đổi nội dung CMS trong thời gian chạy. Không cần xây dựng lại hoặc triển khai lại. Khi được bật, các cập nhật sẽ được truyền đến một máy chủ Live Sync để làm mới các từ điển mà ứng dụng của bạn đọc. Xem thêm [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md) để biết chi tiết.
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## Tham số:
+
+**Tùy chọn cấu hình:**
+
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án. Để lấy cấu hình intlayer, lệnh sẽ tìm file `intlayer.config.{ts,js,json,cjs,mjs}` trong thư mục gốc.
+
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)

package/docs/vi/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Kéo Từ Điển
+description: Tìm hiểu cách kéo từ điển từ trình chỉnh sửa Intlayer và CMS.
+keywords:
+  - Kéo
+  - Từ điển
+  - CLI
+  - Intlayer
+  - Trình chỉnh sửa
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# Kéo Từ Điển Từ Xa
+
+```bash
+npx intlayer pull
+```
+
+Nếu đã cài đặt [trình chỉnh sửa intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md), bạn cũng có thể kéo từ điển từ trình chỉnh sửa. Bằng cách này, bạn có thể ghi đè nội dung của các từ điển để phục vụ nhu cầu ứng dụng của bạn.
+
+## Bí danh:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## Tham số:
+
+**Tùy chọn từ điển:**
+
+- **`-d, --dictionaries`**: Id của các từ điển cần kéo. Nếu không chỉ định, tất cả các từ điển sẽ được kéo.
+
+  > Ví dụ: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: Id của các từ điển cần kéo (bí danh của --dictionaries).
+
+  > Ví dụ: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Tùy chọn cấu hình:**
+
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án. Để lấy cấu hình intlayer, lệnh sẽ tìm file `intlayer.config.{ts,js,json,cjs,mjs}` trong thư mục gốc.
+
+  > Ví dụ: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer build --no-cache`
+
+**Tùy chọn biến môi trường:**
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`).
+- **`--env-file`**: Cung cấp file môi trường tùy chỉnh để tải các biến.
+- **`--base-dir`**: Chỉ định thư mục gốc cho dự án. Để lấy cấu hình intlayer, lệnh sẽ tìm file `intlayer.config.{ts,js,json,cjs,mjs}` trong thư mục gốc.
+
+  > Ví dụ: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Ví dụ: `npx intlayer dictionary push --env production`
+
+**Tùy chọn đầu ra:**
+
+- **`--new-dictionaries-path`** : Đường dẫn đến thư mục nơi các từ điển mới sẽ được lưu. Nếu không được chỉ định, các từ điển mới sẽ được lưu trong thư mục `./intlayer-dictionaries` của dự án. Nếu trường `filePath` được chỉ định trong nội dung từ điển của bạn, các từ điển sẽ không xem xét tham số này và sẽ được lưu trong thư mục `filePath` đã chỉ định.
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+
+## Ví dụ:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```

package/docs/vi/cli/push.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Đẩy Từ Điển
+description: Tìm hiểu cách đẩy từ điển của bạn lên trình chỉnh sửa và CMS của Intlayer.
+keywords:
+  - Đẩy
+  - Từ điển
+  - CLI
+  - Intlayer
+  - Trình chỉnh sửa
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - push
+---
+
+# Đẩy Từ Điển
+
+```bash
+npx intlayer dictionary push
+```
+
+Nếu [trình chỉnh sửa intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md) đã được cài đặt, bạn cũng có thể đẩy từ điển lên trình chỉnh sửa. Lệnh này sẽ cho phép làm cho các từ điển có sẵn trên [trình chỉnh sửa](https://intlayer.org/dashboard). Bằng cách này, bạn có thể chia sẻ từ điển với nhóm của mình và chỉnh sửa nội dung mà không cần chỉnh sửa mã nguồn của ứng dụng.
+
+## Bí danh:
+
+- `npx intlayer dictionaries push`
+- `npx intlayer dictionary push`
+- `npx intlayer dic push`
+
+## Tham số:
+
+**Tùy chọn từ điển:**
+
+- **`-d`, `--dictionaries`**: các id của từ điển cần đẩy. Nếu không chỉ định, tất cả từ điển sẽ được đẩy.
+
+  > Ví dụ: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: các id của từ điển cần đẩy (bí danh của --dictionaries).
+
+  > Ví dụ: `npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Tùy chọn cấu hình:**
+
+- **`--base-dir`**: Chỉ định thư mục gốc của dự án. Để lấy cấu hình intlayer, lệnh sẽ tìm file `intlayer.config.{ts,js,json,cjs,mjs}` trong thư mục gốc.
+
+  > Ví dụ: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Vô hiệu hóa bộ nhớ đệm.
+
+  > Ví dụ: `npx intlayer build --no-cache`
+
+**Tùy chọn biến môi trường:**
+
+- **`--env`**: Chỉ định môi trường (ví dụ: `development`, `production`). Hữu ích khi bạn sử dụng biến môi trường trong file cấu hình intlayer của bạn.
+- **`--env-file`**: Cung cấp file môi trường tùy chỉnh để tải biến. Hữu ích khi bạn sử dụng biến môi trường trong file cấu hình intlayer của bạn.
+
+  > Ví dụ: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Ví dụ: `npx intlayer dictionary push --env production`
+
+**Tùy chọn đầu ra:**
+
+- **`-r`, `--delete-locale-dictionary`**: Bỏ qua câu hỏi yêu cầu xóa thư mục locales sau khi các từ điển được đẩy lên, và xóa chúng. Mặc định, nếu từ điển được định nghĩa cục bộ, nó sẽ ghi đè nội dung từ điển ở xa.
+
+  > Ví dụ: `npx intlayer dictionary push -r`
+
+  > Ví dụ: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: Bỏ qua câu hỏi yêu cầu xóa thư mục locales sau khi các từ điển được đẩy lên, và giữ lại chúng. Mặc định, nếu từ điển được định nghĩa cục bộ, nó sẽ ghi đè nội dung từ điển ở xa.
+
+  > Ví dụ: `npx intlayer dictionary push -k`
+
+  > Ví dụ: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Tùy chọn chuẩn bị:**
+
+- **`--build`**: Xây dựng các từ điển trước khi đẩy lên để đảm bảo nội dung được cập nhật. True sẽ bắt buộc xây dựng, false sẽ bỏ qua việc xây dựng, undefined sẽ cho phép sử dụng bộ nhớ đệm của bản xây dựng.
+
+**Tùy chọn ghi log:**
+
+- **`--verbose`**: Bật ghi log chi tiết để gỡ lỗi. (mặc định là true khi sử dụng CLI)
+
+**Tùy chọn Git:**
+
+- **`--git-diff`**: Chỉ chạy trên các từ điển có thay đổi từ cơ sở (mặc định `origin/main`) đến nhánh hiện tại (mặc định: `HEAD`).
+- **`--git-diff-base`**: Chỉ định tham chiếu cơ sở cho git diff (mặc định `origin/main`).
+- **`--git-diff-current`**: Chỉ định tham chiếu hiện tại cho git diff (mặc định: `HEAD`).
+- **`--uncommitted`**: Bao gồm các thay đổi chưa được commit.
+- **`--unpushed`**: Bao gồm các thay đổi chưa được đẩy lên.
+- **`--untracked`**: Bao gồm các file chưa được theo dõi.
+
+  > Ví dụ: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ví dụ: `npx intlayer dictionary push --uncommitted --unpushed --untracked`

package/docs/vi/cli/sdk.md

@@ -0,0 +1,67 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI SDK
+description: Tìm hiểu cách sử dụng Intlayer CLI SDK trong mã của bạn.
+keywords:
+  - SDK
+  - CLI
+  - Intlayer
+  - Programmatic
+slugs:
+  - doc
+  - concept
+  - cli
+  - sdk
+---
+
+# CLI SDK
+
+CLI SDK là một thư viện cho phép bạn sử dụng Intlayer CLI trong mã của riêng bạn.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+Ví dụ sử dụng:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  listContentDeclaration,
+  testMissingTranslations,
+  docTranslate,
+  docReview,
+  transform,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+listContentDeclaration();
+// ...
+testMissingTranslations();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+transform();
+// ...
+```