@intlayer/docs 8.11.1 → 8.11.3

package/docs/zh/dictionary/markdown.md

@@ -17,6 +17,9 @@ slugs:
   - content
   - markdown
 history:
+  - version: 8.11.0
+    date: 2026-05-28
+    changes: "允许为 SSR / 注水（hydration）预解析 Markdown AST"
   - version: 8.10.0
     date: 2026-05-19
     changes: "添加对 `.content.md` 文件的支持"
@@ -737,7 +740,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     );
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
   <Tab label="Next.js" value="nextjs">
@@ -779,7 +782,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     );
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
   <Tab label="Vue" value="vue">
@@ -830,7 +833,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     app.mount("#app");
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
   <Tab label="Svelte" value="svelte">
@@ -870,7 +873,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     </MarkdownProvider>
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
   <Tab label="Preact" value="preact">
@@ -909,7 +912,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     );
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
   <Tab label="Solid" value="solid">
@@ -948,7 +951,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     );
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
   <Tab label="Angular" value="angular">
@@ -970,7 +973,7 @@ Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任
     export class AppModule {}
     ```
 
-    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序Bundle 大小的好方法。
 
   </Tab>
 </Tabs>
@@ -1149,6 +1152,164 @@ export class MyComponent {
 
 ---
 
+## 服务端渲染 (SSR) 与 注水 (Hydration)
+
+与其他 Markdown 解析器（如 remark / rehype）相比，Intlayer Markdown 无依赖关系，且既可以在客户端运行，也可以在服务端运行。
+
+但是 Intlayer 针对服务端渲染 (SSR) 框架（如 Next.js App Router, React Router, Nuxt, SvelteKit 等）进行了解析优化。
+
+Intlayer 允许您在服务端将 Markdown 预解析为抽象语法树 (AST)，而不是将原始 Markdown 字符串发送到客户端并在浏览器中解析（这会带来性能损失）。
+
+您可以在服务端使用框架的 Intlayer 包中的 `parseMarkdown` 函数来生成可序列化的 AST（`ParsedMarkdown` 对象），并将其直接传递给前端。所有 Intlayer 渲染工具（如 `<MarkdownRenderer>`、`useMarkdownRenderer` 等）都会自动接受此 AST 对象并无缝渲染它。
+
+### 服务端/客户端架构中的示例
+
+<Tabs group="framework">
+  <Tab label="React Router" value="react">
+
+    ```tsx fileName="server.ts"
+    import { parseMarkdown } from "react-intlayer/markdown";
+
+    // 1. 在服务端：将 markdown 解析为可序列化的 AST
+    export const loader = async () => {
+      const markdownString = "## My title \n\nLorem Ipsum";
+      const ast = parseMarkdown(markdownString);
+
+      // 将 AST 作为 JSON 返回给客户端
+      return Response.json({ content: ast });
+    };
+    ```
+
+    ```tsx fileName="client.tsx"
+    import { useLoaderData } from "react-router";
+    import { MarkdownRenderer } from "react-intlayer/markdown";
+
+    // 2. 在客户端：直接渲染 AST，无需重新解析
+    export default function Page() {
+      const { content } = useLoaderData();
+
+      // 渲染器既接受原始字符串，也接受解析后的 AST
+      return <MarkdownRenderer content={content} />;
+    }
+    ```
+
+  </Tab>
+  <Tab label="Next.js" value="nextjs">
+
+    ```tsx fileName="app/page.tsx"
+    import { parseMarkdown } from "next-intlayer/markdown";
+    import { MarkdownRenderer } from "next-intlayer/markdown";
+
+    export default async function Page() {
+      // 1. 在服务端将 markdown 解析为可序列化的 AST
+      const markdownString = "## My title \n\nLorem Ipsum";
+      const ast = parseMarkdown(markdownString);
+
+      // 2. 直接渲染 AST
+      // 在服务端组件（Server Component）中，这可以无缝工作，并在需要时
+    // 直接将 AST 传递给底层的客户端组件。
+      return <MarkdownRenderer content={ast} />;
+    }
+    ```
+
+  </Tab>
+  <Tab label="Vue / Nuxt" value="vue">
+
+    ```vue fileName="pages/index.vue"
+    <script setup lang="ts">
+    import { parseMarkdown } from "vue-intlayer/markdown";
+    import { MarkdownRenderer } from "vue-intlayer/markdown";
+
+    // 1. 在服务端获取并解析 markdown 为 AST
+    const { data: ast } = await useAsyncData('markdown', () => {
+      const markdownString = "## My title \n\nLorem Ipsum";
+      return parseMarkdown(markdownString);
+    });
+    </script>
+
+    <template>
+      <!-- 2. 在客户端：直接渲染 AST，无需重新解析 -->
+      <MarkdownRenderer :content="ast" />
+    </template>
+    ```
+
+  </Tab>
+  <Tab label="SvelteKit" value="svelte">
+
+    ```typescript fileName="+page.server.ts"
+    import { parseMarkdown } from "svelte-intlayer/markdown";
+
+    // 1. 在服务端：将 markdown 解析为可序列化的 AST
+    export const load = async () => {
+      const markdownString = "## My title \n\nLorem Ipsum";
+      const ast = parseMarkdown(markdownString);
+
+      // 将 AST 返回给客户端
+      return { content: ast };
+    };
+    ```
+
+    ```svelte fileName="+page.svelte"
+    <script lang="ts">
+      import { MarkdownRenderer } from "svelte-intlayer/markdown";
+      export let data;
+    </script>
+
+    <!-- 2. 在客户端：直接渲染 AST，无需重新解析 -->
+    <MarkdownRenderer value={data.content} />
+    ```
+
+  </Tab>
+  <Tab label="Angular" value="angular">
+
+    Angular SSR 通常在初始加载期间在服务端解析数据，并在客户端进行注水。您可以使用解析器（resolvers）来传递 AST。
+
+    ```typescript fileName="app.resolver.ts"
+    import { Injectable } from "@angular/core";
+    import { Resolve } from "@angular/router";
+    import { parseMarkdown, type ParsedMarkdown } from "angular-intlayer/markdown";
+
+    @Injectable({ providedIn: "root" })
+    export class MarkdownResolver implements Resolve<ParsedMarkdown> {
+      resolve(): ParsedMarkdown {
+        const markdownString = "## My title \n\nLorem Ipsum";
+        // 1. 在服务端：将 markdown 解析为可序列化的 AST
+        return parseMarkdown(markdownString);
+      }
+    }
+    ```
+
+    ```typescript fileName="app.component.ts"
+    import { Component } from "@angular/core";
+    import { ActivatedRoute } from "@angular/router";
+    import { IntlayerMarkdownService, type ParsedMarkdown } from "angular-intlayer/markdown";
+
+    @Component({
+      selector: "app-root",
+      template: `<div [innerHTML]="renderedMarkdown"></div>`,
+    })
+    export class AppComponent {
+      renderedMarkdown: string = "";
+
+      constructor(
+        private route: ActivatedRoute,
+        private markdownService: IntlayerMarkdownService
+      ) {
+        // 2. 在客户端：直接渲染 AST，无需重新解析
+        this.route.data.subscribe((data) => {
+          this.renderedMarkdown = this.markdownService.renderMarkdown(
+            data.markdownAst
+          ) as string;
+        });
+      }
+    }
+    ```
+
+  </Tab>
+</Tabs>
+
+这种模式确保 Markdown 解析逻辑完全在服务端执行，从而显著减少客户端执行时间，并提高初始注水速度。
+
 ## 选项参考
 
 这些选项可传递给`MarkdownProvider`、`MarkdownRenderer`、`useMarkdownRenderer`和`renderMarkdown`。

package/docs/zh/how_works_intlayer.md

@@ -101,7 +101,7 @@ Intlayer 还提供了一个可视化编辑器，允许您以可视化的方式
 
 ## 应用构建优化
 
-为了优化应用的包大小，Intlayer 提供了两个插件来优化应用的构建：`@intlayer/babel` 和 `@intlayer/swc` 插件。
+为了优化应用的Bundle 大小，Intlayer 提供了两个插件来优化应用的构建：`@intlayer/babel` 和 `@intlayer/swc` 插件。
 Babel 和 SWC 插件通过分析应用程序的抽象语法树（AST）来替换 Intlayer 函数的调用为优化后的代码。此过程确保只导入实际使用的字典，优化分块，从而减小生产环境中的最终包体积。
 
 在开发模式下，Intlayer 使用集中式静态导入字典以简化开发体验。

package/docs/zh/interest_of_intlayer.md

@@ -1,38 +1,77 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-09-27
-title: Intlayer 的优势
-description: 了解在项目中使用 Intlayer 的好处和优势。明白为什么 Intlayer 在其他框架中脱颖而出。
+updatedAt: 2026-05-31
+title: Intlayer 的重要性
+description: 探索在项目中使用 Intlayer 的好处和优势。了解为什么 Intlayer 在其他框架中脱颖而出。
 keywords:
   - 好处
   - 优势
   - Intlayer
   - 框架
-  - 比较
+  - 对比
 slugs:
   - doc
   - why
 history:
+  - version: 8.11.2
+    date: 2026-05-31
+    changes: "添加为什么选择 Intlayer 而不是其他替代方案的章节"
   - version: 7.3.1
     date: 2025-11-27
-    changes: "编译器发布"
+    changes: "发布编译器"
   - version: 5.8.0
     date: 2025-08-19
-    changes: "更新比较表"
+    changes: "更新对比表"
   - version: 5.5.10
     date: 2025-06-29
-    changes: "初始化历史"
+    changes: "初始化历史记录"
 ---
 
 # 为什么你应该考虑使用 Intlayer？
 
 ## 什么是 Intlayer？
 
-**Intlayer** 是专门为 JavaScript 开发人员设计的国际化库。它允许在代码的任何地方声明你的内容。它将多语言内容的声明转换为结构化的字典，以便轻松集成到你的代码中。通过使用 TypeScript，**Intlayer** 使你的开发更加健壮和高效。
+**Intlayer** 是一个专门为 JavaScript 开发者设计的国际化（i18n）库。它允许你在代码中的任何地方声明你的内容。它将多语言内容的声明转换为结构化的字典，以便轻松集成到你的代码中。通过使用 TypeScript，**Intlayer** 让你的开发工作更加稳固和高效。
+
+## 为什么选择 Intlayer 而不是其他替代方案？
+
+与 `next-intl` 或 `i18next` 等主要解决方案相比，Intlayer 是一个自带集成优化的解决方案，例如：
+
+**打包体积 (Bundle size)**
+
+无需在页面中加载庞大的 JSON 文件，只需加载必要的特定内容。Intlayer 可以帮助你**将打包体积和页面大小减少多达 50%**。
+
+**可维护性 (Maintainability)**
+
+对应用程序的内容进行组件级的范围限制，**大大简化了大型应用程序的维护工作**。你可以复制或删除单个功能文件夹，而无需承担审查整个内容代码库的精神负担。此外，Intlayer 是**完全类型化**的，以确保你内容的准确性。
+
+**AI 智能体支持 (AI Agent)**
+
+将内容与组件共同放置（Co-location）**减少了大型语言模型（LLMs）所需的上下文**。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 智能体的开发体验（DX）更加流畅。
+
+**功能丰富 (Feature)**
+
+Intlayer 提供了其他 i18n 解决方案所没有的一系列附加功能，例如 [Markdown 支持](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)、[外部内容获取](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/function_fetching.md)、[文件内容加载](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/file.md)、[实时内容更新](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/live.md)、[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)等。
+
+**自动化 (Automation)**
+
+使用自动化在你的 CI/CD 流程中翻译，可以使用你选择的任何 LLM，成本完全取决于你的 AI 提供商。Intlayer 还提供了一个**编译器**来自动提取内容，以及一个 [网页平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 来帮助你**在后台进行翻译工作**。
+
+**性能表现 (Performance)**
+
+将庞大的 JSON 文件连接到组件上可能会导致性能和响应性问题。Intlayer 在构建时优化了你的内容加载方式。
+
+**扩展至非开发团队 (Scaling with non-dev)**
+
+不仅仅是一个 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)**，帮助你**实时**管理多语言内容，使与翻译人员、文案人员和其他团队成员的协作变得无缝衔接。内容可以存储在本地和/或远程。
+
+**跨框架设计 (Cross framework design)**
+
+如果你在应用程序的不同部分使用不同的框架（例如 React、React-native、Vue、Angular、Svelte 等），Intlayer 提供了一种**在所有主流前端框架中使用通用语法和实现**的方法。你还可以跨设计系统、应用、后端等共享你的内容声明。
 
 ## 为什么要创建 Intlayer？
 
-创建 Intlayer 是为了解决影响所有常用 i18n 库（如 `next-intl`、`react-i18next`、`react-intl`、`next-i18next` 和 `vue-i18n`）的共同问题。
+创建 Intlayer 是为了解决一个普遍影响所有常见 i18n 库（如 `next-intl`、`react-i18next`、`react-intl`、`next-i18next`、`react-intl` 和 `vue-i18n`）的痛点。
 
 所有这些解决方案都采用集中式方法来列出和管理你的内容。例如：
 
@@ -49,7 +88,7 @@ history:
             └── index.tsx
 ```
 
-或者使用命名空间：
+或者使用命名空间（namespaces）：
 
 ```bash
 .
@@ -70,23 +109,23 @@ history:
             └── index.tsx
 ```
 
-由于以下几个原因，这种类型的架构会减慢开发过程并使代码库的维护变得更加复杂：
+由于以下几个原因，这种架构会降低开发速度，并使代码库的维护变得更加复杂：
 
-1. **对于创建的任何新组件，你应该：**
+1. **对于创建的任何新组件，你都必须：**
    - 在 `locales` 文件夹中创建新的资源/命名空间
    - 记住在页面中导入新的命名空间
-   - 翻译你的内容（通常通过从 AI 提供商处复制/粘贴手动完成）
+   - 翻译你的内容（通常是通过从 AI 提供商手动复制/粘贴来完成）
 
-2. **对于对组件进行的任何更改，你应该：**
-   - 搜索相关的资源/命名空间（远离组件）
+2. **对于对组件进行的任何更改，你都必须：**
+   - 寻找相关的资源/命名空间（远离组件本身）
    - 翻译你的内容
-   - 确保你的内容对于任何语言环境都是最新的
+   - 确保你的内容在所有语言（locales）中都是最新的
    - 验证你的命名空间不包含未使用的键/值
-   - 确保所有语言环境的 JSON 文件结构相同
+   - 确保你的 JSON 文件结构在所有语言中都是相同的
 
-在使用这些解决方案的专业项目中，通常会使用本地化平台来帮助管理内容的翻译。然而，对于大型项目，这可能会迅速变得昂贵。
+在采用这些解决方案的专业项目中，通常会使用定位管理平台来协助管理内容的翻译。然而，对于大型项目来说，这很快就会变得昂贵。
 
-为了解决这个问题，Intlayer 采用了一种将内容限定在每个组件范围内的方法，并将内容保持在组件附近，就像我们通常处理 CSS (`styled-components`)、类型、文档 (`storybook`) 或单元测试 (`jest`) 一样。
+为了解决这个问题，Intlayer 采用了一种将内容按组件作用域划分的方法，并将你的内容保持在组件附近，就像我们通常对 CSS (`styled-components`)、类型、文档 (`storybook`) 或单元测试 (`jest`) 所做的那样。
 
 ```bash codeFormat="typescript"
 .
@@ -148,81 +187,79 @@ export const ComponentExample = () => {
 这种方法允许你：
 
 1. **提高开发速度**
-   - 可以使用 VSCode 扩展创建 `.content.{{ts|mjs|cjs|json}}` 文件
-   - IDE 中的自动完成 AI 工具（如 GitHub Copilot）可以帮助你声明内容，减少复制/粘贴
+   - 可以使用 VSCode 插件创建 `.content.{{ts|mjs|cjs|json}}` 文件
+   - IDE 中的 AI 自动补全工具（例如 GitHub Copilot）可以帮助你声明内容，减少复制/粘贴
 
-2. **清理你的代码库**
-   - 降低复杂性
+2. **保持代码库的整洁**
+   - 降低复杂度
    - 提高可维护性
 
-3. **更轻松地复制组件及其相关内容（例如：登录/注册组件等）**
-   - 通过限制影响其他组件内容的风险
-   - 通过将内容从一个应用程序复制/粘贴到另一个应用程序，无需外部依赖项
+3. **更容易地复制组件及其相关内容（例如：登录/注册组件等）**
+   - 限制影响其他组件内容的风险
+   - 将你的内容从一个应用复制到另一个应用，而无需任何外部依赖
 
-4. **避免因未使用的组件而导致未使用的键/值污染代码库**
+4. **避免在未使用的组件中残留未使用的键/值以污染代码库**
    - 如果你不使用某个组件，Intlayer 将不会导入其相关内容
-   - 如果你删除一个组件，你将更容易记住删除其相关内容，因为它位于同一个文件夹中
+   - 如果你删除了一个组件，你更容易记得移除其相关内容，因为它就存在于同一个文件夹中
 
-5. **降低 AI 代理声明多语言内容的推理成本**
-   - AI 代理无需扫描整个代码库就知道在哪里实现你的内容
-   - 翻译可以通过 IDE 中的自动完成 AI 工具（如 GitHub Copilot）轻松完成
+5. **减少 AI 智能体声明多语言内容的推断成本**
+   - AI 智能体无需扫描你整个代码库来了解在哪里实现你的内容
+   - 翻译可以通过 IDE 中的 AI 自动补全工具（例如 GitHub Copilot）轻松完成
 
 6. **优化加载性能**
-   - 如果一个组件是懒加载的，其相关内容将同时加载
-
-## Intlayer 的附加功能
-
-| 功能                                                                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                          |
-| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ![功能](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                             | **跨框架支持**<br><br>Intlayer 与所有主要框架和库兼容，包括 Next.js、React、Vite、Vue.js、Nuxt、Preact、Express 等。                                                                                                                                                                                                                                          |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 驱动的内容管理**<br><br>利用 JavaScript 的灵活性高效地定义和管理内容。<br><br> - [内容声明](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                            |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="功能" width="700">     | **编译器**<br><br>Intlayer 编译器自动从组件中提取内容并生成字典文件。<br><br> - [编译器](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                   |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **按语言环境的内容声明文件**<br><br>在自动生成之前，通过一次性声明内容来加速开发。<br><br> - [按语言环境的内容声明文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                     |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **类型安全环境**<br><br>利用 TypeScript 确保内容定义和代码无错误，同时受益于 IDE 自动完成。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **简化设置**<br><br>通过最少的配置快速启动并运行。轻松调整国际化、路由、AI、构建和内容处理设置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                   |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **简化内容检索**<br><br>无需为每条内容调用 `t` 函数。使用单个 hook 直接检索所有内容。<br><br> - [React 集成](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **一致的服务器组件实现**<br><br>非常适合 Next.js 服务器组件，客户端和服务器组件使用相同的实现，无需在每个服务器组件中传递 `t` 函数。<br><br> - [服务器组件](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                  |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **有组织的代码库**<br><br>保持代码库更有组织性：1 个组件 = 1 个位于同一文件夹中的字典。靠近其各自组件的翻译增强了可维护性和清晰度。<br><br> - [Intlayer 工作原理](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                        |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **增强型路由**<br><br>全面支持应用路由，无缝适应复杂的应用结构，适用于 Next.js、React、Vite、Vue.js 等。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 支持**<br><br>导入和解释本地文件和远程 Markdown 以获取多语言内容，如隐私政策、文档等。在代码中解释并使 Markdown 元数据可访问。<br><br> - [内容文件](https://intlayer.org/doc/concept/content/file)                                                                                                                                                 |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **免费视觉编辑器和 CMS**<br><br>为内容作者提供免费的视觉编辑器和 CMS，无需本地化平台。使用 Git 保持内容同步，或者使用 CMS 完全或部分外部化内容。<br><br> - [Intlayer 编辑器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Tree-shakable 内容**<br><br>Tree-shakable 内容，减小最终包的大小。按组件加载内容，从包中排除任何未使用的内容。支持懒加载以提高应用加载效率。<br><br> - [应用构建优化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                           |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **静态渲染**<br><br>不阻塞静态渲染。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                    |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI 驱动翻译**<br><br>只需单击一下，即可使用 Intlayer 先进的 AI 驱动翻译工具和自己的 AI 提供商/API 密钥，将网站转换为 231 种语言。<br><br> - [CI/CD 集成](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自动填充](https://intlayer.org/doc/concept/auto-fill)                                  |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 服务器集成**<br><br>为 IDE 自动化提供 MCP (Model Context Protocol) 服务器，实现在开发环境中无缝的内容管理和 i18n 工作流。<br><br> - [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/zh/mcp_server.md)                                                                                                                                |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 扩展**<br><br>Intlayer 提供 VSCode 扩展来帮助你管理内容和翻译、构建字典、翻译内容等。<br><br> - [VSCode 扩展](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                            |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **互操作性**<br><br>允许与 react-i18next、next-i18next、next-intl 和 react-intl 进行互操作。<br><br> - [Intlayer 和 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 和 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 和 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) |
-| 测试缺失的翻译 (CLI/CI)                                                                                                   | ✅ CLI: npx intlayer content test (CI 友好型审计)                                                                                                                                                                                                                                                                                                             |
+   - 如果一个组件是懒加载的，其相关内容将在同一时间被加载
+
+## Intlayer 附加功能
+
+| 功能                                                                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                      |
+| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和库，包括 Next.js、React、Vite、Vue.js、Nuxt、Preact、Express 等。                                                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 驱动的内容管理**<br><br>利用 JavaScript 的灵活性来高效地定义和管理你的内容。<br><br> - [内容声明](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **编译器**<br><br>Intlayer 编译器可自动从组件中提取内容并生成字典文件。<br><br> - [编译器](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **单语言内容声明文件**<br><br>在自动生成前，通过仅声明一次你的内容来加速开发。<br><br> - [单语言内容声明文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **类型安全环境**<br><br>利用 TypeScript 确保你的内容定义和代码没有错误，同时还能享受 IDE 的自动补全功能。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **简易配置**<br><br>仅需极简的配置即可快速启动并运行。轻松调整国际化、路由、AI、构建以及内容处理的设置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                       |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **简化内容检索**<br><br>无需为每一小段内容调用 `t` 函数。使用单一的 hook 即可直接检索你的所有内容。<br><br> - [React 集成](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **一致的服务器组件实现**<br><br>完美适合 Next.js 服务器组件，客户端和服务器组件使用相同的实现，无需跨每个服务器组件传递你的 `t` 函数。<br><br> - [服务器组件](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **有条理的代码库**<br><br>保持代码库更有条理：1 组件 = 在同一文件夹下的 1 个字典。靠近其各自组件的翻译有助于提高可维护性和清晰度。<br><br> - [Intlayer 运行机制](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **增强的路由功能**<br><br>完全支持应用路由，无缝适应复杂的应用结构，适用于 Next.js、React、Vite、Vue.js 等。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 支持**<br><br>导入并解译本地文件以及远程 Markdown，以获得隐私政策、文档等多语言内容。解译并在你的代码中使 Markdown 元数据可被访问。<br><br> - [内容文件](https://intlayer.org/doc/concept/content/file)                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **免费的可视化编辑器与 CMS**<br><br>可视化编辑器和 CMS 免费向内容创作者开放，消除了对第三方本地化平台的依赖。使用 Git 保持内容同步，或使用 CMS 彻底或部分外置管理它。<br><br> - [Intlayer 编辑器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                    |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **构建时摇树优化 (Tree-shakable) 内容**<br><br>构建时摇树优化内容，减小最终包的体积。按组件加载内容，并从打包体积中排除任何未使用的内容。支持懒加载以提高应用加载效率。<br><br> - [应用构建优化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **静态渲染**<br><br>不阻碍静态渲染（Static Rendering）。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI 驱动翻译**<br><br>使用您自己的 AI 提供商/API 密钥，点击一下即可将您的网站翻译成 231 种语言，得益于 Intlayer 先进的 AI 翻译工具。<br><br> - [CI/CD 集成](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自动填充](https://intlayer.org/doc/concept/auto-fill)                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 服务器集成**<br><br>提供用于 IDE 自动化的 MCP（Model Context Protocol）服务器，能够直接在你的开发环境中实现无缝的内容管理和 i18n 工作流。<br><br> - [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/zh/mcp_server.md)                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 插件**<br><br>Intlayer 提供 VSCode 插件协助管理你的内容和翻译，构建你的字典，翻译你的内容等。<br><br> - [VSCode 插件](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **互操作性**<br><br>允许与 react-i18next、next-i18next、next-intl 和 react-intl 互操作。<br><br> - [Intlayer 与 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 与 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 与 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) |
+| 测试缺失翻译 (CLI/CI)                                                                                                     | ✅ CLI: npx intlayer content test (对 CI 友好的审计)                                                                                                                                                                                                                                                                                                      |
 
 ## Intlayer 与其他解决方案的比较
 
-| 功能                                 | `intlayer`                                                                         | `react-i18next`                                              | `react-intl` (FormatJS)                                                    | `lingui`                            | `next-intl`                                                  | `next-i18next`                                               | `vue-i18n`                                            |
-| ------------------------------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------------------------------------------- |
-| **组件附近的翻译**                   | ✅ 是，内容与每个组件并存                                                          | ❌ 否                                                        | ❌ 否                                                                      | ❌ 否                               | ❌ 否                                                        | ❌ 否                                                        | ✅ 是 - 使用 `Single File Components` (SFCs)          |
-| **TypeScript 集成**                  | ✅ 高级，自动生成严格类型                                                          | ⚠️ 基础；为安全需额外配置                                    | ✅ 良好，但不够严格                                                        | ⚠️ 类型，需要配置                   | ✅ 良好                                                      | ⚠️ 基础                                                      | ✅ 良好 (提供类型；键安全需设置)                      |
-| **缺失翻译检测**                     | ✅ TypeScript 错误高亮和构建时错误/警告                                            | ⚠️ 运行时主要是回退字符串                                    | ⚠️ 回退字符串                                                              | ⚠️ 需要额外配置                     | ⚠️ 运行时回退                                                | ⚠️ 运行时回退                                                | ⚠️ 运行时回退/警告 (可配置)                           |
-| **丰富内容 (JSX/Markdown/组件)**     | ✅ 直接支持                                                                        | ⚠️ 受限 / 仅插值                                             | ⚠️ ICU 语法，非真实 JSX                                                    | ⚠️ 受限                             | ❌ 不为丰富节点设计                                          | ⚠️ 受限                                                      | ⚠️ 受限 (通过 `<i18n-t>` 使用组件，Markdown 通过插件) |
-| **AI 驱动翻译**                      | ✅ 是，支持多个 AI 提供商。可使用你自己的 API 密钥。考虑应用程序的上下文和内容范围 | ❌ 否                                                        | ❌ 否                                                                      | ❌ 否                               | ❌ 否                                                        | ❌ 否                                                        | ❌ 否                                                 |
-| **视觉编辑器**                       | ✅ 是，本地视觉编辑器 + 可选 CMS；可以外部化代码库内容；可嵌入                     | ❌ 否 / 可通过外部本地化平台获取                             | ❌ 否 / 可通过外部本地化平台获取                                           | ❌ 否 / 可通过外部本地化平台获取    | ❌ 否 / 可通过外部本地化平台获取                             | ❌ 否 / 可通过外部本地化平台获取                             | ❌ 否 / 可通过外部本地化平台获取                      |
-| **本地化路由**                       | ✅ 是，开箱即用支持本地化路径 (适用于 Next.js 和 Vite)                             | ⚠️ 无内置，需要插件 (例如 `next-i18next`) 或自定义路由配置   | ❌ 否，仅消息格式化，路由必须手动处理                                      | ⚠️ 无内置，需要插件或手动配置       | ✅ 内置，App Router 支持 `[locale]` 分段                     | ✅ 内置                                                      | ✅ 内置                                               |
-| **动态路由生成**                     | ✅ 是                                                                              | ⚠️ 插件/生态系统或手动设置                                   | ❌ 不提供                                                                  | ⚠️ 插件/手动                        | ✅ 是                                                        | ✅ 是                                                        | ❌ 不提供 (Nuxt i18n 提供)                            |
-| **复数形式**                         | ✅ 基于枚举的模式                                                                  | ✅ 可配置 (插件如 i18next-icu)                               | ✅ (ICU)                                                                   | ✅ (ICU/messageformat)              | ✅ 良好                                                      | ✅ 良好                                                      | ✅ 内置复数规则                                       |
-| **格式化 (日期、数字、货币)**        | ✅ 优化的格式化程序 (底层为 Intl)                                                  | ⚠️ 通过插件或自定义 Intl 使用                                | ✅ ICU 格式化程序                                                          | ✅ ICU/CLI 辅助程序                 | ✅ 良好 (Intl 辅助程序)                                      | ✅ 良好 (Intl 辅助程序)                                      | ✅ 内置日期/数字格式化程序 (Intl)                     |
-| **内容格式**                         | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml 正在开发)                              | ⚠️ .json                                                     | ✅ .json, .js                                                              | ⚠️ .po, .json                       | ✅ .json, .js, .ts                                           | ⚠️ .json                                                     | ✅ .json, .js                                         |
-| **ICU 支持**                         | ⚠️ 正在开发                                                                        | ⚠️ 通过插件 (i18next-icu)                                    | ✅ 是                                                                      | ✅ 是                               | ✅ 是                                                        | ⚠️ 通过插件 (`i18next-icu`)                                  | ⚠️ 通过自定义格式化程序/编译器                        |
-| **SEO 辅助程序 (hreflang, sitemap)** | ✅ 内置工具：sitemap、robots.txt、元数据的辅助程序                                 | ⚠️ 社区插件/手动                                             | ❌ 非核心                                                                  | ❌ 非核心                           | ✅ 良好                                                      | ✅ 良好                                                      | ❌ 非核心 (Nuxt i18n 提供辅助程序)                    |
-| **生态系统 / 社区**                  | ⚠️ 较小但增长迅速且反应灵敏                                                        | ✅ 最大且成熟                                                | ✅ 大                                                                      | ⚠️ 较小                             | ✅ 中等规模，专注于 Next.js                                  | ✅ 中等规模，专注于 Next.js                                  | ✅ Vue 生态系统中的大规模                             |
-| **服务器端渲染和服务器组件**         | ✅ 是，针对 SSR / React 服务器组件进行了流程化                                     | ⚠️ 在页面级别支持，但需要在组件树上为子服务器组件传递 t 函数 | ⚠️ 在页面级别支持，需要额外设置，但需要在组件树上为子服务器组件传递 t 函数 | ✅ 支持，需要设置                   | ⚠️ 在页面级别支持，但需要在组件树上为子服务器组件传递 t 函数 | ⚠️ 在页面级别支持，但需要在组件树上为子服务器组件传递 t 函数 | ✅ 通过 Nuxt/Vue SSR (无 RSC) 提供 SSR                |
-| **Tree-shaking (仅加载使用的内容)**  | ✅ 是，构建时通过 Babel/SWC 插件按组件进行                                         | ⚠️ 通常全部加载 (可以通过命名空间/代码拆分进行改进)          | ⚠️ 通常全部加载                                                            | ❌ 非默认                           | ⚠️ 部分                                                      | ⚠️ 部分                                                      | ⚠️ 部分 (通过代码拆分/手动设置)                       |
-| **懒加载**                           | ✅ 是，按语言环境 / 按字典                                                         | ✅ 是 (例如，按需后端/命名空间)                              | ✅ 是 (拆分语言环境包)                                                     | ✅ 是 (动态目录导入)                | ✅ 是 (按路由/按语言环境)，需要命名空间管理                  | ✅ 是 (按路由/按语言环境)，需要命名空间管理                  | ✅ 是 (异步语言环境消息)                              |
-| **清除未使用的内容**                 | ✅ 是，构建时按字典进行                                                            | ❌ 否，仅通过手动命名空间细分                                | ❌ 否，所有声明的消息都被打包                                              | ✅ 是，在构建时检测并删除未使用的键 | ❌ 否，可以通过命名空间管理进行手动管理                      | ❌ 否，可以通过命名空间管理进行手动管理                      | ❌ 否，仅可通过手动懒加载实现                         |
-| **大型项目管理**                     | ✅ 鼓励模块化，适用于设计系统                                                      | ⚠️ 需要良好的文件纪律                                        | ⚠️ 中央目录可能会变得很大                                                  | ⚠️ 可能会变得复杂                   | ✅ 模块化及设置                                              | ✅ 模块化及设置                                              | ✅ 模块化及 Vue Router/Nuxt i18n 设置                 |
-
----
-
-## GitHub 星数
-
-GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
+| 功能                                          | `intlayer`                                                                       | `react-i18next`                                                | `react-intl` (FormatJS)                                                    | `lingui`                            | `next-intl`                                                    | `next-i18next`                                                 | `vue-i18n`                                        |
+| --------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------- |
+| **翻译就近组件**                              | ✅ 是，内容与每个组件协同定位                                                    | ❌ 否                                                          | ❌ 否                                                                      | ❌ 否                               | ❌ 否                                                          | ❌ 否                                                          | ✅ 是 - 使用 `Single File Components` (SFCs)      |
+| **TypeScript 集成**                           | ✅ 高级，自动生成严格类型                                                        | ⚠️ 基础；为确保安全需额外配置                                  | ✅ 良好，但不够严格                                                        | ⚠️ 类型定义，需要配置               | ✅ 良好                                                        | ⚠️ 基础                                                        | ✅ 良好（类型可用；键安全需要设置）               |
+| **缺失翻译检测**                              | ✅ TypeScript 错误高亮及构建时错误/警告                                          | ⚠️ 运行时多为回退字符串                                        | ⚠️ 回退字符串                                                              | ⚠️ 需要额外配置                     | ⚠️ 运行时回退                                                  | ⚠️ 运行时回退                                                  | ⚠️ 运行时回退/警告（可配置）                      |
+| **富内容 (JSX/Markdown/组件)**                | ✅ 直接支持                                                                      | ⚠️ 受限 / 仅插值                                               | ⚠️ ICU 语法，非真实 JSX                                                    | ⚠️ 受限                             | ❌ 非针对富节点设计                                            | ⚠️ 受限                                                        | ⚠️ 受限（组件通过 `<i18n-t>`，Markdown 通过插件） |
+| **AI 驱动翻译**                               | ✅ 是，支持多个 AI 提供商。可使用您自己的 API 密钥。考虑您的应用上下文和内容范围 | ❌ 否                                                          | ❌ 否                                                                      | ❌ 否                               | ❌ 否                                                          | ❌ 否                                                          | ❌ 否                                             |
+| **可视化编辑器**                              | ✅ 是，本地可视化编辑器 + 可选 CMS；能外置代码库内容；可嵌入                     | ❌ 否 / 只能通过外部定位平台获取                               | ❌ 否 / 只能通过外部定位平台获取                                           | ❌ 否 / 只能通过外部定位平台获取    | ❌ 否 / 只能通过外部定位平台获取                               | ❌ 否 / 只能通过外部定位平台获取                               | ❌ 否 / 只能通过外部定位平台获取                  |
+| **路由本地化**                                | ✅ 是，原生支持本地化路径（兼容 Next.js & Vite）                                 | ⚠️ 没内置，需要插件（例如 `next-i18next`）或自定义路由配置     | ❌ 否，只有消息格式化，路由需手动                                          | ⚠️ 没内置，需要插件或手动配置       | ✅ 内置，App Router 支持 `[locale]` 分段                       | ✅ 内置                                                        | ✅ 内置                                           |
+| **动态路由生成**                              | ✅ 是                                                                            | ⚠️ 插件/生态系统或手动设置                                     | ❌ 未提供                                                                  | ⚠️ 插件/手动                        | ✅ 是                                                          | ✅ 是                                                          | ❌ 未提供 (Nuxt i18n 提供)                        |
+| **复数形式**                                  | ✅ 基于枚举的模式                                                                | ✅ 可配置（像 i18next-icu 插件）                               | ✅ (ICU)                                                                   | ✅ (ICU/messageformat)              | ✅ 良好                                                        | ✅ 良好                                                        | ✅ 内置复数规则                                   |
+| **格式化 (日期、数字、货币)**                 | ✅ 优化格式化程序 (底层使用 Intl)                                                | ⚠️ 通过插件或自定义使用 Intl                                   | ✅ ICU 格式化程序                                                          | ✅ ICU/CLI 助手                     | ✅ 良好 (Intl 助手)                                            | ✅ 良好 (Intl 助手)                                            | ✅ 内置日期/数字格式化程序 (Intl)                 |
+| **内容格式**                                  | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml 研发中)                              | ⚠️ .json                                                       | ✅ .json, .js                                                              | ⚠️ .po, .json                       | ✅ .json, .js, .ts                                             | ⚠️ .json                                                       | ✅ .json, .js                                     |
+| **ICU 支持**                                  | ⚠️ 研发中                                                                        | ⚠️ 通过插件 (i18next-icu)                                      | ✅ 是                                                                      | ✅ 是                               | ✅ 是                                                          | ⚠️ 通过插件 (`i18next-icu`)                                    | ⚠️ 通过自定义格式化程序/编译器                    |
+| **SEO 助手 (hreflang, sitemap)**              | ✅ 内置工具：sitemap、robots.txt、metadata 助手                                  | ⚠️ 社区插件/手动                                               | ❌ 非核心功能                                                              | ❌ 非核心功能                       | ✅ 良好                                                        | ✅ 良好                                                        | ❌ 非核心功能 (Nuxt i18n 提供助手)                |
+| **生态系统 / 社区**                           | ⚠️ 较小但增长迅速且响应迅速                                                      | ✅ 最大且最成熟                                                | ✅ 大                                                                      | ⚠️ 较小                             | ✅ 中等规模，专注于 Next.js                                    | ✅ 中等规模，专注于 Next.js                                    | ✅ 在 Vue 生态系统中巨大                          |
+| **服务端渲染与服务端组件**                    | ✅ 是，为 SSR / React 服务器组件而优化                                           | ⚠️ 页面层级支持，但需要沿组件树传递 t 函数以供子服务端组件使用 | ⚠️ 页面层级在额外设置下支持，但需要沿组件树传递 t 函数以供子服务端组件使用 | ✅ 支持，需要配置                   | ⚠️ 页面层级支持，但需要沿组件树传递 t 函数以供子服务端组件使用 | ⚠️ 页面层级支持，但需要沿组件树传递 t 函数以供子服务端组件使用 | ✅ 通过 Nuxt/Vue SSR 实现 SSR (无 RSC)            |
+| **摇树优化 (Tree-shaking)（仅加载所用内容）** | ✅ 是，构建时通过 Babel/SWC 插件按组件进行                                       | ⚠️ 通常加载全部（可利用命名空间/代码分拆改善）                 | ⚠️ 通常加载全部                                                            | ❌ 非默认                           | ⚠️ 部分                                                        | ⚠️ 部分                                                        | ⚠️ 部分（使用代码分拆/手动配置）                  |
+| **延迟加载 (Lazy loading)**                   | ✅ 是，按语言 / 按字典                                                           | ✅ 是（例如，按需的服务端/命名空间）                           | ✅ 是（分拆语言包）                                                        | ✅ 是（动态目录导入）               | ✅ 是（按路由/按语言），需要命名空间管理                       | ✅ 是（按路由/按语言），需要命名空间管理                       | ✅ 是（异步语言消息）                             |
+| **清除未使用的内容**                          | ✅ 是，构建时按字典进行                                                          | ❌ 否，仅可通过手动命名空间分段完成                            | ❌ 否，打包了所有声明的消息                                                | ✅ 是，在构建时检测并丢弃未使用的键 | ❌ 否，可通过命名空间管理进行手动处理                          | ❌ 否，可通过命名空间管理进行手动处理                          | ❌ 否，仅可通过手动延迟加载实现                   |
+| **大型项目管理**                              | ✅ 鼓励模块化，适合设计系统                                                      | ⚠️ 需要良好的文件规范                                          | ⚠️ 中央目录可能会变得庞大                                                  | ⚠️ 可能会变得复杂                   | ✅ 配合配置实现模块化                                          | ✅ 配合配置实现模块化                                          | ✅ 配合 Vue Router/Nuxt i18n 配置实现模块化       |
+
+## GitHub Star 历史
+
+GitHub Star 数是衡量项目受欢迎程度、社区信任度以及长期相关性的一个强有力指标。虽然它们不是技术质量的直接度量标准，但它们反映了有多少开发者发现该项目有用，关注其进展并有可能采用它。对于评估项目的价值来说，Star 能够帮助对比替代方案之间的吸引力，并提供有关生态系统增长的见解。
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
@@ -230,6 +267,6 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 ## 互操作性
 
-`intlayer` 还可以帮助管理 `react-intl`、`react-i18next`、`next-intl`、`next-i18next` 和 `vue-i18n` 命名空间。
+`intlayer` 还可以帮助管理你的 `react-intl`、`react-i18next`、`next-intl`、`next-i18next` 以及 `vue-i18n` 命名空间。
 
-使用 `intlayer`，你可以按照你喜欢的 i18n 库格式声明内容，intlayer 将在你选择的位置生成命名空间（例如：`/messages/{{locale}}/{{namespace}}.json`）。
+使用 `intlayer`，你可以声明你喜欢的 i18n 库格式的内容，并且 intlayer 将在你想指定的路径下生成命名空间（例如：`/messages/{{locale}}/{{namespace}}.json`）。