@intlayer/docs 9.4.4 → 9.5.1

package/docs/zh/intlayer_with_vite+vue.md

@@ -46,37 +46,31 @@ author: aymericzip
 Intlayer 经过优化，可与 Vue 完美配合，提供**组件级内容范围**、**反应式翻译**以及​​扩展国际化 (i18n) 所需的所有功能。
 
 </Accordion>
-
 <Accordion header="捆绑尺寸">
 
 不要将大量 JSON 文件加载到页面中，而只需加载必要的内容。 Intlayer 有助于**将捆绑包和页面大小减少多达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 确定应用程序内容的范围**有利于大型应用程序的维护**。您可以复制或删除单个功能文件夹，而无需承担检查整个内容代码库的精神负担。此外，Intlayer 具有**完全类型化 (fully typed)**，以确保您的内容的准确性。
 
 </Accordion>
-
 <Accordion header="人工智能代理">
 
 共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 使用您选择的法学硕士，通过自动化在 CI/CD 管道中进行翻译，而费用由您的 AI 提供商承担。 Intlayer 还提供了一个**编译器**来自动提取内容，以及一个[网络平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)来帮助**在后台翻译**。
 
 </Accordion>
-
 <Accordion header="表现">
 
 将大量 JSON 文件连接到组件可能会导致性能和反应性问题。 Intlayer 可在构建时 (build time)优化您的内容加载。
 
 </Accordion>
-
 <Accordion header="无需开发即可扩展">
 
 Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)**和一个**[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** 来帮助您管理多语言内容**实时**，与译员、文案人员和其他团队成员无缝协作。内容可以本地和/或远程存储。
@@ -84,8 +78,6 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 </Accordion>
 </AccordionGroup>
 
----
-
 ## 在 Vite 和 Vue 应用中设置 Intlayer 的分步指南
 
 <Tabs defaultTab="video">
@@ -121,7 +113,6 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 请参阅 GitHub 上的[应用模板](https://github.com/aymericzip/intlayer-vite-vue-template)。
 
 <Steps>
-
 <Step number={1} title="安装依赖">
 
 使用 npm 安装所需的包：
@@ -177,9 +168,33 @@ bun add vite-intlayer --dev
   包含用于将 Intlayer 集成到 [Vite 打包工具](https://vite.dev/guide/why.html#why-bundle-for-production) 的 Vite 插件，以及用于检测用户首选语言环境、管理 Cookie 和处理 URL 重定向的中间件。
 
 </Step>
-
 <Step number={2} title="配置您的项目">
 
+### 架构
+
+在此架构中，`vue-intlayer` 提供安装在 `main.ts` 中的插件。Vue 组件使用 composables 在本地声明和消费翻译，Vite 热重载由 `vite-intlayer` 处理。
+
+```bash
+.
+├── src
+│   ├── app.content.ts
+│   ├── App.vue                       # Root component
+│   ├── components
+│   │   ├── helloWorld
+│   │   │   ├── helloWorld.content.ts
+│   │   │   └── HelloWorld.vue
+│   │   └── LocaleSwitcher.vue
+│   ├── main.ts                       # Entry point installing vue-intlayer plugin
+│   └── style.css
+├── index.html
+├── intlayer.config.ts
+├── package.json
+├── tsconfig.json
+└── vite.config.ts
+```
+
+### 配置
+
 创建一个配置文件来配置应用程序的语言：
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
@@ -203,7 +218,6 @@ export default config;
 > 通过此配置文件，您可以设置本地化的 URL、中间件重定向、cookie 名称、内容声明的位置和扩展名，禁用控制台中的 Intlayer 日志等。有关可用参数的完整列表，请参阅[配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
 </Step>
-
 <Step number={3} title="在您的 Vite 配置中集成 Intlayer">
 
 将 intlayer 插件添加到您的配置中。
@@ -222,7 +236,6 @@ export default defineConfig({
 > `intlayer()` Vite 插件用于将 Intlayer 集成到 Vite 中。它确保构建内容声明文件并在开发模式下监视这些文件。在 Vite 应用中定义了 Intlayer 环境变量。此外，它还提供别名以优化性能。
 
 </Step>
-
 <Step number={4} title="声明您的内容">
 
 创建并管理您的内容声明以存储翻译：
@@ -348,7 +361,6 @@ export default helloWorldContent;
 > 更多详情，请参阅[内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。
 
 </Step>
-
 <Step number={5} title="在代码中使用 Intlayer">
 
 要在整个 Vue 应用中使用 Intlayer 的国际化功能，首先需要在主文件中注册 Intlayer 单例实例。这一步非常关键，因为它为应用中的所有组件提供了国际化上下文，使得翻译内容可以在组件树中的任何位置访问。
@@ -449,7 +461,6 @@ Intlayer 提供了多种 API 来访问您的内容：
   - 或者使用 `const { myContent } = useIntlayer("myContent");` 并通过 `{{ myContent }}` / `<myContent/>` 解构访问内容。
 
 </Step>
-
 <Step number={6} title="更改内容语言">
 
 要更改内容的语言，可以使用 `useLocale` 组合函数提供的 `setLocale` 函数。该函数允许你设置应用的语言环境，并相应地更新内容。
@@ -518,7 +529,6 @@ const content = useIntlayer("app"); // 创建相关的 intlayer 声明文件
 ```
 
 </Step>
-
 <Step number={7} title="为您的应用添加本地化路由">
 
 在 Vue 应用中添加本地化路由通常涉及使用带有语言前缀的 Vue Router。这为每种语言创建唯一的路由，有助于 SEO 和 SEO 友好的 URL。
@@ -658,7 +668,6 @@ export default defineConfig({
 ```
 
 </Step>
-
 <Step number={8} title="当语言环境变化时更改 URL">
 
 为了在用户更改语言时自动更新 URL，您可以修改 `LocaleSwitcher` 组件以使用 Vue Router：
@@ -750,7 +759,6 @@ watch(
 ```
 
 </Step>
-
 <Step number={9} title="切换HTML的语言和方向属性">
 
 当您的应用支持多种语言时，更新`<html>`标签的`lang`和`dir`属性以匹配当前语言环境至关重要。这样做可以确保：
@@ -811,7 +819,6 @@ useI18nHTMLAttributes();
 ```
 
 </Step>
-
 <Step number={10} title="创建本地化链接组件">
 
 为了确保您的应用程序导航遵循当前的语言环境，您可以创建一个自定义的 `Link` 组件。该组件会自动在内部 URL 前添加当前语言的前缀。例如，当讲法语的用户点击“关于”页面的链接时，他们会被重定向到 `/fr/about`，而不是 `/about`。
@@ -912,7 +919,6 @@ import RouterLink from "@components/RouterLink.vue";
 ```
 
 </Step>
-
 <Step number={11} title="提取组件内容" isOptional={true}>
 
 如果您有现有的代码库，转换数千个文件可能会非常耗时。
@@ -1134,14 +1140,10 @@ Intlayer 使用模块扩展 (module augmentation) 来利用 TypeScript 的优势
 
 有关如何使用该扩展的更多详细信息，请参阅 [Intlayer VS Code 扩展文档](https://intlayer.org/zh/doc/vs-code-extension)。
 
----
-
 ### 深入了解
 
 要进一步使用，您可以实现[可视化编辑器](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)将内容外部化。
 
----
-
 ## 常见问题
 
 <FAQ>
@@ -1154,25 +1156,21 @@ Intlayer 使用模块扩展 (module augmentation) 来利用 TypeScript 的优势
 实际差异在于作用域与类型支持。`vue-i18n` 在运行时将键作为字符串进行解析，重命名的键会静默失效；而 Intlayer 会根据您的声明生成类型，并自动剔除未被组件使用的内容。请参阅 [为什么选择 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/interest_of_intlayer.md) 和 [Vue i18n 性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/vue.md)。
 
 </Question>
-
 <Question title="i18n 会给我的 Vue bundle 体积增加多少？">
 
 远少于基于命名空间的方案，因为页面永远不会下载它不渲染的语言目录。构建时编译器将 `useIntlayer` 调用替换为组件使用的确切字典条目，因此未使用的键和未使用的语言都会被自动丢弃，并且 [动态字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/index.md) 会按语言环境拆分剩余内容。与常规替代方案相比，Intlayer 可将 bundle 和页面体积减少高达 50%。请参阅 [Bundle 体积优化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/bundle_optimization.md) 和 [性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/vue.md)。
 
 </Question>
-
 <Question title="我可以从 vue-i18n 迁移而无需重写组件吗？">
 
 可以，有两条迁移路径。您可以使用 [vue-i18n 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_vue-i18n_to_intlayer.md) 逐步迁移内容。或者，您可以完全保留当前的 API：[兼容性适配器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/index.md) 公开与 `vue-i18n` 完全相同的 API，但底层由 Intlayer 字典驱动，因此只需更改导入语句，组件代码完全无需修改。
 
 </Question>
-
 <Question title="我可以保留现有的 JSON 翻译文件吗？">
 
 可以。[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将您的 `/messages/{locale}/{namespace}.json` 文件作为单一真实来源（source of truth），并双向生成 Intlayer 字典。[PO 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-po.md) 对 gettext 目录执行相同的操作，而 [按语言环境组织的文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/per_locale_file.md) 允许您按语言拆分内容，而不是将所有语言打包到一个文件中。
 
 </Question>
-
 <Question title="我必须逐个键迁移我的内容吗？">
 
 不需要。运行 `npx intlayer extract`，Intlayer 会读取您的组件，提取面向用户的字符串，并在每个组件旁边生成 `.content` 文件，这样您只需审查 diff，而无需手动逐一复制字符串到语言目录中。本指南的第 11 步详细介绍了此过程。
@@ -1182,7 +1180,6 @@ Intlayer 使用模块扩展 (module augmentation) 来利用 TypeScript 的优势
 开启编译器前有两个限制值得了解：它通过静态分析工作，因此仅在运行时存在的字符串（如 API 错误代码或 CMS 字段）无法被捕获；此外它需要区分用户文本和应用程序逻辑（如 `className="active"` 或状态代码），在大型代码库中需要少量注解。而 [extract 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md) 则通过让您参与审查避免了这两个问题。
 
 </Question>
-
 <Question title="有哪些可用的编辑器和 AI 代理工具？">
 
 共有 5 个工具，均为可选：
@@ -1194,43 +1191,36 @@ Intlayer 使用模块扩展 (module augmentation) 来利用 TypeScript 的优势
 - **[ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md)**：`no-raw-text` 规则标记硬编码字符串，并提供针对静态字典键和未使用内容的额外规则。
 
 </Question>
-
 <Question title="Intlayer 是否支持 Vue Composition API 和 script setup？">
 
 是的。`useIntlayer` 是一个标准的 Composable，可以像其他组合式函数一样在 `<script setup>` 中使用，返回的内容是响应式的，因此更改语言环境会重新渲染读取该内容的组件，而无需刷新页面。
 
 </Question>
-
 <Question title="如何在 Vue SPA 中设置支持语言环境的路由？">
 
 本指南的第 7 步和第 8 步介绍了 Vue Router 集成：在路由树中添加语言环境段，并使用 watcher 在语言环境变更时重写 URL。如果您不想在路径中包含语言环境，可将 `routing.mode` 设置为 `"no-prefix"` 或 `"search-params"`，此时将通过 Cookie 或查询参数进行解析。请参阅 [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
 </Question>
-
 <Question title="如何为从右到左 (RTL) 的语言设置 html lang 和 dir 属性？">
 
 第 9 步对此进行了介绍。`getHTMLTextDir` 会为阿拉伯语、希伯来语、波斯语和乌尔都语等语言返回 `rtl`，因此您可以根据当前活动的语言环境在根元素上绑定 `lang` 和 `dir`，让 CSS 逻辑属性处理布局反转。
 
 </Question>
-
 <Question title="如何使用 AI 自动翻译 Vue 应用？">
 
 运行 `npx intlayer fill`，它会使用您选择的 LLM、您自己的提供商和 API 密钥填充缺失的翻译。`--git-diff` 可将处理范围限制在当前分支修改的内容。请参阅 [fill 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) 和 [CI/CD 集成](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/CI_CD.md)。
 
 </Question>
-
 <Question title="Intlayer 是否支持复数、性别和富文本？">
 
 支持：包括 [复数形式](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/plurial.md)、[基于性别的内容](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/gender.md)、条件渲染、插值用的 [插入内容 (insertions)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/insertion.md)、用于长文本的 [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/markdown.md)，以及用于数字、日期和货币的 [格式化工具](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/formatters.md)。
 
 </Question>
-
 <Question title="翻译人员如何无需接触代码即可编辑内容？">
 
 可以通过自托管的 [可视化编辑器](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) 进行无需重新部署的内容外部化更新。
 
 </Question>
-
 <Question title="Intlayer 是免费且开源的吗？">
 
 是的，基于 Apache 2.0 许可证开源，包含商业用途。托管版 CMS 是可选的付费服务，同时完全支持 [自托管](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。

package/docs/zh/introduction.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-06
 title: 简介
 description: 了解 Intlayer 的工作原理。查看 Intlayer 在您的应用程序中使用的步骤。了解不同的包各自的功能。
 keywords:
@@ -98,31 +98,26 @@ export const MyComponent: FC = () => {
 您无需在页面中加载庞大的 JSON 文件，而是只加载所需的内容。Intlayer 可以帮助 **将您的捆绑包和页面大小减小多达 50%**。
 
 </Accordion>
-
 <Accordion header="可维护性">
 
 将您的应用程序内容局限在相应范围内，**有助于维护**大规模的应用程序。您可以复制或删除单个功能文件夹，而不会有审查整个内容代码库的心理负担。此外，Intlayer 是 **完全类型化 (fully typed)** 的，这能够确保您的内容的准确性。
 
 </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 代理的开发者体验 (DX) 变得更加顺畅。
 
 </Accordion>
-
 <Accordion header="自动化">
 
 使用您选择的 LLM 并在由您的 AI 提供商承担费用的情况下，通过自动化在您的 CI/CD 管道中进行翻译。Intlayer 还提供了一个 **编译器**，可自动提取内容；并配备了一个 [Web 平台](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md) 以帮助您 **在后台执行翻译**。
 
 </Accordion>
-
 <Accordion header="性能表现 (Performance)">
 
 将庞大的 JSON 文件连接到组件，可能会导致性能与响应式问题。Intlayer 会在构建时优化您的内容加载。
 
 </Accordion>
-
 <Accordion header="无需开发人员的规模化运作 (Scaling with non-dev)">
 
 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)**。借此，您可以 **实时** 管理多语言内容，并让译者、文案及其他团队成员之间的协作变得无缝。内容可以存储在本地和/或远程服务器上。
@@ -180,21 +175,45 @@ Intlayer 提供了多种功能，旨在满足现代 Web 开发的需求。以下
 - **[Intlayer 与 Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nextjs_15.md)**
 - **[Intlayer 与 Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nextjs_14.md)**
 - **[Intlayer 与 Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nextjs_page_router.md)**
-- **[Intlayer 与 React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_create_react_app.md)**
+- **[Intlayer 与 Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_tanstack.md)**
+- **[Intlayer 与 Tanstack Start + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_tanstack+solid.md)**
 - **[Intlayer 与 Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+react.md)**
 - **[Intlayer 与 React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_router_v7.md)**
-- **[Intlayer 与 Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_tanstack.md)**
+- **[Intlayer 与 React Router v7 (fs-routes)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_router_v7_fs_routes.md)**
+- **[Intlayer 与 React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_create_react_app.md)**
 - **[Intlayer 与 React Native 及 Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_native+expo.md)**
 - **[Intlayer 与 Lynx 及 React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_lynx+react.md)**
-- **[Intlayer 与 Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+preact.md)**
+- **[Intlayer 与 Astro](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro.md)**
+- **[Intlayer 与 Astro + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_react.md)**
+- **[Intlayer 与 Astro + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_vue.md)**
+- **[Intlayer 与 Astro + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_svelte.md)**
+- **[Intlayer 与 Astro + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_solid.md)**
+- **[Intlayer 与 Astro + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_preact.md)**
+- **[Intlayer 与 Astro + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_lit.md)**
+- **[Intlayer 与 Astro + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_astro_vanilla.md)**
 - **[Intlayer 与 Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+vue.md)**
 - **[Intlayer 与 Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nuxt.md)**
 - **[Intlayer 与 Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+svelte.md)**
 - **[Intlayer 与 SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_svelte_kit.md)**
+- **[Intlayer 与 Vite + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+solid.md)**
+- **[Intlayer 与 SolidStart](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_solid_start.md)**
+- **[Intlayer 与 Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+preact.md)**
+- **[Intlayer 与 Angular 22](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_angular_21.md)**
+- **[Intlayer 与 Angular 19](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_angular_19.md)**
+- **[Intlayer 与 Analog](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_analog.md)**
+- **[Intlayer 与 Vite + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+lit.md)**
+- **[Intlayer 与 Vite + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+vanilla.md)**
+- **[Intlayer 与 Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vanilla.md)**
+- **[Intlayer 与 htmx](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_htmx.md)**
 - **[Intlayer 与 Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_express.md)**
 - **[Intlayer 与 NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nestjs.md)**
+- **[Intlayer 与 Fastify](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_fastify.md)**
 - **[Intlayer 与 Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_hono.md)**
-- **[Intlayer 与 Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_angular_21.md)**
+- **[Intlayer 与 AdonisJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_adonisjs.md)**
+- **[Intlayer 与 Elysia](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_elysia.md)**
+- **[Intlayer 与 Storybook](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_storybook.md)**
+- **[Intlayer 与 next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_next-intl.md)**
+- **[Intlayer 与 next-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_next-i18next.md)**
 
 每篇集成指南都包含了使用 Intlayer 功能的最佳实践，例如 **服务端渲染**、**动态路由** 或 **客户端渲染**，以便您可以维护一个快速、SEO 友好且高度可扩展的应用程序。
 
@@ -213,25 +232,21 @@ Intlayer 提供了多种功能，旨在满足现代 Web 开发的需求。以下
 Intlayer 是面向 JavaScript 和 TypeScript 应用程序的国际化 (i18n) 库。您在每个组件旁边的 `.content.ts` 文件中声明组件的内容，Intlayer 在构建时将这些声明编译为全类型安全的字典，组件通过类似 `useIntlayer` 的 Hook 读取它们。它涵盖了翻译、复数规则、性别判断、Markdown、支持语言环境的路由、SEO 元数据、AI 辅助翻译以及面向非开发人员的可视化编辑器。
 
 </Question>
-
 <Question title="i18n 会给我的 bundle 体积增加多少？">
 
 远少于基于命名空间的方案，因为页面永远不会下载它不渲染的语言目录。服务端渲染的标记在服务端直接解析内容，而构建时编译器将 `useIntlayer` 调用替换为组件使用的确切字典条目，因此未使用的键和未使用的语言都会被自动丢弃。[动态字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/index.md) 会按语言环境拆分剩余内容。与常规替代方案相比，Intlayer 可将 bundle 和页面体积减少高达 50%。请参阅 [Bundle 体积优化](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/bundle_optimization.md) 和 [性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/index.md)。
 
 </Question>
-
 <Question title="我可以从 i18next、next-intl 或 react-i18next 迁移而无需重写组件吗？">
 
 可以，有两条迁移路径。您可以使用 [i18next 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_i18next_to_intlayer.md) 或 [next-intl 迁移指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/migration_from_next-intl_to_intlayer.md) 逐步迁移内容。或者，您可以完全保留当前的 API：[兼容性适配器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/index.md) 公开与 `i18next`、`react-i18next`、`next-intl`、`next-i18next`、`react-intl`、`use-intl`、`vue-i18n` 和 `Lingui` 完全相同的 API，但底层由 Intlayer 字典驱动，因此只需更改导入语句，组件代码无需修改。
 
 </Question>
-
 <Question title="我可以保留现有的 JSON 翻译文件吗？">
 
 可以。[JSON 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-json.md) 将您的 `/messages/{locale}/{namespace}.json` 文件作为单一真实来源（source of truth），并双向生成 Intlayer 字典。[PO 同步插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/plugins/sync-po.md) 对 gettext 目录执行相同的操作，而 [按语言环境组织的文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/per_locale_file.md) 允许您按语言拆分内容，而不是将所有语言打包到一个文件中。
 
 </Question>
-
 <Question title="我必须逐个键迁移我的内容吗？">
 
 不需要。运行 `npx intlayer extract`，Intlayer 会读取您的源码文件，提取面向用户的字符串，并在每个组件旁边生成 `.content` 文件，这样您只需审查 diff，而无需手动逐一复制字符串到语言目录中。请参阅 [extract 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)。
@@ -239,7 +254,6 @@ Intlayer 是面向 JavaScript 和 TypeScript 应用程序的国际化 (i18n) 库
 如需全自动流程，[Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) 可以在构建时对 JSX、TSX、Vue 和 Svelte 源码执行相同操作，在每次更改时自动生成字典，完全无需手动维护键名。它通过静态分析工作，因此仅在运行时存在的字符串无法被捕获，并且需要少量注解以区分用户文本和应用程序逻辑。
 
 </Question>
-
 <Question title="有哪些可用的编辑器和 AI 代理工具？">
 
 共有 5 个工具，均为可选：
@@ -251,7 +265,6 @@ Intlayer 是面向 JavaScript 和 TypeScript 应用程序的国际化 (i18n) 库
 - **[ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md)**：`no-raw-text` 规则标记硬编码字符串，并提供针对静态字典键和未使用内容的额外规则。
 
 </Question>
-
 <Question title="国际化 JavaScript 应用有哪些不同的解决方案？">
 
 该领域大致分为三代：
@@ -263,43 +276,36 @@ Intlayer 是面向 JavaScript 和 TypeScript 应用程序的国际化 (i18n) 库
 请参阅 [为什么选择 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/interest_of_intlayer.md) 了解详细对比，并参阅 [性能基准](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/benchmark/index.md) 了解测得的包体积和性能数据。
 
 </Question>
-
 <Question title="Intlayer 支持哪些框架？">
 
 React、Next.js、Vite、TanStack Start、React Router、Vue、Nuxt、Svelte、SvelteKit、Angular、Solid、Preact、Lit、支持各类孤岛框架的 Astro、包含 Expo 的 React Native、Lynx，以及在服务端的 Express、Fastify、NestJS、Hono、Elysia 和 AdonisJS。每个框架在 [环境指南](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/introduction.md) 下都有其专属文档。
 
 </Question>
-
 <Question title="为什么要在组件旁边声明内容而不是放在一个集中的 JSON 文件中？">
 
 有三个关键原因：页面仅分发其组件渲染的条目，而不是整个命名空间，从而显著缩减 bundle 体积；功能文件夹可以作为一个整体完整复制或删除，无需在共享目录中费力寻找孤立的残留键；最后，编辑组件的 LLM 或 AI 代理可以在同一个文件夹中看到对应的内容，这也是就近放置 (co-location) 能让 AI 辅助开发高度可靠的原因。请参阅 [Intlayer 工作原理](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/how_works_intlayer.md)。
 
 </Question>
-
 <Question title="如何使用 AI 自动翻译我的应用？">
 
 运行 `npx intlayer fill`。CLI 会检测缺失的翻译，并使用您选择的 LLM、您自己的提供商和 API 密钥进行填充，因此您可以直接向 AI 提供商结算费用。`--git-diff` 参数可将处理范围限制在当前分支修改的内容，从而在 CI 中保持极低的成本。请参阅 [fill 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md) 和 [CI/CD 集成](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/CI_CD.md)。
 
 </Question>
-
 <Question title="如何查找缺失的翻译？">
 
 运行 `npx intlayer test`。当声明的语言环境存在缺失内容时，它将直接报错退出，确保未翻译的字符串永远不会进入生产环境。[VS Code 扩展](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/vs_code_extension.md) 会在行内实时显示相同的错误，而 [ESLint 插件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/eslint.md) 会通过 `no-raw-text` 规则标记硬编码的明文字符串。请参阅 [测试您的内容](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/testing.md)。
 
 </Question>
-
 <Question title="我必须在 URL 中包含语言环境吗？">
 
 不需要。`routing.mode` 支持 `"prefix-no-default"`（默认值，例如 `/about` 和 `/zh/about`）、`"prefix-all"`、`"no-prefix"` 以及 `"search-params"`，而 `routing.domains` 可以将每个语言环境映射到其独立的域名。无论采用哪种方案，`getMultilingualUrls` 都会自动为您构建元数据和站点地图所需的 `hreflang` 备用链接。请参阅 [配置参考](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
 
 </Question>
-
 <Question title="翻译人员和内容编辑如何在不触及代码的情况下开展工作？">
 
 [可视化编辑器](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) 则将内容外部化，使其无需重新部署即可更新，并通过 [实时同步 (live sync)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/live.md) 在运行时应用最新更改。
 
 </Question>
-
 <Question title="Intlayer 是免费且开源的吗？">
 
 是的。Intlayer 在 Apache 2.0 许可证下开源，其核心库、CLI、编译器和可视化编辑器均可免费使用，包括商业项目。托管版 CMS 是一项可选的付费服务，同时完全支持 [自托管](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/self_hosting.md)。

package/docs/zh/live-sync.md

@@ -38,8 +38,6 @@ author: aymericzip
 
 <TOC/>
 
----
-
 ## 启用实时同步
 
 通过更新你的 Intlayer 配置来启用 Live Sync：

package/docs/zh/lsp.md

@@ -31,8 +31,6 @@ author: aymericzip
 
 **Intlayer 语言服务器**是 [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/) 的一个实现，它让你的 IDE —— 以及你的 AI 智能体 —— 理解 Intlayer。它把 `useIntlayer("home")` 这样的调用与声明它的 `.content.ts` 文件双向关联起来。
 
----
-
 ## 功能
 
 | 功能             | 快捷键              | 说明                                                              |
@@ -65,8 +63,6 @@ author: aymericzip
 
 > 字典读取自构建产物，因此请运行 `npx intlayer build`，或保持开发服务器运行，好让服务器有内容可解析。
 
----
-
 ## 安装
 
 服务器以 `@intlayer/lsp` 中的 `intlayer-lsp` 可执行文件形式发布：
@@ -89,8 +85,6 @@ bun add --dev @intlayer/lsp
 
 如果你的编辑器需要在 `PATH` 中找到 `intlayer-lsp`，请改为全局安装（`npm install -g @intlayer/lsp`）—— Claude Code 插件以及下文中直接调用该可执行文件的配置都属于这种情况。
 
----
-
 ## 配置
 
 <Tabs defaultTab="vscode">
@@ -255,16 +249,12 @@ language-servers = ["intlayer-lsp", "typescript-language-server"]
   </Tab>
 </Tabs>
 
----
-
 ## 关于终端 AI 智能体的说明
 
 **Claude Code** 是一个真正的 LSP 客户端 —— 参见上面的标签页。
 
 **OpenAI Codex** 及大多数其他终端工具并不是 LSP 客户端：它们直接读写文件。单独运行服务器对它们没有帮助；真正的价值在于服务器在一个配套编辑器中处于活跃状态，而智能体可以查询该编辑器的索引（Cursor Composer、Windsurf Cascade、Copilot Chat）。
 
----
-
 ## 工作原理
 
 对每个文件，服务器会定位最近的 `intlayer.config.*`，加载该项目的配置以找到已编译的字典。配置、字典和源文件列表会以较短的 TTL 缓存，并在被监听的内容文件发生变化时失效。
@@ -275,8 +265,6 @@ language-servers = ["intlayer-lsp", "typescript-language-server"]
 2. **位于字段使用处**（`content.title`、解构出的属性、`t('path.to.field')`、`<Trans>` 等）→ 将变量回溯到其字典，并返回内容文件中对应的字段。
 3. **从内容文件出发** → 执行反向查找，扫描项目源码以寻找该键或字段的调用点。
 
----
-
 ## 故障排查
 
 | 现象                                    | 可能原因           | 解决办法                                               |

package/docs/zh/mcp_server.md

@@ -76,8 +76,6 @@ MCP 服务器也可以通过 Streamable HTTP 传输方式远程使用。该服
 
 > 由于服务器托管成本，远程服务器的可用性无法保证。我们限制同时连接的数量。我们建议使用本地服务器（stdio）传输方式，以获得最可靠的体验。
 
----
-
 ## 通过 Intlayer CLI 设置（推荐）
 
 Intlayer 提供了一个 CLI 命令，用于在项目中自动配置 MCP 服务器。
@@ -104,8 +102,6 @@ bun x intlayer init mcp
 2. 询问您要使用的传输方法（本地服务器 (stdio) 或远程服务器 (Streamable HTTP)）。
 3. 自动更新您的配置文件（例如 `.cursor/mcp.json`、`.vscode/mcp.json` 或全局 Claude Desktop 配置）。
 
----
-
 ## Setup via Intlayer VS Code extension
 
 1. 打开命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P)。
@@ -114,8 +110,6 @@ bun x intlayer init mcp
 4. 选择要安装的 MCP (stdio, Streamable HTTP)
 5. 按 Enter 键。
 
----
-
 ## 手动配置
 
 <Tabs defaultTab="cursor">
@@ -283,8 +277,6 @@ claude mcp add intlayer https://mcp.intlayer.org -t http
   </Tab>
 </Tabs>
 
----
-
 ## 通过 CLI 使用 MCP Server
 
 您也可以直接从命令行运行 Intlayer MCP server，用于测试、调试或与其他工具集成。