@intlayer/docs 9.5.2 → 9.5.4-canary.0

package/docs/zh/intlayer_with_vite+react.md

@@ -957,7 +957,7 @@ Intlayer 使用模块扩展 (module augmentation) 来利用 TypeScript 的优势
 
 ![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.webp?raw=true)
 
 确保你的 TypeScript 配置包含了自动生成的类型。
 

package/docs/zh/intlayer_with_vite+vue.md

@@ -1100,7 +1100,7 @@ Intlayer 使用模块扩展 (module augmentation) 来利用 TypeScript 的优势
 
 ![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.webp?raw=true)
 
 确保你的 TypeScript 配置包含了自动生成的类型。
 

package/docs/zh/introduction.md

@@ -179,7 +179,6 @@ Intlayer 提供了多种功能，旨在满足现代 Web 开发的需求。以下
 - **[Intlayer 与 Tanstack Start + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_tanstack+solid.md)**
 - **[Intlayer 与 Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_vite+react.md)**
 - **[Intlayer 与 React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_router_v7.md)**
-- **[Intlayer 与 React Router v7 (fs-routes)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_router_v7_fs_routes.md)**
 - **[Intlayer 与 React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_create_react_app.md)**
 - **[Intlayer 与 React Native 及 Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_react_native+expo.md)**
 - **[Intlayer 与 Lynx 及 React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_with_lynx+react.md)**

package/docs/zh/readme.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://intlayer.cn" rel="">
-    <img src="https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/cover.png" width="60%" alt="Intlayer 标志" />
+    <img src="https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/cover.webp" width="60%" alt="Intlayer 标志" />
   </a>
 </p>
 
@@ -48,10 +48,10 @@ Intlayer 是面向 Web 和移动应用程序的**现代国际化解决方案**
 
 | 功能                                                                                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <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/frameworks.webp?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/compiler.webp?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)                                                                                                                                                                                                                                                                                                                                                |
@@ -59,12 +59,12 @@ Intlayer 是面向 Web 和移动应用程序的**现代国际化解决方案**
 | <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/visual_editor.webp?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.webp?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.webp?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/vscode_extension.webp?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)                                                                                                                                                                                                                                                                                                                                         |
 
@@ -269,7 +269,7 @@ Intlayer 将 **开发人员**、**文案撰写人员** 和 **AI 代理** 连接
 - TMS（翻译管理系统）（例如 Crowdin、Phrase、Lokalise）
 - 无头 CMS（例如 Contentful、Strapi、Sanity）
 
-![CMS Preview](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png?raw=true)
+![CMS Preview](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.webp?raw=true)
 
 ## 🌐 其他语言的 Readme
 

package/docs/zh-TW/bundle_optimization.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-11-25
-updatedAt: 2026-08-09
+updatedAt: 2026-09-16
 title: 最佳化 i18n 打包體積與效能
 description: 透過最佳化國際化（i18n）內容來縮減應用程式包的大小。了解如何利用 Intlayer 實現字典的 tree shaking 和延遲載入（lazy loading）。
 keywords:
@@ -37,6 +37,10 @@ author: aymericzip
 
 例如，一個應用程式有 10 個頁面並被翻譯成了 10 種語言，可能導致使用者為了這 10 個頁面下載所有的內容，儘管他們只想要**一個頁面**的內容（當前語言版本的當前頁面）。這不僅會造成頻寬浪費，也會導致更慢的載入時間。
 
+下圖估算了一個理論應用程式的內容體積：1 到 10 個頁面，翻譯成 1 到 10 種語言，每頁約 30 KB 文字。依 locale 動態載入內容可消除語言維度，依元件或路由劃分內容可消除頁面維度，只有兩者結合才能讓體積保持平穩。
+
+![依架構劃分的理論內容洩漏](https://github.com/aymericzip/intlayer/blob/main/docs/assets/theorical_content_leakage.webp?raw=true)
+
 **Intlayer 透過在建置時（build-time）進行最佳化來解決這一問題。** 它可以分析您的程式碼以檢測每個元件實際使用了哪些字典，並只將必要的內容注入到您的打包結果（bundle）中。
 
 ## 目錄

package/docs/zh-TW/interest_of_intlayer.md

@@ -214,9 +214,9 @@ export const ComponentExample = () => {
 
 | 功能                                                                                                                      | 描述                                                                                                                                                                                                                                                                                                                                                                                                                           |
 | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和庫，包括 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 等。                                                                                                                                                                                                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.webp?raw=true)                         | **跨框架支持**<br><br>Intlayer 兼容所有主流框架和庫，包括 Next.js, React, Vite, Vue.js, Nuxt, Preact, Express 等。                                                                                                                                                                                                                                                                                                             |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript 驅動的內容管理**<br><br>利用 JavaScript 的靈活性來高效地定義和管理你的內容。<br><br> - [內容宣告](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                                       |
-| <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.org/doc/compiler)                                                                                                                                                                                                                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.webp?raw=true" alt="Feature" width="700"> | **編譯器**<br><br>Intlayer 編譯器可自動从組件中提取內容并生成字典文件。<br><br> - [編譯器](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                                  |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **單語言內容宣告文件**<br><br>在自動生成前，通過僅宣告一次你的內容來加速開發。<br><br> - [單語言內容宣告文件](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                                                |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **類型安全環境**<br><br>利用 TypeScript 確保你的內容定義和代码沒有錯誤，同時還能享受 IDE 的自動補全功能。<br><br> - [TypeScript 配置](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **簡易配置**<br><br>僅需極簡的配置即可快速啟動并運行。輕鬆調整國際化、路由、AI、構築以及內容處理的設置。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                            |
@@ -225,12 +225,12 @@ export const ComponentExample = () => {
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **有條理的代码庫**<br><br>保持代码庫更有條理：1 組件 = 在同一文件夾下的 1 個字典。靠近其各自組件的翻譯有助於提高可維護性和清晰度。<br><br> - [Intlayer 運行機制](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                                                          |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **增強的路由功能**<br><br>完全支持應用路由，無縫適應複雜的應用結構，適用於 Next.js, React, Vite, Vue.js 等。<br><br> - [探索 Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                        |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown 支持**<br><br>導入并解譯本地文件以及遠程 Markdown，以獲得隱私政策、文檔等多語言內容。解譯并在你的代码中使 Markdown 元數據可被訪問。<br><br> - [內容文件](https://intlayer.org/doc/concept/content/file)                                                                                                                                                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **免費的可視化編輯器與 CMS**<br><br>視覺編輯器和 CMS 免費向內容創作者開放，消除对第三方本地化平台的依賴。使用 Git 保持內容同步，或使用 CMS 徹底或部分外置管理它。<br><br> - [Intlayer 編輯器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                                                                             |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **構築時搖樹優化 (Tree-shakable) 內容**<br><br>構築時搖樹優化內容，減小最終包的體積。按組件載入內容，并从打包體積中排除 any 未使用的內容。支持懶載入以提高應用載入效率。<br><br> - [應用構築優化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                                                  |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **靜態渲染**<br><br>不阻碍靜態渲染（Static Rendering）。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.webp?raw=true)                      | **免費的可視化編輯器與 CMS**<br><br>視覺編輯器和 CMS 免費向內容創作者開放，消除对第三方本地化平台的依賴。使用 Git 保持內容同步，或使用 CMS 徹底或部分外置管理它。<br><br> - [Intlayer 編輯器](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.webp?raw=true)                             | **構築時搖樹優化 (Tree-shakable) 內容**<br><br>構築時搖樹優化內容，減小最終包的體積。按組件載入內容，并从打包體積中排除 any 未使用的內容。支持懶載入以提高應用載入效率。<br><br> - [應用構築優化](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.webp?raw=true)                   | **靜態渲染**<br><br>不阻碍靜態渲染（Static Rendering）。<br><br> - [Next.js 集成](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                 |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI 驅動翻譯**<br><br>使用您自己的 AI 提供商/API 金鑰，點擊一下即可將您的網站翻譯成 231 種語言，得益於 Intlayer 先進的 AI 翻譯工具。<br><br> - [CI/CD 集成](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [自動填充](https://intlayer.org/doc/concept/auto-fill)                                                                                                 |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP 服務器集成**<br><br>提供用於 IDE 自動化的 MCP（Model Context Protocol）服務器，能夠直接在你的開發環境中實現無縫的內容管理和 i18n 工作流。<br><br> - [MCP 服務器](https://github.com/aymericzip/intlayer/blob/main/docs/zh-TW/mcp_server.md)                                                                                                                                                                              |
-| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode 插件**<br><br>Intlayer 提供 VSCode 插件協助管理你的內容和翻譯，構築你的字典，翻譯你的內容等。<br><br> - [VSCode 插件](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.webp?raw=true)                   | **VSCode 插件**<br><br>Intlayer 提供 VSCode 插件協助管理你的內容和翻譯，構築你的字典，翻譯你的內容等。<br><br> - [VSCode 插件](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                                                     |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **互操作性**<br><br>允許與 react-i18next、next-i18next, next-intl 和 react-intl 互操作。<br><br> - [Intlayer 與 react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer 與 next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer 與 next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer 相容轉接器](https://intlayer.org/doc/compatibility) |
 | 測試缺失翻譯 (CLI/CI)                                                                                                     | ✅ CLI: npx intlayer content test (对 CI 友好的審計)                                                                                                                                                                                                                                                                                                                                                                           |
 
@@ -262,7 +262,7 @@ export const ComponentExample = () => {
 
 GitHub 星星數是衡量項目受歡迎程度、社區信任度以及長期相關性的一個強有力指標。雖然它們不是技術質量的直接度量標準，但它們反映了有多少開發者發現該項目有用，關注其進展並有可能採用它。對於評估項目的價值來說，星星能夠幫助對比替代方案之間的吸引力，並提供有關生態系統增長的見解。
 
-[![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
+[![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
 ## 互操作性
 

package/docs/zh-TW/intlayer_with_angular_21.md

@@ -388,7 +388,7 @@ Intlayer使用模組擴充（Module Augmentation）來獲得TypeScript的好處
 
 ![自動補全](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![翻譯錯誤](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
+![翻譯錯誤](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.webp?raw=true)
 
 請確保您的TypeScript配置包含了自動生成的類型。
 

package/docs/zh-TW/introduction.md

@@ -181,7 +181,6 @@ Intlayer 提供了多種功能，旨在滿足現代 Web 開發的需求。以下
 - **[Intlayer 與 Tanstack Start + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_tanstack+solid.md)**
 - **[Intlayer 與 Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_vite+react.md)**
 - **[Intlayer 與 React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_react_router_v7.md)**
-- **[Intlayer 與 React Router v7 (fs-routes)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_react_router_v7_fs_routes.md)**
 - **[Intlayer 與 React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_create_react_app.md)**
 - **[Intlayer 與 React Native 及 Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_react_native+expo.md)**
 - **[Intlayer 與 Lynx 及 React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh-TW/intlayer_with_lynx+react.md)**

package/frequent_questions/ar/claude_code_token_consumption.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2026-09-13
+updatedAt: 2026-09-13
+title: كيفية تقليل استهلاك رموز Claude Code (Tokens) لتوليد الترجمات
+description: لماذا يستهلك استخدام Claude Code للترجمة الكثير من الرموز، وماذا يقدم Intlayer بدلاً من ذلك (تصفية المفاتيح المترجمة، تقسيم JSON، ترجمة markdown كتلة بكتلة)، وكيفية إعادة استخدام اشتراك Claude عبر claude setup-token.
+keywords:
+  - claude code
+  - tokens
+  - استهلاك الرموز
+  - setup-token
+  - i18n
+  - تدويل
+  - ترجمة
+  - fill
+  - mcp
+  - وكيل
+slugs:
+  - frequent-questions
+  - claude-code-token-consumption
+author: aymericzip
+---
+
+# كيفية تقليل استهلاك رموز Claude Code (Tokens) لتوليد الترجمات
+
+## وصف المشكلة
+
+يُعد الطلب من Claude Code (أو أي وكيل برمجي) ترجمة محتواك الطريقة الأكثر تكلفة على الإطلاق. ففي كل تشغيل، يضطر الوكيل إلى:
+
+- تحميل ملف JSON أو ملف المحتوى كاملاً في سياقه، حتى المفاتيح المترجمة بالفعل.
+- البحث في الملفات المرتبطة لمعرفة مكان المحتوى وطريقة تنظيمه.
+- استنتاج اللغات الناقصة التي ينبغي توليدها.
+- إعادة قراءة تعليماتك المخصصة في كل مرة ("تحويل الروابط بهذا الشكل"، "الإبقاء على اسم العلامة التجارية بالإنجليزية"، "استخدام الصيغة غير الرسمية").
+- إعادة كتابة الملف بأكمله، بما في ذلك الأجزاء التي لم تتغير.
+
+يتم إعادة إرسال كل هذا مع كل جولة محادثة، مما يؤدي إلى تضخم التكلفة وفق معادلة `حجم المحتوى × عدد اللغات × عدد الجولات`، بالإضافة إلى ضرورة اكتشاف أي خلل في التنسيق أو المفاتيح يدوياً.
+
+## ماذا يقدم Intlayer بدلاً من ذلك
+
+تكمن فائدة Intlayer في إنجاز هذا العمل خارج سياق الوكيل، عبر خط معالجة مبني خصيصاً للترجمة:
+
+- **تصفية الترجمات الموجودة مسبقاً** للحد من استهلاك الرموز (Tokens). يتم استبعاد المفاتيح المترجمة بالفعل في ملف JSON، وإرسال المفاتيح الناقصة فقط إلى النموذج.
+- **ترجمة ملفات markdown كتلة بكتلة.** بالنسبة للتوثيق، يقارن الأمران [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/doc-translate.md) و [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/doc-review.md) كل كتلة مع المستند الأساسي ويتجاوزان الكتل المترجمة مسبقاً أو غير المعدلة.
+- **تقسيم ملفات JSON إلى أجزاء (Chunks)** إذا كانت كبيرة جداً، لضمان البقاء في النطاق الأمثل لنافذة السياق.
+- **تسطيح وإعادة بناء ملفات JSON** لتحسين استهلاك الرموز.
+- **إدراج مطالبات مخصصة** للقواعد المحددة لعلامتك التجارية وصياغتك (`applicationContext`، `--custom-instructions`)، لتكتبها مرة واحدة بدلاً من تكرارها في كل محادثة.
+- **التحقق من صحة البنية** لضمان الاتساق ومنع انحراف المفاتيح، مع الحفاظ على التنسيق الأصلي (markdown، HTML، الإدراجات، صيغ الجمع).
+- **إدارة إعادة المحاولة (Retry)** في حال كان الناتج غير منسق بشكل سليم.
+- **جدولة الطلبات ومعالجتها بالتوازي** عبر الملفات والكتل واللغات لزيادة سرعة التنفيذ.
+
+لا يمر أي من هذا عبر سياق الوكيل. القاعدة الأساسية: دع الوكيل يقرر **ماذا** ينبغي تدويله، ودع Intlayer يتكفل بالمهام المتكررة.
+
+## الحل
+
+### 1. إسناد الاستخراج إلى `intlayer extract`
+
+بدلاً من مطالبة الوكيل بإعادة كتابة كل مكوّن يدوياً، دعه ينفذ الأمر [`extract`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/extract.md). يقوم هذا الأمر بنقل النصوص الثابتة إلى ملف `.content` بجانب المكوّن دون تحميل الملف كاملاً في سياق الوكيل.
+
+```bash
+npx intlayer extract --file src/components/Header.tsx
+```
+
+### 2. إسناد الترجمة إلى `intlayer fill`
+
+تجنب تماماً مطالبة الوكيل بالترجمة المباشرة. يقوم الأمر [`fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/fill.md) بتطبيق خط المعالجة المذكور: يرسل المفاتيح الناقصة فقط، ويقسمها إلى أجزاء، ويعالج اللغات بالتوازي، ويكتب النتائج مباشرة داخل ملفات المحتوى الخاصة بك.
+
+```bash
+npx intlayer fill
+```
+
+تساعد بعض الخيارات في تقليص نطاق التشغيل:
+
+- `--git-diff` (أو `--uncommitted`) يعالج القواميس التي تم تعديلها في الفرع الحالي فقط.
+- `--file` أو `--keys` يستهدف ملفات محتوى محددة.
+- `--output-locales fr es` يقصر التشغيل على اللغات التي تحتاج إليها بالفعل الآن.
+- `--skip-metadata` يتخطى توليد العنوان والوصف والوسوم.
+- `--data-serialization toon` يرسل حمولة بيانات أكثر إيجازاً للنموذج (رموز أقل، مع تباين طفيف في الإخراج).
+
+```bash
+npx intlayer fill --git-diff --output-locales fr es --skip-metadata
+```
+
+### 3. ترجمة markdown عبر `doc translate` و `doc review`
+
+مطالبة الوكيل بترجمة ملف `.md` يعني لصق المستند بالكامل، لكل لغة، عند كل تعديل. في المقابل، يعمل الأمران [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/doc-translate.md) و [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/doc-review.md) كتلة بكتلة.
+
+استخدم `doc translate` عندما لا يكون الملف المترجم موجوداً بعد. يقوم بتقسيم markdown وترجمته بالتوازي وكتابة الملفات الهدف:
+
+```bash
+npx intlayer doc translate --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+استخدم `doc review` عندما يكون الملف المترجم موجوداً بالفعل. يقارن كل كتلة مع المستند الأساسي، ويتخطى الكتل المترجمة أو غير المتغيرة، ويرسل الكتل المختلفة فقط:
+
+```bash
+npx intlayer doc review --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+يقبل كلا الأمرين القواعد الخاصة بك مرة واحدة، دون الحاجة لتكرارها في كل موجه:
+
+```bash
+npx intlayer doc translate --custom-instructions "Do not translate URLs. Keep the markdown structure and the code blocks untouched."
+```
+
+هناك وضعان في `doc review` مفيدان عندما يحتاج الوكيل للبقاء في حلقة العمل، دون إجراء أي اتصال بالذكاء الاصطناعي من جانب Intlayer:
+
+- `--mode report` يسجل الكتل التي تحتاج إلى مراجعة مع أرقام الأسطر، حتى يعدل الوكيل هذه الكتل فقط.
+- `--mode synthesis` يوضح فقط المستندات المحدثة وتلك التي لا تزال تحتوي على كتل بحاجة للتعديل.
+
+```bash
+npx intlayer doc review --mode report --locales fr
+```
+
+### 4. تمكين الوكيل من استدعاء واجهة الأوامر CLI عبر خادم MCP
+
+باستخدام [خادم Intlayer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)، يجيب الوكيل اعتماداً على أحدث التوثيقات ويشغل `intlayer fill` أو `intlayer doc review` بنفسه بدلاً من إعادة كتابة المنطق في المحادثة.
+
+```bash
+claude mcp add intlayer npx -y @intlayer/mcp
+```
+
+كما أن تثبيت [Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md) عبر `npx intlayer init skills` يمنع الوكيل من تخمين واجهة برمجة تطبيقات Intlayer وإعادة قراءة التوثيق عند كل مهمة.
+
+### 5. إعادة استخدام اشتراك Claude عبر `claude setup-token`
+
+يؤدي تشغيل إعداد التدويل (i18n) في جلسة Claude Code التفاعلية إلى الاحتفاظ بسجل المحادثة بأكمله في السياق. انقل هذه المعالجة الثقيلة إلى جلسة headless سريعة ومستقلة.
+
+قم بتوليد رمز طويل الأمد من اشتراك Claude الخاص بك:
+
+```bash
+claude setup-token
+```
+
+احفظه كـ `CLAUDE_CODE_OAUTH_TOKEN` (في ملف `.env` أو ضمن أسرار CI)، ثم أعد استخدامه لجلسة تشغيل أحادية تنفذ أوامر Intlayer:
+
+```bash
+CLAUDE_CODE_OAUTH_TOKEN=... claude -p "Run npx intlayer extract on src/components, then npx intlayer fill --uncommitted"
+```
+
+تقتصر هذه الجلسة على ذلك الموجه ومخرجات الأمر فقط، دون حمل سجل محادثتك السابق. يعمل نفس الرمز في [Claude Code GitHub Action](https://github.com/anthropics/claude-code-action) لتشغيل `intlayer fill` عند كل طلب سحب (Pull Request).
+
+> الرمز الصادر عن `claude setup-token` يوثق Claude Code فقط. ولا يمكن استخدامه كمفتاح Anthropic API في `ai.apiKey`. بالنسبة للترجمة نفسها، يستخدم `intlayer fill` [حساب Intlayer](https://app.intlayer.org) الخاص بك (الخطة المجانية مشمولة) أو مفتاح المزود الخاص بك المكوّن في [`ai`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#ai-configuration).
+
+## الملخص
+
+| المهمة                | المسؤول عنها             | الرموز (Tokens) في سياق الوكيل |
+| --------------------- | ------------------------ | ------------------------------ |
+| تحديد ما ينبغي تعريبه | Claude Code              | منخفض                          |
+| استخراج النصوص        | `intlayer extract`       | لا شيء                         |
+| ترجمة المحتوى         | `intlayer fill`          | لا شيء                         |
+| ترجمة التوثيق         | `intlayer doc translate` | لا شيء                         |
+| تحديث التوثيق         | `intlayer doc review`    | لا شيء                         |
+| تشغيل الأوامر         | Headless Claude Code     | الموجه + مخرجات الأمر          |

package/frequent_questions/de/claude_code_token_consumption.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2026-09-13
+updatedAt: 2026-09-13
+title: Wie man den Token-Verbrauch von Claude Code bei Übersetzungen begrenzt
+description: Warum das Übersetzen mit Claude Code Tokens verbrennt, was Intlayer stattdessen tut (bereits übersetzte Schlüssel filtern, JSON aufteilen, Markdown blockweise übersetzen) und wie Sie Ihr Claude-Abonnement mit claude setup-token wiederverwenden.
+keywords:
+  - claude code
+  - tokens
+  - token-verbrauch
+  - setup-token
+  - i18n
+  - internationalisierung
+  - übersetzung
+  - fill
+  - mcp
+  - agent
+slugs:
+  - frequent-questions
+  - claude-code-token-consumption
+author: aymericzip
+---
+
+# Wie man den Token-Verbrauch von Claude Code bei Übersetzungen begrenzt
+
+## Problembeschreibung
+
+Claude Code (oder jeden anderen Programmier-Agenten) mit der Übersetzung Ihrer Inhalte zu beauftragen, ist der teuerste Weg. Bei jedem Durchlauf muss der Agent:
+
+- Die gesamte JSON- oder Inhaltsdatei in seinen Kontext laden, selbst die Schlüssel, die bereits übersetzt sind.
+- Die zugehörigen Dateien durchsuchen, um herauszufinden, wo sich der Inhalt befindet und wie er strukturiert ist.
+- Ermitteln, welche Locales fehlen und generiert werden müssen.
+- Ihre benutzerdefinierten Anweisungen jedes Mal erneut lesen ("URLs auf diese Weise anpassen", "Markennamen auf Englisch belassen", "Du-Form verwenden").
+- Die gesamte Datei neu schreiben, einschließlich der Teile, die sich nicht geändert haben.
+
+All das wird bei jedem Durchlauf erneut übermittelt, sodass die Kosten mit `Größe des Inhalts × Anzahl der Locales × Anzahl der Durchläufe` ansteigen, und jede Abweichung bei Formatierung oder Schlüsseln muss manuell überprüft werden.
+
+## Was Intlayer stattdessen tut
+
+Der Vorteil von Intlayer besteht darin, diese Arbeit außerhalb des Agenten mit einer speziell für Übersetzungen entwickelten Pipeline zu erledigen:
+
+- **Filtert bestehende Übersetzungen**, um den Token-Verbrauch zu begrenzen. Bereits übersetzte Schlüssel in Ihrem JSON werden entfernt und nur die fehlenden an das Modell gesendet.
+- **Übersetzt Markdown blockweise.** Für die Dokumentation vergleichen [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-translate.md) und [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-review.md) jeden Block mit dem Basisdokument und überspringen Blöcke, die bereits übersetzt oder unverändert sind.
+- **Teilt Ihr JSON in Chunks auf**, falls es zu groß ist, um im optimalen Bereich des Kontextfensters zu bleiben.
+- **Flacht Ihr JSON ab und rekonstruiert es**, um den Token-Verbrauch zu optimieren.
+- **Fügt benutzerdefinierte Prompts ein** für spezifische Regeln bezüglich Marke und Wording (`applicationContext`, `--custom-instructions`), sodass Sie diese einmal schreiben, anstatt sie in jeder Konversation zu wiederholen.
+- **Validiert die Struktur**, um Konsistenz zu gewährleisten und Schlüssel-Drift zu verhindern, und bewahrt Formatierungen (Markdown, HTML, Einfügungen, Pluralformen).
+- **Implementiert Wiederholungsversuche (Retry-Management)**, wenn die Ausgabe fehlerhaft ist.
+- **Reiht Anfragen ein und parallelisiert sie** über Dateien, Abschnitte und Locales hinweg, um die Geschwindigkeit zu maximieren.
+
+Nichts davon belastet den Kontext des Agenten. Die Faustregel: Lassen Sie den Agenten entscheiden, **was** internationalisiert werden soll, und überlassen Sie Intlayer die wiederkehrende Arbeit.
+
+## Lösung
+
+### 1. Extraktion an `intlayer extract` delegieren
+
+Anstatt den Agenten jede Komponente manuell umschreiben zu lassen, lassen Sie ihn den Befehl [`extract`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/extract.md) ausführen. Dieser verschiebt hartcodierte Zeichenketten in eine `.content`-Datei neben der Komponente, ohne die gesamte Datei in den Kontext des Agenten zu laden.
+
+```bash
+npx intlayer extract --file src/components/Header.tsx
+```
+
+### 2. Übersetzung an `intlayer fill` delegieren
+
+Bitten Sie den Agenten niemals direkt zu übersetzen. Der Befehl [`fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/fill.md) wendet die oben beschriebene Pipeline an: Er sendet nur die fehlenden Schlüssel, teilt sie auf, verarbeitet die Locales parallel und schreibt das Ergebnis direkt in Ihre Inhaltsdateien zurück.
+
+```bash
+npx intlayer fill
+```
+
+Einige Flags halten den Durchlauf schlank:
+
+- `--git-diff` (oder `--uncommitted`) verarbeitet nur die im aktuellen Branch geänderten Wörterbücher.
+- `--file` oder `--keys` zielt auf bestimmte Inhaltsdateien ab.
+- `--output-locales fr es` beschränkt den Durchlauf auf die Locales, die Sie aktuell wirklich benötigen.
+- `--skip-metadata` überspringt die Generierung von Titel, Beschreibung und Tags.
+- `--data-serialization toon` sendet eine kompaktere Nutzlast an das Modell (weniger Tokens, leicht weniger vorhersehbare Ausgabe).
+
+```bash
+npx intlayer fill --git-diff --output-locales fr es --skip-metadata
+```
+
+### 3. Markdown mit `doc translate` und `doc review` übersetzen
+
+Einen Agenten mit der Übersetzung einer `.md`-Datei zu beauftragen bedeutet, das gesamte Dokument für jedes Locale bei jeder Änderung einzufügen. Die Befehle [`doc translate`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-translate.md) und [`doc review`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-review.md) arbeiten stattdessen blockweise.
+
+Verwenden Sie `doc translate`, wenn die übersetzte Datei noch nicht existiert. Der Befehl teilt das Markdown auf, übersetzt es parallel und erstellt die Zieldateien:
+
+```bash
+npx intlayer doc translate --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+Verwenden Sie `doc review`, wenn die übersetzte Datei bereits existiert. Der Befehl vergleicht jeden Block mit dem Basisdokument, überspringt Blöcke, die bereits übersetzt oder unverändert sind, und sendet nur die abweichenden Blöcke:
+
+```bash
+npx intlayer doc review --doc-pattern "docs/**/*.md" --base-locale en --locales fr es
+```
+
+Beide Befehle übernehmen Ihre Regeln einmalig, anstatt sie in jedem Prompt wiederholen zu müssen:
+
+```bash
+npx intlayer doc translate --custom-instructions "Do not translate URLs. Keep the markdown structure and the code blocks untouched."
+```
+
+Zwei Modi von `doc review` sind nützlich, wenn der Agent ohne KI-Aufrufe seitens Intlayer eingebunden bleiben soll:
+
+- `--mode report` gibt die Blöcke aus, die Aufmerksamkeit erfordern, samt Zeilennummern, sodass der Agent nur diese Blöcke bearbeitet.
+- `--mode synthesis` gibt lediglich an, welche Dokumente aktuell sind und welche noch bearbeitbare Blöcke enthalten.
+
+```bash
+npx intlayer doc review --mode report --locales fr
+```
+
+### 4. Den Agenten die CLI über den MCP-Server aufrufen lassen
+
+Mit dem [Intlayer MCP-Server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/mcp_server.md) antwortet der Agent auf Basis der aktuellen Dokumentation und führt `intlayer fill` oder `intlayer doc review` selbst aus, anstatt die Logik in der Konversation neu zu implementieren.
+
+```bash
+claude mcp add intlayer npx -y @intlayer/mcp
+```
+
+Die Installation der [Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/agent_skills.md) mit `npx intlayer init skills` verhindert zudem, dass der Agent die Intlayer-API erraten und die Dokumentation bei jeder Aufgabe neu lesen muss.
+
+### 5. Das Claude-Abonnement mit `claude setup-token` wiederverwenden
+
+Das Einrichten von i18n in Ihrer interaktiven Claude Code-Sitzung behält den gesamten Konversationsverlauf im Kontext. Verlagern Sie diese arbeitsintensive Aufgabe stattdessen in eine kurze Headless-Sitzung.
+
+Generieren Sie ein langlebiges Token aus Ihrem Claude-Abonnement:
+
+```bash
+claude setup-token
+```
+
+Speichern Sie es als `CLAUDE_CODE_OAUTH_TOKEN` (in einer `.env`-Datei oder in Ihren CI-Secrets) und nutzen Sie es für eine einmalige Sitzung, die die Intlayer-Befehle ausführt:
+
+```bash
+CLAUDE_CODE_OAUTH_TOKEN=... claude -p "Run npx intlayer extract on src/components, then npx intlayer fill --uncommitted"
+```
+
+Die Sitzung enthält lediglich diesen Prompt und die Ausgabe des Befehls, nicht Ihre gesamte Konversation. Dasselbe Token funktioniert auch in der [Claude Code GitHub Action](https://github.com/anthropics/claude-code-action), um `intlayer fill` bei jedem Pull Request auszuführen.
+
+> Das von `claude setup-token` ausgegebene Token authentifiziert ausschließlich Claude Code. Es kann nicht als Anthropic-API-Schlüssel in `ai.apiKey` verwendet werden. Für die eigentliche Übersetzung nutzt `intlayer fill` Ihr [Intlayer-Konto](https://app.intlayer.org) (kostenloser Tarif enthalten) oder Ihren eigenen in [`ai`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md#ai-configuration) konfigurierten Provider-Schlüssel.
+
+## Zusammenfassung
+
+| Aufgabe                           | Wer führt sie aus        | Tokens im Kontext des Agenten |
+| --------------------------------- | ------------------------ | ----------------------------- |
+| Entscheiden, was lokalisiert wird | Claude Code              | Gering                        |
+| Zeichenketten extrahieren         | `intlayer extract`       | Keine                         |
+| Inhalte übersetzen                | `intlayer fill`          | Keine                         |
+| Dokumentation übersetzen          | `intlayer doc translate` | Keine                         |
+| Dokumentation aktualisieren       | `intlayer doc review`    | Keine                         |
+| Befehle ausführen                 | Headless Claude Code     | Prompt + Befehlsausgabe       |