@intlayer/docs 9.3.3 → 9.4.0

package/docs/zh/live-sync.md

@@ -42,6 +42,45 @@ author: aymericzip
 
 ## 启用实时同步
 
+通过更新你的 Intlayer 配置来启用 Live Sync：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... 其他配置设置
+  editor: {
+    /**
+     * 检测到更改时启用区域配置的热重新加载。
+     * 例如，当添加或更新字典时，应用程序会更新
+     * 页面上显示的内容。
+     *
+     * 因为热重新加载需要与服务器的持续连接，它只
+     * 对 `enterprise` 计划的客户端可用。
+     *
+     * 默认值: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * 控制字典的导入方式：
+     *
+     * - "fetch": 使用 Live Sync API 动态获取字典。
+     *   将 useIntlayer 替换为 useDictionaryDynamic。
+     *
+     * 注意: Live 模式使用 Live Sync API 来获取字典。如果 API 调用
+     * 失败，字典会动态导入。
+     * 注意: 只有具有远程内容和 "live" 标志的字典才会使用 live 模式。
+     * 其他字典为了性能考虑使用动态模式。
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
 > 实时同步需要持续的服务器连接，并且仅在企业版计划中可用。
 
 通过更新您的 Intlayer 配置来启用实时同步：
@@ -169,8 +208,6 @@ export default config;
 - CMS URL
 - 确保项目配置已推送到 Intlayer CMS。
 
-- 可视化编辑器使用 iframe 来显示您的网站。确保您网站的内容安全策略（CSP）允许 CMS URL 作为 `frame-ancestors`（默认是 'https://intlayer.org'）。检查编辑器控制台是否有任何错误。
-
 ## Useful links
 
 - [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)

package/docs/zh/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-03-03
+updatedAt: 2026-08-21
 title: MCP 服务器文档
 description: 探索 MCP 服务器的功能和设置，以优化您的服务器管理和操作。
 keywords:
@@ -15,6 +15,9 @@ slugs:
   - doc
   - mcp-server
 history:
+  - version: 9.3.3
+    date: 2026-08-21
+    changes: "Group the platform setup sections into tabs"
   - version: 5.5.12
     date: 2025-07-11
     changes: "添加 ChatGPT 的设置"
@@ -113,13 +116,18 @@ bun x intlayer init mcp
 
 ---
 
-## 在 Cursor 中的设置
+## 手动配置
+
+<Tabs defaultTab="cursor">
+  <Tab label="Cursor" value="cursor">
+
+### 在 Cursor 中的设置
 
 请按照[官方文档](https://docs.cursor.com/context/mcp)配置 Cursor 中的 MCP 服务器。
 
 在您的项目根目录下，添加以下 `.cursor/mcp.json` 配置文件：
 
-### 本地服务器（stdio）（推荐）
+#### 本地服务器（stdio）（推荐）
 
 ```json fileName=".cursor/mcp.json"
 {
@@ -132,7 +140,7 @@ bun x intlayer init mcp
 }
 ```
 
-### 远程服务器（Streamable HTTP）
+#### 远程服务器（Streamable HTTP）
 
 要通过服务器发送事件（Streamable HTTP）连接到远程 Intlayer MCP 服务器，您可以配置 MCP 客户端以连接到托管服务。
 
@@ -149,15 +157,16 @@ bun x intlayer init mcp
 
 这会告诉您的 IDE 使用 `npx` 启动 Intlayer MCP 服务器，确保它始终使用最新可用版本，除非您进行了版本固定。
 
----
+  </Tab>
+  <Tab label="VS Code" value="vscode">
 
-## 在 VS Code 中设置
+### 在 VS Code 中设置
 
 请参阅[官方文档](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)以配置 VS Code 中的 MCP 服务器。
 
 要在 VS Code 中使用 Intlayer MCP 服务器，您需要在工作区或用户设置中进行配置。
 
-### 本地服务器（stdio）（推荐）
+#### 本地服务器（stdio）（推荐）
 
 在你的项目根目录下创建一个 `.vscode/mcp.json` 文件：
 
@@ -173,7 +182,7 @@ bun x intlayer init mcp
 }
 ```
 
-### 远程服务器（Streamable HTTP）
+#### 远程服务器（Streamable HTTP）
 
 要连接到使用服务器发送事件（Streamable HTTP）的远程 Intlayer MCP 服务器，你可以配置你的 MCP 客户端以连接到托管服务。
 
@@ -188,11 +197,12 @@ bun x intlayer init mcp
 }
 ```
 
----
+  </Tab>
+  <Tab label="ChatGPT" value="chatgpt">
 
-## 在 ChatGPT 中设置
+### 在 ChatGPT 中设置
 
-### 远程服务器（Streamable HTTP）
+#### 远程服务器（Streamable HTTP）
 
 请按照[官方文档](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server)配置 ChatGPT 中的 MCP 服务器。
 
@@ -209,9 +219,10 @@ bun x intlayer init mcp
 
 7. 点击 “Save”
 
----
+  </Tab>
+  <Tab label="Claude Desktop" value="claude-desktop">
 
-## 在 Claude Desktop 中设置
+### 在 Claude Desktop 中设置
 
 按照[官方文档](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)配置 Claude Desktop 中的 MCP 服务器。
 
@@ -220,7 +231,7 @@ bun x intlayer init mcp
 - macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-### 本地服务器（stdio）（推荐）
+#### 本地服务器（stdio）（推荐）
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -233,7 +244,7 @@ bun x intlayer init mcp
 }
 ```
 
-### 远程服务器（Streamable HTTP）
+#### 远程服务器（Streamable HTTP）
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -246,13 +257,14 @@ bun x intlayer init mcp
 }
 ```
 
----
+  </Tab>
+  <Tab label="Claude Code (CLI)" value="claude-code">
 
-## 在 Claude Code (CLI) 中设置
+### 在 Claude Code (CLI) 中设置
 
 按照[官方文档](https://modelcontextprotocol.io/quickstart/user)来配置 MCP server 在 Claude Code 中。
 
-### 本地服务器 (stdio) (推荐)
+#### 本地服务器 (stdio) (推荐)
 
 要通过 stdio 将 Intlayer MCP 服务器连接到 Claude Code：
 
@@ -260,7 +272,7 @@ bun x intlayer init mcp
 claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
-### 远程服务器 (Streamable HTTP)
+#### 远程服务器 (Streamable HTTP)
 
 要使用 Streamable HTTP (SSE) 将 Intlayer MCP 服务器连接到 Claude Code：
 
@@ -268,6 +280,9 @@ claude mcp add intlayer npx -y @intlayer/mcp
 claude mcp add intlayer https://mcp.intlayer.org -t http
 ```
 
+  </Tab>
+</Tabs>
+
 ---
 
 ## 通过 CLI 使用 MCP Server

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: elysia-intlayer 包文档
+description: Intlayer 的 Elysia 插件，提供翻译函数和 locale 检测。
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "统一所有导出的文档"
+author: aymericzip
+---
+
+# elysia-intlayer 包
+
+`elysia-intlayer` 包为 Elysia 应用提供了一个处理国际化的插件。它会检测用户的 locale，并向路由上下文注入一个 `intlayer` 对象。
+
+## 安装
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` 是一个 peer dependency（`>=1.0.0`）。Elysia 面向 **Bun** 运行时。
+
+## 导出
+
+### 插件
+
+导入：
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| 函数       | 描述                                                                                                                                                                                                                                                                | 相关文档                                                                                                       |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | 将 Intlayer 集成到你的 Elysia 应用中的 Elysia 插件。负责先从 storage（cookies、headers）、再从 `Accept-Language` 进行 locale 检测，向路由上下文注入暴露 `locale`、`t`、`getIntlayer` 和 `getDictionary` 的 `intlayer` 对象，并建立 `AsyncLocalStorage` 请求上下文。 | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/elysia-intlayer/intlayer.md) |
+
+### 函数
+
+导入：
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| 函数            | 描述                                                                                                                                                                         | 相关文档                                                                                               |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `t`             | 在 Elysia 中获取当前 locale 内容的全局翻译函数。使用 `AsyncLocalStorage` 访问由 `intlayer` 插件建立的请求上下文，在其之外则回退到默认 locale。也可以通过 `intlayer.t` 访问。 | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/translation.md) |
+| `getIntlayer`   | 从生成的声明中按 key 获取字典，并返回其在当前 locale 下的内容。`getDictionary` 的优化版本。使用 `AsyncLocalStorage` 访问请求上下文。也可以通过 `intlayer.getIntlayer` 访问。 | -                                                                                                      |
+| `getDictionary` | 处理字典对象并返回当前 locale 的内容。处理 `t()` 翻译、枚举、markdown、HTML 等。使用 `AsyncLocalStorage` 访问请求上下文。也可以通过 `intlayer.getDictionary` 访问。          | -                                                                                                      |
+
+### 类型
+
+导入：
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| 类型                | 描述                                                                                                                                                  |
+| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerContext`   | 注入到每个路由上下文中的 `intlayer` 对象的结构：`locale`、`locale_storage`、`locale_detected`、`defaultLocale`、`t`、`getIntlayer`、`getDictionary`。 |
+| `TranslateFunction` | 翻译函数的签名，将 locale map 转换为与当前请求 locale 匹配的内容。                                                                                    |
+
+## 用法
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // 加载国际化插件
+  .use(intlayer())
+  // 从路由上下文读取语言环境和辅助函数
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      zh: "你好",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // 或者使用绑定到当前请求的独立辅助函数
+  .get("/t_example", () =>
+    t({
+      zh: "在中文中返回的内容示例",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> 该插件通过 **全局** `derive` 注册其上下文，Elysia 会将其类型标注为 `Partial<{ intlayer: IntlayerContext }>`。对于在 `.use(intlayer())` 之后注册的路由，该值在运行时始终存在，因此请使用非空断言（`intlayer!.locale`）或可选链，以满足 `strict` 模式下的 TypeScript。
+
+## 相关文档
+
+- [Elysia i18n - 完整指南翻译你的应用](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_elysia.md)
+- [配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)

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

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: intlayer Elysia 插件文档 | elysia-intlayer
+description: 了解如何使用 elysia-intlayer 包中的 intlayer 插件
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - 国际化
+  - 文档
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "初始化文档"
+author: aymericzip
+---
+
+# intlayer Elysia 插件文档
+
+Elysia 的 `intlayer` 插件会检测用户的 locale，并向路由上下文注入一个 `intlayer` 对象。它同时支持在请求上下文中使用全局翻译函数。
+
+## 用法
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    zh: "你好",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> 该插件通过 **全局** `derive` 注册其上下文，Elysia 会将其类型标注为 `Partial<{ intlayer: IntlayerContext }>`。对于在 `.use(intlayer())` 之后注册的路由，该值在运行时始终存在，因此请使用非空断言（`intlayer!.t`）或可选链，以满足 `strict` 模式下的 TypeScript。
+
+同样的 helper 也以独立导出的形式提供，因此你可以在不解构路由上下文的情况下调用它们：
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    zh: "你好",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## 描述
+
+该插件执行以下任务：
+
+1. **Locale 检测**：它先从 storage（cookie、header）读取客户端显式设置的 locale，然后回退到从 `Accept-Language` 请求头协商得到的 locale。
+2. **上下文注入**：它向 Elysia 路由上下文添加一个 `intlayer` 属性（参见下方的“路由上下文”表格）。
+3. **上下文管理**：它使用 `AsyncLocalStorage` 管理异步上下文，使全局 Intlayer 函数（`t`、`getIntlayer`、`getDictionary`）无需传递上下文对象即可访问该请求特定的 locale。
+4. **字典准备**：它在创建插件时调用 `prepareIntlayer`，因此字典会在应用启动时构建。
+
+### 路由上下文
+
+| 属性              | 类型                   | 描述                                                                 |
+| ----------------- | ---------------------- | -------------------------------------------------------------------- |
+| `locale`          | `Locale`               | 本次请求要使用的 locale，`locale_storage` 优先于 `locale_detected`。 |
+| `locale_storage`  | `Locale` (可选)        | 客户端通过 cookie 或 header 显式请求的 locale。                      |
+| `locale_detected` | `Locale`               | 从请求头协商得到的 locale。                                          |
+| `defaultLocale`   | `Locale`               | 在 `intlayer.config.ts` 中配置为 fallback 的 locale。                |
+| `t`               | `TranslateFunction`    | 翻译函数。                                                           |
+| `getIntlayer`     | `typeof getIntlayer`   | 按 key 获取字典的函数。                                              |
+| `getDictionary`   | `typeof getDictionary` | 处理字典对象的函数。                                                 |
+
+> 与基于 Node 的 Intlayer 插件不同，`elysia-intlayer` 依赖 `AsyncLocalStorage` 而非 `cls-hooked`，因为 `cls-hooked` 依赖于 Bun 未实现的 `async_hooks.createHook`。
+
+请求上下文会在响应被映射后释放，因此独立的 helper 永远不会针对已经结束的请求进行解析。当在插件处理的请求之外调用时，它们会回退到配置的默认 locale。
+
+## 语言环境解析顺序
+
+默认情况下，插件按以下顺序解析语言环境：
+
+1. `INTLAYER_LOCALE` cookie。
+2. `x-intlayer-locale` 请求头。
+3. `Accept-Language` 请求头协商。
+4. 配置的 `defaultLocale`。
+
+```bash
+# 从 `Accept-Language` 协商得出
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# cookie 优先于 `Accept-Language`
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# 请求头优先于 `Accept-Language`
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## 配置
+
+该插件会读取你的 `intlayer.config.ts` 文件。你可以自定义用于 locale 检测的 cookie 和 header：
+
+```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,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> 有关配置的更多信息，请访问[配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
+
+## 相关文档
+
+- [elysia-intlayer 包文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - 完整指南翻译你的应用](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_elysia.md)

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

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: getDictionary 函数文档 | intlayer
+description: 查看如何在 intlayer package 中使用 getDictionary 函数
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "初始文档"
+author: aymericzip
+---
+
+# 文档：`intlayer` 中的 `getDictionary` 函数
+
+## 描述
+
+`getDictionary` 函数解析**您自己传递的字典对象**，并返回其为给定区域设置解析后的内容。它单次遍历内容并根据需要应用每个解析器插件，解析 `t()` 翻译、枚举、条件、插入、嵌套、markdown、HTML 和文件节点。
+
+与 [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getIntlayer.md)（在生成的注册表中按键查找字典）不同，`getDictionary` 接收字典本身。这使其成为处理在运行时构建、从 API 或 CMS 获取或在测试中声明的内容的合适工具。
+
+**主要功能：**
+
+- 适用于任何遵循字典结构（`{ key, content }`）的对象
+- 也接受合格的字典组（集合、变体）和选择器
+- 完全类型化：返回的对象镜像您传递的 `content`
+- 接受自定义解析器插件
+
+---
+
+## 函数签名
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // 必需
+  localeOrSelector?: LocalesValues | DictionarySelector, // 可选
+  plugins?: Plugins[]                                // 可选
+): DeepTransformContent<...>
+```
+
+---
+
+## 参数
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **描述**: 要解释的字典（或合格字典组）。
+  - **类型**: `Dictionary | QualifiedDictionaryGroup`
+  - **必需**: 是
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **描述**: 用于解释内容的区域设置，或选择器对象（`{ item }`、`{ variant }`，可选择带 `locale`）。请参阅[动态字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dynamic_dictionaries/index.md)。
+  - **类型**: `LocalesValues | DictionarySelector`
+  - **必需**: 否（可选）— 默认为配置的 `defaultLocale`。
+
+- `plugins: Plugins[]`
+  - **描述**: 节点转换器数组，定义如何解释识别的节点。如果省略，将使用默认的解释器插件集。
+  - **类型**: `Plugins[]`
+  - **必需**: 否（可选）
+
+### 返回值
+
+- **类型**：字典的解释内容。
+- **描述**：你传递的 `content`，其中所有 Intlayer 节点都为请求的区域设置进行了解析。对于没有 `item` 选择器的集合组，返回一个有序的解释条目数组；当选择器不指向任何内容时，返回 `null`。
+
+---
+
+## 示例用法
+
+### 基本用法
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        zh: "你好",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "fr"
+);
+
+console.log(content.greeting); // "Bonjour"
+```
+
+### 解释运行时获取的内容
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### 使用选择器
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// 一个合格的字典组被解析为单个条目…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …或者当没有给定 `item` 时返回一个有序数组
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## 相关函数
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getIntlayer.md): 相同的解释，但字典是通过键在生成的注册表中查找的。
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getDictionaryAsync.md): 针对每个区域设置加载器映射的对应函数。
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/react-intlayer/useDictionary.md): 等效的 React hook，从提供程序读取区域设置。
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```