@intlayer/docs 8.1.10 → 8.2.0

package/docs/update_docs.py

@@ -0,0 +1,65 @@
+import os
+import re
+
+locales = [
+    "ar", "de", "en", "en-GB", "es", "fr", "hi", "id", "it", "ja", "ko", "pl", "pt", "ru", "tr", "uk", "vi", "zh"
+]
+
+translations = {
+    "ar": {"cli_title": "الإعداد عبر واجهة سطر أوامر Intlayer (موصى به)"},
+    "de": {"cli_title": "Einrichtung über die Intlayer CLI (empfohlen)"},
+    "en": {"cli_title": "Setup via Intlayer CLI (recommended)"},
+    "en-GB": {"cli_title": "Setup via Intlayer CLI (recommended)"},
+    "es": {"cli_title": "Configuración a través de la CLI de Intlayer (recomendado)"},
+    "fr": {"cli_title": "Configuration via la CLI Intlayer (recommandé)"},
+    "hi": {"cli_title": "Intlayer CLI के माध्यम से सेटअप (अनुशंसित)"},
+    "id": {"cli_title": "Setup melalui CLI Intlayer (disarankan)"},
+    "it": {"cli_title": "Configurazione tramite la CLI di Intlayer (consigliata)"},
+    "ja": {"cli_title": "Intlayer CLI経由のセットアップ（推奨）"},
+    "ko": {"cli_title": "Intlayer CLI를 통한 설정 (권장)"},
+    "pl": {"cli_title": "Konfiguracja przez Intlayer CLI (zalecane)"},
+    "pt": {"cli_title": "Configuração via CLI do Intlayer (recomendado)"},
+    "ru": {"cli_title": "Настройка через Intlayer CLI (рекомендуется)"},
+    "tr": {"cli_title": "Intlayer CLI aracılığıyla kurulum (önerilen)"},
+    "uk": {"cli_title": "Налаштування через Intlayer CLI (рекомендовано)"},
+    "vi": {"cli_title": "Thiết lập qua Intlayer CLI (khuyên dùng)"},
+    "zh": {"cli_title": "通过 Intlayer CLI 设置（推荐）"}
+}
+
+base_dir = "/Users/aymericpineau/Documents/intlayer_/docs/docs"
+
+vsc_title = "## Setup via Intlayer VS Code extension"
+
+for lang in locales:
+    file_path = os.path.join(base_dir, lang, "mcp_server.md")
+    if not os.path.exists(file_path):
+        continue
+    
+    with open(file_path, "r", encoding="utf-8") as f:
+        content = f.read()
+    
+    # Update title as requested
+    # Standardize titles even if translated before, because user explicitly asked for English title specifically.
+    # Pattern to find the section and ensure its title is exactly as requested
+    content = re.sub(r"## (Using|Utilisation|Uso|Installation|Einrichtung|إعداد|सेटअप|Setup|でのセットアップ|에서 설정|Konfiguracja|Configuração|Настройка|Kurulum|Thiết lập|通过).*VS Code.*extension.*", "## Setup via Intlayer VS Code extension", content)
+    
+    # Standardize CLI titles too if they exist
+    trans = translations.get(lang)
+    if trans:
+        cli_pattern = r"## (Setup via Intlayer CLI|Configuration via la CLI Intlayer|Configuración a través de la CLI de Intlayer|Einrichtung über die Intlayer CLI|الإعداد عبر واجهة سطر أوامر|Intlayer CLI के माध्यम से|Setup attraverso la CLI|Intlayer CLI経由のセットアップ|Intlayer CLI를 통한 설정|Konfiguracja przez Intlayer CLI|Configuração via CLI|Настройка через Intlayer CLI|Intlayer CLI aracılığıyla|Налаштування через Intlayer CLI|Thiết lập qua Intlayer CLI|通过 Intlayer CLI 设置).*"
+        content = re.sub(cli_pattern, f"## {trans['cli_title']}", content)
+
+    # General updates
+    content = re.sub(r"updatedAt: \d{4}-\d{2}-\d{2}", "updatedAt: 2026-03-03", content)
+    content = re.sub(r"docs/docs/" + re.escape(lang) + r"/intlayer_cli\.md", "docs/docs/" + lang + "/cli/index.md", content)
+    
+    # Fix Claude Desktop JSON block extra brace issue for all
+    # Pattern to fix the double closure if it exists
+    # If the file has ...}\n}\n}\n```, change to ...}\n}\n}\n}\n``` if it was meant to be 4 deep?
+    # Actually, Claude Desktop config uses "mcpServers": { "intlayer": { ... } } so it needs 3 closing braces for the object + 1 for file?
+    # Usually: { "mcpServers": { "intlayer": { ... } } } - so 3 braces at the end.
+    
+    with open(file_path, "w", encoding="utf-8") as f:
+        f.write(content)
+
+print("Done")

package/docs/vi/CI_CD.md

@@ -95,7 +95,7 @@ npx intlayer build                          # Để đảm bảo từ điển đ
 npx intlayer fill --unpushed --mode fill    # Chỉ điền nội dung còn thiếu, không cập nhật những nội dung đã có
 ```
 
-> Để biết thêm thông tin về các lệnh Intlayer CLI và cách sử dụng chúng, hãy tham khảo [tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+> Để biết thêm thông tin về các lệnh Intlayer CLI và cách sử dụng chúng, hãy tham khảo [tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 > Nếu bạn có nhiều ứng dụng trong kho mã của mình sử dụng các instance intlayer riêng biệt, bạn có thể sử dụng đối số `--base-dir` như sau:
 
@@ -195,4 +195,4 @@ jobs:
 
 > Mặc định, đối số `--git-diff` lọc các từ điển bao gồm các thay đổi từ base (mặc định `origin/main`) đến nhánh hiện tại (mặc định: `HEAD`).
 
-> Để biết thêm thông tin về các lệnh Intlayer CLI và cách sử dụng chúng, hãy tham khảo [tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+> Để biết thêm thông tin về các lệnh Intlayer CLI và cách sử dụng chúng, hãy tham khảo [tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).

package/docs/vi/agent_skills.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-02-09
-updatedAt: 2026-02-12
+updatedAt: 2026-03-03
 title: Kỹ năng Agent
 description: Tìm hiểu cách sử dụng Intlayer Agent Skills để cải thiện khả năng AI agent hiểu về dự án của bạn, bao gồm các hướng dẫn thiết lập toàn diện cho Metadata, Sitemaps và Server Actions.
 keywords:
@@ -15,63 +15,89 @@ slugs:
 history:
   - version: 8.1.0
     date: 2026-02-09
-    changes: Init history
+    changes: Khởi tạo lịch sử
 ---
 
 # Kỹ năng Agent
 
-## Lệnh `intlayer init skills`
+## Thiết lập
 
-Lệnh `intlayer init skills` là cách dễ nhất để thiết lập agent skills trong dự án của bạn. Nó phát hiện môi trường và cài đặt các tập tin cấu hình cần thiết cho các nền tảng bạn ưu tiên.
+### Sử dụng CLI
+
+Lệnh `intlayer init skills` là cách dễ nhất để thiết lập kỹ năng agent trong dự án của bạn. Nó phát hiện môi trường và cài đặt các tập tin cấu hình cần thiết cho các nền tảng bạn ưu tiên.
 
 ```bash
 npx intlayer init skills
 ```
 
-Hoặc sử dụng Vercel Skill SDK
+### Sử dụng SDK Vercel Skill
 
 ```bash
 npx skills add aymericzip/intlayer-skills
 ```
 
-Khi bạn chạy lệnh này, nó sẽ:
+### Sử dụng tiện ích mở rộng VS Code
+
+1. Mở Command Palette (Ctrl+Shift+P hoặc Cmd+Shift+P).
+2. Nhập `Intlayer: Setup AI Agent Skills`
+3. Chọn nền tảng bạn sử dụng (ví dụ: `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, v.v.).
+4. Chọn các Kỹ năng bạn muốn cài đặt (ví dụ: `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+5. Nhấn Enter.
+
+## Danh sách kỹ năng
+
+**intlayer-config**
+
+- Hiệu quả hóa việc truyền đạt cho agent hiểu các cấu hình i18n cụ thể cho dự án của bạn, cho phép nó định cấu hình chính xác các ngôn ngữ (locales), mẫu định tuyến và chiến lược dự phòng.
+
+**intlayer-cli**
+
+- Cho phép agent tự động quản lý vòng đời dịch thuật của bạn, bao gồm kiểm tra các bản dịch bị thiếu, xây dựng từ điển và đồng bộ hóa nội dung qua dòng lệnh.
+
+**intlayer-angular**
+
+- Trang bị cho agent chuyên môn cụ thể về framework để triển khai chính xác các mẫu i18n phản ứng và tín hiệu (signals) theo các phương pháp hay nhất của Angular.
+
+**intlayer-astro**
+
+- Cung cấp cho agent kiến thức để xử lý các bản dịch phía máy chủ và các mẫu định tuyến được bản địa hóa duy nhất cho hệ sinh thái Astro.
+
+**intlayer-content**
+
+- Dạy agent cách sử dụng các nút nội dung nâng cao—như số nhiều, điều kiện và markdown—để xây dựng các từ điển phong phú, động và được bản địa hóa.
 
-1.  Phát hiện framework mà bạn đang sử dụng (ví dụ: Next.js, React, Vite).
-2.  Hỏi bạn muốn cài kỹ năng cho nền tảng nào (Cursor, Windsurf, VS Code, OpenCode, Claude Code, GitHub Copilot Workspace, v.v.).
-3.  Tạo các tệp cấu hình cần thiết (chẳng hạn `.cursor/skills/intlayer-next-js/SKILL.md`, `.windsurf/skills/intlayer-next-js/SKILL.md`, `.opencode/skills/intlayer-next-js/SKILL.md`, `.vscode/mcp.json`, v.v.).
+**intlayer-next-js**
 
-## Các nền tảng được hỗ trợ
+- Mang lại cho agent chiều sâu kiến thức để triển khai i18n trên các thành phần Server và Client của Next.js, đảm bảo tối ưu hóa SEO và định tuyến bản địa hóa liền mạch.
 
-Intlayer cung cấp tài liệu cụ thể cho từng framework (Cài đặt, Sử dụng, Metadata, Sitemap, Server Actions, v.v.) để giúp AI agent hiểu cách làm việc với Intlayer trong dự án cụ thể của bạn. Các kỹ năng này được thiết kế để hướng dẫn agent vượt qua các phức tạp của quốc tế hóa, đảm bảo nó tuân theo các mô hình và thực hành tốt nhất.
+**intlayer-react**
 
-Intlayer hỗ trợ tích hợp với các nền tảng sau:
+- Cung cấp kiến thức chuyên sâu để agent triển khai hiệu quả các thành phần và hook i18n khai báo (declarative) trong bất kỳ môi trường nào dựa trên React.
 
-### 1. Cursor
+**intlayer-preact**
 
-Cursor hỗ trợ các máy chủ MCP (Model Context Protocol) và các kỹ năng tùy chỉnh. Chạy `intlayer init skills` sẽ:
+- Tối ưu hóa khả năng của agent trong việc triển khai i18n cho Preact, cho phép nó viết các thành phần bản địa hóa nhẹ nhàng bằng cách sử dụng các tín hiệu và mẫu phản ứng hiệu quả.
 
-- Tạo một tệp `.cursor/mcp.json` để giao tiếp với máy chủ Intlayer MCP.
-- Cài đặt các kỹ năng cụ thể cho framework trong thư mục `.cursor/skills`.
+**intlayer-solid**
 
-### 2. Windsurf
+- Cho phép agent tận dụng khả năng phản ứng tinh vi của SolidJS để quản lý nội dung bản địa hóa hiệu suất cao.
 
-Windsurf là một IDE hỗ trợ bởi AI. Chạy `intlayer init skills` sẽ cài đặt các kỹ năng cụ thể cho framework trong thư mục `.windsurf/skills`.
+**intlayer-svelte**
 
-### 3. VS Code
+- Dạy agent sử dụng các store của Svelte và cú pháp đặc trưng cho nội dung được bản địa hóa an toàn về kiểu dữ liệu và phản ứng trên các ứng dụng Svelte và SvelteKit.
 
-Đối với người dùng VS Code, đặc biệt là những người sử dụng GitHub Copilot hoặc các tiện ích mở rộng tương thích với MCP khác, lệnh:
+**intlayer-cms**
 
-- Tạo cấu hình `.vscode/mcp.json`.
-- Cài đặt các kỹ năng cụ thể cho framework trong thư mục `skills/` ở gốc dự án của bạn.
+- Cho phép agent tích hợp và quản lý nội dung từ xa, cho phép nó xử lý việc đồng bộ hóa trực tiếp và quy trình dịch thuật từ xa thông qua Intlayer CMS.
 
-### 4. OpenCode
+**intlayer-usage**
 
-OpenCode là một tác nhân CLI tương tác được thiết kế cho các tác vụ kỹ thuật phần mềm. Intlayer cung cấp các kỹ năng cụ thể để giúp OpenCode hỗ trợ bạn trong các tác vụ quốc tế hóa. Những kỹ năng này được cài đặt trong thư mục `.opencode/skills`.
+- Tiêu chuẩn hóa phương pháp tiếp cận của agent đối với cấu trúc dự án và khai báo nội dung, đảm bảo nó tuân theo các quy trình làm việc hiệu quả nhất cho dự án i18n của bạn.
 
-### 5. Claude Code
+**intlayer-vue**
 
-Claude Code có thể được cấu hình để sử dụng các kỹ năng của Intlayer. Lệnh này cài đặt các kỹ năng cụ thể cho framework trong thư mục `.claude/skills`.
+- Trang bị cho agent các mẫu cụ thể của Vue—bao gồm Composables và hỗ trợ Nuxt—để xây dựng các ứng dụng web hiện đại, được bản địa hóa.
 
-### 6. GitHub Copilot Workspace
+**intlayer-compiler**
 
-GitHub Copilot Workspace cho phép bạn xác định các kỹ năng tùy chỉnh. Lệnh này cài đặt các kỹ năng cụ thể cho framework trong thư mục `.github/skills`.
+- Đơn giản hóa quy trình làm việc của agent bằng cách cho phép trích xuất nội dung tự động, cho phép nó viết các chuỗi có thể dịch trực tiếp trong mã của bạn mà không cần các tệp từ điển thủ công.

package/docs/vi/cli/extract.md

@@ -61,5 +61,5 @@ Lệnh này phân tích các tệp mã của bạn để trích xuất chuỗi t
 
 Lệnh extract hoạt động mà không cần plugin bổ sung đối với các tệp TypeScript / JSX. Tuy nhiên, nó yêu cầu các plugin sau phải được cài đặt cho các dự án Vue và Svelte:
 
-- **`@intlayer/vue-transformer`**: Cho các tệp Vue.
-- **`@intlayer/svelte-transformer`**: Cho các tệp Svelte.
+- **`@intlayer/vue-compiler`**: Cho các tệp Vue.
+- **`@intlayer/svelte-compiler`**: Cho các tệp Svelte.

package/docs/vi/dictionary/condition.md

@@ -230,7 +230,7 @@ module.exports = ConditionalComponent;
 
 Để biết thêm thông tin chi tiết về cấu hình và cách sử dụng, vui lòng tham khảo các tài nguyên sau:
 
-- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)
+- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
 - [Tài liệu React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)
 - [Tài liệu Intlayer cho Next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)
 

package/docs/vi/dictionary/enumeration.md

@@ -248,7 +248,7 @@ Trong ví dụ này, component tự động điều chỉnh kết quả hiển t
 
 Để biết thêm thông tin chi tiết về cấu hình và cách sử dụng, hãy tham khảo các tài nguyên sau:
 
-- [Tài liệu CLI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)
+- [Tài liệu CLI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
 - [Tài liệu React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)
 - [Tài liệu Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)
 

package/docs/vi/dictionary/file.md

@@ -225,7 +225,7 @@ Hàm `file` dựa trên module `fs` của Node.js để đọc nội dung của
 
 Để biết thêm chi tiết về cách cấu hình và sử dụng nhúng tệp trong Intlayer, hãy tham khảo các tài nguyên sau:
 
-- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)
+- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
 - [Tài liệu React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)
 - [Tài liệu Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)
 - [Tài liệu Nội dung Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/markdown.md)

package/docs/vi/dictionary/gender.md

@@ -266,7 +266,7 @@ module.exports = GenderComponent;
 
 Để biết thêm thông tin chi tiết về cấu hình và cách sử dụng, hãy tham khảo các tài nguyên sau:
 
-- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)
+- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
 - [Tài liệu React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)
 - [Tài liệu Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)
 

package/docs/vi/dictionary/insertion.md

@@ -288,7 +288,7 @@ module.exports = InsertionComponent;
 
 Để biết thêm thông tin chi tiết về cấu hình và cách sử dụng, vui lòng tham khảo các tài nguyên sau:
 
-- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)
+- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
 - [Tài liệu React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)
 - [Tài liệu Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)
 

package/docs/vi/dictionary/nesting.md

@@ -266,7 +266,7 @@ module.exports = NestComponent;
 
 Để biết thêm thông tin chi tiết về cấu hình và cách sử dụng, vui lòng tham khảo các tài nguyên sau:
 
-- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)
+- [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
 - [Tài liệu React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)
 - [Tài liệu Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)
 

package/docs/vi/index.md

@@ -41,7 +41,7 @@ Intlayer cung cấp một phương pháp linh hoạt và hiện đại để d
 - **[Cấu Hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)**  
   Tùy chỉnh Intlayer để phù hợp với nhu cầu dự án của bạn. Khám phá các tùy chọn middleware, cấu trúc thư mục, và các thiết lập nâng cao.
 
-- **[Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md)**  
+- **[Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)**  
   Quản lý nội dung và bản dịch bằng công cụ dòng lệnh của chúng tôi. Khám phá cách đẩy và kéo nội dung, tự động hóa bản dịch, và nhiều hơn nữa.
 
 - **[Trình Soạn Thảo Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md)**  

package/docs/vi/intlayer_CMS.md

@@ -258,7 +258,7 @@ module.exports = config;
 
 ### Đẩy cấu hình của bạn
 
-Để cấu hình Intlayer CMS, bạn có thể sử dụng các lệnh của [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/vi/intlayer_cli.md).
+Để cấu hình Intlayer CMS, bạn có thể sử dụng các lệnh của [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/vi/cli/index.md).
 
 ```bash
 npx intlayer config push
@@ -274,7 +274,7 @@ Lệnh này sẽ tải cấu hình của bạn lên Intlayer CMS.
 
 ### Đẩy một từ điển
 
-Để chuyển đổi các từ điển locale của bạn thành một từ điển từ xa, bạn có thể sử dụng các lệnh của [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/vi/intlayer_cli.md).
+Để chuyển đổi các từ điển locale của bạn thành một từ điển từ xa, bạn có thể sử dụng các lệnh của [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/vi/cli/index.md).
 
 ```bash
 npx intlayer dictionary push -d my-first-dictionary-key

package/docs/vi/intlayer_with_astro.md

@@ -75,7 +75,7 @@ yarn add react react-dom react-intlayer @astrojs/react
 ```
 
 - **intlayer**
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **astro-intlayer**
   Bao gồm plugin tích hợp Astro để tích hợp Intlayer với [trình đóng gói Vite](https://vite.dev/guide/why.html#why-bundle-for-production), cũng như middleware để phát hiện ngôn ngữ ưu tiên của người dùng, quản lý cookie, và xử lý chuyển hướng URL.

package/docs/vi/intlayer_with_create_react_app.md

@@ -76,7 +76,7 @@ bunx intlayer init
 
 - **intlayer**
 
-Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và các [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và các [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **react-intlayer**
 

package/docs/vi/intlayer_with_lynx+react.md

@@ -526,6 +526,6 @@ Tiện ích mở rộng này cung cấp:
 
 - **Trình chỉnh sửa trực quan**: Sử dụng [Trình chỉnh sửa trực quan Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md) để quản lý bản dịch một cách trực quan.
 - **Tích hợp CMS**: Bạn cũng có thể ngoại vi hóa và lấy nội dung từ điển của mình từ một [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md).
-- **Lệnh CLI**: Khám phá [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md) cho các tác vụ như **trích xuất bản dịch** hoặc **kiểm tra các khóa bị thiếu**.
+- **Lệnh CLI**: Khám phá [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md) cho các tác vụ như **trích xuất bản dịch** hoặc **kiểm tra các khóa bị thiếu**.
 
 ---

package/docs/vi/intlayer_with_next-i18next.md

@@ -617,7 +617,7 @@ Các luồng phổ biến:
 - `pnpm i18n:test` trong CI để làm cho build thất bại khi thiếu key
 - `pnpm i18n:fill` chạy cục bộ để đề xuất bản dịch AI cho các key mới được thêm vào
 
-> Bạn có thể cung cấp các đối số CLI; xem thêm tại [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+> Bạn có thể cung cấp các đối số CLI; xem thêm tại [Tài liệu CLI của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 ---
 

package/docs/vi/intlayer_with_next-intl.md

@@ -453,4 +453,4 @@ Ghi chú:
 - `intlayer fill`: sử dụng nhà cung cấp AI của bạn để điền các bản dịch còn thiếu dựa trên các locale đã cấu hình.
 - `intlayer test`: kiểm tra các bản dịch bị thiếu hoặc không hợp lệ (sử dụng trong CI).
 
-Bạn có thể cấu hình các đối số và nhà cung cấp; xem thêm tại [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+Bạn có thể cấu hình các đối số và nhà cung cấp; xem thêm tại [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).

package/docs/vi/intlayer_with_nextjs_14.md

@@ -97,7 +97,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **next-intlayer**
 

package/docs/vi/intlayer_with_nextjs_15.md

@@ -127,9 +127,7 @@ bunx intlayer init
 
 - **intlayer**
 
-- **intlayer**
-
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **next-intlayer**
 

package/docs/vi/intlayer_with_nextjs_compiler.md

@@ -379,9 +379,7 @@ import { Locales, getHTMLTextDir, getLocaleName } from "intlayer";
 import { useLocale } from "next-intlayer";
 
 export const LocaleSwitcher: FC = () => {
-  const { locale, availableLocales, setLocale } = useLocale({
-    onChange: () => window.location.reload(),
-  });
+  const { locale, availableLocales, setLocale } = useLocale();
 
   return (
     <div>

package/docs/vi/intlayer_with_nextjs_no_locale_path.md

@@ -882,9 +882,7 @@ import { Locales, getHTMLTextDir, getLocaleName } from "intlayer";
 import { useLocale } from "next-intlayer";
 
 export const LocaleSwitcher: FC = () => {
-  const { locale, availableLocales, setLocale } = useLocale({
-    onChange: () => window.location.reload(),
-  });
+  const { locale, availableLocales, setLocale } = useLocale();
 
   return (
     <div>
@@ -927,9 +925,7 @@ import { Locales, getHTMLTextDir, getLocaleName } from "intlayer";
 import { useLocale } from "next-intlayer";
 
 export const LocaleSwitcher = () => {
-  const { locale, availableLocales, setLocale } = useLocale({
-    onChange: () => window.location.reload(),
-  });
+  const { locale, availableLocales, setLocale } = useLocale();
 
   return (
     <div>

package/docs/vi/intlayer_with_nextjs_page_router.md

@@ -77,7 +77,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **next-intlayer**
 

package/docs/vi/intlayer_with_react_native+expo.md

@@ -678,7 +678,7 @@ Tiện ích mở rộng này cung cấp:
 
 - **Trình chỉnh sửa trực quan**: Sử dụng [Trình chỉnh sửa trực quan Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md) để quản lý bản dịch một cách trực quan.
 - **Tích hợp CMS**: Bạn cũng có thể tách riêng và lấy nội dung từ từ điển của mình từ một [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md).
-- **Lệnh CLI**: Khám phá [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md) cho các tác vụ như **trích xuất bản dịch** hoặc **kiểm tra các khóa bị thiếu**.
+- **Lệnh CLI**: Khám phá [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md) cho các tác vụ như **trích xuất bản dịch** hoặc **kiểm tra các khóa bị thiếu**.
 
 Chúc bạn xây dựng các ứng dụng **React Native** với i18n đầy đủ sức mạnh thông qua **Intlayer**!
 

package/docs/vi/intlayer_with_react_router_v7.md

@@ -96,7 +96,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và các [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và các [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **react-intlayer**
   Gói tích hợp Intlayer với ứng dụng React. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong React.

package/docs/vi/intlayer_with_react_router_v7_fs_routes.md

@@ -95,7 +95,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và các [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và các [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **react-intlayer**
   Gói tích hợp Intlayer với ứng dụng React. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong React.

package/docs/vi/intlayer_with_tanstack.md

@@ -121,7 +121,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **react-intlayer**
   Gói tích hợp Intlayer với ứng dụng React. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong React.

package/docs/vi/intlayer_with_vite+solid.md

@@ -102,7 +102,7 @@ bunx intlayer init
 
 - **intlayer**
 
-Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **solid-intlayer**  
   Gói tích hợp Intlayer với ứng dụng Solid. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong Solid.

package/docs/vi/intlayer_with_vite+svelte.md

@@ -88,7 +88,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **svelte-intlayer**
   Gói tích hợp Intlayer với ứng dụng Svelte. Nó cung cấp các context providers và hooks cho việc quốc tế hóa trong Svelte.

package/docs/vi/intlayer_with_vite+vue.md

@@ -97,7 +97,7 @@ bunx intlayer init
 
 - **intlayer**
 
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 - **vue-intlayer**
   Gói tích hợp Intlayer với ứng dụng Vue. Nó cung cấp các context provider và composable cho việc quốc tế hóa trong Vue.

package/docs/vi/introduction.md

@@ -148,7 +148,7 @@ Intlayer cung cấp nhiều tính năng được thiết kế phù hợp để
 - **Hỗ trợ Quốc tế hóa**: Nâng cao khả năng tiếp cận toàn cầu của ứng dụng với hỗ trợ quốc tế hóa tích hợp sẵn.
 - **Trình Soạn Thảo Trực Quan**: Cải thiện quy trình phát triển của bạn với các plugin trình soạn thảo được thiết kế dành riêng cho Intlayer. Xem hướng dẫn tại [Hướng Dẫn Trình Soạn Thảo Trực Quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md).
 - **Tùy Biến Cấu Hình**: Tùy chỉnh thiết lập của bạn với các tùy chọn cấu hình phong phú được trình bày chi tiết trong [Hướng Dẫn Cấu Hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md).
-- **Công Cụ CLI Nâng Cao**: Quản lý dự án hiệu quả bằng giao diện dòng lệnh của Intlayer. Khám phá các khả năng trong [Tài Liệu Công Cụ CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+- **Công Cụ CLI Nâng Cao**: Quản lý dự án hiệu quả bằng giao diện dòng lệnh của Intlayer. Khám phá các khả năng trong [Tài Liệu Công Cụ CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 ## Các Khái Niệm Cốt Lõi
 

package/docs/vi/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-07-11
+updatedAt: 2026-03-03
 title: Tài liệu Máy chủ MCP
 description: Khám phá các tính năng và cách thiết lập Máy chủ MCP để tối ưu hóa quản lý và vận hành máy chủ của bạn.
 keywords:
@@ -49,7 +49,7 @@ Bằng cách kích hoạt Máy chủ Intlayer MCP trong IDE của bạn, bạn s
 - **Tích hợp CLI thông minh**
   Truy cập và chạy các lệnh Intlayer CLI trực tiếp từ giao diện IDE của bạn. Sử dụng máy chủ MCP, bạn có thể để trợ lý AI của mình chạy các lệnh như `intlayer dictionaries build` để cập nhật từ điển, hoặc `intlayer dictionaries fill` để điền các bản dịch còn thiếu.
 
-> Xem danh sách đầy đủ các lệnh và tùy chọn trong [tài liệu Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+> Xem danh sách đầy đủ các lệnh và tùy chọn trong [tài liệu Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
 ## Máy chủ cục bộ (stdio) và máy chủ từ xa (SSE)
 
@@ -74,6 +74,32 @@ Lưu ý rằng máy chủ từ xa không tích hợp các công cụ CLI, tự
 
 ---
 
+## Thiết lập qua Intlayer CLI (khuyên dùng)
+
+Intlayer cung cấp lệnh CLI để tự động cấu hình máy chủ MCP trong dự án của bạn.
+
+```bash
+npx intlayer init mcp
+```
+
+Lệnh này sẽ:
+
+1. Hỏi bạn đang sử dụng nền tảng nào (Cursor, VS Code, Claude Desktop, v.v.).
+2. Hỏi bạn muốn sử dụng phương thức vận chuyển nào (Máy chủ cục bộ (stdio) hoặc Máy chủ từ xa (SSE)).
+3. Tự động cập nhật tệp cấu hình của bạn (ví dụ: `.cursor/mcp.json`, `.vscode/mcp.json` hoặc cấu hình Claude Desktop chung).
+
+---
+
+## Setup via Intlayer VS Code extension
+
+1. Mở Command Palette (Ctrl+Shift+P hoặc Cmd+Shift+P).
+2. Nhập `Intlayer: Setup AI Agent Skills`
+3. Chọn nền tảng bạn sử dụng (ví dụ: `VSC Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, v.v.).
+4. Chọn MCP để cài đặt (stdio, SSE)
+5. Nhấn Enter.
+
+---
+
 ## Cài đặt trong Cursor
 
 Theo dõi [tài liệu chính thức](https://docs.cursor.com/context/mcp) để cấu hình máy chủ MCP trong Cursor.

package/docs/vi/per_locale_file.md

@@ -341,4 +341,4 @@ console.log(JSON.stringify(intlayer, null, 2));
 
 ### Tạo Dịch Tự Động
 
-Sử dụng [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md) để tự động điền các bản dịch còn thiếu dựa trên các dịch vụ bạn ưu tiên.
+Sử dụng [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md) để tự động điền các bản dịch còn thiếu dựa trên các dịch vụ bạn ưu tiên.

package/docs/vi/plugins/sync-json.md

@@ -265,7 +265,7 @@ Các tệp JSON được đồng bộ sẽ được coi như các tệp `.conten
 - `intlayer content push` để đẩy các tệp JSON được đồng bộ lên
 - `intlayer content pull` để kéo các tệp JSON được đồng bộ về
 
-Xem [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md) để biết thêm chi tiết.
+Xem [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md) để biết thêm chi tiết.
 
 ## Hạn chế (hiện tại)