@intlayer/docs 9.3.3 → 9.4.0

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

@@ -31,6 +31,14 @@ author: aymericzip
 
 `getMultilingualUrls` 函数通过在给定的 URL 前添加每个支持的语言环境前缀来生成多语言 URL 的映射。它可以处理绝对和相对 URL，根据提供的配置或默认值应用适当的语言环境前缀。
 
+**主要功能：**
+
+- 仅需 1 个参数：`url`
+- 可选的 `options` 对象包含 `locales`、`defaultLocale` 和 `mode`
+- 使用您的项目国际化配置作为默认值
+- 支持多种路由模式：`prefix-no-default`、`prefix-all`、`no-prefix` 和 `search-params`
+- 返回一个映射对象，其中所有语言区域作为键，对应的 URL 作为值
+
 ---
 
 ## 函数签名
@@ -139,8 +147,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### 不同的路由模式
 
 ```typescript
@@ -206,6 +212,12 @@ getMultilingualUrls("/dashboard", {
 - **不支持的语言：**
   - 仅考虑 `locales` 数组中提供的语言来生成 URL。
 
+- **路由模式：**
+  - `'prefix-no-default'`：默认语言没有前缀，其他语言有前缀（例如 `/dashboard`、`/fr/dashboard`）
+  - `'prefix-all'`：所有语言都有前缀（例如 `/en/dashboard`、`/fr/dashboard`）
+  - `'no-prefix'`：URL 中没有语言前缀（所有语言返回相同 URL）
+  - `'search-params'`：通过查询参数指定语言（例如 `/dashboard?locale=fr`）
+
 ---
 
 ## 在应用中的使用

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

@@ -77,8 +77,6 @@ type GetPrefixResult = {
     - **类型**：`Locales`
     - **默认值**：[`项目配置`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)
 
-  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
-
 - **描述**：用于处理本地化的 URL 路由模式。如果未提供，则使用项目配置中设置的模式。
 - **类型**：`'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
 - **默认值**：[项目配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md#middleware)

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 `getTranslationContent` 函数从一组可自定义的语言内容中检索对应特定语言环境的内容。如果未找到指定的语言环境，则默认返回项目中配置的默认语言环境的内容。
 
+有关如何声明翻译的更多详情，请参阅 [翻译文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/translation.md)。
+
 ## 参数
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/zh/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ const greeting = t(translations);
 
 #### 示例：
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## 常见错误与故障排除

package/docs/zh/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,35 @@ author: aymericzip
 
 以下示例展示了如何在 Next.js 页面中实现 `useIntlayer` 钩子，根据应用程序当前的语言环境动态加载本地化内容：
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  // 获取主页内容
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +133,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/zh/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## 返回值
 
+当你调用 `useLocale` hook 时，它会返回一个包含以下属性的对象：
+
 - **`locale`**：当前在 React 上下文中设置的语言环境。
 - **`defaultLocale`**：配置中定义的主要语言环境。
 - **`availableLocales`**：配置中定义的所有可用语言环境列表。

package/docs/zh/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ author: aymericzip
 
 ## React 中的示例用法
 
-以下是如何在 React 组件中使用 `useDictionary` 钩子的示例：
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

package/docs/zh/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ author: aymericzip
 
 以下是在 React 组件中使用 `useI18n` 钩子的示例：
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/zh/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## React 中的示例用法
 
-演示在 React 组件中使用 `useIntlayer` 钩子：
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

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

@@ -55,12 +55,6 @@ import { ... } from "vite-intlayer";
 
 ### 插件
 
-导入：
-
-```tsx
-import "vite-intlayer";
-```
-
 | 功能                 | 描述                                                       | 相关文档                                                                                                               |
 | -------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
 | `intlayer`           | 主要的 Vite 插件，将 Intlayer 集成到构建流程中。           | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayer.md)           |

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

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` 为 `true`（或 `undefined`，构建时默认为 `true`）。
 3. 您的 Intlayer 配置中 `build.minify` 为 `true`。
 
-当 `editor.enabled` 为 `true` 时，它会自动**禁用**，因为编辑器需要完整、人类可读的字典内容。
+当 `editor.enabled` 为 `true` 时，插件仍会运行，但会**跳过字段重命名**：重命名会重写解释器遍历的内容键，这会导致可视化编辑器收到的 `keyPath` 不再与其正在编辑的未合并字典相匹配。空白压缩和顶层元数据清除仍保持启用。
 
 ## 哪些内容会被压缩
 

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

@@ -28,6 +28,8 @@ author: aymericzip
 
 `intlayerPrune` Vite 插件用于对应用包中未使用的字典进行 tree-shaking 和裁剪。这样可以通过仅包含必要的多语言内容来减小最终包的体积。
 
+> 当你使用 [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/vite-intlayer/intlayer.md) 时，该插件已自动包含并配置。只有在你自己组合插件堆栈时，才需要手动注册它。
+
 ## 使用
 
 ### 作为 `intlayer()` 的一部分（推荐）
@@ -115,4 +117,4 @@ const { title, description } = useIntlayer("myDict");
 2. `build.optimize` 是 `true`（或 `undefined`，在构建时默认为 `true`）。
 3. 在您的 Intlayer 配置中 `build.purge` 是 `true`。
 
-当 `editor.enabled` 是 `true` 时，它会自动**禁用**，因为编辑器需要完整的字典内容。
+当 `editor.enabled` 为 `true` 时，它仍保持启用：可视化编辑器通过 `dictionaryKey` + `keyPath` 对照未合并的字典来解析每一次编辑，而该插件从不触碰这些字典；被清除的字段是没有任何组件会读取的字段——因此它永远不会被渲染，也无法在页面中被选中。

package/docs/zh/per_locale_file.md

@@ -93,6 +93,19 @@ module.exports = helloWorldContent;
 }
 ```
 
+```json5 fileName="hello-world.zh.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "zh", // 重要
+  "content": {
+    "multilingualContent": "我的组件标题",
+  },
+}
+```
+
+> 重要：确保定义了 locale 字段。它告诉 Intlayer 该文件代表哪种语言。
+
 > 推荐：当使用 Intlayer 的可视化编辑器或直接在代码中管理翻译时，此格式最佳。
 
 ### 每个语言区域文件的全局配置
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // 重要
-  "content": {
-    "multilingualContent": "我的组件标题",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -168,8 +170,6 @@ export default helloWorldContent;
 }
 ```
 
-> 重要提示：确保定义了 locale 字段。它告诉 Intlayer 该文件代表哪种语言。
-
 > 注意：在这两种情况下，内容声明文件必须遵循命名模式 `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`，以便被 Intlayer 识别。`.[locale]` 后缀是可选的，仅作为命名约定使用。
 
 ## 混合格式

package/docs/zh/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 您仍然可以使用内容文件中的 `autoFill` 字段对每个字典进行微调。完整参考请见 `doc/autoFill` 和 `doc/dictionary/content_file`。
 
+你仍然可以使用内容文件中的 `autoFill` 字段对每个字典进行微调。Intlayer 将首先考虑每个字典的配置，然后回退到全局配置。请参阅 [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/autoFill.md) 和 [Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md) 中的完整参考。
+
 ---
 
 ## 填充命令：更安全的默认设置
@@ -175,6 +177,20 @@ CI 示例可在 [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/do
 
 ---
 
+I'm ready to audit the translation. I can see that:
+
+- 自动填充
+- 测试缺失翻译
+- 实时更新
+- 日志记录
+- 验证
+- 迁移注记
+- 文档
+
+> MCP server 帮助自动化使用 Intlayer 的项目。测试自动生成代码的缺失翻译。它帮助理解你的配置，并将 Intlayer 的文档嵌入到你的 IDE 中。
+
+---
+
 ## 性能提升：快 10 倍
 
 - 本地和远程词典并行解析
@@ -296,8 +312,6 @@ bun x intlayer live --with 'vite preview'
 
 请参阅[CMS 和实时同步](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)和[配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)以获取完整指南。
 
----
-
 ## 使用 turbopack 监视文件的并行进程
 
 当在 Next.js 14 及以上版本中使用 Turbopack 作为开发服务器，并使用 `next dev --turbopack` 命令时，默认情况下字典更改不会被自动检测。

package/docs/zh/self_hosting.md

@@ -19,6 +19,8 @@ author: aymericzip
 
 # 自托管 Intlayer
 
+Intlayer 可以在您自己的基础设施上运行。无需 Intlayer Cloud 账户。单个一体化 Docker 镜像捆绑了仪表板、API 和它所需的本地数据存储（Redis 和 MinIO），由 [s6-overlay](https://github.com/just-containers/s6-overlay) 监管。
+
 Intlayer 可以完全在您自己的基础设施上运行——无需 Intlayer Cloud 账户。只需一条命令即可启动一个生产就绪的堆栈：
 
 ```sh
@@ -27,6 +29,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 安装程序会下载 `docker-compose.yml` 和 `.env` 文件，自动生成所需的密钥，并使用 `docker compose up -d` 启动所有容器。
 
+唯一的外部依赖是 **MongoDB**：后端连接到你提供的 MongoDB **Atlas** 集群。其他一切都在容器内运行。
+
 ## 目录
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium（用于 Puppeteer 屏幕截图生成）捆绑在后端镜像中——
 - 主机上端口 `3000`、`3100`、`8025`、`9000` 和 `9001` 可用。
 - Linux 或 macOS 主机（或 Windows 上的 WSL2）。
 
+其他所有内容 — Bun、Redis、MinIO、Chromium — 都包含在镜像中。
+
 ---
 
 ## 快速开始
 
-Pull 并运行已发布的镜像，提供您的 MongoDB Atlas 凭证和密钥：
+### 1. 运行安装程序
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+它验证 Docker 是否已安装且正在运行，将 `./intlayer.env` 写入已生成的 `BETTER_AUTH_SECRET` 和 `S3_SECRET_ACCESS_KEY`，并拉取镜像。它不启动容器 — 后端无法在没有数据库凭证的情况下启动。
+
+重新运行安装程序是安全的：现有的 `intlayer.env` 永远不会被覆盖，因此它也可以作为升级路径。
+
+### 2. 填入你的凭证
+
+打开 `intlayer.env` 并完成标记为 `TODO` 的值：
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+该文件还包含了可选功能的注释块 — [SMTP mailer](#global-mailer)、`OPENAI_API_KEY` 和 OAuth 提供商。取消注释你需要的内容。
+
+> 该文件由 `docker run --env-file` 读取，它不会去除引号，并将 `=` 之后的所有内容视为值。写入裸值，并将注释放在单独的行上。
+
+### 3. 启动容器
+
+这是安装程序完成时打印的命令:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-然后打开 **http://localhost:3000**。
+然后打开 **http://localhost:3000**。首次启动会初始化数据存储，请等待一分钟。
 
-> dashboard 在 `localhost` 上提供。请参阅 [限制](#limitations) — 已发布的镜像不支持自定义域名。
+> 仪表板在 `localhost` 上提供。请参阅[限制](#limitations) — 已发布的镜像不支持自定义域名。
 
----
+### 安装程序设置
 
-## 快速开始
+安装程序读取几个环境变量。由于它被管道传输到 `sh`，请将它们传递给 shell 而不是 `curl`：
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| 变量                      | 默认值                                        | 描述                    |
+| ------------------------- | --------------------------------------------- | ----------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | 要拉取的镜像            |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | 环境文件的写入位置      |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | 容器名称                |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | 挂载在 `/data` 的命名卷 |
+| `INTLAYER_APP_PORT`       | `3000`                                        | 仪表板的主机端口        |
+| `INTLAYER_API_PORT`       | `3100`                                        | API 的主机端口          |
+| `INTLAYER_S3_PORT`        | `9000`                                        | MinIO S3 API 的主机端口 |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | MinIO 控制台的主机端口  |
+
+> 四个端口变量仅改变 `docker run` 命令中打印的映射的**主机**端，已发布的镜像在构建时将 `http://localhost:3000`、`http://localhost:3100` 和 `http://localhost:9000` 编译到仪表板包中，因此重新映射它们会导致浏览器指向旧端口。除非您正在构建自己的镜像，否则请保持默认值 — 参见[限制](#limitations)。
+
+---
+
+## 快速开始
+
 安装程序执行以下操作：
 
 1. 检查 `docker` 和 `docker compose` 是否存在。
@@ -117,8 +163,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                     | `9000` (S3), `9001` (控制台)   | 用于头像和截图的 S3 兼容对象存储   |
 | **mailpit** | `axllent/mailpit`                 | `1025` (SMTP), `8025` (Web UI) | 本地事务性电子邮件接收器           |
 
-默认情况下，内部端口（mongo、redis）不会暴露给主机。
-
 > MinIO 端口 `9000` 必须可从浏览器访问，因为上传的资产（头像、截图）直接从 `S3_PUBLIC_URL=http://localhost:9000/intlayer` 加载。
 
 ---
@@ -174,8 +218,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuth 登录                                    |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuth 登录                                   |
 
----
-
 ### 全局邮件服务
 
 默认情况下，所有事务性电子邮件都通过使用 `RESEND_API_KEY` 的 Resend 发送。自托管部署可以改为通过配置了环境变量的全局邮件服务路由**所有**电子邮件 — 包括非组织电子邮件，例如密码重置和魔法链接。
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## 升级
 
-在现有部署上重新运行安装程序会执行滚动升级：
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 这会拉取最新镜像并使用 `docker compose pull && docker compose up -d` 重启容器。现有卷（`mongo-data`、`redis-data`、`minio-data`）会保留——不会丢失数据。
 
-要在 `./intlayer/` 目录中手动升级：
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,14 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+在日志的顶部附近查找 `MongoDB connection error`。
+
 ### 电子邮件未发送
 
 默认情况下，所有出站电子邮件都会被 Mailpit 捕获。打开 `http://localhost:8025` 查看已发送的消息。要发送真实电子邮件，请在 `.env` 中设置 `MAIL_PROVIDER=resend` 和 `RESEND_API_KEY=<your-key>`，然后重启后端：
 
-```sh
-docker compose restart backend
-```
-
 ### MinIO 存储桶缺失
 
 如果 `minio-init` 一次性服务未运行（或在 MinIO 准备好之前运行），请手动创建存储桶：

package/docs/zh-TW/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> 如果在 `optimize` 被設為 `false`、又或是啟用了視覺化編輯器也就是當 `editor.enabled` 設定為了 `true` 時（由於編輯器需要保留欄位名稱以便做後續處理），重新命名這個操作都將會被跳過。
+> 當 `optimize` 為 `false` 時，壓縮會被跳過。當 `editor.enabled` 為 `true` 時，壓縮仍會執行，但不會執行欄位重新命名步驟——視覺化編輯器透過 `keyPath` 解析編輯內容，因此原始欄位名稱必須保留。
 
 > 在 Next.js 上，當 `@intlayer/swc` 未安裝或無法載入時（Next.js 低於 16.1.0），壓縮同樣會被略過。重寫原始碼存取的正是這個外掛，因此在沒有它的情況下重新命名字典，會讓你的程式碼讀取已不存在的欄位名稱。
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> 與前邊提到的類似，當 `optimize` 是 `false` 或是開啟了視覺化編輯器(`editor.enabled` 取值 `true`) 時，它會選擇跳過對資料的清除操作。 在 Next.js 上，當 `@intlayer/swc` 不可用以及設定了相容轉接器呼叫方時，還會被額外略過。
+> 當 `optimize` 為 `false` 時，清除（Purge）會被跳過。當 `editor.enabled` 為 `true` 時，它仍保持啟用——被清除的欄位不會被任何元件讀取，因此編輯器永遠不會渲染它。在 Next.js 上，當 `@intlayer/swc` 不可用以及設定了相容轉接器呼叫方時，還會被額外略過。
 
 > 當檢測到某份程式碼因為異常無法順利解析、又或者當把由 `useIntlayer` 輸出的值以靜態解析器難以預測分析的模式在不同元件中來回丟（比如被打包成物件傳入等而未被進行解構）的時候，它同樣會跳過，以此保守地保留整部字典的全部資訊，避免意外發生。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.3.3",
+  "version": "9.4.0",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,14 +73,14 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.3.3",
-    "@intlayer/core": "9.3.3",
-    "@intlayer/types": "9.3.3"
+    "@intlayer/config": "9.4.0-canary.0",
+    "@intlayer/core": "9.4.0-canary.0",
+    "@intlayer/types": "9.4.0"
   },
   "devDependencies": {
-    "@intlayer/api": "9.3.2",
-    "@intlayer/cli": "9.3.2",
-    "@types/node": "26.2.0",
+    "@intlayer/api": "9.4.0",
+    "@intlayer/cli": "9.4.0",
+    "@types/node": "26.3.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",