@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.6

package/docs/vi/packages/react-intlayer/useI18n.md

@@ -133,34 +133,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Xử lý thuộc tính
-
-Khi bản địa hóa các thuộc tính, truy cập giá trị dịch một cách thích hợp:
-
-```html
-<!-- Đối với các thuộc tính hỗ trợ truy cập (ví dụ: aria-label), sử dụng .value vì cần chuỗi thuần túy -->
-<button aria-label={t("button.ariaLabel").value}>{t("button.text")}</button>
-```
-
-## Tài nguyên bổ sung
-
-- **Trình chỉnh sửa trực quan Intlayer**: Để có trải nghiệm quản lý nội dung trực quan hơn, tham khảo tài liệu trình chỉnh sửa trực quan [tại đây](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md).
-
-```tsx
-const { useI18n } = require("react-intlayer/server");
-
-const ServerComponentExample = () => {
-  const t = useI18n("server-component");
-
-  return (
-    <div>
-      <h1>{t("title")}</h1>
-      <p>{t("description")}</p>
-    </div>
-  );
-};
-```
-
 ## Xử lý Thuộc tính
 
 Khi bản địa hóa các thuộc tính, truy cập giá trị dịch một cách thích hợp:

package/docs/vi/packages/react-intlayer/useIntlayer.md

@@ -25,49 +25,6 @@ history:
 author: aymericzip
 ---
 
-# Tích hợp React: Tài liệu Hook `useIntlayer`
-
-Phần này cung cấp hướng dẫn chi tiết về cách sử dụng hook `useIntlayer` trong các ứng dụng React, cho phép bản địa hóa nội dung hiệu quả.
-
-## Nhập `useIntlayer` trong React
-
-Hook `useIntlayer` có thể được tích hợp vào các ứng dụng React bằng cách nhập nó tùy theo ngữ cảnh:
-
-- **Component phía Client:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Sử dụng trong các component React phía client
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Sử dụng trong các component React phía client
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Sử dụng trong các component React phía client
-  ```
-
-- **Component phía Server:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Sử dụng trong các component React phía server
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Sử dụng trong các component React phía server
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Sử dụng trong các component React phía server
-  ```
-
-## Tham số
-
-Hook nhận hai tham số:
-
-1. **`key`**: Khóa từ điển để lấy nội dung đã được bản địa hóa.
-2. **`locale`** (tùy chọn): Ngôn ngữ mong muốn. Mặc định là ngôn ngữ của ngữ cảnh nếu không được chỉ định.
-
 ## Từ điển
 
 Tất cả các khóa từ điển phải được khai báo trong các tệp khai báo nội dung để tăng tính an toàn kiểu và tránh lỗi. Bạn có thể tìm thấy [hướng dẫn thiết lập tại đây](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md).
@@ -131,14 +88,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Xử lý Thuộc tính
-
-Khi bản địa hóa các thuộc tính, truy cập giá trị nội dung một cách thích hợp:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Tài nguyên Bổ sung
 
 - **Trình chỉnh sửa trực quan Intlayer**: Để có trải nghiệm quản lý nội dung trực quan hơn, hãy tham khảo tài liệu trình chỉnh sửa trực quan [tại đây](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md).

package/docs/vi/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Tài liệu gói react-native-intlayer
-description: Hỗ trợ React Native cho Intlayer, cung cấp provider và các polyfill.
+description: Hỗ trợ React Native cho Intlayer, cung cấp provider, hook, polyfill và cấu hình Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Tái xuất toàn bộ API react-intlayer (hook, tiện ích, các subpath format/html/markdown) để ứng dụng React Native chỉ cần phụ thuộc vào react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Hợp nhất tài liệu cho tất cả các exports"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Gói react-native-intlayer
 
-Gói `react-native-intlayer` cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng React Native. Nó bao gồm một provider và các polyfill để hỗ trợ locale.
+Gói `react-native-intlayer` cung cấp các công cụ cần thiết để tích hợp Intlayer vào các ứng dụng React Native. Nó tái xuất toàn bộ API `react-intlayer` (hook và tiện ích) với `IntlayerProvider` sẵn sàng cho React Native, cùng các polyfill và cấu hình Metro mà React Native yêu cầu.
+
+> Trong một ứng dụng React Native, hãy nhập **tất cả mọi thứ** từ `react-native-intlayer`. Bạn không cần cài đặt hoặc nhập `react-intlayer` trực tiếp.
 
 ## Cài đặt
 
@@ -34,14 +39,30 @@ npm install react-native-intlayer
 
 ### Provider
 
-| Thành phần         | Mô tả                                                                     |
-| ------------------ | ------------------------------------------------------------------------- |
-| `IntlayerProvider` | Component Provider bọc ứng dụng của bạn và cung cấp context của Intlayer. |
+| Thành phần         | Mô tả                                                                                                             |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Component Provider bọc ứng dụng của bạn và cung cấp context của Intlayer. Tự động áp dụng các polyfill cần thiết. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Hook và tiện ích
+
+Các mục này được tái xuất từ `react-intlayer`, vì vậy bạn có thể nhập chúng trực tiếp từ `react-native-intlayer`:
 
-Nhập:
+| Export                                                                                                            | Mô tả                                                  |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `useIntlayer`                                                                                                     | Truy cập nội dung đã bản địa hóa cho một khóa từ điển. |
+| `useLocale`                                                                                                       | Đọc và thay đổi locale hiện tại.                       |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Tải nội dung từ điển theo nhiều cách khác nhau.        |
+| `useI18n`                                                                                                         | Hook tương thích với i18next.                          |
+| `t`                                                                                                               | Trợ lý dịch inline.                                    |
+| `getIntlayer`, `getDictionary`                                                                                    | Các hàm lấy nội dung theo kiểu mệnh lệnh.              |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Các trợ lý lưu trữ locale.                             |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### Polyfill
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------- |
 | `intlayerPolyfill` | Hàm áp dụng các polyfill cần thiết cho React Native để hỗ trợ Intlayer. |
 
-Nhập:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Polyfill được áp dụng tự động khi bạn nhập `IntlayerProvider`. Chỉ gọi `intlayerPolyfill` thủ công nếu bạn cần các polyfill trước khi provider được mount.
+
+### Bộ định dạng (Formatters)
+
+Các hook định dạng số, ngày tháng và các hook dựa trên Intl khác có sẵn từ subpath `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown và HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Cấu hình Metro
@@ -66,8 +102,6 @@ Gói `react-native-intlayer` cung cấp các tiện ích cấu hình Metro để
 | `configMetroIntlayerSync` | Hàm đồng bộ hợp nhất cấu hình Metro mà không chuẩn bị tài nguyên của Intlayer.             |
 | `exclusionList`           | Tạo một biểu thức RegExp cho blockList của Metro để loại trừ các tệp nội dung khỏi bundle. |
 
-Import:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/vi/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Chào mừng đến với Intlayer v6! Phiên bản này tập trung vào hiệu suất, trải nghiệm nhà phát triển và độ tin cậy. Dưới đây là những điểm nổi bật, kèm theo ghi chú di chuyển và ví dụ có thể sao chép-dán.
 
+## Mục lục
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Những điểm nổi bật
 
 - Lệnh mới: `npx intlayer content test` để phát hiện các bản dịch còn thiếu

package/docs/vi/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Chào mừng đến với Intlayer v7! Phiên bản lớn này giới thiệu các cải tiến đáng kể về hiệu suất, an toàn kiểu và trải nghiệm nhà phát triển. Dưới đây là những điểm nổi bật, kèm theo ghi chú di chuyển và ví dụ thực tiễn.
 
+## Mục lục
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Những điểm nổi bật
 
 - Chiến lược lưu bộ nhớ đệm để xây dựng nhanh hơn
@@ -260,6 +264,126 @@ Gói Trình chỉnh sửa trực quan đã được tối ưu hóa để nhỏ h
 
 ---
 
+## Định dạng Code Tự động: cấu hình formatCommand
+
+v7 giới thiệu tùy chọn `formatCommand` trong cấu hình editor, cho phép bạn tự động định dạng các tệp nội dung khi chúng được ghi bởi Intlayer. Điều này đảm bảo kiểu code và định dạng nhất quán trên các tệp khai báo nội dung của bạn.
+
+Nếu không được đặt, Intlayer sẽ cố gắng phát hiện lệnh định dạng tự động. Bằng cách cố gắng giải quyết các lệnh sau: prettier, biome, eslint.
+
+### Cấu hình
+
+Tùy chọn `formatCommand` chấp nhận một mẫu chuỗi trong đó `{{file}}` sẽ được thay thế bằng đường dẫn tệp thực tế:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Các formatter được hỗ trợ
+
+Bạn có thể sử dụng bất kỳ code formatter nào chấp nhận đường dẫn tệp làm đối số:
+
+**Sử dụng Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Sử dụng Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Sử dụng ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Sử dụng built-in formatter của Bun:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Lợi ích
+
+- **Định dạng nhất quán**: Tất cả các tệp nội dung được tự động định dạng theo các hướng dẫn kiểu dáng của dự án của bạn
+- **Trải nghiệm nhà phát triển**: Không cần phải định dạng tệp theo cách thủ công sau khi Intlayer ghi chúng
+- **Tính nhất quán của nhóm**: Đảm bảo tất cả các thành viên trong nhóm có cùng định dạng được áp dụng cho các tệp nội dung
+- **Tích hợp CI/CD**: Các tệp nội dung duy trì định dạng nhất quán trong các quy trình làm việc tự động
+
+### Cách hoạt động
+
+Khi Intlayer ghi hoặc cập nhật một tệp khai báo nội dung (`.content.ts`, `.content.js`, v.v.), nó tự động chạy lệnh định dạng được chỉ định trên tệp. Trình giữ chỗ `{{file}}` được thay thế bằng đường dẫn tệp thực tế và lệnh được thực thi trong thư mục cơ sở của dự án.
+
+---
+
+## Cấu hình Dictionary: Tổ chức và cấu trúc tốt hơn
+
+v7 giới thiệu một phần cấu hình `dictionary` mới được dành riêng cung cấp tổ chức tốt hơn cho các cài đặt liên quan đến dictionary và quản lý nội dung được cải thiện.
+
+### Cấu trúc cấu hình dictionary mới
+
+Thuộc tính `fill` đã được chuyển từ phần `content` sang phần `dictionary` mới, cung cấp sự tách biệt rõ ràng hơn về các mối quan tâm:
+
+**Cấu hình v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Cấu hình v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Lợi ích của cấu trúc mới
+
+- **Tổ chức rõ ràng hơn**: Các cài đặt dành riêng cho từ điển hiện được nhóm lại với nhau
+- **Tách biệt mối quan tâm tốt hơn**: Khám phá nội dung và các hoạt động từ điển được tách biệt rõ ràng
+- **Khả năng bảo trì được cải thiện**: Dễ dàng hiểu và sửa đổi các cấu hình liên quan đến từ điển
+- **Khả năng mở rộng trong tương lai**: Phần từ điển có thể chứa các cài đặt dành riêng cho từ điển bổ sung
+- **Quản lý từ điển toàn diện**: Bao gồm các thuộc tính như `title`, `live`, `priority`, `tags`, `version` và `description` để tạo và quản lý các từ điển mới
+
+### Cách sử dụng cấu hình
+
+Cấu hình từ điển phục vụ hai mục đích chính:
+
+1. **Giá trị mặc định**: Xác định giá trị mặc định khi tạo các tệp khai báo nội dung
+2. **Hành vi dự phòng**: Cung cấp giá trị dự phòng khi các trường cụ thể không được xác định, cho phép bạn xác định hành vi hoạt động của từ điển một cách toàn cầu
+
+Phần từ điển bao gồm các thuộc tính toàn diện để quản lý từ điển:
+
+- **`fill`**: Hành vi tự động điền cho việc tạo nội dung
+- **`title`**: Tiêu đề mặc định cho các từ điển mới
+- **`live`**: Cấu hình đồng bộ hóa trực tiếp cho các bản cập nhật theo thời gian thực
+- **`priority`**: Cài đặt ưu tiên để phân giải từ điển
+- **`tags`**: Thẻ mặc định để tổ chức nội dung
+- **`version`**: Quản lý phiên bản cho các bản cập nhật từ điển
+- **`description`**: Mô tả mặc định cho nội dung mới
+
+Để biết thêm thông tin về các tệp khai báo nội dung và cách áp dụng các giá trị cấu hình, hãy xem [Tài liệu tệp nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md).
+
+---
+
 ## Lệnh fill: Hành vi cập nhật để quản lý nội dung tốt hơn
 
 Phiên bản v7 giới thiệu hành vi cải tiến cho lệnh `fill`, cung cấp quản lý nội dung linh hoạt và dễ dự đoán hơn:
@@ -407,6 +531,10 @@ Hệ thống tự động:
 - **`middleware.prefixDefault`**: Thay thế bằng `routing.mode`
 - **`middleware.noPrefix`**: Thay thế bằng `routing.mode`
 
+### Cấu hình mới
+
+- **`editor.formatCommand`**: Tùy chọn mới để tự động định dạng mã trong các tệp nội dung
+
 ### Bản đồ di chuyển
 
 #### Bản đồ cấu hình

package/docs/vi/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Intlayer v9 Mới - Có gì mới?
 description: Khám phá các tính năng mới trong Intlayer v9. Giới thiệu các package tương thích drop-in cho các thư viện i18n phổ biến và hỗ trợ Collections, Variants, và Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ Tại build time, `@intlayer/swc` và `@intlayer/babel` sẽ quét các file c
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Plugin Vite `intlayer()` hiện đóng gói **compiler** và **locale-routing proxy** trực tiếp, vì vậy hầu hết các dự án chỉ cần một plugin duy nhất trong `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Kích hoạt tự động khi `compiler.enabled` được đặt và một đường dẫn `compiler.output` được cấu hình. Bạn không còn cần phải đăng ký `intlayerCompiler()` riêng biệt.
+- **Proxy**: Kích hoạt tự động dựa trên tùy chọn `routing.enableProxy` mới (`true` theo mặc định). Nó kết nối middleware phát hiện ngôn ngữ / chuyển hướng / ghi đè trong phát triển, xem trước và SSR sản xuất. Bạn không còn cần phải đăng ký `intlayerProxy()` riêng biệt.
+
+### Tùy chọn `routing.enableProxy`
+
+Một tùy chọn `routing.enableProxy` mới kiểm soát xem proxy định tuyến locale có được cắm vào hay không. Nó mặc định là `true`. Vô hiệu hóa nó khi bạn muốn xử lý định tuyến locale của riêng mình:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Mặc định: true
+  },
+};
+
+export default config;
+```
+
+Các plugin độc lập `intlayerCompiler()` và `intlayerProxy()` vẫn được xuất cho các cài đặt nâng cao. Đăng ký chúng cùng với `intlayer()` là an toàn — mỗi plugin loại bỏ chính nó và chỉ chạy một lần.
+
+---
+
 ## Lưu ý khi migration từ v8
 
 Nếu bạn đang nâng cấp từ v8, lưu ý rằng v9 không bao gồm các breaking change. Tuy nhiên, dưới đây là các thay đổi chính:

package/docs/zh/CI_CD.md

@@ -28,7 +28,7 @@ Intlayer 允许自动生成内容声明文件的翻译。根据您的工作流
 
 ## 使用 CMS
 
-使用 Intlayer，您可以采用一种工作流程，只在本地声明单一语言环境，而所有翻译内容则通过 CMS 远程管理。这使内容和翻译完全脱离代码库，为内容编辑者提供更大的灵活性，并支持热内容重载（无需重建应用即可应用更改）。
+使用 Intlayer，你可以采用一种工作流程，其中只需在本地声明单一语言环境，而所有翻译都通过 CMS 远程管理。这允许内容和翻译与代码库完全分离，为内容编辑提供更多灵活性，并支持 Live Sync（无需重新构建应用程序即可应用更改）。
 
 ### 示例配置
 

package/docs/zh/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# 填充内容声明文件翻译
+
+**在 CI 中自动填充内容声明文件**是加快开发工作流程的一种方式。
+
+## 理解行为
+
+`fill` 命令包括两种模式：
+
+- **Complete**: 自动为每个区域设置填充所有缺失的内容，并编辑当前文件或指定的另一个文件。也就是说，完整模式将跳过已翻译内容的翻译。
+- **Review**: 自动为每个区域设置填充**所有**内容，并为特定文件或指定的另一个文件生成。
+
+fill 命令将处理您的所有区域内容声明文件。也就是说，它不会处理来自 CMS 的远程内容。CMS 包含其自己的翻译管理。
+如果您使用插件，如 `@intlayer/sync-json-plugin`，Intlayer 将把 JSON 文件转换为区域内容声明文件。也就是说，它们将由 `fill` 命令处理。
+
+新生成的文件包含一个 `filled` 指令作为字典元数据。此指令将由 Intlayer 用来判断文件是否已自动填充，以及如果存在则跳过此文件不再进行翻译。
+
+Intlayer 还将考虑以下自动填充指令：
+
+- 来自您的 `.content.{ts|js|json}` → `fill` 指令
+- 来自您的配置文件 `.intlayer.config.ts` → `dictionary.fill` 指令
+- 否则将默认设置为 `true`
+
+对于按区域设置的内容声明文件，`true` 指令将被替换为 `./{{fileName}}.fill.content.json`。这是因为按区域设置的内容声明文件无法接收额外的本地化内容。因此它将生成一个新文件，以不覆盖现有文件。
+
+## 默认行为
+
+默认情况下，`fill` 全局设置为 `true`，这意味着 Intlayer 将自动填充所有内容文件并编辑文件本身。这个行为可以通过以下几种方式自定义：
+
+### 全局配置选项
+
+1. **`fill: true` (默认)** - 自动填充所有语言并编辑当前文件
+2. **`fill: false`** - 禁用此内容文件的自动填充
+3. **`fill: "./relative/path/to/file"`** - 创建/更新指定的文件，不编辑当前文件，指向基于当前文件位置解析的相对路径
+4. **`fill: "/absolute/path/to/file"`** - 创建/更新指定的文件，不编辑当前文件，指向基于基目录位置解析的相对路径（配置文件 `.intlayer.config.ts` 中的 `baseDir` 字段）
+5. **`fill: "C:\\absolute\path\to\file"`** - 创建/更新指定的文件，不编辑当前文件，指向基于你的操作系统解析的绝对路径
+6. **`fill: { [key in Locales]?: string }`** - 为每个语言创建/更新指定的文件
+
+### v7 行为更改
+
+在 v7 中，`fill` 命令的行为已更新：
+
+- **`fill: true`** - 使用所有语言的已填充内容重写当前文件
+- **`fill: "path/to/file"`** - 填充指定文件而不修改当前文件
+- **`fill: false`** - 完全禁用自动填充
+
+使用路径选项写入另一个文件时，填充机制通过内容声明文件之间的 _主从_ 关系工作。主（master）文件作为真实来源，当它被更新时，Intlayer 将自动将这些更改应用到由路径指定的派生（填充）声明文件。
+
 # 自动填充内容声明文件翻译
 
 **自动填充内容声明文件** 是加快开发工作流程的一种方式。
@@ -88,6 +135,40 @@ Intlayer 将自动生成派生的声明文件，路径为 `src/components/exampl
 
 之后，这两个声明文件将合并为一个字典，可以通过标准的 `useIntlayer("example")` 钩子（React）或组合函数（Vue）访问。
 
+## 全局配置
+
+您可以在 `intlayer.config.ts` 文件中配置全局自动填充配置。
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // 为所有字典自动生成缺失的翻译
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // 为所有字典自动生成缺失的翻译，如使用 "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+您仍然可以使用内容文件中的 `fill` 字段按字典进行微调。Intlayer 将首先考虑每个字典的配置，然后回退到全局配置。
+
 ## 自动填充文件格式
 
 推荐的自动填充声明文件格式是 **JSON**，这有助于避免格式限制。然而，Intlayer 也支持 `.ts`、`.js`、`.mjs`、`.cjs` 及其他格式。

package/docs/zh/benchmark/solid.md

@@ -117,6 +117,28 @@ history:
 - **分层静态 (Scoped static)**: 保持代码有序（逻辑分离），无需复杂的额外网络请求。
 - **分层动态 (Scoped dynamic)**: _代码拆分_ 和性能的最佳方法。通过仅加载当前视图和活动语言所需的内容来最小化内存使用。
 
+### 我测量的内容：
+
+我在实际浏览器中为每个技术栈运行相同的多语言应用，然后记录了实际显示的内容和花费的时间。大小是在**正常 Web 压缩后**报告的，因为这更接近人们下载的内容，而不是原始源代码计数。
+
+- **国际化库大小**：在捆绑、树形摇晃和最小化后，i18n 库的大小是空组件中提供程序 + hooks/基元代码的大小。它不包括加载翻译文件。它回答了在您的内容进入之前库的成本。
+
+- **每页 JavaScript**：对于每个基准测试路由，浏览器在该访问中提取的脚本量，在套件中的页面之间平均（以及在报告汇总的语言之间）。沉重的页面是缓慢的页面。
+
+- **来自其他语言的泄漏**：这是同一页面但以另一种语言显示的内容，会被错误地加载到已审核页面中。此内容是不必要的，应该避免。（例如 `/fr/about` 页面内容在 `/en/about` 页面包中）
+
+- **来自其他路由的泄漏**：对于应用中的**其他屏幕**也是相同的概念：当您只打开一个页面时，它们的副本是否会随之而来。（例如 `/en/about` 页面内容在 `/en/contact` 页面包中）。高分数表示分割较弱或包过于宽泛。
+
+- **平均组件包大小**：常见的 UI 部分被**一次一个**测量，而不是隐藏在一个巨大的应用数字中。它显示国际化是否悄悄地增加了日常组件的大小。例如，如果您的组件重新渲染，它将从内存加载所有该数据。将一个巨大的 JSON 附加到任何组件就像连接一个大量未使用数据的仓库，这会减慢您组件的性能。
+
+- **语言切换响应性**：我使用应用自己的控件翻转语言，并计时直到页面明显切换需要多长时间，这是访问者会注意到的，而不是实验室微步骤。
+
+- **语言更改后的渲染工作**：一个更狭隘的后续：界面为新语言重新绘制需要花费多少工作量，一旦切换进行中。当"感知"时间和框架成本不同时很有用。
+
+- **初始页面加载时间**：从导航到浏览器认为页面对我测试的场景完全加载。适合比较冷启动。
+
+- **水合时间**：当应用公开它时，客户端花费多长时间将服务器 HTML 转换为您实际可以点击的内容。表格中的破折号表示该实现在此基准测试中没有提供可靠的水合数据。
+
 ## GitHub 星数
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。

package/docs/zh/benchmark/svelte.md

@@ -116,6 +116,28 @@ history:
 - **分层静态 (Scoped static)**: 保持代码有序（逻辑分离），无需复杂的额外网络请求。
 - **分层动态 (Scoped dynamic)**: _代码拆分_ 和性能的最佳方法。通过仅加载当前视图和活动语言所需的内容来最小化内存使用。
 
+### 我测量了什么:
+
+我在真实浏览器中为每个栈运行相同的多语言应用，然后记录了实际在网络上显示的内容以及花费的时间。大小报告是**在正常网络压缩后**的，因为这比原始源代码计数更接近人们实际下载的内容。
+
+- **国际化库大小**：在打包、tree-shaking 和 minification 之后，i18n 库的大小是空组件中提供程序 + 存储代码的大小。它不包括翻译文件的加载。它回答了库在你的内容进入之前有多昂贵的问题。
+
+- **每页 JavaScript**：对于每个基准测试路由，浏览器在该访问中拉取多少脚本，在套件中的页面之间平均（以及在报告汇总的区域设置之间）。页面重则加载慢。
+
+- **其他区域设置的泄漏**：同一页面的内容但以另一种语言形式，会被错误地加载到审核页面中。此内容是不必要的，应该避免。（例如 `/fr/about` 页面内容出现在 `/en/about` 页面包中）
+
+- **其他路由的泄漏**：对于**应用中的其他屏幕**也是同样的想法：当你只打开一个页面时，它们的副本是否会被带入。（例如 `/en/about` 页面内容出现在 `/en/contact` 页面包中）。高分数表示分割较弱或包范围过宽。
+
+- **平均组件包大小**：常见的 UI 组件**一次一个**地测量，而不是隐藏在一个巨大的应用数字中。它展示了国际化是否悄悄地膨胀了日常组件。例如，如果你的组件重新渲染，它会从内存中加载所有这些数据。将一个巨大的 JSON 附加到任何组件就像连接一个大的未使用数据存储，这会减慢你的组件性能。
+
+- **语言切换响应性**：我使用应用自身的控件翻转语言，并计时直到页面清晰地切换为止，这是访问者会注意到的，而不是实验室微步骤。
+
+- **语言更改后的渲染工作**：一个更窄的后续跟进：一旦切换进行中，界面为新语言重新绘制花费了多少工作量。在"感受"时间和框架成本不一致时很有用。
+
+- **初始页面加载时间**：从导航到浏览器认为我测试的场景中的页面完全加载。适合比较冷启动。
+
+- **Hydration 时间**：当应用暴露它时，客户端花费多长时间将服务器 HTML 转换为你实际可以点击的内容。表格中的破折号表示该实现在此基准测试中没有提供可靠的 hydration 数字。
+
 ## GitHub 星数
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。

package/docs/zh/benchmark/tanstack.md

@@ -124,6 +124,28 @@ history:
 - **Scoped static (局部静态)**: 保持代码组织良（逻辑分离），且无需复杂的额外网络请求。
 - **Scoped dynamic (局部动态)**: 代码分割和性能的最佳方案。通过仅加载当前视图和活动语言环境所需的内容来最小化内存占用。
 
+### 我测量的内容：
+
+我在真实浏览器中为每个技术栈运行相同的多语言应用，然后记录了实际传输的内容以及所花费的时间。大小是在**正常网络压缩后**报告的，因为这比原始源代码数更接近人们下载的内容。
+
+- **国际化库大小**：在捆绑、树抖动和最小化后，i18n 库的大小是提供程序（例如 `NextIntlClientProvider`）+ 钩子（例如 `useTranslations`）在空组件中的代码大小。它不包括加载翻译文件。它回答了在内容进入之前库的成本是多少。
+
+- **每页 JavaScript**：对于每个基准路由，浏览器在该访问期间拉取多少脚本，在套件中的页面上取平均值（以及在报告汇总的地方跨地区）。页面越重，页面越慢。
+
+- **来自其他地区的泄漏**：这是同一页面但用另一种语言编写的内容，会被错误地加载到审计页面中。此内容是不必要的，应该避免。（例如，`/en/about` 页面包中的 `/fr/about` 页面内容）
+
+- **来自其他路由的泄漏**：对于应用中的**其他屏幕**有相同的想法：当你只打开一个页面时，它们的副本是否会随之传输。（例如，`/en/contact` 页面包中的 `/en/about` 页面内容）。高分提示弱分割或过宽的包。
+
+- **平均组件捆绑大小**：常见 UI 片段被**一次测量一个**而不是隐藏在一个巨大的应用编号中。它展示了国际化是否悄悄地膨胀日常组件。例如，如果你的组件重新渲染，它将从内存中加载所有该数据。将一个巨大的 JSON 附加到任何组件就像连接一个大的未使用数据存储，这会减慢你的组件性能。
+
+- **语言切换响应速度**：我使用应用自己的控件来切换语言，并计时直到页面明确切换需要多长时间，这是访问者会注意到的，而不是实验室微步。
+
+- **语言更改后的渲染工作**：一个更窄的后续问题：一旦切换进行中，界面为新语言重绘需要多少工作量。当"感觉"时间和框架成本不同时很有用。
+
+- **初始页面加载时间**：从导航到浏览器认为页面完全加载的时间，用于我测试的场景。很好用于比较冷启动。
+
+- **水合时间**：当应用公开时，客户端将服务器 HTML 转换为可以实际点击的内容所花费的时间。表中的破折号意味着该实现在此基准中没有提供可靠的水合数据。
+
 ## GitHub 星数
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。

package/docs/zh/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## 脚手架 GitHub Actions
+
+当你运行 `intlayer init` 时，Intlayer 会检测你的包管理器（npm、yarn、pnpm 或 bun），并在 `.github/workflows/` 下脚手架生成两个 GitHub Actions 工作流，命令与该包管理器相匹配：
+
+- **`intlayer-fill.yml`** — 在每个 pull request 上，构建字典并运行 `intlayer fill --git-diff --mode complete` 来为更改的字典生成缺失的翻译，然后将结果提交回 PR 分支。
+- **`intlayer-test.yml`** — 在每个 pull request 上，构建字典并运行 `intlayer test`，当必需的语言环境缺少翻译时，检查失败。
+
+现有的工作流文件永远不会被覆盖。要完全跳过脚手架，运行：
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### 为 fill workflow 提供 AI 访问权限
+
+生成的 `intlayer-fill.yml` 需要 AI 访问权限。有两个选项可用（在 workflow 的 `env` 块中配置）：
+
+1. **您自己的 AI 提供商密钥** — 在您的存储库设置中添加 `AI_API_KEY` 密钥（Settings → Secrets and variables → Actions）。workflow 通过 `--provider`、`--model` 和 `--api-key` 转发它。
+2. **Intlayer CMS 访问密钥** — 添加 `INTLAYER_CLIENT_ID` 和 `INTLAYER_CLIENT_SECRET` 密钥，并将它们连接到您的 `intlayer.config` `editor` 部分。CMS 访问密钥通过 Intlayer 后端授予 AI 访问权限。
+
+`intlayer-test.yml` workflow 不需要任何 AI 访问权限。
+
 ## 错误处理
 
 - 如果未设置 `INTLAYER_PROJECT_CREDENTIALS`，命令将以错误退出。