@intlayer/docs 9.1.3 → 9.2.0

package/docs/zh/intlayer_with_vite+vanilla.md

@@ -93,9 +93,306 @@ Intlayer 不仅仅是一个 i18n 解决方案，还提供了一个**自托管的
 
 ---
 
-### (可选) 第 8 步：渲染 Markdown 和 HTML 内容
+## 在 Vite 和 Vanilla JS 应用中设置 Intlayer 的分步指南
 
-Intlayer 支持 `md()` 和 `html()` 内容声明。在纯 JS 中，编译后的输出通过 `innerHTML` 作为原始 HTML 插入。
+<Steps>
+
+<Step number={1} title="安装依赖">
+
+使用 npm 安装必要的包：
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> `--interactive` 标志是可选的。如果你是 AI 代理，请使用 `intlayer-cli init`。
+
+> 此命令将检测你的环境并安装所需的包。例如：
+
+```bash packageManager="npm"
+npm install intlayer vanilla-intlayer
+npm install vite-intlayer --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer vanilla-intlayer
+pnpm add vite-intlayer --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer vanilla-intlayer
+yarn add vite-intlayer --save-dev
+```
+
+```bash packageManager="bun"
+bun add intlayer vanilla-intlayer
+bun add vite-intlayer --dev
+```
+
+- **intlayer**
+  核心包，提供国际化工具，用于配置管理、翻译、[内容声明](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)、代码转换和 [CLI 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/index.md)。
+
+- **vanilla-intlayer**
+  将 Intlayer 与纯 JavaScript / TypeScript 应用集成的包。它提供一个 pub/sub 单例 (`IntlayerClient`) 和基于回调的辅助函数 (`useIntlayer`、`useLocale` 等)，使你的应用的任何部分都可以对语言环境变化做出反应，而无需依赖 UI 框架。
+
+- **vite-intlayer**
+  包含用于将 Intlayer 与 [Vite bundler](https://vite.dev/guide/why.html#why-bundle-for-production) 集成的 Vite 插件，以及用于检测用户首选语言环境、管理 cookie 和处理 URL 重定向的中间件。
+
+</Step>
+
+<Step number={2} title="项目配置">
+
+创建一个配置文件以配置应用的语言：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      // 你的其他语言环境
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+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 插件添加到你的配置中。
+
+```typescript fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+> `intlayer()` Vite 插件用于将 Intlayer 与 Vite 集成。它确保内容声明文件的构建，并在开发模式下监视它们。它在 Vite 应用中定义 Intlayer 环境变量。此外，它提供别名以优化性能。
+
+</Step>
+
+<Step number={4} title="在你的入口点引导 Intlayer">
+
+在渲染任何内容**之前**调用 `installIntlayer()`，以便全局语言环境单例已准备好。
+
+```typescript fileName="src/main.ts" codeFormat="typescript"
+import { installIntlayer } from "vanilla-intlayer";
+
+// 必须在渲染任何 i18n 内容之前调用。
+installIntlayer();
+
+// 导入并运行你的应用模块。
+import "./app.js";
+```
+
+如果你还使用 `md()` 内容声明（Markdown），请也安装 markdown 渲染器：
+
+```typescript fileName="src/main.ts" codeFormat="typescript"
+import { installIntlayer, installIntlayerMarkdown } from "vanilla-intlayer";
+
+installIntlayer();
+installIntlayerMarkdown();
+
+import "./app.js";
+```
+
+</Step>
+
+<Step number={5} title="声明你的内容">
+
+创建并管理内容声明以存储翻译：
+
+```typescript fileName="src/app.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { insert, t, type Dictionary } from "intlayer";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: "Vite + Vanilla",
+
+    viteLogoLabel: t({
+      zh: "Vite 标志",
+      en: "Vite Logo",
+      fr: "Logo Vite",
+      es: "Logo Vite",
+    }),
+
+    count: insert(
+      t({
+        zh: "计数是 {{count}}",
+        en: "count is {{count}}",
+        fr: "le compte est {{count}}",
+        es: "el recuento es {{count}}",
+      })
+    ),
+
+    readTheDocs: t({
+      zh: "点击 Vite 标志以了解更多信息",
+      en: "Click on the Vite logo to learn more",
+      fr: "Cliquez sur le logo Vite pour en savoir plus",
+      es: "Haga clic en el logotipo de Vite para obtener más información",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```json fileName="src/app.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "app",
+  "content": {
+    "title": "Vite + Vanilla",
+    "viteLogoLabel": {
+      "nodeType": "translation",
+      "translation": {
+        "zh": "Vite 标志",
+        "en": "Vite Logo",
+        "fr": "Logo Vite",
+        "es": "Logo Vite"
+      }
+    },
+    "count": {
+      "nodeType": "insertion",
+      "insertion": {
+        "nodeType": "translation",
+        "translation": {
+          "zh": "计数是 {{count}}",
+          "en": "count is {{count}}",
+          "fr": "le compte est {{count}}",
+          "es": "el recuento es {{count}}"
+        }
+      }
+    },
+    "readTheDocs": {
+      "nodeType": "translation",
+      "translation": {
+        "zh": "点击 Vite 标志以了解更多信息",
+        "en": "Click on the Vite logo to learn more",
+        "fr": "Cliquez sur le logo Vite pour en savoir plus",
+        "es": "Haga clic en el logotipo de Vite para obtener más información"
+      }
+    }
+  }
+}
+```
+
+> 你的内容声明可以在应用的任何地方定义，只要它们包含在 `contentDir` 目录中（默认情况下为 `./src`）。并匹配内容声明文件扩展名（默认为 `.content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}`）。
+>
+> 有关更多详细信息，请参考 [内容声明文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)。
+
+</Step>
+
+<Step number={6} title="在你的 JavaScript 中使用 Intlayer">
+
+`vanilla-intlayer` 镜像了 `react-intlayer` 的表面 API：`useIntlayer(key, locale?)` 直接返回翻译的内容。在结果上链接 `.onChange()` 以订阅语言环境变化 - 这是 React 重新渲染的显式等效物。
+
+```typescript fileName="src/main.ts" codeFormat="typescript"
+import { installIntlayer, useIntlayer } from "vanilla-intlayer";
+
+installIntlayer();
+
+// 获取当前语言环境的初始内容。
+// 链接 .onChange() 以在语言环境每次变化时收到通知。
+const content = useIntlayer("app").onChange((newContent) => {
+  // 重新渲染或仅修补受影响的 DOM 节点
+  document.querySelector<HTMLHeadingElement>("h1")!.textContent = String(
+    newContent.title
+  );
+  document.querySelector<HTMLParagraphElement>(".read-the-docs")!.textContent =
+    String(newContent.readTheDocs);
+});
+
+// 初始渲染
+document.querySelector<HTMLHeadingElement>("h1")!.textContent = String(
+  content.title
+);
+document.querySelector<HTMLParagraphElement>(".read-the-docs")!.textContent =
+  String(content.readTheDocs);
+```
+
+> 通过在 `String()` 中包装叶值来将其作为字符串访问，这调用节点的 `toString()` 方法并返回翻译的文本。
+>
+> 当你需要用于原生 HTML 属性的值时（例如 `alt`、`aria-label`），直接使用 `.value`：
+>
+> ```typescript
+> img.alt = content.viteLogoLabel.value;
+> ```
+
+</Step>
+
+<Step number={7} title="更改你的内容的语言" isOptional={true}>
+
+要更改你的内容的语言，请使用 `useLocale` 公开的 `setLocale` 函数。
+
+```typescript fileName="src/locale-switcher.ts" codeFormat="typescript"
+import { getLocaleName } from "intlayer";
+import { useLocale } from "vanilla-intlayer";
+
+export function setupLocaleSwitcher(container: HTMLElement): () => void {
+  const { locale, availableLocales, setLocale, subscribe } = useLocale();
+
+  const select = document.createElement("select");
+  select.setAttribute("aria-label", "Language");
+
+  const render = (currentLocale: string) => {
+    select.innerHTML = availableLocales
+      .map(
+        (loc) =>
+          `<option value="${loc}"${loc === currentLocale ? " selected" : ""}>
+            ${getLocaleName(loc)}
+          </option>`
+      )
+      .join("");
+  };
+
+  render(locale);
+  container.appendChild(select);
+
+  select.addEventListener("change", () => setLocale(select.value as any));
+
+  // 保持下拉菜单与其他地方的语言环境变化同步
+  return subscribe((newLocale) => render(newLocale));
+}
+```
+
+</Step>
+
+<Step number={8} title="渲染 Markdown 和 HTML 内容" isOptional={true}>
+
+Intlayer 支持 `md()` 和 `html()` 内容声明。在 vanilla JS 中，编译的输出通过 `innerHTML` 作为原始 HTML 插入。
 
 ```typescript fileName="src/app.content.ts" contentDeclarationFormat=["typescript", "esm", "cjs"]
 import { md, t, type Dictionary } from "intlayer";
@@ -106,6 +403,7 @@ const appContent = {
     // ...
     editNote: md(
       t({
+        zh: "编辑 `src/main.ts` 并保存以测试 **HMR**",
         en: "Edit `src/main.ts` and save to test **HMR**",
         fr: "Modifiez `src/main.ts` et enregistrez pour tester **HMR**",
         es: "Edite `src/main.ts` y guarde para probar **HMR**",
@@ -138,10 +436,10 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 ```
 
 > [!TIP]
-> `String(content.editNote)` 在 `IntlayerNode` 上调用 `toString()`，该方法返回原始 Markdown 字符串。将其传递给 `compileMarkdown` 以获取 HTML 字符串，然后通过 `innerHTML` 设置它。
+> `String(content.editNote)` 调用 `IntlayerNode` 上的 `toString()`，它返回原始 Markdown 字符串。将其传递给 `compileMarkdown` 以获取 HTML 字符串，然后通过 `innerHTML` 设置它。
 
 > [!WARNING]
-> 仅对受信任的内容使用 `innerHTML`。如果 Markdown 来自用户输入，请先对其进行消毒（例如使用 DOMPurify）。您可以动态安装消毒渲染器：
+> 仅对受信任的内容使用 `innerHTML`。如果 markdown 来自用户输入，请先进行清理（例如使用 DOMPurify）。你可以动态安装清理渲染器：
 >
 > ```typescript
 > import { installIntlayerMarkdownDynamic } from "vanilla-intlayer";
@@ -152,6 +450,201 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 > });
 > ```
 
+</Step>
+
+<Step number={9} title="向你的应用添加本地化路由" isOptional={true}>
+
+要为每种语言创建唯一的路由（对 SEO 有用），你可以在 Vite 配置中使用 `intlayerProxy` 进行服务器端语言环境检测。
+
+首先，将 `intlayerProxy` 添加到你的 Vite 配置：
+
+> 请注意，要在生产中使用 `intlayerProxy`，你需要将 `vite-intlayer` 从 `devDependencies` 移到 `dependencies`。
+
+> 从 Intlayer v9 开始，`intlayerProxy()` 直接捆绑到 `intlayer()` 插件中，并通过 `routing.enableProxy` 选项默认启用（默认为 `true`）。单独注册如下所示现在是可选的 — 为了向后兼容和需要控制插件顺序的设置而保留。设置 `routing.enableProxy: false` 以选择退出。有关更多信息，请参见 [v9 发布说明](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/releases/v9.md)。
+
+```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+</Step>
+
+<Step number={10} title="当语言环境更改时更改 URL" isOptional={true}>
+
+要在语言环境更改时更新浏览器 URL，请在安装 Intlayer 后调用 `useRewriteURL()`：
+
+```typescript fileName="src/main.ts" codeFormat="typescript"
+import { installIntlayer, useRewriteURL } from "vanilla-intlayer";
+
+installIntlayer();
+
+// 立即重写 URL，并在随后的每次语言环境更改时重写。
+// 返回一个用于清理的取消订阅函数。
+const stopRewriteURL = useRewriteURL();
+```
+
+</Step>
+
+<Step number={11} title="切换 HTML 语言和方向属性" isOptional={true}>
+
+更新 `<html>` 标签的 `lang` 和 `dir` 属性以匹配当前语言环境，以实现可访问性和 SEO。
+
+```typescript fileName="src/main.ts" codeFormat="typescript"
+import { getHTMLTextDir } from "intlayer";
+import { installIntlayer, useLocale } from "vanilla-intlayer";
+
+installIntlayer();
+
+useLocale({
+  onLocaleChange: (locale) => {
+    document.documentElement.lang = locale;
+    document.documentElement.dir = getHTMLTextDir(locale);
+  },
+});
+```
+
+</Step>
+
+<Step number={12} title="按语言环境延迟加载字典" isOptional={true}>
+
+对于大型应用，你可能希望将每个语言环境的字典拆分为其自己的块。使用 `useDictionaryDynamic` 以及 Vite 的动态 `import()`：
+
+```typescript fileName="src/app.ts" codeFormat="typescript"
+import { installIntlayer, useDictionaryDynamic } from "vanilla-intlayer";
+
+installIntlayer();
+
+const unsubscribe = useDictionaryDynamic(
+  {
+    en: () => import("../.intlayer/dictionaries/en/app.mjs"),
+    fr: () => import("../.intlayer/dictionaries/fr/app.mjs"),
+    es: () => import("../.intlayer/dictionaries/es/app.mjs"),
+  },
+  "app"
+).onChange((content) => {
+  document.querySelector("h1")!.textContent = String(content.title);
+});
+```
+
+> 每个语言环境的包仅在该语言环境变为活跃时才被获取，结果被缓存 - 随后对同一语言环境的切换是即时的。
+
+</Step>
+
+<Step number={13} title="提取你的组件的内容" isOptional={true}>
+
+如果你有现有的 codebase，转换数千个文件可能会耗时。
+
+为了简化此过程，Intlayer 提供了一个 [编译器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/compiler.md) / [提取器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md) 来转换你的组件并提取内容。
+
+要设置它，你可以在 `intlayer.config.ts` 文件中添加一个 `compiler` 部分：
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... 配置的其余部分
+  compiler: {
+    /**
+     * 指示是否应启用编译器。
+     */
+    enabled: true,
+
+    /**
+     * 定义输出文件路径
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 指示转换后是否应保存组件。
+     *
+     * - 如果为 `true`，编译器将在磁盘中重写组件文件。所以转换将是永久的，编译器将跳过下一个过程的转换。这样，编译器可以转换应用，然后可以被移除。
+     *
+     * - 如果为 `false`，编译器将仅在构建输出中注入 `useIntlayer()` 函数调用，并保持基础 codebase 完整。转换将仅在内存中进行。
+     */
+    saveComponents: false,
+
+    /**
+     * 字典键前缀
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+<Tabs>
+ <Tab value='Extract command'>
+
+运行提取器来转换你的组件并提取内容
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bun x intlayer extract
+```
+
+ </Tab>
+ <Tab value='Babel compiler'>
+
+> 从 v9 开始，`intlayerCompiler` 包含在 `intlayer` 插件中。所以你不需要手动添加它。
+
+更新你的 `vite.config.ts` 以包含 `intlayerCompiler` 插件：
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // 添加编译器插件
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # 或 npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # 或 pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # 或 yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # 或 bun run dev
+```
+
+ </Tab>
+</Tabs>
+</Step>
+
+</Steps>
+
 ### （可选）站点地图与 robots.txt（构建时生成）
 
 Intlayer 提供 `generateSitemap` 与 `getMultilingualUrls`，可将面向爬虫的多语言 `sitemap.xml` 和 `robots.txt` 格式化并自动写入 `public/`。实践中在 Vite **之前**运行小型 Node 脚本（例如 npm 的 `predev` / `prebuild`）即可在构建或开发时生成这些文件。

package/docs/zh/mcp_server.md

@@ -252,20 +252,14 @@ bun x intlayer init mcp
 
 按照[官方文档](https://modelcontextprotocol.io/quickstart/user)来配置 MCP server 在 Claude Code 中。
 
-## 通过命令行界面使用 MCP 服务器
+### 本地服务器 (stdio) (推荐)
 
-您也可以直接从命令行运行 Intlayer MCP 服务器，用于测试、调试或与其他工具集成。
+要通过 stdio 将 Intlayer MCP 服务器连接到 Claude Code：
 
 ```bash
-# 全局安装
-npm install -g @intlayer/mcp
-
-# 或直接使用 npx（推荐）
-npx @intlayer/mcp
+claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
----
-
 ### 远程服务器 (Streamable HTTP)
 
 要使用 Streamable HTTP (SSE) 将 Intlayer MCP 服务器连接到 Claude Code：

package/docs/zh/packages/intlayer/getLocalizedUrl.md

@@ -66,30 +66,32 @@ getLocalizedUrl(
   - **Type**: `Locales`
   - **Required**: Yes
 
-## 参数
-
-- `url: string`
-  - **描述**：需要添加语言环境前缀的原始 URL 字符串。
-  - **类型**：`string`
-
-- `currentLocale: Locales`
-  - **描述**：当前正在本地化的语言环境。
-  - **类型**：`Locales`
-
-- `locales: Locales[]`
-  - **描述**：可选的支持语言环境数组。默认情况下，提供项目中配置的语言环境。
-  - **类型**：`Locales[]`
-  - **默认值**：[`项目配置`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
-
-- `defaultLocale: Locales`
-  - **描述**：应用程序的默认语言环境。默认情况下，提供项目中配置的默认语言环境。
-  - **类型**：`Locales`
-  - **默认值**：[`项目配置`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
-
-- `prefixDefault: boolean`
-  - **描述**：是否为默认语言环境的 URL 添加前缀。默认情况下，提供项目中配置的值。
-  - **类型**：`boolean`
-  - **默认值**：[`项目配置`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
+### 可选参数
+
+- `options?: object`
+  - **Description**: URL 本地化行为的配置对象。
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: 支持的 locale 数组。如果未提供，将使用项目配置中配置的 locale。
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: 应用程序的默认 locale。如果未提供，将使用项目配置中配置的默认 locale。
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: 用于 locale 处理的 URL 路由模式。如果未提供，将使用项目配置中配置的模式。
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: 默认 locale 无前缀，其他 locale 有前缀
+      - `prefix-all`: 所有 locale（包括默认 locale）都有前缀
+      - `no-prefix`: URL 中无 locale 前缀
+      - `search-params`: 使用查询参数表示 locale（例如 `?locale=fr`）
 
 ### 返回值
 

package/docs/zh/packages/intlayer/getMultilingualUrls.md

@@ -50,26 +50,12 @@ getMultilingualUrls(
 
 ## 参数
 
-## 参数
+### 必需参数
 
 - `url: string`
-  - **描述**：需要添加语言环境前缀的原始 URL 字符串。
-  - **类型**：`string`
-
-- `locales: Locales[]`
-  - **描述**：可选的支持语言环境数组。默认为项目中配置的语言环境。
-  - **类型**：`Locales[]`
-  - **默认值**：`localesDefault`
-
-- `defaultLocale: Locales`
-  - **描述**：应用的默认语言环境。默认为项目中配置的默认语言环境。
-  - **类型**：`Locales`
-  - **默认值**：`defaultLocaleDefault`
-
-- `prefixDefault: boolean`
-  - **描述**：是否为默认语言环境添加前缀。默认为项目中配置的值。
-  - **类型**：`boolean`
-  - **默认值**：`prefixDefaultDefault`
+  - **描述**: 原始 URL 字符串，用于添加区域前缀。
+  - **类型**: `string`
+  - **必需**: 是
 
 ### 可选参数
 

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

@@ -37,6 +37,26 @@ npm install vite-intlayer
 
 导入：
 
+```ts
+import { ... } from "vite-intlayer";
+```
+
+| 导出                       | 描述                                                                                                      | 相关文档                                                                                                                     |
+| -------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `intlayer`                 | 主要 Vite 插件。准备字典、配置别名、启动开发服务器监听器，以及（从 v9 开始）捆绑代理和编译器。            | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayer.md)                 |
+| `intlayerPlugin`           | (**已弃用**) `intlayer` 的别名。                                                                          | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayer.md)                 |
+| `intLayerPlugin`           | (**已弃用**) `intlayer` 的别名。                                                                          | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayer.md)                 |
+| `intlayerProxy`            | 本地化路由中间件插件（检测、重定向、重写）。从 v9 开始，它捆绑在 `intlayer()` 内部 — 仅在需要时单独注册。 | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerProxy.md)       |
+| `intlayerMiddleware`       | (**已弃用**) `intlayerProxy` 的别名。                                                                     | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerProxy.md)       |
+| `intLayerMiddlewarePlugin` | (**已弃用**) `intlayerProxy` 的别名。                                                                     | [intlayerProxy](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerProxy.md)       |
+| `intlayerCompiler`         | 从组件中提取内联内容声明并将其写入字典。从 v9 开始，它捆绑在 `intlayer()` 内部。                          | [intlayerCompiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerCompiler.md) |
+| `intlayerPrune`            | 从生产 bundle 中树摇未使用的字典字段。                                                                    | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerPrune.md)       |
+| `intlayerMinify`           | 压缩编译后的字典 JSON 文件，并可选地破坏字段名。                                                          | [intlayerMinify](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerMinify.md)     |
+
+### 插件
+
+导入：
+
 ```tsx
 import "vite-intlayer";
 ```
@@ -48,3 +68,12 @@ import "vite-intlayer";
 | `intlayerProxy`      | 开发时的中间件插件，用于处理语言检测和路由。               | -                                                                                                                      |
 | `intlayerMiddleware` | (**已弃用**) `intlayerProxy` 的别名。                      | -                                                                                                                      |
 | `intlayerPrune`      | 用于在构建期间对未使用的字典进行 tree-shake 和修剪的插件。 | [intlayerPrune](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayerPrune.md) |
+
+### 类型
+
+| 导出                         | 描述                                                                                               |
+| ---------------------------- | -------------------------------------------------------------------------------------------------- |
+| `IntlayerPluginOptions`      | `intlayer()` 接受的选项。扩展 `GetConfigurationOptions`，添加 `compatCallers` 和 `proxy`。         |
+| `IntlayerProxyPluginOptions` | `intlayerProxy()` 和 `createIntlayerProxyHandler()` 接受的选项。包括 `ignore` 和 `configOptions`。 |
+| `IntlayerCompilerOptions`    | `intlayerCompiler()` 接受的选项。包括 `configOptions` 和 `compilerConfig`。                        |
+| `CompatCallerConfig`         | 从 `@intlayer/babel` 重新导出。描述用于字段使用分析的 compat-adapter 调用者模式。                  |