@intlayer/docs 9.5.4 → 9.5.6

package/docs/zh/intlayer_with_vite+preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Preact i18n - 翻译你的应用的完整指南"
 description: "告别 i18next。2026 年构建多语言 (i18n) Vite + Preact 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
@@ -887,8 +887,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > 从 v9 起，`intlayerCompiler` 已包含在 `intlayer` 插件中。所以您不需要手动添加它。
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
 
 ```ts fileName="vite.config.ts"
@@ -903,6 +909,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+构建你的应用程序来转换你的组件并提取内容
+
 ```bash packageManager="npm"
 npm run build # 或 npm run dev
 ```
@@ -964,7 +975,9 @@ const pathList = [
 ];
 
 // 生成 sitemap.xml
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 // 获取所有多语言 URL
@@ -980,7 +993,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1161,6 +1174,13 @@ Vite 本身对 i18n 没有特定偏好，因此选择主要来自 Preact 生态
 
 可以通过自托管的 [可视化编辑器](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 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)对您的应用程序是 **零成本** 的。额外的逻辑仅在显式启用并在需要时才会加载。
+
+即使启用，其开销也极其轻量（仅在激活时动态加载 +5 kB），因为主要逻辑由 [app.intlayer.org](https://app.intlayer.org) 上的服务端编辑器或通过 `intlayer-editor` 软件包进行处理。如果您只需要一个无需可视化编辑的简单翻译方案，Intlayer 不会给您的应用带来任何额外负担。
+
 </Question>
 <Question title="Intlayer 是免费且开源的吗？">
 

package/docs/zh/intlayer_with_vite+react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + React i18n - 翻译你的应用的完整指南"
 description: "告别 i18next。2026 年构建多语言 (i18n) Vite + React 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
@@ -839,8 +839,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel 编译器'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
 
 ```ts fileName="vite.config.ts"
@@ -855,6 +861,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+构建你的应用程序来转换你的组件并提取内容
+
 ```bash packageManager="npm"
 npm run build # 或 npm run dev
 ```
@@ -911,7 +922,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -924,7 +937,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1080,6 +1093,13 @@ 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) 进行无需重新部署的内容外部化更新。
 
+</Question>
+<Question title="可视化编辑器的成本是多少？如果我不需要它，会不会显得多余？">
+
+如果未进行配置，Intlayer [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)对您的应用程序是 **零成本** 的。额外的逻辑仅在显式启用并在需要时才会加载。
+
+即使启用，其开销也极其轻量（仅在激活时动态加载 +5 kB），因为主要逻辑由 [app.intlayer.org](https://app.intlayer.org) 上的服务端编辑器或通过 `intlayer-editor` 软件包进行处理。如果您只需要一个无需可视化编辑的简单翻译方案，Intlayer 不会给您的应用带来任何额外负担。
+
 </Question>
 <Question title="Intlayer 是免费且开源的吗？">
 

package/docs/zh/intlayer_with_vite+solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Solid i18n - 翻译你的应用的完整指南"
 description: "告别 i18next。2026 年构建多语言 (i18n) Vite + Solid 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
@@ -680,8 +680,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > 自从 v9 以来，`intlayerCompiler` 已包含在 `intlayer` 插件中。因此您无需手动添加它。
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
 
 ```ts fileName="vite.config.ts"
@@ -696,6 +702,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+构建你的应用程序来转换你的组件并提取内容
+
 ```bash packageManager="npm"
 npm run build # 或 npm run dev
 ```
@@ -753,7 +764,9 @@ const pathList = [
 ];
 
 // 生成网站地图
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 // 获取所有多语言 URL
@@ -768,7 +781,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -918,6 +931,13 @@ Vite 本身对 i18n 没有特定偏好，因此选择主要来自 Solid 生态
 
 可以通过自托管的 [可视化编辑器](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 [可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)对您的应用程序是 **零成本** 的。额外的逻辑仅在显式启用并在需要时才会加载。
+
+即使启用，其开销也极其轻量（仅在激活时动态加载 +5 kB），因为主要逻辑由 [app.intlayer.org](https://app.intlayer.org) 上的服务端编辑器或通过 `intlayer-editor` 软件包进行处理。如果您只需要一个无需可视化编辑的简单翻译方案，Intlayer 不会给您的应用带来任何额外负担。
+
 </Question>
 <Question title="Intlayer 是免费且开源的吗？">
 

package/docs/zh/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Svelte i18n - 翻译你的应用的完整指南"
 description: "告别 i18next。2026 年构建多语言 (i18n) Vite + Svelte 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
@@ -597,8 +597,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel 编译器'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
 
 ```ts fileName="vite.config.ts"
@@ -613,6 +619,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+构建你的应用程序来转换你的组件并提取内容
+
 ```bash packageManager="npm"
 npm run build # 或 npm run dev
 ```
@@ -669,7 +680,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -682,7 +695,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/zh/intlayer_with_vite+vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vanilla JS i18n - 翻译你的应用的完整指南"
 description: "告别 i18next。2026 年构建多语言 (i18n) Vite + Vanilla JS 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
@@ -623,8 +623,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel compiler'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > 从 v9 开始，`intlayerCompiler` 包含在 `intlayer` 插件中。所以你不需要手动添加它。
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 更新你的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
 
 ```ts fileName="vite.config.ts"
@@ -639,6 +645,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+构建你的应用程序来转换你的组件并提取内容
+
 ```bash packageManager="npm"
 npm run build # 或 npm run dev
 ```
@@ -695,7 +706,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -708,7 +721,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/zh/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vue i18n - 翻译你的应用的完整指南"
 description: "告别 i18next。2026 年构建多语言 (i18n) Vite + Vue 应用的完整指南。使用 AI 代理翻译并优化包体积、SEO 和性能。"
 keywords:
@@ -982,8 +982,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel 编译器'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 更新您的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
 
 ```ts fileName="vite.config.ts"
@@ -998,6 +1004,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+构建你的应用程序来转换你的组件并提取内容
+
 ```bash packageManager="npm"
 npm run build # 或 npm run dev
 ```
@@ -1054,7 +1065,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -1067,7 +1080,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/zh/introduction.md

@@ -189,7 +189,6 @@ Intlayer 提供了多种功能，旨在满足现代 Web 开发的需求。以下
 - **[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)**

package/docs/zh/packages/astro-intlayer/exports.md

@@ -1,12 +1,12 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
-title: astro-intlayer 包文档
-description: 用于 Intlayer 的 Astro 集成，提供基于区域设置（locale）的路由和字典管理的配置。
+updatedAt: 2026-09-19
+title: astro-intlayer 软件包文档
+description: Intlayer 的 Astro 集成，提供基于语言环境的路由、中间件、钩子 (hooks)、客户端存储以及字典管理配置。
 keywords:
   - astro-intlayer
   - astro
-  - internationalization
+  - 国际化
   - i18n
 slugs:
   - doc
@@ -14,15 +14,18 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "添加 useIntlayer、useDictionary、useLocale 钩子、中间件和格式化工具文档"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "统一所有导出项的文档"
+    changes: "所有导出内容的统一文档"
 author: aymericzip
 ---
 
-# astro-intlayer 包
+# astro-intlayer 软件包
 
-`astro-intlayer` 包提供将 Intlayer 集成到 Astro 应用所需的工具。它配置基于区域设置（locale）的路由和字典管理。
+`astro-intlayer` 软件包提供了将 Intlayer 集成到 Astro 应用程序中所需的工具。它配置基于语言环境的路由、字典管理、构建时页面重写、请求中间件以及用于在服务器端渲染的 `.astro` 组件和客户端脚本中访问多语言内容的钩子。
 
 ## 安装
 
@@ -30,26 +33,175 @@ author: aymericzip
 npm install astro-intlayer
 ```
 
-## 导出
+## 导出项
 
 ### 集成
 
-astro-intlayer 包为你的项目提供一个用于在 Astro 中设置 Intlayer 的集成。
+`astro-intlayer` 软件包提供了一个 Astro 集成，用于在项目中配置 Intlayer。
 
 导入：
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-或将其添加到 `astro.config.mjs`：
+或在 `astro.config.mjs` 中使用默认导入：
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| 函数       | 说明                                      |
-| ---------- | ----------------------------------------- |
-| `intlayer` | 在你的项目中设置 Intlayer 的 Astro 集成。 |
+| 函数       | 描述                                                                                                                      | 相关文档                                                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Astro 集成，负责准备字典、配置 Vite 插件（别名、路由代理、剪裁）、自动注册请求中间件并在重写的本地化 URL 输出预渲染页面。 | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/intlayer.md) |
+
+### 钩子（服务端与客户端）
+
+导入：
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| 钩子            | 描述                                                                                                                                      | 相关文档                                                                                                                |
+| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | 根据键选择一个字典并返回其本地化内容。在 `.astro` frontmatter 中从 `Astro.locals` 读取请求语言环境，在 `<script>` 中从客户端 store 读取。 | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | 转换字典对象并返回解析后的语言环境对应的内容。在 frontmatter 和客户端脚本中均可使用。                                                     | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | 返回当前语言环境、默认语言环境、可用语言环境列表以及更新语言环境的函数。                                                                  | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/useLocale.md)         |
+
+### 中间件 (astro-intlayer/middleware)
+
+导入：
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| 导出项      | 类型                | 描述                                                                                                             | 相关文档                                                                                                        |
+| ----------- | ------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | 检测请求语言环境并附加 `Astro.locals.intlayer` 的 Astro 中间件。由 `intlayer()` 自动注册，或者手动导入进行组合。 | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/onRequest.md) |
+
+### 实用工具
+
+导入：
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| 函数                | 描述                                                                               | 相关文档 |
+| ------------------- | ---------------------------------------------------------------------------------- | -------- |
+| `getIntlayerLocals` | 辅助函数，用于在 `Astro.locals` 之外从请求存储范围检索当前 `IntlayerLocals` 对象。 | -        |
+
+### 客户端实用工具 (astro-intlayer/client)
+
+导入：
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+在浏览器或客户端 `<script>` 标签内导入时，`astro-intlayer` 会自动映射到 `astro-intlayer/client`（由 `vanilla-intlayer` 提供支持），提供客户端字典获取器、store 订阅者和语言环境持久化工具。
+
+### 格式化工具 (astro-intlayer/format)
+
+导入：
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| 钩子              | 描述                                                                       |
+| ----------------- | -------------------------------------------------------------------------- |
+| `useIntl`         | 返回绑定到请求或客户端语言环境的 Intl 实例，具备缓存和订阅功能。           |
+| `useDate`         | 返回预绑定到当前语言环境的日期格式化函数 (`Intl.DateTimeFormat`)。         |
+| `useNumber`       | 返回预绑定到当前语言环境的数字格式化函数 (`Intl.NumberFormat`)。           |
+| `useCurrency`     | 返回预绑定到当前语言环境的货币格式化函数。                                 |
+| `usePercentage`   | 返回预绑定到当前语言环境的百分比格式化函数。                               |
+| `useRelativeTime` | 返回预绑定到当前语言环境的相对时间格式化函数 (`Intl.RelativeTimeFormat`)。 |
+| `useList`         | 返回预绑定到当前语言环境的列表格式化函数 (`Intl.ListFormat`)。             |
+| `useUnit`         | 返回预绑定到当前语言环境的单位格式化函数。                                 |
+| `useCompact`      | 返回预绑定到当前语言环境的紧凑数字格式化函数（例如 `1.5K`）。              |
+
+### HTML 实用工具 (astro-intlayer/html)
+
+导入：
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| 导出项            | 类型       | 描述                                 |
+| ----------------- | ---------- | ------------------------------------ |
+| `renderHTML`      | `Function` | 用于渲染 HTML 节点的独立实用函数。   |
+| `useHTML`         | `Hook`     | 获取 HTML 提供者上下文和配置的钩子。 |
+| `useHTMLRenderer` | `Hook`     | 获取预配置的 HTML 渲染器函数的钩子。 |
+
+### Markdown 实用工具 (astro-intlayer/markdown)
+
+导入：
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| 导出项                | 类型       | 描述                                     |
+| --------------------- | ---------- | ---------------------------------------- |
+| `compileMarkdown`     | `Function` | 将 Markdown 字符串编译为结构化表示。     |
+| `renderMarkdown`      | `Function` | 将 Markdown 内容渲染为输出节点。         |
+| `parseMarkdown`       | `Function` | 将原始 Markdown 内容解析为 AST。         |
+| `useMarkdown`         | `Hook`     | 获取 Markdown 提供者上下文的钩子。       |
+| `useMarkdownRenderer` | `Hook`     | 获取预配置的 Markdown 渲染器函数的钩子。 |
+
+### 类型
+
+导入：
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| 类型              | 描述                                                                                          |
+| ----------------- | --------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | 附加到 `Astro.locals.intlayer` 的对象，包含 `locale`、`defaultLocale` 和 `availableLocales`。 |
+| `UseLocaleProps`  | `useLocale()` 接受的可选配置属性。                                                            |
+| `UseLocaleResult` | `useLocale()` 的返回类型，提供语言环境属性和更新方法。                                        |

package/docs/zh/packages/astro-intlayer/intlayer.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: intlayer 集成文档 | astro-intlayer
+description: 了解如何在 astro.config.mjs 中配置和使用 intlayer Astro 集成。
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - 集成
+  - i18n
+  - 国际化
+  - 文档
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "更新了包含中间件和钩子细节的集成文档"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "初始文档"
+author: aymericzip
+---
+
+# intlayer Astro 集成文档
+
+Astro 的 `intlayer` 集成为多语言国际化 (i18n) 配置您的项目。它处理构建时字典准备、Vite 插件注入、请求中间件自动注册以及在重写的本地化路径输出预渲染页面。
+
+## 使用方法
+
+将 `intlayer()` 添加到您的 `astro.config.mjs` 中：
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+Astro CLI 的 codemod（`astro add astro-intlayer`）也会生成一个支持的默认导入：
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## 说明
+
+该集成接入 Astro 的构建和运行时生命周期：
+
+1. **配置设置 (`astro:config:setup`)**：
+   - **字典准备**：在构建运行之前准备 Intlayer 字典和生成的类型。
+   - **Vite 插件**：注入 Vite 别名插件（实现无缝字典导入）、语言环境路由代理和构建剪裁。
+   - **中间件注册**：自动将 `astro-intlayer/middleware` 注入到项目的中间件链中，在每个传入请求上填充 `Astro.locals.intlayer`。
+2. **构建完成 (`astro:build:done`)**：
+   - **页面重写**：检查本地化 URL 重写规则，并在其对应的本地化路径输出预渲染的 HTML 页面。
+
+## 开箱即用功能
+
+配置完成后，您的 Astro 应用程序可以立即使用：
+
+- `.astro` 组件 frontmatter 中的 `useIntlayer`、`useDictionary` 和 `useLocale` 钩子。
+- Astro 端点和页面中的 `Astro.locals.intlayer` 对象。
+- `<script>` 块中的客户端导入，以响应式更新镜像相同的 API。
+- `astro-intlayer/format` 下的内置格式化程序（`useDate`、`useNumber`、`useCurrency` 等）。
+
+## 相关文档
+
+- [`useIntlayer` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/useIntlayer.md)
+- [`useLocale` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/useLocale.md)
+- [`onRequest` 中间件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/astro-intlayer/onRequest.md)