@intlayer/docs 9.1.3 → 9.3.0

package/blog/zh/intlayer_with_next-i18next.md

@@ -54,11 +54,62 @@ author: aymericzip
 
 ---
 
-### 第2步：实现 Intlayer 插件以封装 JSON
+## 使用 next-i18next 设置 Intlayer 的分步指南
 
-创建一个 Intlayer 配置文件以定义你支持的语言环境：
+<Steps>
+
+<Step number={1} title="安装依赖项">
+
+使用您首选的包管理器安装必要的包：
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
 
-**如果你还想导出用于 i18next 的 JSON 词典**，请添加 `syncJSON` 插件：
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> `--interactive` 标志是可选的。如果您是 AI 代理，请使用 `intlayer-cli init`。
+
+> 此命令将检测您的环境并安装所需的包。例如：
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+```
+
+**包说明：**
+
+- **intlayer**：用于内容声明和管理的核心库
+- **@intlayer/sync-json-plugin**：将 Intlayer 内容声明同步到 i18next JSON 格式的插件
+
+</Step>
+
+<Step number={2} title="实现 Intlayer 插件以包装 JSON">
+
+创建一个 Intlayer 配置文件来定义您支持的语言环境：
+
+**如果您也想为 i18next 导出 JSON 字典**，请添加 `syncJSON` 插件：
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -79,26 +130,32 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-`syncJSON` 插件会自动包装 JSON。它会读取和写入 JSON 文件，而不会改变内容结构。
+`syncJSON` 插件将自动包装 JSON。它将读写 JSON 文件而不改变内容架构。
 
-如果你想让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 会按以下方式处理：
+如果您想让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 将按以下方式处理：
 
-    1. 加载 JSON 和内容声明文件，并将它们转换为 intlayer 字典。
-    2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 会合并所有字典。具体合并方式取决于插件的优先级以及内容声明文件的优先级（所有均可配置）。
+1. 加载 JSON 和内容声明文件，并将它们转换为 intlayer 字典。
+2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 将合并所有字典。根据插件的优先级和内容声明文件的优先级（都可配置）。
 
-如果使用 CLI 翻译 JSON，或使用 CMS 进行更改，Intlayer 将使用新的翻译更新 JSON 文件。
+如果使用 CLI 或 CMS 对 JSON 进行更改以翻译，Intlayer 将用新翻译更新 JSON 文件。
 
-要查看更多关于 `syncJSON` 插件的详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
+有关 `syncJSON` 插件的更多详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
 
----
+</Step>
 
-<Steps>
+<Step number={3} title="设置 AI 提供者">
 
-<Step number={1} title="实现按组件的 JSON 翻译" isOptional={true}>
+Intlayer 为您的 i18next 工作流解锁了一套高级自动化和开发者友好的功能。
 
-默认情况下，Intlayer 会加载、合并并同步 JSON 和内容声明文件。更多详情请参阅 [内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。但如果你愿意，也可以使用 Intlayer 插件，在代码库中的任何位置实现按组件管理本地化的 JSON。
+- **自动检测和填充缺失的翻译**：Intlayer 扫描您的 JSON 字典，找到未翻译或缺失的键，并仅翻译那些，所以您的 JSON 的 99% 保持不变。
+- **大型 JSON 文件的分块翻译**：当您的翻译文件非常大时，Intlayer 会自动将处理分成可管理的块，独立翻译它们以避免 API 限制和内存问题。
+- **命名空间并行化**：如果您有数百个命名空间（或文件），Intlayer 会并行化翻译任务，有效地加快您的 CI/CD 或批量翻译操作。
+- **灵活的 AI 提供者支持**：只需配置凭据，即可选择您首选的 AI 提供者（例如 OpenAI、Claude、Gemini）。使用您自己的 API 密钥，并根据需要切换提供者。
+- **强大的 AI 响应处理**：Intlayer 可以处理您的 AI 提供者以字符串或对象形式返回文本的边界情况，甚至在格式不一致时自动重试。
+- **CLI 和 CI/CD 就绪**：直接在您的测试或管道中运行 Intlayer 的检查和自动填充，使您的本地化流程健壮且自动化。
+- **集成在您现有的设置之上**：您不需要改变您的 i18next 或 Next.js 基础。Intlayer 作为您当前设置的附加插件工作，以最少的迁移为您提供所有这些好处。
 
-为此，您可以使用 `loadJSON` 插件。
+以下是如何设置 AI 提供者的示例：
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -109,23 +166,14 @@ const config: IntlayerConfig = {
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
     defaultLocale: Locales.ENGLISH,
   },
-
-  // 保持您当前的 JSON 文件与 Intlayer 字典同步
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
   plugins: [
-    /**
-     * 将加载 src 中所有匹配模式 {key}.i18n.json 的 JSON 文件
-     */
-    loadJSON({
-      source: ({ key }) => `./src/**/${key}.i18n.json`,
-      locale: Locales.ENGLISH,
-      priority: 1, // 确保这些 JSON 文件优先于 `./public/locales/en/${key}.json` 中的文件
-    }),
-    /**
-     * 将输出和翻译写回到 locales 目录中的 JSON 文件
-     */
     syncJSON({
       source: ({ key, locale }) => `./public/locales/${locale}/${key}.json`,
-      priority: 0,
     }),
   ],
 };
@@ -133,7 +181,16 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-这将加载 `src` 目录中所有匹配 `{key}.i18n.json` 模式的 JSON 文件，并将它们作为 Intlayer 字典加载。
+然后您可以执行以下命令来填充您的翻译：
+
+```bash
+npx intlayer fill
+```
+
+这将使用您配置的 AI 提供者填充您的翻译。
+
+> 在 [Intlayer AI 配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#ai-configuration) 中查看所有可用的 AI 提供者。
+> 在 [Intlayer CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md) 中查看所有可用的命令。
 
 ---
 

package/blog/zh/intlayer_with_next-intl.md

@@ -55,11 +55,62 @@ author: aymericzip
 
 <TOC/>
 
-### 第2步：实现 Intlayer 插件以封装 JSON
+## 使用 next-intl 设置 Intlayer 的分步指南
 
-创建一个 Intlayer 配置文件以定义支持的语言环境：
+<Steps>
+
+<Step number={1} title="安装依赖">
+
+安装必要的包：
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> `--interactive` 标志是可选的。如果你是 AI agent，请使用 `intlayer-cli init`。
+
+> 此命令将检测你的环境并安装所需的包。例如：
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+```
+
+**包描述：**
+
+- **intlayer**：国际化管理、内容声明和构建的核心库
+- **@intlayer/sync-json-plugin**：将 Intlayer 内容声明导出为 next-intl 兼容 JSON 格式的插件
+
+</Step>
 
-**如果您还想为 next-intl 导出 JSON 字典**，请添加 `syncJSON` 插件：
+<Step number={2} title="实现 Intlayer 插件以包装 JSON">
+
+创建一个 Intlayer 配置文件来定义你支持的语言：
+
+**如果你还想为 next-intl 导出 JSON 字典**，添加 `syncJSON` 插件：
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -81,25 +132,32 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-`syncJSON` 插件会自动封装 JSON。它会读取和写入 JSON 文件，而不会改变内容结构。
-
-如果你想让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 会按以下方式处理：
+`syncJSON` 插件将自动包装 JSON。它将读取和写入 JSON 文件，而不改变内容架构。
 
-    1. 加载 JSON 和内容声明文件，并将它们转换为 intlayer 字典。
+如果你想让 JSON 与 intlayer 内容声明文件（`.content` 文件）并存，Intlayer 将按以下方式处理：
 
-2. 如果 JSON 文件和内容声明文件之间存在冲突，Intlayer 将合并所有字典。合并的优先级取决于插件的优先级以及内容声明文件的优先级（所有优先级均可配置）。
+1. 加载 JSON 和内容声明文件，并将其转换为 intlayer 字典。
+2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 将合并所有字典。这取决于插件的优先级和内容声明文件的优先级（都是可配置的）。
 
-如果通过 CLI 翻译 JSON 或使用 CMS 进行更改，Intlayer 会使用新的翻译更新 JSON 文件。
+如果使用 CLI 或 CMS 更改了 JSON 的翻译，Intlayer 将使用新翻译更新 JSON 文件。
 
 有关 `syncJSON` 插件的更多详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
 
-<Steps>
+</Step>
 
-<Step number={1} title="实现按组件的 JSON 翻译" isOptional={true}>
+<Step number={3} title="设置 AI 提供商">
 
-默认情况下，Intlayer 会加载、合并并同步 JSON 文件和内容声明文件。更多详情请参见[内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。但如果你愿意，也可以使用 Intlayer 插件，在代码库中的任意位置实现基于组件的 JSON 本地化管理。
+Intlayer 为你的 i18next 工作流解锁了一系列高级自动化和开发者友好的功能。
 
-为此，你可以使用 `loadJSON` 插件。
+- **自动检测和填充缺失的翻译**：Intlayer 扫描你的 JSON 字典，查找未翻译或缺失的键，仅翻译那些，所以你的 JSON 的 99% 保持不变。
+- **大 JSON 文件的分块翻译**：当你的翻译文件非常大时，Intlayer 自动将处理分成可管理的块，独立地翻译它们以避免 API 限制和内存问题。
+- **命名空间并行化**：如果你有数百个命名空间（或文件），Intlayer 并行化翻译任务，有效加快你的 CI/CD 或批量翻译操作。
+- **灵活的 AI 提供商支持**：选择你首选的 AI 提供商（例如 OpenAI、Claude、Gemini），只需配置凭证。使用你自己的 API 密钥，并根据需要切换提供商。
+- **弹性的 AI 响应处理**：Intlayer 可以处理你的 AI 提供商将文本作为字符串或对象返回的边界情况，甚至在格式不一致时自动重试。
+- **CLI 和 CI/CD 就绪**：直接在你的测试或管道中运行 Intlayer 的检查和自动填充，使你的本地化流程强大和自动化。
+- **集成在你现有的设置之上**：你无需更改你的 i18next 或 Next.js 基础。Intlayer 作为你当前设置的插件，为你提供所有这些好处，同时需要最小的迁移。
+
+以下是如何设置 AI 提供商的示例：
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -110,24 +168,15 @@ const config: IntlayerConfig = {
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
     defaultLocale: Locales.ENGLISH,
   },
-
-  // 保持您当前的 JSON 文件与 Intlayer 字典同步
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
   plugins: [
-    /**
-     * 将加载 src 目录中所有匹配模式 {key}.i18n.json 的 JSON 文件
-     */
-    loadJSON({
-      source: ({ key }) => `./src/**/${key}.i18n.json`,
-      locale: Locales.ENGLISH,
-      priority: 1, // 确保这些 JSON 文件优先于 `./locales/en/${key}.json` 中的文件
-    }),
-    /**
-     * 将加载并将输出和翻译写回到 locales 目录中的 JSON 文件
-     */
     syncJSON({
       format: "icu",
       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
-      priority: 0,
     }),
   ],
 };
@@ -135,7 +184,18 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-这将加载 `src` 目录中所有匹配 `{key}.i18n.json` 模式的 JSON 文件，并将它们作为 Intlayer 字典加载。
+然后你可以执行以下命令来填充你的翻译：
+
+```bash
+npx intlayer fill
+```
+
+这将用你配置的 AI 提供商填充你的翻译。
+
+> 在 [Intlayer AI 配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#ai-configuration) 中查看所有可用的 AI 提供商。
+> 在 [Intlayer CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md) 中查看所有可用的命令。
+
+---
 
 </Step>
 

package/blog/zh/intlayer_with_react-i18next.md

@@ -55,11 +55,62 @@ author: aymericzip
 
 <TOC/>
 
-### 第 2 步：实现 Intlayer 插件以包装 JSON
+## 使用 react-i18next 设置 Intlayer 的分步指南
 
-创建一个 Intlayer 配置文件以定义支持的语言环境：
+<Steps>
+
+<Step number={1} title="安装依赖项">
+
+安装必要的包：
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
 
-**如果您还想导出用于 react-i18next 的 JSON 字典**，请添加 `syncJSON` 插件：
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> `--interactive` 标志是可选的。如果您是 AI 代理，请使用 `intlayer-cli init`。
+
+> 此命令将检测您的环境并安装所需的包。例如：
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+```
+
+**包描述：**
+
+- **intlayer**：国际化管理、内容声明和构建的核心库
+- **@intlayer/sync-json-plugin**：将 Intlayer 内容声明导出为 react-i18next 兼容 JSON 格式的插件
+
+</Step>
+
+<Step number={2} title="实现 Intlayer 插件以包装 JSON">
+
+创建 Intlayer 配置文件以定义您支持的语言：
+
+**如果您还想为 react-i18next 导出 JSON 字典**，请添加 `syncJSON` 插件：
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -80,24 +131,32 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-`syncJSON` 插件会自动包装 JSON。它会读取和写入 JSON 文件，而不会改变内容结构。
+`syncJSON` 插件将自动包装 JSON。它将读写 JSON 文件，而不改变内容架构。
 
-如果你想让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 会按以下方式处理：
+如果您想让该 JSON 与 Intlayer 内容声明文件（`.content` 文件）共存，Intlayer 将按以下方式处理：
 
-1. 加载 JSON 和内容声明文件，并将它们转换为 intlayer 字典。
-2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 会合并所有字典。合并的优先级取决于插件的优先级和内容声明文件的优先级（所有均可配置）。
+1. 加载 JSON 和内容声明文件，并将它们转换为 Intlayer 字典。
+2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 将合并所有字典。根据插件的优先级和内容声明文件的优先级（都可配置）。
 
-如果通过 CLI 翻译 JSON 或使用 CMS 进行更改，Intlayer 会使用新的翻译更新 JSON 文件。
+如果使用 CLI 或 CMS 对 JSON 进行更改以进行翻译，Intlayer 将用新翻译更新 JSON 文件。
 
-要查看更多关于 `syncJSON` 插件的详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
+有关 `syncJSON` 插件的更多详情，请参考 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
 
-<Steps>
+</Step>
+
+<Step number={3} title="设置 AI 提供商">
 
-<Step number={1} title="实现按组件的 JSON 翻译" isOptional={true}>
+Intlayer 为您的 i18next 工作流解锁了一组高级自动化和开发者友好的功能。
 
-默认情况下，Intlayer 会加载、合并并同步 JSON 文件和内容声明文件。更多详情请参阅 [内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。但如果你愿意，也可以使用 Intlayer 插件，在代码库中的任意位置实现按组件管理本地化的 JSON。
+- **自动检测和填充缺失的翻译**：Intlayer 扫描您的 JSON 字典，查找未翻译或缺失的键，仅翻译这些，以便 99% 的 JSON 保持不变。
+- **大型 JSON 文件的分块翻译**：当您的翻译文件非常大时，Intlayer 会自动将处理分成可管理的块，独立翻译它们以避免 API 限制和内存问题。
+- **命名空间并行化**：如果您有数百个命名空间（或文件），Intlayer 会并行化翻译任务，有效加快您的 CI/CD 或批量翻译操作。
+- **灵活的 AI 提供商支持**：选择您首选的 AI 提供商（例如 OpenAI、Claude、Gemini），只需配置凭证即可。使用您自己的 API 密钥，并根据需要切换提供商。
+- **弹性 AI 响应处理**：Intlayer 可以处理 AI 提供商以字符串或对象形式返回文本的边界情况，甚至在格式不一致时自动重试。
+- **CLI 和 CI/CD 就绪**：直接在您的测试或管道中运行 Intlayer 的检查和自动填充，使您的本地化过程健壮和自动化。
+- **集成到现有设置之上**：您无需改变 i18next 或 Next.js 基础。Intlayer 作为插件添加到您当前的设置中，以最小的迁移工作量为您提供所有这些好处。
 
-为此，你可以使用 `loadJSON` 插件。
+以下是如何设置 AI 提供商的示例：
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -108,23 +167,14 @@ const config: IntlayerConfig = {
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
     defaultLocale: Locales.ENGLISH,
   },
-
-  // 保持当前的 JSON 文件与 Intlayer 字典同步
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
   plugins: [
-    /**
-     * 将加载 src 目录中所有匹配模式 {key}.i18n.json 的 JSON 文件
-     */
-    loadJSON({
-      source: ({ key }) => `./src/**/${key}.i18n.json`,
-      locale: Locales.ENGLISH,
-      priority: 1, // 确保这些 JSON 文件优先于 `./locales/en/${key}.json` 中的文件
-    }),
-    /**
-     * 将加载并将输出和翻译写回到 locales 目录中的 JSON 文件
-     */
     syncJSON({
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
-      priority: 0,
     }),
   ],
 };
@@ -132,7 +182,16 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-这将加载 `src` 目录中所有匹配 `{key}.i18n.json` 模式的 JSON 文件，并将它们作为 Intlayer 字典加载。
+然后您可以执行以下命令来填充您的翻译：
+
+```bash
+npx intlayer fill
+```
+
+这将使用您配置的 AI 提供商填充您的翻译。
+
+> 在 [Intlayer AI 配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#ai-configuration) 中查看所有可用的 AI 提供商。
+> 在 [Intlayer CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md) 中查看所有可用的命令。
 
 </Step>
 

package/blog/zh/intlayer_with_react-intl.md

@@ -53,11 +53,62 @@ author: aymericzip
 
 本指南将向您展示如何利用 Intlayer 优越的内容声明系统，同时保持与 react-intl 的兼容性。
 
-### 第 2 步：实现 Intlayer 插件以包装 JSON
+## 使用 react-intl 设置 Intlayer 的分步指南
 
-创建一个 Intlayer 配置文件以定义您支持的语言环境：
+<Steps>
+
+<Step number={1} title="安装依赖">
+
+安装必要的包：
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> `--interactive` 标志是可选的。如果您是 AI agent，请使用 `intlayer-cli init`。
+
+> 此命令将检测您的环境并安装所需的包。例如：
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/sync-json-plugin --save-dev
+```
 
-**如果您还想导出适用于 react-intl 的 JSON 字典**，请添加 `syncJSON` 插件：
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/sync-json-plugin --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/sync-json-plugin --dev
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/sync-json-plugin --dev
+```
+
+**包描述：**
+
+- **intlayer**：国际化管理、内容声明和构建的核心库
+- **@intlayer/sync-json-plugin**：将 Intlayer 内容声明导出为 react-intl 兼容 JSON 格式的插件
+
+</Step>
+
+<Step number={2} title="实现 Intlayer 插件来包装 JSON">
+
+创建一个 Intlayer 配置文件来定义您支持的区域设置：
+
+**如果您还想为 react-intl 导出 JSON 字典**，请添加 `syncJSON` 插件：
 
 ```typescript fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -79,24 +130,32 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-`syncJSON` 插件会自动包装 JSON。它会读取和写入 JSON 文件，而不会改变内容结构。
+`syncJSON` 插件将自动包装 JSON。它将读取和写入 JSON 文件而不更改内容架构。
 
-如果你希望让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 会按以下方式处理：
+如果您想让 JSON 与 intlayer 内容声明文件（`.content` 文件）共存，Intlayer 将按以下方式处理：
 
 1. 加载 JSON 和内容声明文件，并将它们转换为 intlayer 字典。
-2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 会合并所有字典。具体合并方式取决于插件的优先级以及内容声明文件的优先级（所有优先级均可配置）。
+2. 如果 JSON 和内容声明文件之间存在冲突，Intlayer 将处理所有字典的合并。这取决于插件的优先级和内容声明文件的优先级（所有都是可配置的）。
 
-如果通过 CLI 翻译 JSON 或使用 CMS 进行更改，Intlayer 会使用新的翻译更新 JSON 文件。
+如果使用 CLI 或 CMS 进行更改以翻译 JSON，Intlayer 将使用新的翻译更新 JSON 文件。
 
-要查看更多关于 `syncJSON` 插件的详细信息，请参阅 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
+有关 `syncJSON` 插件的更多详细信息，请参考 [syncJSON 插件文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md)。
 
-<Steps>
+</Step>
+
+<Step number={3} title="设置 AI provider">
 
-<Step number={1} title="实现按组件的 JSON 翻译" isOptional={true}>
+Intlayer 为您的 i18next 工作流解锁了一套高级自动化和开发者友好的功能。
 
-默认情况下，Intlayer 会加载、合并并同步 JSON 和内容声明文件。更多详情请参阅 [内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。但如果你愿意，也可以使用 Intlayer 插件，在代码库中的任意位置实现按组件管理本地化的 JSON。
+- **自动检测和填充缺失的翻译**：Intlayer 扫描您的 JSON 字典，找到未翻译或缺失的键，只翻译那些，所以您的 JSON 的 99% 保持不变。
+- **大型 JSON 文件的分块翻译**：当您的翻译文件非常大时，Intlayer 自动将处理分成可管理的块，独立翻译它们以避免 API 限制和内存问题。
+- **命名空间并行化**：如果您有数百个命名空间（或文件），Intlayer 会并行化翻译任务，有效地加快您的 CI/CD 或批量翻译操作。
+- **灵活的 AI provider 支持**：选择您首选的 AI provider（例如 OpenAI、Claude、Gemini），只需配置凭证。使用您自己的 API 密钥，并根据需要切换 provider。
+- **弹性 AI 响应处理**：Intlayer 可以处理您的 AI provider 将文本作为字符串或对象返回的边界情况，甚至在格式不一致时自动重试。
+- **CLI 和 CI/CD 就绪**：直接在您的测试或管道中运行 Intlayer 的检查和自动填充，使您的本地化流程健壮且自动化。
+- **集成在您现有的设置之上**：您无需更改您的 i18next 或 Next.js 基础。Intlayer 作为插件工作在您当前的设置之上，为您提供所有这些优点且迁移最少。
 
-为此，你可以使用 `loadJSON` 插件。
+下面是如何设置 AI provider 的示例：
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -107,24 +166,15 @@ const config: IntlayerConfig = {
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
     defaultLocale: Locales.ENGLISH,
   },
-
-  // 保持您当前的 JSON 文件与 Intlayer 字典同步
+  ai: {
+    provider: "openai",
+    model: "gpt-5-mini",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
   plugins: [
-    /**
-     * 将加载 src 目录中所有匹配模式 {key}.i18n.json 的 JSON 文件
-     */
-    loadJSON({
-      source: ({ key }) => `./src/**/${key}.i18n.json`,
-      locale: Locales.ENGLISH,
-      priority: 1, // 确保这些 JSON 文件优先于 `./locales/en/${key}.json` 中的文件
-    }),
-    /**
-     * 将加载并将输出和翻译写回 locales 目录中的 JSON 文件
-     */
     syncJSON({
       format: "icu",
       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
-      priority: 0,
     }),
   ],
 };
@@ -132,7 +182,18 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-这将加载 `src` 目录中所有匹配 `{key}.i18n.json` 模式的 JSON 文件，并将它们作为 Intlayer 字典加载。
+然后您可以执行以下命令来填充您的翻译：
+
+```bash
+npx intlayer fill
+```
+
+这将使用您配置的 AI provider 填充您的翻译。
+
+> 在 [Intlayer AI 配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#ai-configuration) 中查看所有可用的 AI provider。
+> 在 [Intlayer CLI 文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md) 中查看所有可用的命令。
+
+---
 
 </Step>