@intlayer/docs 9.4.4 → 9.5.0

package/docs/zh/migration_from_i18next_to_intlayer.md

@@ -32,7 +32,6 @@ author: aymericzip
 与其将庞大的 JSON 文件加载到页面中，不如仅加载必要的内容。Intlayer 帮助**将 bundle 和页面大小减少高达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 限定应用内容的范围**便于大规模应用的维护**。您可以复制或删除单个功能文件夹，而无需费力审查整个内容 codebase。此外，Intlayer **完全类型化**以确保内容的准确性。
@@ -40,25 +39,21 @@ author: aymericzip
 Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案——问题得到快速修复，新的框架适配器定期发布，核心 API 根据真实生产反馈不断改进。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 内容共定位**减少了大型语言模型 (LLM) 所需的上下文**。Intlayer 还提供一套工具，如**CLI** 来测试缺失的翻译、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 和**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI agents 的开发者体验 (DX) 更加顺利。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 使用自动化在您的 CI/CD pipeline 中进行翻译，使用您选择的 LLM，费用由您的 AI 提供商承担。Intlayer 还提供**编译器**来自动化内容提取，以及一个 [web platform](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 来帮助**在后台翻译**。
 
 </Accordion>
-
 <Accordion header="性能">
 
 将庞大的 JSON 文件连接到组件可能导致性能和响应性问题。Intlayer 在构建时优化您的内容加载。
 
 </Accordion>
-
 <Accordion header="与非开发人员协作扩展">
 
 不仅仅是一个 i18n 解决方案，Intlayer 提供**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和一个**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助您**实时**管理多语言内容，使与翻译人员、文案编写者和其他团队成员的协作无缝衔接。内容可以本地和/或远程存储。
@@ -66,8 +61,6 @@ Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案——问
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 迁移策略
 
 从 `i18next` 迁移到 Intlayer 有两种互补策略：
@@ -78,20 +71,15 @@ Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案——问
 
 本指南首先涵盖**策略 1**（即插即用的兼容性适配器），然后演示可选的完整迁移。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 快速迁移
 
 以下步骤是使现有 `i18next` 应用以零代码更改运行在 Intlayer 上所需的最少要求。
 
 <Steps>
-
 <Step number={1} title="安装依赖">
 
 安装 Intlayer 核心包和兼容性适配器：
@@ -135,7 +123,6 @@ bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
 > 你可以保持 `i18next` 的安装 — 兼容性适配器将其用作 `devDependency` / `peerDependency` 来获取 TypeScript 类型。
 
 </Step>
-
 <Step number={2} title="配置 Intlayer">
 
 `intlayer init` 命令创建一个起始的 `intlayer.config.ts`。更新它以匹配你现有的语言环境并将 `syncJSON` 插件指向你的消息文件：
@@ -170,7 +157,6 @@ export default config;
 > **`source`** 将语言环境映射到其 JSON 文件路径。**`location`** 告诉 Intlayer 监听器应监控哪个文件夹以获取更改。`format: 'i18next'` 选项确保正确解析占位符，如 `{{name}}`。
 
 </Step>
-
 <Step number={3} title="更新 Bundler 别名（可选）">
 
 如果你使用 bundler（Vite、Webpack、esbuild），可以注入模块别名，使得 `import ... from 'i18next'` 自动解析为 `@intlayer/i18next`。这消除了手动更改代码库中任何导入的需要。
@@ -194,14 +180,11 @@ export default defineConfig({
 
 这就是快速迁移的全部内容。你的应用现在运行在 Intlayer 上，同时保持每个 `i18next` 导入和 API 完整。
 
----
-
 ## 完整迁移
 
 下面的步骤是可选的，可以逐步完成。它们解锁了完整的 Intlayer 功能集：可视化编辑器、CMS、类型化内容文件、AI 驱动的翻译等。
 
 <Steps>
-
 <Step number={4} title="显式导入重命名（可选）" isOptional={true}>
 
 如果您想在源文件中明确声明依赖关系，或者您没有使用 bundler 插件来别名导入，您可以手动重命名导入：
@@ -215,7 +198,6 @@ export default defineConfig({
 这些是**直接替换** — 不需要对调用签名、参数或返回类型进行任何更改。
 
 </Step>
-
 <Step number={5} title="启用 AI 驱动的翻译自动化" isOptional={true}>
 
 Intlayer 配置完成后，使用其 CLI 自动填充缺失的翻译：
@@ -277,8 +259,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 迁移后可以删除的内容
 
 一旦 compat adapter 就位，以下 `i18next` 样板代码可以删除：
@@ -291,8 +271,6 @@ export default config;
 
 当您准备进一步操作时，Intlayer **自动发现您的 codebase 中任何地方的所有 `.content.ts` 和 `.content.json` 文件**（默认情况下，在 `./src` 内的任何地方）。您可以将 `my-component.content.ts` 文件放在逻辑代码的旁边，Intlayer 将在构建时自动发现它，无需任何额外配置——无需导入、无需注册、无需集中索引文件。这使得共置翻译完全无摩擦。
 
----
-
 ## 配置 TypeScript
 
 Intlayer 使用模块增强来为您的翻译键提供完整的 TypeScript intellisense。确保您的 `tsconfig.json` 包含自动生成的类型：
@@ -307,8 +285,6 @@ Intlayer 使用模块增强来为您的翻译键提供完整的 TypeScript intel
 }
 ```
 
----
-
 ## Git 配置
 
 将 Intlayer 生成的目录添加到你的 `.gitignore`：
@@ -318,8 +294,6 @@ Intlayer 使用模块增强来为您的翻译键提供完整的 TypeScript intel
 .intlayer
 ```
 
----
-
 ## 深入了解
 
 - **Visual Editor** — 在浏览器中直观管理翻译: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)

package/docs/zh/migration_from_next-i18next_to_intlayer.md

@@ -35,7 +35,6 @@ author: aymericzip
 与其将大量 JSON 文件加载到页面中，不如只加载必要的内容。Intlayer 可帮助**将 bundle 和页面大小减少最多 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 限定应用程序内容的范围**有利于大规模应用程序的维护**。你可以复制或删除单个功能文件夹，而无需费力审查整个内容 codebase。此外，Intlayer **完全类型化**，以确保内容的准确性。
@@ -43,25 +42,21 @@ author: aymericzip
 Intlayer 也是 i18n 生态系统中**开发最活跃**的解决方案 — 问题修复迅速，新的框架适配器定期发布，核心 API 根据真实的生产反馈不断改进。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 内容共置**减少了大型语言模型 (LLM) 所需的上下文**。Intlayer 还附带一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI agents 的开发者体验 (DX) 更加顺畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 在你的 CI/CD pipeline 中使用自动化翻译，使用你选择的 LLM，成本由你的 AI 提供商承担。Intlayer 还提供**编译器**来自动化内容提取，以及一个 [web platform](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 帮助**后台翻译**。
 
 </Accordion>
-
 <Accordion header="性能">
 
 将大量 JSON 文件连接到组件可能会导致性能和响应性问题。Intlayer 在构建时优化了你的内容加载。
 
 </Accordion>
-
 <Accordion header="与非开发人员协作扩展">
 
 Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管[可视编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助你**实时**管理多语言内容，使与翻译人员、文案和其他团队成员的协作无缝进行。内容可以存储在本地和/或远程。
@@ -69,8 +64,6 @@ Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管[可视
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 迁移策略
 
 由于 `next-i18next` 在底层封装了 `react-i18next` 和 `i18next`，迁移到 Intlayer 有两种互补的策略：
@@ -81,20 +74,15 @@ Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管[可视
 
 本指南首先介绍**策略 1**（即插即用的兼容适配器），然后演示可选的完全迁移。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 快速迁移
 
 以下步骤是让现有 Next.js Pages Router 应用在 Intlayer 上运行所需的最少要求,无需对页面和组件进行任何代码更改。
 
 <Steps>
-
 <Step number={1} title="安装依赖">
 
 安装 Intlayer 核心包和兼容适配器:
@@ -138,7 +126,6 @@ bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/r
 > 在迁移期间,您可以安全地保留 `next-i18next`、`react-i18next` 和 `i18next` 的安装,尽管在别名后您将删除它们。
 
 </Step>
-
 <Step number={2} title="配置 Intlayer">
 
 `intlayer init` 命令创建一个启动器 `intlayer.config.ts`。更新它以匹配您现有的语言环境,并将 `syncJSON` 插件指向您的 `next-i18next` 消息文件(通常在 `public/locales` 内):
@@ -173,7 +160,6 @@ export default config;
 > **`source`** 将语言环境和命名空间(`key`)映射到其 JSON 文件路径。**`location`** 告诉 Intlayer 监听器监视哪个文件夹以获取更改。`format: 'i18next'` 选项确保正确解析 `next-i18next` 的占位符。
 
 </Step>
-
 <Step number={3} title="更新 Next.js 配置">
 
 使用来自 `@intlayer/next-i18next/plugin` 的 `createNextI18nPlugin` 包装现有的 `next.config.ts`(或 `.js`)。此包装器组合 `withIntlayer` **并且** 注入 `next-i18next` / `react-i18next` / `i18next` → `@intlayer/*` 别名,因此您现有的 `import { useTranslation } from 'next-i18next'` 调用在构建时透明地重定向。不需要更改源文件。
@@ -217,14 +203,11 @@ export default withIntlayer(nextConfig);
 > tAbout("counter.label"); // ✓ 有类型
 > ```
 
----
-
 ## 完整迁移
 
 下面的步骤是可选的，可以逐步完成。它们解锁完整的 Intlayer 功能集：可视化编辑器、CMS、类型化内容文件、AI 驱动的翻译等。
 
 <Steps>
-
 <Step number={4} title="显式导入重命名（可选）" isOptional={true}>
 
 Intlayer 插件已经在 bundler 级别处理别名。如果您更希望在源文件中明确依赖关系，可以手动重命名导入：
@@ -239,7 +222,6 @@ Intlayer 插件已经在 bundler 级别处理别名。如果您更希望在源
 这些是**即插即用替代品**——无需更改调用签名、参数或返回类型。
 
 </Step>
-
 <Step number={5} title="启用 AI 驱动的翻译自动化" isOptional={true}>
 
 一旦 Intlayer 连接好，使用其 CLI 自动填充缺失的翻译：
@@ -301,8 +283,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 迁移后可以删除的内容
 
 一旦 compat adapter 就位，以下 `next-i18next` 样板代码可以删除：
@@ -315,8 +295,6 @@ export default config;
 
 当你准备进一步操作时，Intlayer **会自动发现整个 codebase 中的所有 `.content.ts` 和 `.content.json` 文件**（默认情况下，在 `./src` 内的任何位置）。你可以将 `my-component.content.ts` 文件放在 `MyComponent.tsx` 旁边，Intlayer 将在构建时自动识别它，无需任何额外配置 — 无需导入、无需注册、无需集中的索引文件。这使得将翻译与页面和组件并置完全无障碍。
 
----
-
 ## 配置 TypeScript
 
 Intlayer 使用模块扩充来为你的翻译键提供完整的 TypeScript intellisense。确保你的 `tsconfig.json` 包含自动生成的类型：
@@ -331,8 +309,6 @@ Intlayer 使用模块扩充来为你的翻译键提供完整的 TypeScript intel
 }
 ```
 
----
-
 ## Git 配置
 
 将 Intlayer 生成的目录添加到您的 `.gitignore`：
@@ -342,8 +318,6 @@ Intlayer 使用模块扩充来为你的翻译键提供完整的 TypeScript intel
 .intlayer
 ```
 
----
-
 ## 进一步学习
 
 - **Visual Editor** — 在浏览器中可视化管理翻译：[Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)

package/docs/zh/migration_from_next-intl_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 与其将大量 JSON 文件加载到页面中，不如只加载必要的内容。Intlayer 帮助**将 bundle 和页面大小减少高达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 将应用程序的内容范围化**便于大规模应用程序的维护**。您可以复制或删除单个功能文件夹，而无需费力审查整个内容 codebase。此外，Intlayer **完全类型化**，以确保内容的准确性。
@@ -41,25 +40,21 @@ author: aymericzip
 Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 — 问题修复迅速，新的框架适配器定期发布，核心 API 根据真实生产反馈不断完善。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 将内容共置**降低大型语言模型（LLM）所需的上下文**。Intlayer 还附带一套工具，例如**用于测试缺失翻译的 CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 和**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI agents 的开发者体验（DX）更加顺畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 使用自动化在 CI/CD 管道中进行翻译，使用您选择的 LLM，费用由您的 AI 提供商承担。Intlayer 还提供**编译器**来自动提取内容，以及一个 [web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)来帮助**后台翻译**。
 
 </Accordion>
-
 <Accordion header="性能">
 
 将大量 JSON 文件连接到组件可能会导致性能和响应性问题。Intlayer 在构建时优化内容加载。
 
 </Accordion>
-
 <Accordion header="与非开发人员的协作">
 
 Intlayer 不仅仅是一个 i18n 解决方案，它提供了一个**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和一个**[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助您**实时**管理多语言内容，使与翻译人员、文案和其他团队成员的协作无缝进行。内容可以本地和/或远程存储。
@@ -67,8 +62,6 @@ Intlayer 不仅仅是一个 i18n 解决方案，它提供了一个**自托管的
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 迁移策略
 
 现有应用的推荐方法是使用 **compat adapter**：安装 `@intlayer/next-intl`，它公开了与 `next-intl` **完全相同的 API**，但在幕后将所有翻译工作委托给 Intlayer。
@@ -77,20 +70,15 @@ Intlayer 不仅仅是一个 i18n 解决方案，它提供了一个**自托管的
 
 随着时间的推移，您可以选择将各个文件迁移到 Intlayer 更丰富的 `.content.ts` 格式，以解锁可视化编辑器、CMS 和按组件内容作用域的功能 — 但这一步完全是可选的，可以逐步进行。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 快速迁移
 
 以下步骤是使现有 `next-intl` 应用在 Intlayer 上运行所需的最少要求，无需更改任何代码。
 
 <Steps>
-
 <Step number={1} title="安装依赖">
 
 安装 Intlayer 核心包和 `@intlayer/next-intl` 兼容性适配器：
@@ -134,7 +122,6 @@ bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
 > 保持 `next-intl` 已安装 — 它仍然是 **URL 路由**（`createNavigation`、`createMiddleware`、`Link`、`redirect`、`usePathname`、`useRouter`）所必需的。兼容性适配器**不**替换路由层。
 
 </Step>
-
 <Step number={2} title="配置 Intlayer">
 
 `intlayer init` 命令创建一个启动器 `intlayer.config.ts`。更新它以匹配你现有的语言，并将 `syncJSON` 插件指向你的消息文件：
@@ -171,7 +158,6 @@ export default config;
 > 有关配置选项的完整列表，请参阅[配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
 </Step>
-
 <Step number={3} title="将 Intlayer 插件添加到 Next.js">
 
 使用来自 `@intlayer/next-intl/plugin` 的 `createNextIntlPlugin` 包装你现有的 Next.js 配置。此包装器组合了 `withIntlayer` **并**为你注册了 `next-intl` → `@intlayer/next-intl` 别名：
@@ -212,14 +198,11 @@ export default withIntlayer(nextConfig);
 > t("counter.label"); // ✓ 类型化
 > ```
 
----
-
 ## 完整迁移
 
 下面的步骤是可选的，可以逐步执行。它们解锁了 Intlayer 的完整功能集：可视化编辑器、CMS、类型化内容文件、AI 驱动的翻译等。
 
 <Steps>
-
 <Step number={4} title="显式导入重命名（可选）" isOptional={true}>
 
 `createNextIntlPlugin()` 包装器已在打包工具级别处理了 `next-intl` → `@intlayer/next-intl` 别名。如果你希望在源文件中明确依赖关系（并改用纯 `withIntlayer` 插件），可以手动重命名导入：
@@ -246,7 +229,6 @@ export default withIntlayer(nextConfig);
 > 或者，你可以使用 `@intlayer/next-intl/routing` 中的 `defineRouting`，它会自动从你的 `intlayer.config.ts` 合并语言环境配置。
 
 </Step>
-
 <Step number={5} title="启用 AI 驱动的翻译自动化" isOptional={true}>
 
 Intlayer 接入后，你可以使用其 CLI 使用你选择的 LLM 自动填充缺失的翻译：
@@ -309,8 +291,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 迁移后可以删除的内容
 
 一旦 `@intlayer/next-intl` 就位，以下 `next-intl` 样板代码可以删除：
@@ -323,8 +303,6 @@ export default config;
 
 当你准备好进一步操作时，Intlayer **自动发现代码库中任何位置的所有 `.content.ts` 和 `.content.json` 文件**（默认情况下，在 `./src` 内的任何位置）。你可以将 `about.content.ts` 文件放在 `about/page.tsx` 文件旁边，Intlayer 将在构建时将其选中，无需额外配置 — 无需导入、无需注册、无需集中索引文件。这使得将翻译与页面和组件并置完全无摩擦。
 
----
-
 ## 配置 TypeScript
 
 Intlayer 使用模块扩展来为您的翻译键提供完整的 TypeScript intellisense。确保您的 `tsconfig.json` 包含自动生成的类型：
@@ -339,8 +317,6 @@ Intlayer 使用模块扩展来为您的翻译键提供完整的 TypeScript intel
 }
 ```
 
----
-
 ## Git 配置
 
 将 Intlayer 生成的目录添加到您的 `.gitignore`：
@@ -350,8 +326,6 @@ Intlayer 使用模块扩展来为您的翻译键提供完整的 TypeScript intel
 .intlayer
 ```
 
----
-
 ## 进一步了解
 
 - **Visual Editor** — 在浏览器中直观管理翻译: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)

package/docs/zh/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 不再需要将庞大的 JSON 文件加载到页面中，只加载必要的内容。Intlayer 帮助您**将 bundle 和页面大小减少高达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 对应用程序的内容进行作用域划分**便于大规模应用的维护**。您可以复制或删除单个功能文件夹，无需审查整个内容代码库的心理负担。此外，Intlayer **完全类型化**，确保内容的准确性。
@@ -42,25 +41,21 @@ author: aymericzip
 Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案 — 问题修复快速、新框架适配器定期发布，核心 API 根据真实生产反馈不断优化。
 
 </Accordion>
-
 <Accordion header="AI Agent">
 
 将内容并置**减少了大语言模型 (LLM) 所需的上下文**。Intlayer 还提供了一套工具，如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI agents 的开发体验 (DX) 更加顺畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 在 CI/CD 管道中使用自动化翻译，使用您选择的 LLM，按 AI 提供商的费用计费。Intlayer 还提供了**编译器**来自动提取内容，以及 [web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 来帮助**后台翻译**。
 
 </Accordion>
-
 <Accordion header="性能">
 
 将庞大的 JSON 文件连接到组件可能会导致性能和响应性问题。Intlayer 在构建时优化您的内容加载。
 
 </Accordion>
-
 <Accordion header="与非开发人员协作扩展">
 
 Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)**，帮助您**实时**管理多语言内容，使与翻译人员、文案人员和其他团队成员的协作无缝衔接。内容可以存储在本地和/或远程。
@@ -68,8 +63,6 @@ Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管的[可
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 迁移策略
 
 由于 `@nuxtjs/i18n` 在底层由 `vue-i18n` 驱动，迁移到 Intlayer 有两种互补的策略：
@@ -80,20 +73,15 @@ Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管的[可
 
 本指南首先介绍**策略 1**（即插即用兼容适配器），然后讲解可选的完整迁移。
 
----
-
 ## 目录
 
 <TOC/>
 
----
-
 ## 快速迁移
 
 以下步骤是使现有 Nuxt 应用在 Intlayer 上运行所需的最低要求，组件中无需任何代码更改。
 
 <Steps>
-
 <Step number={1} title="安装依赖">
 
 安装 Intlayer 核心包和兼容性适配器：
@@ -137,7 +125,6 @@ bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-js
 > 你可以在迁移期间安全地保持 `@nuxtjs/i18n` 已安装状态，尽管稍后你将从 Nuxt 配置中删除它。
 
 </Step>
-
 <Step number={2} title="配置 Intlayer">
 
 `intlayer init` 命令创建一个启动 `intlayer.config.ts`。更新它以匹配你现有的语言环境，并将 `syncJSON` 插件指向你的消息文件：
@@ -172,7 +159,6 @@ export default config;
 > **`source`** 将语言环境映射到其 JSON 文件路径。**`location`** 告诉 Intlayer 观察器监控哪个文件夹以查找更改。`format: 'icu'` 选项确保占位符被正确解析以供 `vue-i18n` 使用。
 
 </Step>
-
 <Step number={3} title="更新 Nuxt 配置">
 
 在 `nuxt.config.ts` 中用 `nuxt-intlayer` 替换 `@nuxtjs/i18n` 模块。Intlayer 插件自动注入模块别名，这意味着你现有的 `import { useI18n } from 'vue-i18n'` 调用被透明地重定向到 `@intlayer/vue-i18n`。
@@ -192,14 +178,11 @@ export default defineNuxtConfig({
 
 快速迁移就这样。你的 Nuxt 应用现在在 Intlayer 上运行，同时保持所有 `$t` 和 `useI18n()` 完好无损。
 
----
-
 ## 完整迁移
 
 以下步骤是可选的，可以逐步完成。它们可以解锁 Intlayer 的完整功能集：可视编辑器、CMS、类型化内容文件、AI 驱动的翻译等。
 
 <Steps>
-
 <Step number={4} title="显式导入重命名（可选）" isOptional={true}>
 
 Intlayer 插件已在 bundler 级别处理别名。如果你更希望在源文件中明确表示依赖关系，可以手动重命名导入：
@@ -211,7 +194,6 @@ Intlayer 插件已在 bundler 级别处理别名。如果你更希望在源文
 这些是**即插即用的替代品** — 不需要对调用签名、参数或返回类型进行任何更改。
 
 </Step>
-
 <Step number={5} title="启用 AI 驱动的翻译自动化" isOptional={true}>
 
 设置好 Intlayer 后，使用其 CLI 自动填充缺失的翻译：
@@ -273,8 +255,6 @@ export default config;
 
 </Steps>
 
----
-
 ## 迁移后可以删除的内容
 
 兼容适配器就位后，可以移除以下样板代码：
@@ -287,8 +267,6 @@ export default config;
 
 当你准备继续深入时，Intlayer **会自动发现代码库中任何位置的所有 `.content.ts` 和 `.content.json` 文件**（默认情况下，在 `./src` 内的任何位置）。你可以将 `my-component.content.ts` 文件放在你的 `MyComponent.vue` 旁边，Intlayer 会在构建时自动获取它，无需任何额外配置 — 无需导入、无需注册、无需中央索引文件。这使得将翻译与页面和组件共置变得完全无摩擦。
 
----
-
 ## 配置 TypeScript
 
 Intlayer 使用模块增强来为你的翻译键提供完整的 TypeScript 智能感知。确保你的 `tsconfig.json` 包含自动生成的类型：
@@ -303,8 +281,6 @@ Intlayer 使用模块增强来为你的翻译键提供完整的 TypeScript 智
 }
 ```
 
----
-
 ## Git 配置
 
 将 Intlayer 生成的目录添加到你的 `.gitignore`：
@@ -314,8 +290,6 @@ Intlayer 使用模块增强来为你的翻译键提供完整的 TypeScript 智
 .intlayer
 ```
 
----
-
 ## 进一步了解
 
 - **Visual Editor** — 在浏览器中以可视方式管理翻译：[Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)