@intlayer/docs 9.3.2 → 9.4.0-canary.0

package/docs/zh/intlayer_with_solid_start.md

@@ -78,7 +78,7 @@ Intlayer 经过优化，可与 Solid 完美配合，提供**组件级内容划
 
 <Accordion header="AI 代理">
 
-将内容协同定位**减少了大语言模型 (LLM) 所需的上下文**。Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发人员体验 (DX) 更加顺畅。
+将内容协同定位**减少了大语言模型 (LLM) 所需的上下文**。Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发人员体验 (DX) 更加顺畅。
 
 </Accordion>
 

package/docs/zh/intlayer_with_storybook.md

@@ -50,7 +50,7 @@ Intlayer 经过优化，可与 Storybook 完美配合，提供**多语言故事
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_svelte_kit.md

@@ -78,7 +78,7 @@ Intlayer 经过优化，可与 SvelteKit 完美配合，提供**多语言路由*
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_tanstack+solid.md

@@ -57,7 +57,7 @@ Intlayer 经过优化，可与 TanStack Start 和 Solid 完美配合，提供**
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_tanstack.md

@@ -74,7 +74,7 @@ Intlayer 针对 TanStack Start 进行了全面优化，提供**多语言路由**
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_vanilla.md

@@ -76,7 +76,7 @@ Intlayer 经过优化，可与 Vanilla JavaScript 完美配合，提供**与框
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_vite+lit.md

@@ -76,7 +76,7 @@ Intlayer 经过优化，可与 Lit 完美配合，提供 **Web 组件级内容
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_vite+preact.md

@@ -83,7 +83,7 @@ Intlayer 经过优化，可与 Preact 完美配合，提供**组件级内容范
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_vite+react.md

@@ -55,7 +55,7 @@ Intlayer 经过优化，可与 Vite 和 React 完美配合，提供**组件级
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_vite+svelte.md

@@ -89,7 +89,7 @@ Intlayer 经过优化，可与 Svelte 完美配合，提供**组件级内容范
 
 <Accordion header="人工智能代理">
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 </Accordion>
 

package/docs/zh/intlayer_with_vite+vanilla.md

@@ -77,7 +77,7 @@ Intlayer 经过优化，可与 Vite 完美配合，提供**与框架无关的内
 
 **人工智能代理**
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 **自动化**
 

package/docs/zh/intlayer_with_vite+vue.md

@@ -64,7 +64,7 @@ Intlayer 经过优化，可与 Vue 完美配合，提供**组件级内容范围*
 
 <Accordion header="人工智能代理">
 
-共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent技能](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
+共置内容**减少大型语言模型 (LLM) 所需的上下文**。 Intlayer 还附带了一套工具，例如用于测试缺失翻译的 **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** 和 **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/agent_skills.md)**，使 AI 代理的开发者体验 (DX) 更加流畅。
 
 </Accordion>
 

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/intlayer/getLocalizedPath.md

@@ -128,6 +128,20 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 
 ---
 
+### 省略 Locale
+
+当未提供 locale 时，路径将针对配置的默认 locale 进行本地化：
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// 配置：defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// 输出："/about"
+```
+
+---
+
 ## 相关函数
 
 - [`getCanonicalPath`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/packages/intlayer/getCanonicalPath.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

@@ -115,4 +115,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-TW/bundle_optimization.md

@@ -159,7 +159,7 @@ pnpm add -D webpack-bundle-analyzer
 bun add -d webpack-bundle-analyzer
 ```
 
-```typescript fileName="webpack.config.ts
+```typescript fileName="webpack.config.ts"
 import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
 
 export default {
@@ -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/docs/zh-TW/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: ESLint 外掛 | Intlayer 的 Lint 規則
 description: 使用 eslint-plugin-intlayer 捕捉硬編碼字串、Intlayer 編譯器無法最佳化的動態呼叫以及未使用的字典內容。支援 ESLint 與 oxlint，適用於 React、Vue、Svelte、Angular 與 Astro。
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-需要 ESLint 9 或更高版本（Flat config）。
+需要 ESLint 9 或更高版本（Flat config）。支援 ESLint 10。
 
 ## 使用方法
 
@@ -61,20 +61,20 @@ yarn add --dev eslint-plugin-intlayer
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-或者逐一啟用規則：
+或者展開某個設定並自行指定嚴重程度：
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ const { title } = useIntlayer("home");
 
 **設定選項**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ export default {
 
 **設定選項**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ export default {
 | Angular 範本              | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.3.2",
+  "version": "9.4.0-canary.0",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,13 +73,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.3.2",
-    "@intlayer/core": "9.3.2",
-    "@intlayer/types": "9.3.2"
+    "@intlayer/config": "9.4.0-canary.0",
+    "@intlayer/core": "9.4.0-canary.0",
+    "@intlayer/types": "9.4.0-canary.0"
   },
   "devDependencies": {
-    "@intlayer/api": "9.3.2",
-    "@intlayer/cli": "9.3.2",
+    "@intlayer/api": "9.4.0-canary.0",
+    "@intlayer/cli": "9.4.0-canary.0",
     "@types/node": "26.2.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
@@ -88,7 +88,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "engines": {
     "node": ">=14.18"