@intlayer/docs 9.5.6 → 9.5.8

package/docs/zh/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026 年 Next.js 最佳 i18n 解决方案 - 基准测试报告
 description: 对比 next-intl、next-i18next 和 Intlayer 等 Next.js 国际化 (i18n) 库。关于打包体积、泄漏和响应性的详细性能报告。
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "更新基准测试结果"
   - version: 9.5.1
     date: 2026-09-11
     changes: "更新基准测试结果"
@@ -112,19 +115,19 @@ Intlayer 尝试在这些维度上进行优化。
 在此基准测试中，我们对比了以下库：
 
 - `Base App`（无 i18n 库）
-- `next-intlayer` (v9.5.1)
-- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-intl.md) (v9.5.1)
-- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-i18next.md) (v9.5.1)
-- `next-i18next` (v16.3.0)
-- `next-intl` (v4.14.2)
-- `@lingui/core` (v6.6.0)
-- `next-translate` (v3.2.0)
-- `next-international` (v1.3.1)
-- `@inlang/paraglide-js` (v2.15.1)
-- `@tolgee/react` (v7.2.0)
-- `@lingo.dev/compiler` (v0.4.12)
-- `wuchale` (v0.26.6)
-- `gt-next` (v11.1.24)
+- [`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/next-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/next-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/next-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-i18next.md) (v9.5.6)
+- [`next-i18next`](https://github.com/i18next/next-i18next) (v16.3.0)
+- [`next-intl`](https://github.com/amannn/next-intl) (v4.14.2)
+- [`@lingui/core`](https://github.com/lingui/js-lingui) (v6.6.0)
+- [`next-translate`](https://github.com/aralroca/next-translate) (v3.2.0)
+- [`next-international`](https://github.com/QuiiBz/next-international) (v1.3.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.15.1)
+- [`@tolgee/react`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`@lingo.dev/compiler`](https://github.com/lingodotdev/lingo.dev) (v0.4.12)
+- [`wuchale`](https://github.com/wuchalejs/wuchale) (v0.26.6)
+- [`gt-next`](https://github.com/generaltranslation/gt) (v11.1.24)
 
 我使用了 `Next.js` 版本 `16.3.4` 以及 App Router。
 
@@ -213,7 +216,7 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 **(Tolgee)** (`@tolgee/react@7.2.0`):
 
-`Tolgee` 解决了前面提到的许多问题。我发现它比类似的工具更难采用。它不提供类型安全，这增加了在编译时捕捉缺失键的难度。我不得不使用自己的函数封装 Tolgee 的函数，以添加缺失键检测。
+`Tolgee` 解决了前面提到的许多问题。我发现它比类似的工具更难采用。它不提供类型安全，这增加了在编译时捕捉缺失键的难度。我不得不使用自己的函数封装 Tolgee 的函数，以添加缺失键检测。 该软件包也相对较重（~14.3kb，约为 `next-intlayer` 的 2.8 倍）。
 
 **(Next Intl)** (`next-intl@4.14.2`):
 
@@ -239,7 +242,7 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 如果你喜欢 `t()` 风格的 API，`next-translate` 是我的主要推荐方案。它通过 `next-translate-plugin` 优雅运作，利用 Webpack / Turbopack loader 通过 `getStaticProps` 加载命名空间。它也是这些方案中最轻量的之一（约 3.5kb）。对于命名空间拆分，在配置中为每个页面或路由定义命名空间的设计非常周到，比 **next-intl** 或 **next-i18next** 等主要替代方案更易于维护。在版本 `3.1.2` 中，我注意到静态渲染无法工作，Next.js 会回退到动态渲染。
 
-**(Intlayer)** (`next-intlayer@9.5.1`):
+**(Intlayer)** (`next-intlayer@9.5.6`):
 
 出于客观性考量，我不会亲自评价 `next-intlayer`，因为这是我自己的解决方案。
 

package/docs/zh/benchmark/solid.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026 年 Solid 最佳 i18n 解决方案 - 基准报告
-description: 比较 Solid 国际化（i18n）库，如 solid-primitives、solid-i18next 和 Intlayer。关于Bundle 大小、泄漏和反应性的详细性能报告。
+description: 比较 Solid 国际化（i18n）库，如 solid-primitives、solid-i18next、Tolgee 和 Intlayer。关于Bundle 大小、泄漏和反应性的详细性能报告。
 keywords:
   - benchmark
   - i18n
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "更新基准测试结果"
   - version: 9.5.1
     date: 2026-09-11
     changes: "更新基准测试结果"
@@ -64,9 +67,10 @@ history:
 
 ## TL;DR
 
-- **Intlayer**: 需要高级功能和优化的专业 Solid 应用的推荐选择（v9.5.0）。
+- **Intlayer**: 需要高级功能和优化的专业 Solid 应用的推荐选择（v9.5.6）。
 - **@solid-primitives/i18n**: 简单项目的绝佳轻量级替代方案，但缺乏延迟加载等高级功能。
 - **solid-i18next**: 标准但沉重的选项（约为 Intlayer 的 3.5 倍），具有与 React i18next 相同的缺点。
+- **Tolgee**: 功能丰富的翻译平台，但体积较重（约 12.7kb，约为 Intlayer 的 3.0 倍），缺乏原生 Solid 原语支持（依赖 @tolgee/web），且在静态配置下存在显著的页面间翻译泄露（90% 页面泄露）。
 - **Paraglide**: 创新的方法，但在某些设置中 DX 复杂且存在 tree-shaking 问题。
 
 ## 测试您的应用
@@ -99,10 +103,11 @@ history:
 在此基准测试中，我们比较了以下库：
 
 - `Base App`（无 i18n 库）
-- `solid-intlayer` (v9.5.0)
-- `@solid-primitives/i18n` (v2.2.1)
-- `i18next` (v26.0.8) + `@mbarzda/solid-i18next` (v1.4.1)
-- `@inlang/paraglide-js` (v2.25.1)
+- [`solid-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/solid-intlayer/exports.md) (v9.5.6)
+- [`@solid-primitives/i18n`](https://github.com/solidjs-community/solid-primitives/tree/main/packages/i18n) (v2.2.1)
+- [`i18next`](https://github.com/i18next/i18next) (v26.0.8) + [`@mbarzda/solid-i18next`](https://github.com/mbarzda/solid-i18next) (v1.4.1)
+- [`@tolgee/web`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 框架是 `Solid`，应用包含 **10 个页面** 和 **10 种语言**。
 
@@ -146,7 +151,7 @@ history:
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
 
-[![Star History Chart](https://api.star-history.com/chart?repos=solidjs-community%2Fsolid-primitives%2Cmbarzda%2Fsolid-i18next%2Copral%2Fparaglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#solidjs-community/solid-primitives&mbarzda/solid-i18next&opral/paraglide-js&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=solidjs-community%2Fsolid-primitives%2Cmbarzda%2Fsolid-i18next%2Copral%2Fparaglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#solidjs-community/solid-primitives&mbarzda/solid-i18next&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
 
 ## 结果详情
 
@@ -169,6 +174,18 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 Solid primitive 非常轻量且高效，我推荐将其用于轻量级项目，但对于包含 cookie 管理、代理重定向、格式化器等在内的专业解决方案，它可能会迅速显现功能不足。
 它还缺乏延迟加载和分层命名空间以进行页面大小优化。
 
+**(Tolgee)** (`@tolgee/web@7.2.0`):
+
+`Tolgee` 提供了功能完善的翻译管理平台，并具备上下文内编辑（in-context editing）功能。
+
+在 Solid 上，目前还没有官方的原生适配器（例如 `@tolgee/solid`），需要开发者通过 `@tolgee/web` 结合自定义信号进行集成。
+
+该包体积相对较重（约 12.7kb，约为 `solid-intlayer` 的 3.0 倍）。
+
+由于在 Solid 中缺乏细粒度的按页面命名空间拆分机制，在静态配置下所有翻译都会在启动时加载到内存中。这导致严重的包内容泄露（44.5% 语言泄露，90.0% 页面内容泄露），页面平均 JS 大小达到 ~91.8kb（相比之下 Intlayer 仅为 ~35.8kb）。
+
+语言切换响应极为迅速（0.6ms），契合 Solid 的细粒度响应式系统，不过注水（hydration）开销略高（~5.6ms 对比 Intlayer 的 ~3.0ms）。
+
 **(Paraglide)** (`@inlang/paraglide-js@2.25.1`):
 
 `Paraglide` 提供了一种创新且深思熟虑的方法。尽管如此，在此基准测试中，他们宣传的 tree-shaking 在我的实现中没有按预期工作。工作流程和 DX 也比其他选项更复杂。
@@ -177,7 +194,7 @@ Solid primitive 非常轻量且高效，我推荐将其用于轻量级项目，
 
 ### 3 - 建议
 
-**(Intlayer)** (`solid-intlayer@9.5.0`):
+**(Intlayer)** (`solid-intlayer@9.5.6`):
 
 出于客观性考虑，我个人不会对 `solid-intlayer` 做出评价，因为它是我的个人解决方案。
 

package/docs/zh/benchmark/svelte.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026 年 Svelte 最佳 i18n 解决方案 - 基准报告
-description: 比较 Svelte 国际化（i18n）库，如 svelte-i18n、Paraglide 和 Intlayer。关于Bundle 大小、泄漏和反应性的详细性能报告。
+description: 比较 Svelte 国际化（i18n）库，如 svelte-i18n、Paraglide、Tolgee 和 Intlayer。关于Bundle 大小、泄漏和反应性的详细性能报告。
 keywords:
   - benchmark
   - i18n
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "Update benchmark results"
   - version: 9.5.1
     date: 2026-09-11
     changes: "更新基准测试结果"
@@ -65,8 +68,9 @@ history:
 
 ## TL;DR
 
-- **Intlayer**: 性能最高效的选择（v9.5.0），占用空间最小。
+- **Intlayer**: 性能最高效的选择（v9.5.6），占用空间最小。
 - **Paraglide**: tree-shaking 的有力竞争者，但开发者体验更复杂，且有反应性开销。
+- **Tolgee**: 具备上下文内编辑功能的多功能翻译平台，但体积较重（约 13.0kb，约为 Intlayer 的 3.6 倍），且在静态配置下存在显著的页面间翻译泄露（90% 页面泄露）。
 - **svelte-i18n**: 功能完善且是 Svelte 的标准，但包重量大得多（约为 Intlayer 的 4.5 倍）。
 
 ## 测试您的应用
@@ -99,9 +103,10 @@ history:
 在此基准测试中，我们比较了以下库：
 
 - `Base App`（无 i18n 库）
-- `svelte-intlayer` (v9.5.0)
-- `svelte-i18n` (v4.0.1)
-- `@inlang/paraglide-js` (v2.25.1)
+- [`svelte-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/svelte-intlayer/exports.md) (v9.5.6)
+- [`svelte-i18n`](https://github.com/kaisermann/svelte-i18n) (v4.0.1)
+- [`@tolgee/svelte`](https://github.com/tolgee/tolgee-js) (v7.2.1)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.25.1)
 
 框架是 `Svelte`，应用包含 **10 个页面** 和 **10 种语言**。
 
@@ -145,7 +150,7 @@ history:
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
 
-[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2Fparaglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2Fparaglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
 
 ## 结果详情
 
@@ -165,6 +170,16 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 > 关于 paraglide 的说明：该解决方案在您的代码库中注入代码进行导入，因此基准报告中的“库大小”指标几乎为 0。代码生成是一件好事，因为使用的函数将仅包含必要的逻辑（全局前缀 vs 无前缀、cookie vs 存储等）。相比之下，Intlayer 在构建期间通过注入环境变量来进行过滤，以迫使打包器根据逻辑对内容进行 tree-shake。得益于此，paraglide 和 intlayer 最终比 i18next 或 next-intl 轻 6 到 10 倍。
 
+**(Tolgee)** (`@tolgee/svelte@7.2.1`):
+
+`Tolgee` 提供了集上下文内编辑（in-context editing）于一体的本地化平台，并通过 `@tolgee/svelte` 提供官方 Svelte 支持。
+
+该包体积相对较重（约 13.0kb，约为 `svelte-intlayer` 的 3.6 倍）。
+
+由于在 Svelte 中缺乏细粒度的按页面拆分机制，在静态配置下所有翻译都会在启动时直接加载到内存中。这导致严重的包内容泄露（50.0% 语言泄露，90.0% 页面内容泄露），页面平均 JS 大小达到 ~100.7kb（相比之下 Intlayer 仅为 ~59.0kb）。
+
+得益于 Svelte 的响应式 store，语言切换响应极为迅速（0.5ms），不过注水（hydration）开销略高（~6.2ms 对比 Intlayer 的 ~5.5ms）。
+
 **(svelte-i18n)** (`svelte-i18n@4.0.1`):
 
 此解决方案满足 Svelte 项目中 i18n 的所有需求。但正如 i18next 或其他主流 i18n 解决方案的情况一样，它有点重（~16.6kb，约为 `svelte-intlayer` 的 4.5 倍）。

package/docs/zh/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026 年 TanStack Start 最佳 i18n 解决方案 - 基准测试报告
 description: 对比 react-i18next、use-intl 和 Intlayer 等 TanStack Start 国际化库。关于打包体积、泄漏和响应性的详细性能报告。
 keywords:
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "更新基准测试结果"
   - version: 9.5.1
     date: 2026-09-11
     changes: "更新基准测试结果"
@@ -65,7 +68,7 @@ history:
 
 ## TL;DR
 
-- **Intlayer**: 为 TanStack Start 提供最佳性能和最小的打包体积 (v9.5.1)。
+- **Intlayer**: 为 TanStack Start 提供最佳性能和最小的打包体积 (v9.5.6)。
 - **react-i18next** & **use-intl**: 拥有庞大生态系统的成熟替代方案，但体积显著更大且优化更为复杂。
 - **Paraglide**: 创新的 Tree-shaking 理念，但在实际应用中并未生效。在 TanStack Start 中 DX 复杂且存在响应性开销。
 - **应当避免**: **General Translation (GT)** 和 **Lingo.dev**。由于严重的性能问题、AI 配额限制以及供应商锁定 (vendor lock-in)。
@@ -100,18 +103,19 @@ history:
 在此基准测试中，我们对比了以下库：
 
 - `Base App`（无 i18n 库）
-- `react-intlayer` (v9.5.1)
-- `@intlayer/use-intl` (v9.5.1)
-- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/lingui.md) (v9.5.1)
-- `react-i18next` (v17.0.13)
-- `use-intl` (v4.14.2)
-- `@lingui/core` (v6.6.0)
-- `@inlang/paraglide-js` (v2.15.1)
-- `@tolgee/react` (v7.2.0)
-- `react-intl` (v10.1.26)
-- `wuchale` (v0.26.6)
-- `gt-react` (v10.18.3)
-- `lingo.dev` (v0.138.7)
+- [`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/react-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/use-intl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/next-intl.md) (v9.5.6)
+- [`@intlayer/lingui`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/lingui.md) (v9.5.6)
+- [`@intlayer/react-i18next`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/react-i18next.md) (v9.5.6)
+- [`react-i18next`](https://github.com/i18next/react-i18next) (v17.0.13)
+- [`use-intl`](https://github.com/amannn/next-intl/tree/main/packages/use-intl) (v4.14.2)
+- [`@lingui/core`](https://github.com/lingui/js-lingui) (v6.6.0)
+- [`@inlang/paraglide-js`](https://github.com/opral/paraglide-js) (v2.15.1)
+- [`@tolgee/react`](https://github.com/tolgee/tolgee-js) (v7.2.0)
+- [`react-intl`](https://github.com/formatjs/formatjs) (v10.1.26)
+- [`wuchale`](https://github.com/wuchalejs/wuchale) (v0.26.6)
+- [`gt-react`](https://github.com/generaltranslation/gt) (v10.18.3)
+- [`lingo.dev`](https://github.com/lingodotdev/lingo.dev) (v0.138.7)
 
 框架使用 `TanStack Start`，构建了一个拥有 **10 个页面**和 **10 种语言**的多语言应用。
 
@@ -233,7 +237,7 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 在本次 TanStack Start 基准测试中，没有与 `next-translate`（Next.js 插件 + `getStaticProps`）直接对应的方案。对于那些确实想要 `t()` API 且拥有成熟生态的团队，`react-i18next` 和 `use-intl` 仍是“合理”的选择，但要做好投入大量时间进行优化以避免泄漏的准备。
 
-**(Intlayer)** (`react-intlayer@9.5.1`):
+**(Intlayer)** (`react-intlayer@9.5.6`):
 
 出于客观性考量，我不会亲自评价 `react-intlayer`，因为这是我自己的解决方案。
 

package/docs/zh/benchmark/vue.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-09-11
+updatedAt: 2026-09-23
 title: 2026 年 Vue 最佳 i18n 解决方案 - 基准报告
-description: 比较 Vue 国际化（i18n）库，如 vue-i18n、fluent-vue 和 Intlayer。关于Bundle 大小、泄漏和反应性的详细性能报告。
+description: 比较 Vue 国际化（i18n）库，如 vue-i18n、fluent-vue, Tolgee 和 Intlayer。关于Bundle 大小、泄漏和反应性的详细性能报告。
 keywords:
   - benchmark
   - i18n
@@ -17,6 +17,9 @@ slugs:
 author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 9.5.7
+    date: 2026-09-23
+    changes: "更新基准测试结果并添加 Tolgee"
   - version: 9.5.1
     date: 2026-09-11
     changes: "更新基准测试结果"
@@ -65,7 +68,8 @@ style="border:none;"
 
 ## TL;DR
 
-- **Intlayer**: 最轻量级的解决方案（v9.5.0），内置分层（scoping）和动态加载。
+- **Intlayer**: 最轻量级的解决方案（v9.5.6），内置分层（scoping）和动态加载。
+- **Tolgee**：在动态模式下具备零泄漏的有效动态加载，但体积较重（约 3.7 倍于 Intlayer），且缺乏编译时内置的类型安全。
 - **vue-i18n**: 具有丰富生态系统的行业标准，但在大型应用中可能会显著变重且难以进行代码拆分优化。
 - **fluent-vue**: 创新的消息组织方式，但缺乏类型安全且极其沉重。
 
@@ -99,10 +103,11 @@ style="border:none;"
 在此基准测试中，我们比较了以下库：
 
 - `Base App`（无 i18n 库）
-- `vue-intlayer` (v9.5.0)
-- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/vue-i18n.md) (v9.5.1)
-- `vue-i18n` (v11.4.0)
-- `fluent-vue` (v3.8.2)
+- [`vue-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vue-intlayer/exports.md) (v9.5.6)
+- [`@intlayer/vue-i18n`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compat/vue-i18n.md) (v9.5.6)
+- [`vue-i18n`](https://github.com/intlify/vue-i18n) (v11.4.0)
+- [`fluent-vue`](https://github.com/fluent-vue/fluent-vue) (v3.8.2)
+- [`@tolgee/vue`](https://github.com/tolgee/tolgee-js) (v7.2.0)
 
 框架是 `Vue`，应用包含 **10 个页面** 和 **10 种语言**。
 
@@ -146,7 +151,7 @@ style="border:none;"
 
 GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力指标。虽然星数不是技术质量的直接衡量标准，但它们反映了有多少开发人员发现该项目有用、关注其进展并可能采用它。在评估项目价值时，星数有助于比较不同方案的吸引力，并提供对生态系统增长的见解。
 
-[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&tolgee/tolgee-js&aymericzip/intlayer)
 
 ## 结果详情
 
@@ -156,18 +161,22 @@ GitHub 星数是项目受欢迎程度、社区信任和长期相关性的有力
 
 ### 2 - 可接受的解决方案
 
+**(Tolgee)** (`@tolgee/vue@7.2.0`):
+
+`Tolgee` 解决了前面提到的许多问题，提供了成功消除语言区域和页面泄漏的动态加载（将页面 JS 减少至约 58.8kb）。但是，它在默认情况下不提供键的编译时内置类型安全，这使得捕获缺失的键更加困难。此外，该库的体积相对较重（~13.8kb，约为 `vue-intlayer` 的 3.7 倍）。
+
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
 - **vue-i18n** 毫无疑问是 Vue 中最常用的 i18n 库，它具有大量功能和庞大的生态系统。但在底层，该解决方案相当沉重。即使 vue-i18n 集成了消息的懒加载，它也缺乏分层（scoping）功能。在经典的 Vue SPA 应用中没有问题，但对于使用 @nuxt/i18n 的 Nuxt 应用，它会导致所有页面的消息都包含在单个页面中。对于包含 10 个以上页面的大型 Nuxt 应用，这可能会变得非常成问题。
 
-该包非常重（~24.3kb，约为 `vue-intlayer` 的 6 倍）。
+该包非常重（~24.1 kb，约为 `vue-intlayer` 的 6.5倍）。
 
 **(fluent-vue)** (`fluent-vue@3.8.2`):
 
-- **fluent-vue** 通过 .ftl 格式提供了一种创新尝试。消息组织很棒，更容易上手。但在实践中，缺乏类型安全增加了错误风险，并且调试起来可能很快就会变得耗时。此外，该解决方案使用 vite 插件加载消息，强制将所有语言的所有内容加载到每个页面中。此外，这是一个极其沉重的解决方案（~29.7kb，约为 `vue-intlayer` 的 7.5 倍）。
+- **fluent-vue** 通过 .ftl 格式提供了一种创新尝试。消息组织很棒，更容易上手。但在实践中，缺乏类型安全增加了错误风险，并且调试起来可能很快就会变得耗时。此外，该解决方案使用 vite 插件加载消息，强制将所有语言的所有内容加载到每个页面中。此外，这是一个极其沉重的解决方案（~29.7kb，约为 `vue-intlayer` 的 8倍）。
 
 ### 3 - 建议
 
-**(Intlayer)** (`vue-intlayer@9.5.0`):
+**(Intlayer)** (`vue-intlayer@9.5.6`):
 
 出于客观性考虑，我个人不会对 `vue-intlayer` 做出评价，因为它是我的个人解决方案。

package/docs/zh/chrome_extension.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2026-09-22
+updatedAt: 2026-09-22
+title: Chrome 与 Firefox 扩展，i18n 与 SEO 扫描器
+description: 使用 Intlayer Chrome 扩展检查任何网站的 i18n 配置。检测框架、i18n 库、语言区域、hreflang 和 SEO 标签，并运行完整的 i18n SEO 审计。
+keywords:
+  - Chrome 扩展
+  - i18n 扫描器
+  - hreflang 检查器
+  - 多语言 SEO
+  - Intlayer
+  - 本地化
+  - 开发工具
+slugs:
+  - doc
+  - chrome-extension
+history:
+  - version: 9.5.6
+    date: 2026-09-22
+    changes: "初始化历史"
+author: aymericzip
+---
+
+# Chrome 与 Firefox 扩展：i18n 与 SEO 扫描器
+
+## 概述
+
+[**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc) 是 **Intlayer** 的官方 Chrome 扩展。在任何网站上打开它，即可查看该网站如何处理国际化：使用了哪个框架和 i18n 库，提供了哪些语言区域，以及多语言 SEO 标签是否配置正确。
+
+无论网站是否使用 Intlayer，它都能正常工作。
+
+![Intlayer Chrome 扩展](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension.png?raw=true)
+
+[Chrome 扩展链接](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)
+
+[Firefox 附加组件链接](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/)
+
+## 功能特性
+
+- **技术检测**：识别框架（Next.js、Nuxt、Astro、SvelteKit、Angular、Vue.js、Qwik、React、Gatsby、WordPress）和 i18n 库（Intlayer、i18next、Vue I18n、@nuxtjs/i18n、Angular @angular/localize、next-intl / next-i18next、Weglot、Localize、WPML、Polylang）。每次检测都会显示触发它的依据，例如全局变量、cookie 或 DOM 标记。
+- **语言区域**：列出在 `lang` 属性、hreflang 和 `og:locale` 标签、URL 语言前缀以及语言 cookie 或本地存储中发现的语言区域。
+- **SEO i18n 标签**：检查 `html lang`、`html dir`、规范链接（canonical）、hreflang 标签、`x-default`、`og:locale` 以及本地化内部链接的比例。
+- **跨语言环境导航**：根据 hreflang 标签，一键将当前页面切换到任一本地化版本。
+- **站点地图搜索**：搜索网站站点地图中列出的所有页面，并在当前标签页中打开。
+- **完整审计**：运行与 [i18n SEO Scanner](https://intlayer.org/i18n-seo-scanner) 相同的审计，并显示实时评分。
+
+## 安装
+
+<Tabs group="browser">
+  <Tab label="Chrome" value="chrome">
+
+从 Chrome 网上应用店安装 [**Intlayer i18n Scanner**](https://chromewebstore.google.com/detail/intlayer_i18n_scanner/pmlehcgmjmfimmjnembihbakhnheiabc)，然后将其固定到工具栏。
+
+该扩展适用于 Chrome 以及任何支持 Chrome 网上应用店扩展的 Chromium 内核浏览器（Edge、Brave、Arc、Opera）。
+
+  </Tab>
+  <Tab label="Firefox" value="firefox">
+
+从 Firefox 附加组件商店安装 [**Intlayer i18n Scanner**](https://addons.mozilla.org/en-US/firefox/addon/intlayer-i18n-scanner/)，然后将其固定到工具栏。
+
+  </Tab>
+</Tabs>
+
+## 使用方法
+
+### 检查页面
+
+1. 打开您想要检查的网站。
+2. 点击工具栏中的 **Intlayer i18n Scanner** 图标。
+3. 弹出窗口将显示当前页面的 **检测到的技术**、**语言区域** 和 **SEO i18n 标签** 部分。
+
+检测完全在您的浏览器本地运行，仅针对当前标签页。
+
+### 在语言环境之间切换
+
+![Intlayer Chrome 扩展导航](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_navigation.png?raw=true)
+
+**导航** 部分列出当前页面的 **本地化版本**，数据来自其 hreflang 标签。点击某个语言环境，即可在当前标签页中打开该版本。
+
+在 **站点地图页面** 中，输入关键词搜索网站站点地图中的 URL，然后点击结果即可打开。
+
+### 运行完整审计
+
+![Intlayer Chrome 扩展审计评分](https://github.com/aymericzip/intlayer/blob/main/docs/assets/chrome_extension_audit_score.png?raw=true)
+
+滚动到 **完整审计** 部分，然后点击 **运行完整 i18n 审计**。随着每项检查的完成，结果将实时显示，分为以下几组：
+
+- **页面**：`html lang` 和 `dir` 属性、当前语言区域、hreflang 标签、`x-default`、规范链接、本地化内部链接、语言选择器、国旗图标以及 JavaScript bundle 中未使用的语言内容。
+- **Robots.txt**：是否存在，以及语言路径是否保持可抓取。
+- **站点地图（Sitemap）**：是否存在、列出的所有语言区域、备用链接和 `x-default`。
+- **域名**：在整个网站中发现的语言区域数量。
+
+每项检查都会标记为通过、警告或未通过，综合评分总结了页面的整体 i18n SEO 健康状况。
+
+## 隐私与权限
+
+该扩展仅申请最少权限：
+
+- **activeTab** 和 **scripting**：检测器仅在您正在查看的标签页上运行，且仅在您打开弹出窗口时运行。
+- **back.intlayer.org**：仅在您运行完整审计时使用。当前页面的 URL 会发送到 Intlayer API 进行扫描。
+
+不会收集任何浏览历史记录，后台也不会运行任何程序。
+
+## 常见问题
+
+<FAQ>
+
+<Question title="网站需要使用 Intlayer 吗？">
+
+不需要。无论网站使用何种框架或 i18n 库，该扩展都可以检查任何网站。
+
+</Question>
+<Question title="为什么有些技术没有被检测到？">
+
+检测依赖于页面在浏览器中公开的信息：全局变量、cookie、meta 标签和 DOM 标记。某些生产构建会移除这些标记，因此库可能在使用中但未留下可见痕迹。
+
+</Question>
+<Question title="如何修复审计发现的问题？">
+
+大多数检查都对应路由或元数据设置。使用 Intlayer 时，hreflang、规范链接、`x-default`、本地化链接、站点地图和 robots.txt 均可从您的[配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)自动生成。请参阅适用于您框架的集成指南，例如 [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nextjs_16.md)、[Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_nuxt.md) 或 [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_tanstack.md)。
+
+</Question>
+
+</FAQ>
+
+## 相关工具
+
+- [VS Code 扩展](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/vs_code_extension.md)
+- [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)
+- [LSP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/lsp.md)

package/docs/zh/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-12
+updatedAt: 2026-09-23
 title: CLI - 适用于多语言网站的所有 Intlayer CLI 命令
 description: 了解如何使用 Intlayer CLI 管理您的多语言网站。按照此在线文档中的步骤，在几分钟内设置您的项目。
 keywords:
@@ -17,6 +17,12 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "添加 upgrade 命令"
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "添加 init infra 命令"
   - version: 9.5.2
     date: 2026-09-12
     changes: "用 `--ci` 标志替换 `ci` 命令"
@@ -151,6 +157,8 @@ Intlayer 接受多种配置文件格式：
 ### 配置
 
 - **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/init.md)** - 使用自动配置在您的项目中设置 Intlayer
+- **[配置基础设施](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/infra.md)** - 安装桌面应用或使用 Docker（多合一或 Compose）自行托管 CMS
+- **[升级 Intlayer 软件包](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/upgrade.md)** - 列出每个 `package.json` 中的 Intlayer 软件包并将其升级到最新版本
 - **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/configuration.md)** - 获取您的 Intlayer 配置并将其发送到 CMS
 
 ### 文档管理
@@ -177,6 +185,8 @@ Intlayer 接受多种配置文件格式：
 ```json fileName="package.json"
 "scripts": {
   "intlayer:init": "npx intlayer init",
+  "intlayer:infra": "npx intlayer init infra",
+  "intlayer:upgrade": "npx intlayer upgrade",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",