@intlayer/docs 8.1.6 → 8.1.8

package/docs/zh/component_i18n.md

@@ -78,7 +78,7 @@ export default componentContent;
 
 ## 2) 获取您的内容
 
-### 情况 A — React 应用 (Vite/SPA)
+### 情况 A. React 应用 (Vite/SPA)
 
 默认方法：使用 `useIntlayer` 通过键来获取内容。这使组件保持简洁且类型安全。
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### 方案 B — Next.js（App 路由）
+### 方案 B. Next.js（App 路由）
 
 优先使用服务器组件以确保数据安全和性能。在服务器文件中使用来自 `next-intlayer/server` 的 `useIntlayer`，在客户端组件中使用来自 `next-intlayer` 的 `useIntlayer`。
 

package/docs/zh/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: 配置
 description: 了解如何为您的应用程序配置 Intlayer。了解各种设置和选项，以根据您的需求自定义 Intlayer。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: 更新编译器选项
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -440,6 +443,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -979,6 +993,13 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _注意_: 实时模式将使用实时同步 API 来获取字典。如果 API 调用失败，字典将以 "dynamic" 模式动态导入。
   - _注意_: 此选项不会影响 `getIntlayer`、`getDictionary`、`useDictionary`、`useDictionaryAsync` 和 `useDictionaryDynamic` 函数。
 
+- **outputFormat**：
+  - _类型_： `'esm' | 'cjs'`
+  - _默认值_： `'esm'`
+  - _描述_： 控制字典的输出格式。
+  - _示例_： `'cjs'`
+  - _注意_： 字典的输出格式。
+
 - **traversePattern**:
   - _类型_: `string[]`
   - _默认值_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -987,3 +1008,49 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择。目前支持
   - _注意_：使用此选项限制优化范围到相关代码文件，以提升构建性能。
   - _注意_：如果禁用 `optimize`，此选项将被忽略。
   - _注意_：使用 glob 模式。
+
+---
+
+### 编译器配置
+
+控制 Intlayer 编译器的设置，该编译器直接从您的组件中提取字典。
+
+#### 属性
+
+- **enabled**:
+  - _类型_：`boolean | 'build-only'`
+  - _默认值_：`true`
+  - _描述_：指示是否应启用编译器以提取字典。
+  - _示例_：`'build-only'`
+  - _注意_：设置为 `'build-only'` 将在开发模式下跳过编译器，以加快启动速度。它仅在构建命令时运行。
+
+- **dictionaryKeyPrefix**:
+  - _类型_：`string`
+  - _默认值_：`'comp-'`
+  - _描述_：提取的字典键的前缀。
+  - _示例_：`'my-key-'`
+  - _注意_：提取字典时，键是根据文件名生成的。此前缀会添加到生成的键中，以防止冲突。
+
+- **saveComponents**:
+  - _类型_：`boolean`
+  - _默认值_：`false`
+  - _描述_：指示是否应在转换后保存组件。
+  - _注意_：如果为 true，编译器将用转换后的文件替换原始文件。这样，编译器只需运行一次来转换应用，然后即可移除。
+
+- **transformPattern**:
+  - _类型_：`string | string[]`
+  - _默认值_：`['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _描述_：定义在优化过程中应遍历哪些文件的模式。
+  - _示例_：`['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _注意_：使用此选项限制优化范围到相关代码文件，以提升构建性能。
+
+- **excludePattern**:
+  - _类型_：`string | string[]`
+  - _默认值_：`['**/node_modules/**']`
+  - _描述_：定义在优化过程中应排除哪些文件的模式。
+  - _示例_：`['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _类型_：`string`
+  - _默认值_： `'compiler'`
+  - _描述_：存储提取字典的目录，相对于您的项目基准路径。

package/docs/zh/dictionary/content_file.md

@@ -512,7 +512,7 @@ export default aboutPageMetaContent;
 
 - `'local'`: 字典仅在本地管理。它不会被推送到远程 CMS。用于应保留在代码库中的内容。
 - `'remote'`: 字典仅在远程管理。推送到 CMS 后，它将与本地文件分离。在内容加载时，远程字典将从 CMS 拉取。带有 `remote` 位置的 `.content` 文件在初始推送后将被忽略。
-- `'hybrid'`: 字典在本地和远程同时管理。推送到 CMS 后，它将保持同步—本地文件的更改会推送到 CMS，远程更改可以拉回本地文件。
+- `'hybrid'`: 字典在本地和远程同时管理。推送到 CMS 后，它将保持同步, 本地文件的更改会推送到 CMS，远程更改可以拉回本地文件。
 - `string`（例如 `'plugin'`）：字典由插件或自定义源管理。当您尝试推送时，系统会询问您要执行的操作。
 
 **示例：**

package/docs/zh/index.md

@@ -64,7 +64,7 @@ Intlayer 提供了一种灵活且现代化的应用翻译方案。我们的文
 - **[枚举](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/enumeration.md)**  
   轻松管理跨多种语言的重复或固定数据集。
 
-- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/conditional.md)**  
+- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/condition.md)**  
   学习如何在 Intlayer 中使用条件逻辑来创建动态内容。
 
 - **[插入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)**  
@@ -76,7 +76,7 @@ Intlayer 提供了一种灵活且现代化的应用翻译方案。我们的文
 - **[枚举](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/enumeration.md)**  
   轻松管理跨多语言的重复或固定数据集。
 
-- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/conditional.md)**  
+- **[条件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/condition.md)**  
   学习如何在 Intlayer 中使用条件逻辑来创建动态内容。
 
 - **[插入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)**  
@@ -88,7 +88,7 @@ Intlayer 提供了一种灵活且现代化的应用翻译方案。我们的文
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)**  
   学习如何在 Intlayer 中使用 Markdown 创建丰富内容。
 
-- **[文件嵌入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/file_embeddings.md)**  
+- **[文件嵌入](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/file.md)**  
   了解如何在 Intlayer 中嵌入外部文件，以便在内容编辑器中使用。
 
 - **[嵌套](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/nesting.md)**  

package/docs/zh/intlayer_CMS.md

@@ -443,7 +443,7 @@ module.exports = config;
 
 Live Sync 服务器包裹您的应用程序，并在更新内容到达时自动应用。
 
-为了接收来自 CMS 的变更通知，Live Sync 服务器会与后端保持 SSE 连接。当 CMS 中的内容发生变化时，后端会将更新转发给 Live Sync 服务器，服务器会写入新的字典。您的应用将在下一次导航或浏览器刷新时反映更新——无需重新构建。
+为了接收来自 CMS 的变更通知，Live Sync 服务器会与后端保持 SSE 连接。当 CMS 中的内容发生变化时，后端会将更新转发给 Live Sync 服务器，服务器会写入新的字典。您的应用将在下一次导航或浏览器刷新时反映更新, 无需重新构建。
 
 流程图（CMS/后端 -> Live Sync 服务器 -> 应用服务器 -> 前端）：
 

package/docs/zh/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - 如何翻译您的 AdonisJS 应用 – 2026 指南
+title: AdonisJS i18n - 如何翻译AdonisJS 应用 2026
 description: 探索如何使您的 AdonisJS 后端多语言化。遵循文档进行国际化 (i18n) 和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - 如何翻译您的 Analog 应用 – 2026 指南
+title: Analog i18n - 如何翻译Analog 应用 2026
 description: 了解如何让您的 Analog 应用支持多语言。遵循文档进行国际化 (i18n) 和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - 如何翻译你的 Angular 应用 – 2026 指南
+title: Angular i18n - 如何翻译Angular 应用 2026
 description: 探索如何让你的 Angular 网站支持多语言。遵循文档进行国际化 (i18n) 和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - 如何翻译您的 Astro 应用 – 指南 2026
+title: Astro i18n - 如何翻译Astro 应用 2026
 description: 学习如何使用 Intlayer 为您的 Astro 网站添加国际化（i18n）。按照本指南使您的网站支持多语言。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Create React App i18n - 如何翻译您的 React 应用 – 指南 2026
+title: Create React App i18n - 如何翻译React 应用 2026
 description: 了解如何使您的 Create React App (CRA) 网站实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Express i18n - 如何翻译您的 Express 应用 – 指南 2026
+title: Express i18n - 如何翻译Express 应用 2026
 description: 了解如何使您的 Express 后端实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - 如何翻译您的 Fastify 应用 – 指南 2026
+title: Fastify i18n - 如何翻译Fastify 应用 2026
 description: 了解如何使你的 Fastify 后端实现多语言。按照文档对其进行国际化 (i18n) 并翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Hono i18n - 如何翻译您的 Hono 应用 – 2026 指南
+title: Hono i18n - 如何翻译Hono 应用 2026
 description: 探索如何使您的 Hono 后端支持多语言。按照文档进行国际化 (i18n) 和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx 和 React i18n - 如何翻译您的 Lynx 应用 – 指南 2026
+title: Lynx + React i18n - 如何翻译Lynx 应用 2026
 description: 了解如何使您的使用 Lynx 和 React 的移动应用实现多语言。请遵循文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - 如何翻译您的 NestJS 应用 – 指南 2026
+title: NestJS i18n - 如何翻译NestJS 应用 2026
 description: 了解如何使你的 NestJS 后端支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js 和 next-i18next i18n - 如何翻译您的 Next.js 应用 – 指南 2026
+title: next-i18next - 如何在 2026 年翻译 Next.js (i18n) 应用
 description: 一个实用且适用于生产环境的指南，教你如何使用 i18next/next-i18next 国际化 Next.js 15 App Router 应用，并通过 Intlayer 进行增强。
 keywords:
   - 国际化
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - 集成 Intlayer 以自动化翻译工作流（测试、AI 填充、JSON 同步）
 
 > 注意：next-i18next 是构建在 i18next 之上的。本指南使用与 next-i18next 在 App Router 中兼容的 i18next 原语，同时保持架构简单且适合生产环境。
-> 如需更全面的比较，请参见 [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/zh/next-i18next_vs_next-i18next_vs_intlayer.md)。
+> 如需更全面的比较，请参见 [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/zh/next-i18next_vs_next-intl_vs_intlayer.md)。
 
 ---
 

package/docs/zh/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js 和 next-intl i18n - 如何翻译您的 Next.js 应用 – 指南 2026
+title: next-intl - 如何在 2026 年翻译 Next.js (i18n) 应用
 description: 了解如何使你的 Next.js 15 App Router 网站实现多语言。按照文档进行国际化 (i18n) 和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - 如何翻译您的 Next.js 14 应用 – 指南 2026
+title: Next.js i18n - 如何翻译Next.js 14 应用 2026
 description: 了解如何使你的 Next.js 14 App Router 网站支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - 如何翻译您的 Next.js 15 应用 – 指南 2026
+title: Next.js i18n - 如何翻译Next.js 15 应用 2026
 description: 了解如何使您的 Next.js 15 网站支持多语言。按照文档进行国际化（i18n）和翻译。
 keywords:
   - 国际化

package/docs/zh/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - 如何翻译您的 Next.js 16 应用 – 指南 2026
+title: Next.js i18n - 如何翻译Next.js 16 应用 2026
 description: 了解如何让您的 Next.js 16 网站支持多语言。按照文档进行国际化 (i18n) 并对其进行翻译。
 keywords:
   - 国际化
@@ -708,6 +708,8 @@ const ServerComponentExample = () => {
 
 > 要了解有关 `useIntlayer` 钩子的更多信息，请参阅[文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/next-intlayer/useIntlayer.md)。
 
+> 如果您的应用程序已经存在，您可以结合使用 [Intlayer 编译器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) 和 [提取命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md) 在一秒钟内转换成干个组件。
+
 ### （可选）第 7 步：配置代理进行语言环境检测
 
 设置代理以检测用户首选的语言环境：