@intlayer/docs 9.3.0 → 9.3.1

package/docs/zh/lsp.md

@@ -1,12 +1,14 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-05-31
+updatedAt: 2026-08-10
 title: Intlayer LSP 服务器
-description: 了解 Intlayer 语言服务器如何为所有支持的编辑器中的 useIntlayer、getIntlayer 和相关调用提供“转到定义”和其他 IDE 功能。
+description: 了解 Intlayer 语言服务器如何为你的 IDE 和 AI 智能体带来转到定义、查找引用、悬停预览、键名自动补全与诊断能力。
 keywords:
   - LSP
   - 语言服务器
-  - 转到定义
+  - Go to Definition
+  - 自动补全
+  - 诊断
   - IDE
   - Intlayer
   - VS Code
@@ -16,6 +18,9 @@ slugs:
   - doc
   - lsp
 history:
+  - version: 9.1.3
+    date: 2026-08-10
+    changes: "新增查找引用、悬停、自动补全与诊断"
   - version: 8.12.0
     date: 2026-06-01
     changes: "Release LSP"
@@ -24,48 +29,47 @@ author: aymericzip
 
 # Intlayer LSP 服务器
 
-**Intlayer 语言服务器**是一个 [语言服务器协议 (LSP)](https://microsoft.github.io/language-server-protocol/) 实现，可通过感知 Intlayer 的智能来增强您的 IDE。它当前为字典键调用提供**转到定义**（Go to Definition），使您能够直接从组件中的 `useIntlayer("my-key")` 跳转到声明它的 `.content.ts` 文件。
+**Intlayer 语言服务器**是 [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/) 的一个实现，它让你的 IDE —— 以及你的 AI 智能体 —— 理解 Intlayer。它把 `useIntlayer("home")` 这样的调用与声明它的 `.content.ts` 文件双向关联起来。
 
 ---
 
-## 为什么使用 LSP？
+## 功能
 
-当您使用 Intlayer 时，像 `useIntlayer("homepage")` 这样的调用与其在 `src/homepage.content.ts` 中的声明之间的连接是隐式的。如果没有工具，您必须手动搜索文件。LSP 使该链接显式化：
+| 功能             | 快捷键              | 说明                                                              |
+| ---------------- | ------------------- | ----------------------------------------------------------------- |
+| **转到定义**     | `F12` / `Cmd+点击`  | 从字典键或字段使用处跳转到内容文件中的声明                        |
+| **查找所有引用** | `Shift+F12`         | 从内容文件出发，列出使用该键或字段的所有调用点                    |
+| **悬停**         | 将光标悬停其上      | 无需离开当前文件即可预览字典的字段，或某个字段的翻译值            |
+| **自动补全**     | `"` `'` `` ` `` `.` | 在 getter 内提示已声明的字典键，并在 `.` 之后或解构时提示内容字段 |
+| **诊断**         | 自动                | 当某个键未在任何内容文件中声明时发出警告                          |
 
-**AI 智能助手感知**
+还有两个行为值得了解：
 
-AI 编码助手（Cursor、Windsurf、GitHub Copilot、Claude Code、Codex）依赖语言服务器来解析符号并理解跨文件关系。运行 Intlayer LSP 后，助手可以追溯 `useIntlayer("key")` 到其声明，从而获得有关可用内容键、每个字典的形状以及要读取或编辑哪些文件的准确上下文。
+- **合并字典** —— 分散在多个内容文件中的键会按文件各返回一个结果，因此你可以跳转到每一处声明。
+- **支持 monorepo** —— 服务器会解析距离每个文件_最近的_ `intlayer.config.*`，因此同一工作区中的多个项目各自拥有独立的字典。
 
-**转到定义**
+### 支持的调用
 
-将光标放在支持的 getter 调用中的任何字典键字符串上，然后按 `F12`（或 `Cmd/Ctrl+单击`）。编辑器将打开内容声明文件，并将光标定位在 `key:` 行上。
+键既可以从位置字符串参数读取，也可以从选项对象（`{ namespace }`、`{ id }`）读取。
 
-**合并字典支持**
+| 库                          | 调用                                                     |
+| --------------------------- | -------------------------------------------------------- |
+| **Intlayer**                | `useIntlayer`, `getIntlayer`                             |
+| **i18next / react-i18next** | `useTranslation`, `getFixedT`, `t`, `Trans`              |
+| **next-intl / use-intl**    | `useTranslations`, `getTranslations`, `createTranslator` |
+| **react-intl**              | `formatMessage`, `FormattedMessage`                      |
+| **Lingui**                  | `useLingui`, `t`, `Trans`, `_`                           |
+| **vue-i18n**                | `useI18n`                                                |
 
-一个键可以分割在多个内容文件中（Intlayer 会合并它们）。服务器为每个源文件返回一个 `Location`，以便您可以导航到每个声明。
+它适用于所有 `*-intlayer` 包（`next-intlayer`、`react-intlayer`、`vue-intlayer`、`svelte-intlayer`、`solid-intlayer`、`preact-intlayer`、`angular-intlayer`、`lit-intlayer`、`express-intlayer`、`hono-intlayer`、`fastify-intlayer`、`intlayer`），也适用于让你保留现有 i18n 语法的 compat 适配包。
 
-**随处运行**
-
-支持所有 `*-intlayer` 包 (`next-intlayer`、`react-intlayer`、`vue-intlayer`、`svelte-intlayer`、`solid-intlayer`、`preact-intlayer`、`angular-intlayer`、`lit-intlayer`、`express-intlayer`、`hono-intlayer`、`fastify-intlayer`、`adonis-intlayer`、`intlayer`)。
-
-### 支持的 getter 调用
-
-服务器检测以下函数调用，并提取第一个字符串字面量参数作为字典键：
-
-| 函数          | 示例                          |
-| ------------- | ----------------------------- |
-| `useIntlayer` | `useIntlayer("hero")`         |
-| `getIntlayer` | `getIntlayer("hero", locale)` |
-
-TypeScript 泛型和额外参数将被忽略 —— 只有键字符串重要。
-
-> `useDictionary` 和 `getDictionary` 接受一个已导入的 `Dictionary` 对象作为其第一个参数，而不是字符串键，因此它们无法享受“转到定义”的好处，且不受服务器跟踪。
+> 字典读取自构建产物，因此请运行 `npx intlayer build`，或保持开发服务器运行，好让服务器有内容可解析。
 
 ---
 
 ## 安装
 
-LSP 服务器作为 `@intlayer/lsp` 的一部分进行分发：
+服务器以 `@intlayer/lsp` 中的 `intlayer-lsp` 可执行文件形式发布：
 
 ```bash packageManager="npm"
 npm install --save-dev @intlayer/lsp
@@ -83,43 +87,43 @@ pnpm add --save-dev @intlayer/lsp
 bun add --dev @intlayer/lsp
 ```
 
-该包公开了 `intlayer-lsp` 二进制文件，编辑器将其用作服务器可执行文件。
+如果你的编辑器需要在 `PATH` 中找到 `intlayer-lsp`，请改为全局安装（`npm install -g @intlayer/lsp`）—— Claude Code 插件以及下文中直接调用该可执行文件的配置都属于这种情况。
 
 ---
 
-## 设置为 Claude Code 插件
+## 配置
 
-Intlayer LSP 可以作为直接托管在 Intlayer GitHub 仓库中的 **Claude Code 插件**使用。安装它可以让 Claude Code 对您所有的 `useIntlayer` / `getIntlayer` 调用具有原生的“转到定义”感知。
+<Tabs defaultTab="vscode">
+  <Tab label="VS Code" value="vscode">
 
-### 1. 安装语言服务器二进制文件
+安装 [Intlayer VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)。语言服务器自 v8.12.0 起已内置并会自动启动 —— **无需任何配置**。
 
-```bash packageManager="npm"
-npm install -g @intlayer/lsp
-```
+其他功能请参阅 [VS Code 扩展文档](https://intlayer.org/doc/vs-code-extension)。
 
-```bash packageManager="yarn"
-yarn global add @intlayer/lsp
-```
+  </Tab>
+  <Tab label="Cursor / Windsurf" value="cursor">
 
-```bash packageManager="pnpm"
-pnpm add -g @intlayer/lsp
-```
+[Cursor](https://www.cursor.com/) 和 [Windsurf](https://windsurf.com/) 是 VS Code 的分支，使用相同的扩展生态。安装一次 [Intlayer VS Code 扩展](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)，服务器便会自动启用 —— **无需任何配置**。
+
+  </Tab>
+  <Tab label="Claude Code" value="claude-code">
 
-这会将 `intlayer-lsp` 二进制文件放入您的 PATH 中，这是插件的 `lspServers` 条目所调用的。
+Intlayer 提供了一个托管在 Intlayer 仓库中的 **Claude Code 插件**。它让 Claude Code 能真正解析字典键的符号，而不必退回到 `grep`。
 
-### 2. 注册 Intlayer 市场并安装插件
+先把可执行文件放入 `PATH`，然后注册 marketplace 并安装插件：
 
 ```bash
+npm install -g @intlayer/lsp
+
 claude plugin marketplace add intlayer@github:aymericzip/intlayer
 claude plugin install intlayer-lsp@intlayer
-claude plugin enable intlayer-lsp@intlayer
 ```
 
-Claude Code 将把 `"intlayer-lsp@intlayer": true` 添加到您的 `enabledPlugins` 中，并在支持的文件类型（`.ts`、`.tsx`、`.js`、`.jsx`、`.vue`、`.svelte`）上自动启动语言服务器。
+`install` 同时会启用该插件。**请重启 Claude Code** —— 语言服务器在启动时加载，因此在重启前插件不会生效。
 
-### 3. 启用 LSP 工具（如果尚未激活）
+之后 Claude Code 会在 `.ts`、`.tsx`、`.js`、`.jsx`、`.vue`、`.astro` 和 `.svelte` 文件上启动该服务器，并在浏览代码时使用 `goToDefinition`、`findReferences` 和 `hover`。
 
-某些 Claude Code 版本需要设置 LSP 功能标志。如果在安装后“转到定义”不起作用，请将以下内容添加到 `~/.claude/settings.json` 中：
+如果转到定义仍然没有反应，你使用的 Claude Code 版本可能通过一个开关来控制 LSP 工具：
 
 ```json fileName="~/.claude/settings.json"
 {
@@ -129,61 +133,10 @@ Claude Code 将把 `"intlayer-lsp@intlayer": true` 添加到您的 `enabledPlugi
 }
 ```
 
-重启 Claude Code —— 在导航 Intlayer 代码库时，它现在将使用 `goToDefinition`、`findReferences` 和其他 LSP 操作，而不是回退到 `grep`。
-
----
-
-## 在 VS Code 中设置（通过扩展程序 —— 推荐）
-
-如果安装了 [Intlayer VS Code 扩展程序](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)，语言服务器将自动启动。无需其他配置。 自 v8.12.0 版本起，LSP 已直接集成到 VSCode 扩展中。
-
-> 有关安装和其他功能，请参阅 [VS Code 扩展程序文档](https://intlayer.org/doc/vs-code-extension)。
-
----
-
-## 在 VS Code 中手动设置
-
-如果您没有使用 Intlayer 扩展程序，可以使用通用的 LSP 客户端扩展程序（例如 [**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter)）或通过编写您自己的小型扩展程序来手动连接语言服务器。推荐的方法是使用 Intlayer 扩展程序。
-
-作为参考，服务器通过 stdio 上的 `intlayer-lsp` 二进制文件启动：
-
-```json fileName=".vscode/settings.json"
-{
-  "intlayer.languageServer.command": "npx",
-  "intlayer.languageServer.args": ["@intlayer/lsp"]
-}
-```
-
-Intlayer 扩展程序读取这些设置以启动服务器。如果您仅依赖该扩展程序，则不需要手动设置。
-
----
-
-## 在 Cursor 中设置
-
-[Cursor](https://www.cursor.com/) 是一个具有内置 AI 功能的 VS Code 分支。它使用相同的扩展生态系统，因此 **Intlayer VS Code 扩展程序**无需任何额外配置即可工作 —— 安装一次，Cursor 就会自动加载它。
-
-如果您更喜欢手动配置，Cursor 也会从工作区根目录读取 `.vscode/settings.json`，因此上面的 VS Code 代码片段直接适用。
-
----
-
-## 在 Windsurf 中设置
-
-[Windsurf](https://windsurf.com/)（由 Codeium 提供）是另一个基于 VS Code 的编辑器。从 VS Code 市场安装 Intlayer 扩展程序，语言服务器将自动激活，就像在 VS Code 和 Cursor 中一样。
-
-对于手动配置，在项目根目录下创建 `.vscode/settings.json`：
-
-```json fileName=".vscode/settings.json"
-{
-  "intlayer.languageServer.command": "npx",
-  "intlayer.languageServer.args": ["@intlayer/lsp"]
-}
-```
-
----
-
-## 在 Zed 中设置
+  </Tab>
+  <Tab label="Zed" value="zed">
 
-[Zed](https://zed.dev/) 通过其语言设置具有原生的 LSP 支持。在您的 Zed 用户设置中添加一个条目（`~/.config/zed/settings.json`）：
+Zed 原生支持 LSP。请将该服务器添加到用户设置中：
 
 ```json fileName="~/.config/zed/settings.json"
 {
@@ -196,47 +149,21 @@ Intlayer 扩展程序读取这些设置以启动服务器。如果您仅依赖
     }
   },
   "languages": {
-    "TypeScript": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "TSX": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "JavaScript": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "Vue.js": {
-      "language_servers": ["intlayer-lsp", "..."]
-    },
-    "Svelte": {
-      "language_servers": ["intlayer-lsp", "..."]
-    }
+    "TypeScript": { "language_servers": ["intlayer-lsp", "..."] },
+    "TSX": { "language_servers": ["intlayer-lsp", "..."] },
+    "JavaScript": { "language_servers": ["intlayer-lsp", "..."] },
+    "Vue.js": { "language_servers": ["intlayer-lsp", "..."] },
+    "Svelte": { "language_servers": ["intlayer-lsp", "..."] }
   }
 }
 ```
 
-`"..."` 占位符告诉 Zed 将其默认的语言服务器与 Intlayer 的语言服务器一起保留。
-
----
-
-## 设置 AI 智能助手命令行界面（Claude Code、Codex 等）
-
-**Claude Code** 具有一流的 LSP 插件支持 —— 遵循上面的 [Claude Code 插件设置](#设置为-claude-code-插件)以直接在您的终端会话中获得完整的“转到定义”体验。
+`"..."` 占位符可让 Zed 的默认语言服务器与 Intlayer 的服务器共存。
 
-**OpenAI Codex** 和其他基于终端的工具尚不能充当 LSP 客户端 —— 它们直接读取和写入文件，而不是维护持久的语言服务器会话。对于这些工具，运行 LSP 的价值是间接带来的：当服务器在伴侣编辑器（VS Code、Cursor、Windsurf……）中激活时，编辑器的实时索引可供任何能够通过编辑器提供的上下文（例如，Cursor Composer、Windsurf Cascade、GitHub Copilot Chat）查询它的 AI 助手使用。
+  </Tab>
+  <Tab label="Neovim" value="neovim">
 
-如果您完全在终端中工作且没有打开编辑器，则可以在后台启动语言服务器，以便它为以后连接到同一工作区的任何编辑器做好准备：
-
-```bash
-# 在后台保持服务器运行
-npx @intlayer/lsp &
-```
-
----
-
-## 在 Neovim 中手动设置
-
-使用 [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)，注册自定义服务器配置：
+使用 [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig) 注册一个自定义服务器配置：
 
 ```lua fileName="~/.config/nvim/init.lua"
 local lspconfig = require('lspconfig')
@@ -245,7 +172,7 @@ local configs = require('lspconfig.configs')
 if not configs.intlayer_lsp then
   configs.intlayer_lsp = {
     default_config = {
-      -- 使用 npx 启动服务器，因此您不需要全局安装
+      -- 用 npx 启动服务器，这样就不需要全局安装
       cmd = { 'npx', '--yes', '@intlayer/lsp' },
       filetypes = {
         'typescript',
@@ -267,21 +194,10 @@ end
 lspconfig.intlayer_lsp.setup({})
 ```
 
-重启 Neovim 后，在 Intlayer 键上按 `gd` 将调用“转到定义”。
-
----
-
-## 在其他编辑器中手动设置
-
-任何支持语言服务器协议的编辑器都可以使用 `@intlayer/lsp`。服务器：
+重启 Neovim 后，在字典键上按 `gd` 会执行转到定义，按 `gr` 会执行查找引用。
 
-- **传输** – Node.js IPC / stdio (标准)
-- **可执行文件** – `npx @intlayer/lsp` (或本地安装的 `intlayer-lsp` 二进制文件)
-- **能力** – `definitionProvider: true`, `textDocumentSync: Incremental`
-
-请参阅您的编辑器 LSP 文档以获取确切的配置格式（例如，[coc.nvim](https://github.com/neoclide/coc.nvim) 的 `languageserver.json`，或 [Helix](https://helix-editor.com) 中的 LSP 客户端设置）。
-
-### 示例：coc.nvim
+  </Tab>
+  <Tab label="coc.nvim" value="coc">
 
 ```json fileName="~/.config/nvim/coc-settings.json"
 {
@@ -307,9 +223,14 @@ lspconfig.intlayer_lsp.setup({})
 }
 ```
 
-### 示例：Helix
+  </Tab>
+  <Tab label="Helix" value="helix">
 
 ```toml fileName="~/.config/helix/languages.toml"
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+
 [[language]]
 name = "typescript"
 language-servers = ["intlayer-lsp", "typescript-language-server"]
@@ -317,36 +238,54 @@ language-servers = ["intlayer-lsp", "typescript-language-server"]
 [[language]]
 name = "tsx"
 language-servers = ["intlayer-lsp", "typescript-language-server"]
-
-[language-server.intlayer-lsp]
-command = "npx"
-args = ["@intlayer/lsp"]
 ```
 
+  </Tab>
+  <Tab label="其他编辑器" value="other">
+
+任何支持 LSP 的编辑器都可以运行 `@intlayer/lsp`。请将其指向：
+
+- **可执行文件** —— `npx @intlayer/lsp`，或 `intlayer-lsp` 可执行文件
+- **传输方式** —— stdio（标准）
+- **能力** —— `definitionProvider`、`referencesProvider`、`hoverProvider`、`completionProvider`（触发字符 `"` `'` `` ` `` `.`）、推送式诊断、`textDocumentSync: Incremental`
+- **根目录匹配模式** —— `intlayer.config.ts`、`intlayer.config.js`、`package.json`
+
+确切的配置格式请查阅你所用编辑器的 LSP 文档。
+
+  </Tab>
+</Tabs>
+
 ---
 
-## 工作原理
+## 关于终端 AI 智能体的说明
 
-当服务器启动时，它会使用 `getConfiguration()` 从工作区根目录解析 Intlayer 配置。这为它提供了查找已编译字典所需的 `build` 和 `system` 路径。
+**Claude Code** 是一个真正的 LSP 客户端 —— 参见上面的标签页。
 
-在每个**转到定义**请求上：
+**OpenAI Codex** 及大多数其他终端工具并不是 LSP 客户端：它们直接读写文件。单独运行服务器对它们没有帮助；真正的价值在于服务器在一个配套编辑器中处于活跃状态，而智能体可以查询该编辑器的索引（Cursor Composer、Windsurf Cascade、Copilot Chat）。
 
-1. 服务器读取打开文档的全文。
-2. 它使用正则表达式扫描获取器调用（`useIntlayer`、`getIntlayer` 等）。
-3. 它检查光标位置是否落在这些调用之一的内部。
-4. 如果是，它将提取字典键（正则表达式的捕获组 3），并调用 `getUnmergedDictionaries()` 来定位声明该键的每个内容文件。
-5. 它读取每个匹配的文件，并找到包含 `key: "<key>"` 的确切行，以精确地定位光标。
-6. 它返回一个 `Location` 对象数组 —— 每个源文件一个。
+---
 
-配置会被懒惰地解析并在每个会话中缓存；它在每个 `initialize` 请求（例如，当您打开一个新的工作区文件夹时）重置。
+## 工作原理
+
+对每个文件，服务器会定位最近的 `intlayer.config.*`，加载该项目的配置以找到已编译的字典。配置、字典和源文件列表会以较短的 TTL 缓存，并在被监听的内容文件发生变化时失效。
+
+收到请求时，服务器会（通过 [oxc](https://oxc.rs/)）解析文档并检查光标位置：
+
+1. **位于键字符串上**（`useIntlayer("home")`）→ 返回声明该键的每个内容文件，并定位到其 `key:` 所在行。
+2. **位于字段使用处**（`content.title`、解构出的属性、`t('path.to.field')`、`<Trans>` 等）→ 将变量回溯到其字典，并返回内容文件中对应的字段。
+3. **从内容文件出发** → 执行反向查找，扫描项目源码以寻找该键或字段的调用点。
 
 ---
 
-## 故障排除
+## 故障排查
+
+| 现象                                    | 可能原因           | 解决办法                                               |
+| --------------------------------------- | ------------------ | ------------------------------------------------------ |
+| 完全没有反应                            | 服务器未运行       | 检查是否已安装 `@intlayer/lsp`，以及编辑器是否会启动它 |
+| 在编辑器中可用，在 Claude Code 中不可用 | 会话中途安装了插件 | 重启 Claude Code —— 语言服务器在启动时加载             |
+| 找不到某个键的定义                      | 字典尚未构建       | 运行 `npx intlayer build`，或启动开发服务器            |
+| 所有键都被报告为未声明                  | 配置未解析         | 确认项目根目录存在 `intlayer.config.ts`（或 `.js`）    |
+| 在 monorepo 中使用了错误的项目          | 缺少各自的包级配置 | 为每个声明自有内容的包添加 `intlayer.config.*`         |
+| 服务器启动时崩溃                        | Node.js 版本过低   | 需要 Node.js ≥ 14.18                                   |
 
-| 症状                     | 可能的原因       | 解决方法                                                    |
-| ------------------------ | ---------------- | ----------------------------------------------------------- |
-| 转到定义不起作用         | 服务器未运行     | 检查是否已安装 `@intlayer/lsp` 且编辑器正在启动它           |
-| 检测到错误的工作区根目录 | 多个工作区文件夹 | 确保包含 `intlayer.config.ts` 的文件夹是第一个工作区文件夹  |
-| 找不到键的定义           | 配置未解析       | 验证工作区根目录下是否存在 `intlayer.config.ts`（或 `.js`） |
-| 服务器在启动时崩溃       | Node.js 版本太旧 | 需要 Node.js ≥ 14.18                                        |
+在 VS Code 中，服务器会将日志输出到 **查看 → 输出 → “Intlayer LSP”** —— 便于确认解析到的是哪份配置以及找到了多少字典。

package/docs/zh/readme.md

@@ -46,27 +46,27 @@ Intlayer 是面向 Web 和移动应用程序的**现代国际化解决方案**
 
 ## Intlayer 的主要优势：
 
-| 功能                                                                                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **多框架支持**<br><br>Intlayer 兼容所有主流框架和库，包括 Next.js、React、Vite、Vue.js、Nuxt、Preact、Express 等。                                                                                                                                                                                                                                                                                                                                |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **基于 JavaScript 的内容管理**<br><br>利用 JavaScript 的灵活性高效地定义和管理您的内容。<br><br> - [内容声明](https://intlayer.cn/doc/concept/content)                                                                                                                                                                                                                                                                                            |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **按语言区分的内容声明文件**<br><br>通过在自动生成之前声明一次内容，加快您的开发速度。<br><br> - [按语言区分的内容声明文件](https://intlayer.cn/doc/concept/per-locale-file)                                                                                                                                                                                                                                                                      |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **编译器**<br><br>Intlayer 编译器自动从组件中提取内容并创建词典文件。<br><br> - [编译器](https://intlayer.cn/doc/compiler)                                                                                                                                                                                                                                                                                                                        |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **类型安全环境**<br><br>利用 TypeScript 确保您的内容定义和代码无错误，同时享受 IDE 自动补全的便利。<br><br> - [TypeScript 配置](https://intlayer.cn/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                                          |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **简化设置**<br><br>通过最少的配置快速启动。轻松调整国际化、路由、AI、构建和内容管理的设置。<br><br> - [探索 Next.js 集成](https://intlayer.cn/doc/environment/nextjs)                                                                                                                                                                                                                                                                            |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **简化内容获取**<br><br>无需为每一条内容调用 `t` 函数。使用单一钩子即可直接获取所有内容。<br><br> - [React 集成](https://intlayer.cn/doc/environment/create-react-app)                                                                                                                                                                                                                                                                            |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **一致的服务器组件实现**<br><br>完美适用于 Next.js 服务器组件，客户端和服务器组件使用相同的实现，无需在每个服务器组件之间传递您的 `t` 函数。<br><br> - [服务器组件](https://intlayer.cn/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                                                                               |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **有序的代码库**<br><br>保持代码库更有条理：1 个组件 = 同一文件夹中的 1 个词典。翻译内容靠近各自的组件，提高可维护性和清晰度。<br><br> - [Intlayer 如何工作](https://intlayer.cn/doc/concept/how-works-intlayer)                                                                                                                                                                                                                                  |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **增强的路由功能**<br><br>全面支持应用路由，能够无缝适应复杂的应用结构，适用于 Next.js、React、Vite、Vue.js 等框架。<br><br> - [探索 Next.js 集成](https://intlayer.cn/doc/environment/nextjs)                                                                                                                                                                                                                                                    |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown 支持**<br><br>导入并解析本地文件和远程 Markdown，用于多语言内容，如隐私政策、文档等。解析并使 Markdown 元数据在代码中可访问。<br><br> - [内容文件](https://intlayer.cn/doc/concept/content/file)                                                                                                                                                                                                                                       |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **免费可视化编辑器和 CMS**<br><br>为内容创作者提供免费的可视化编辑器和 CMS，免去了使用本地化平台的需求。通过 Git 保持内容同步，或使用 CMS 完全或部分外部化内容。<br><br> - [Intlayer 编辑器](https://intlayer.cn/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.cn/doc/concept/cms)                                                                                                                                                   |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **可摇树内容**<br><br>可摇树内容，减少最终包的大小。按组件加载内容，排除包中未使用的内容。支持延迟加载以提高应用程序加载效率。<br><br> - [应用构建优化](https://intlayer.cn/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                                                                                                                |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **静态渲染**<br><br>不阻塞静态渲染。<br><br> - [Next.js 集成](https://intlayer.cn/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                                         |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI 驱动的翻译**<br><br>使用 Intlayer 先进的 AI 驱动翻译工具，结合您自己的 AI 提供商 / API 密钥，只需一键即可将您的网站转换为 231 种语言。<br><br> - [CI/CD 集成](https://intlayer.cn/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.cn/doc/concept/cli) <br> - [自动填充](https://intlayer.cn/doc/concept/auto-fill)                                                                                                                 |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP 服务器集成**<br><br>提供一个 MCP (模型上下文协议) 服务器，用于 IDE 自动化，使内容管理和 i18n 工作流程能够直接在您的开发环境中无缝进行。<br><br> - [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)                                                                                                                                                                                                 |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode 扩展**<br><br>Intlayer 提供了一个 VSCode 扩展，帮助您管理内容和翻译、构建词典、翻译内容等。<br><br> - [VSCode 扩展](https://intlayer.cn/doc/vs-code-extension)                                                                                                                                                                                                                                                                           |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **互操作性**<br><br>允许与 react-i18next、next-i18next、next-intl、react-intl、vue-i18n 进行互操作。<br><br> - [Intlayer 与 react-intl](https://intlayer.cn/blog/intlayer-with-react-intl) <br> - [Intlayer 与 next-intl](https://intlayer.cn/blog/intlayer-with-next-intl) <br> - [Intlayer 与 next-i18next](https://intlayer.cn/blog/intlayer-with-next-i18next) <br> - [Intlayer 与 vue-i18n](https://intlayer.cn/blog/intlayer-with-vue-i18n) |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **性能与基准测试**<br><br>使用先进的摇树优化（tree-shaking）和动态加载来提高性能，并使解决方案保持尽可能轻量。 <br><br> - [性能与基准测试](https://intlayer.cn/doc/benchmark)                                                                                                                                                                                                                                                                     |
+| 功能                                                                                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **多框架支持**<br><br>Intlayer 兼容所有主流框架和库，包括 Next.js、React、Vite、Vue.js、Nuxt、Preact、Express 等。                                                                                                                                                                                                                                                                                                                                                                                                    |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **基于 JavaScript 的内容管理**<br><br>利用 JavaScript 的灵活性高效地定义和管理您的内容。<br><br> - [内容声明](https://intlayer.cn/doc/concept/content)                                                                                                                                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **按语言区分的内容声明文件**<br><br>通过在自动生成之前声明一次内容，加快您的开发速度。<br><br> - [按语言区分的内容声明文件](https://intlayer.cn/doc/concept/per-locale-file)                                                                                                                                                                                                                                                                                                                                          |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **编译器**<br><br>Intlayer 编译器自动从组件中提取内容并创建词典文件。<br><br> - [编译器](https://intlayer.cn/doc/compiler)                                                                                                                                                                                                                                                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **类型安全环境**<br><br>利用 TypeScript 确保您的内容定义和代码无错误，同时享受 IDE 自动补全的便利。<br><br> - [TypeScript 配置](https://intlayer.cn/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **简化设置**<br><br>通过最少的配置快速启动。轻松调整国际化、路由、AI、构建和内容管理的设置。<br><br> - [探索 Next.js 集成](https://intlayer.cn/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **简化内容获取**<br><br>无需为每一条内容调用 `t` 函数。使用单一钩子即可直接获取所有内容。<br><br> - [React 集成](https://intlayer.cn/doc/environment/create-react-app)                                                                                                                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **一致的服务器组件实现**<br><br>完美适用于 Next.js 服务器组件，客户端和服务器组件使用相同的实现，无需在每个服务器组件之间传递您的 `t` 函数。<br><br> - [服务器组件](https://intlayer.cn/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **有序的代码库**<br><br>保持代码库更有条理：1 个组件 = 同一文件夹中的 1 个词典。翻译内容靠近各自的组件，提高可维护性和清晰度。<br><br> - [Intlayer 如何工作](https://intlayer.cn/doc/concept/how-works-intlayer)                                                                                                                                                                                                                                                                                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **增强的路由功能**<br><br>全面支持应用路由，能够无缝适应复杂的应用结构，适用于 Next.js、React、Vite、Vue.js 等框架。<br><br> - [探索 Next.js 集成](https://intlayer.cn/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                        |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown 支持**<br><br>导入并解析本地文件和远程 Markdown，用于多语言内容，如隐私政策、文档等。解析并使 Markdown 元数据在代码中可访问。<br><br> - [内容文件](https://intlayer.cn/doc/concept/content/file)                                                                                                                                                                                                                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **免费可视化编辑器和 CMS**<br><br>为内容创作者提供免费的可视化编辑器和 CMS，免去了使用本地化平台的需求。通过 Git 保持内容同步，或使用 CMS 完全或部分外部化内容。<br><br> - [Intlayer 编辑器](https://intlayer.cn/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.cn/doc/concept/cms)                                                                                                                                                                                                                       |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **可摇树内容**<br><br>可摇树内容，减少最终包的大小。按组件加载内容，排除包中未使用的内容。支持延迟加载以提高应用程序加载效率。<br><br> - [应用构建优化](https://intlayer.cn/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                                                                                                                                                                                    |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **静态渲染**<br><br>不阻塞静态渲染。<br><br> - [Next.js 集成](https://intlayer.cn/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI 驱动的翻译**<br><br>使用 Intlayer 先进的 AI 驱动翻译工具，结合您自己的 AI 提供商 / API 密钥，只需一键即可将您的网站转换为 231 种语言。<br><br> - [CI/CD 集成](https://intlayer.cn/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.cn/doc/concept/cli) <br> - [自动填充](https://intlayer.cn/doc/concept/auto-fill)                                                                                                                                                                                     |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP 服务器集成**<br><br>提供一个 MCP (模型上下文协议) 服务器，用于 IDE 自动化，使内容管理和 i18n 工作流程能够直接在您的开发环境中无缝进行。<br><br> - [MCP 服务器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/mcp_server.md)                                                                                                                                                                                                                                                                     |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode 扩展**<br><br>Intlayer 提供了一个 VSCode 扩展，帮助您管理内容和翻译、构建词典、翻译内容等。<br><br> - [VSCode 扩展](https://intlayer.cn/doc/vs-code-extension)                                                                                                                                                                                                                                                                                                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **互操作性**<br><br>允许与 react-i18next、next-i18next、next-intl、react-intl、vue-i18n 进行互操作。<br><br> - [Intlayer 与 react-intl](https://intlayer.cn/blog/intlayer-with-react-intl) <br> - [Intlayer 与 next-intl](https://intlayer.cn/blog/intlayer-with-next-intl) <br> - [Intlayer 与 next-i18next](https://intlayer.cn/blog/intlayer-with-next-i18next) <br> - [Intlayer 与 vue-i18n](https://intlayer.cn/blog/intlayer-with-vue-i18n) <br> - [Intlayer 兼容适配器](https://intlayer.cn/doc/compatibility) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **性能与基准测试**<br><br>使用先进的摇树优化（tree-shaking）和动态加载来提高性能，并使解决方案保持尽可能轻量。 <br><br> - [性能与基准测试](https://intlayer.cn/doc/benchmark)                                                                                                                                                                                                                                                                                                                                         |
 
 ---