@intlayer/docs 9.3.0 → 9.3.2

package/docs/ru/intlayer_with_tanstack.md

@@ -271,13 +271,15 @@ export default config;
 ```tsx fileName="src/routes/__root.tsx"
 import {
   createRootRouteWithContext,
+  getRouteApi,
   HeadContent,
   Scripts,
 } from "@tanstack/react-router";
 import { defaultLocale, getHTMLTextDir } from "intlayer";
 import { type ReactNode } from "react";
 import { IntlayerProvider } from "react-intlayer";
-import { Route as LocaleRoute } from "./{-$locale}/route";
+
+const localeRoute = getRouteApi("/{-$locale}");
 
 export const Route = createRootRouteWithContext<{}>()({
   head: () => ({
@@ -299,7 +301,7 @@ export const Route = createRootRouteWithContext<{}>()({
 });
 
 function RootDocument({ children }: { children: ReactNode }) {
-  const params = LocaleRoute.useParams();
+  const params = localeRoute.useParams();
   const locale = params?.locale ?? defaultLocale;
 
   return (
@@ -632,7 +634,7 @@ export const LocaleSwitcher: FC = () => {
 
 ```tsx fileName="src/routes/__root.tsx"
 function RootDocument({ children }: { children: ReactNode }) {
-  const params = LocaleRoute.useParams();
+  const params = localeRoute.useParams();
   const locale = params?.locale ?? defaultLocale;
 
   return (

package/docs/ru/lsp.md

@@ -1,12 +1,14 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-05-31
+updatedAt: 2026-08-10
 title: LSP-сервер Intlayer
-description: Узнайте, как языковой сервер Intlayer предоставляет функцию «Перейти к определению» и другие функции IDE для useIntlayer, getIntlayer и связанных вызовов во всех поддерживаемых редакторах.
+description: Узнайте, как языковой сервер Intlayer добавляет переход к определению, поиск ссылок, всплывающие подсказки, автодополнение ключей и диагностику в вашу IDE и вашего ИИ-агента.
 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
 
 # LSP-сервер Intlayer
 
-**Языковой сервер Intlayer (LSP)** — это реализация [протокола языкового сервера (LSP)](https://microsoft.github.io/language-server-protocol/), которая расширяет возможности вашей IDE с помощью интеллектуальных функций, адаптированных под Intlayer. В настоящее время он поддерживает функцию **Перейти к определению (Go to Definition)** для вызовов ключей словаря, позволяя переходить прямо из вызова `useIntlayer("my-key")` в вашем компоненте к файлу `.content.ts`, в котором он объявлен.
+**Языковой сервер Intlayer** — это реализация [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/), которая делает вашу IDE — и вашего ИИ-агента — осведомлёнными об Intlayer. Он связывает вызов вида `useIntlayer("home")` с файлом `.content.ts`, который его объявляет, в обоих направлениях.
 
 ---
 
-## Зачем использовать LSP?
+## Возможности
 
-При использовании Intlayer связь между вызовом вроде `useIntlayer("homepage")` и его объявлением в `src/homepage.content.ts` является неявной. Без инструментов вам придется искать файл вручную. LSP делает эту связь явной:
+| Возможность               | Сочетание клавиш    | Что делает                                                                                              |
+| ------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------- |
+| **Перейти к определению** | `F12` / `Cmd+Клик`  | Перейти от ключа словаря или использования поля к его объявлению в файле контента                       |
+| **Найти все ссылки**      | `Shift+F12`         | Из файла контента показать все места вызова, использующие этот ключ или поле                            |
+| **Всплывающая подсказка** | навести курсор      | Посмотреть поля словаря или переведённое значение поля, не покидая файл                                 |
+| **Автодополнение**        | `"` `'` `` ` `` `.` | Предлагать объявленные ключи словарей внутри геттера и поля контента после `.` или при деструктуризации |
+| **Диагностика**           | автоматически       | Предупреждать, когда ключ не объявлен ни в одном файле контента                                         |
 
-**Понимание ИИ-агентами**
+Стоит знать ещё о двух особенностях:
 
-ИИ-агенты для кодинга (Cursor, Windsurf, GitHub Copilot, Claude Code, Codex) полагаются на языковой сервер для разрешения символов и понимания связей между файлами. При запущенном Intlayer LSP агенты могут отслеживать путь от `useIntlayer("key")` до места объявления ключа, получая точный контекст о доступных ключах контента, структуре каждого словаря и о том, какие файлы следует читать или редактировать.
+- **Объединённые словари** — ключ, разделённый между несколькими файлами контента, возвращает по одному результату на файл, поэтому вы можете перейти к каждому объявлению.
+- **Поддержка монорепозиториев** — сервер находит _ближайший_ к каждому файлу `intlayer.config.*`, поэтому несколько проектов в одном рабочем пространстве получают собственные словари.
 
-**Перейти к определению**
+### Поддерживаемые вызовы
 
-Поместите курсор на любую строку с ключом словаря внутри поддерживаемого вызова геттера и нажмите `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.
 
-**Работает везде**
-
-Поддерживает все пакеты `*-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`).
-
-### Поддерживаемые вызовы геттеров
-
-Сервер обнаруживает следующие вызовы функций и извлекает первый строковый литерал в качестве ключа словаря:
-
-| Функция       | Пример                        |
-| ------------- | ----------------------------- |
-| `useIntlayer` | `useIntlayer("hero")`         |
-| `getIntlayer` | `getIntlayer("hero", locale)` |
-
-Дженерики TypeScript и дополнительные аргументы игнорируются — важен только ключ.
-
-> `useDictionary` и `getDictionary` принимают уже импортированный объект `Dictionary` в качестве первого аргумента вместо строкового ключа, поэтому они не поддерживают функцию «Перейти к определению» и не отслеживаются сервером.
+> Словари читаются из результата сборки, поэтому выполните `npx intlayer build` — или держите dev-сервер запущенным — чтобы серверу было что разрешать.
 
 ---
 
 ## Установка
 
-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`, который редакторы используют в качестве исполняемого файла сервера.
+Установите его глобально (`npm install -g @intlayer/lsp`), если вашему редактору нужен `intlayer-lsp` в `PATH` — это относится к плагину Claude Code и к любой конфигурации ниже, которая вызывает бинарный файл напрямую.
 
 ---
 
-## Настройка в качестве плагина Claude Code
+## Настройка
 
-Intlayer LSP доступен как **плагин Claude Code**, размещенный непосредственно в репозитории Intlayer на GitHub. Его установка дает 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 поставляет **плагин для Claude Code**, размещённый в репозитории Intlayer. Он даёт Claude Code настоящее разрешение символов для ваших ключей словарей вместо отката к `grep`.
 
-### 2. Зарегистрируйте маркетплейс Intlayer и установите плагин
+Поместите бинарный файл в `PATH`, затем зарегистрируйте маркетплейс и установите плагин:
 
 ```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` в список ва
 }
 ```
 
-Перезапустите Claude Code — теперь он будет использовать `goToDefinition`, `findReferences` и другие операции LSP при навигации по вашему коду Intlayer вместо возврата к `grep`.
-
----
-
-## Настройка в VS Code (через расширение — рекомендуется)
-
-Если у вас установлено [расширение Intlayer для VS Code](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), языковой сервер запускается автоматически. Никакой дополнительной настройки не требуется. LSP напрямую интегрирован в расширение VSCode начиная с версии 8.12.0.
-
-> Инструкции по установке и описание других функций см. в [документации расширения 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.
-
-Для справки, сервер запускается через бинарный файл `intlayer-lsp` через stdio:
-
-```json fileName=".vscode/settings.json"
-{
-  "intlayer.languageServer.command": "npx",
-  "intlayer.languageServer.args": ["@intlayer/lsp"]
-}
-```
-
-Расширение Intlayer считывает эти настройки для запуска сервера. Если вы используете только расширение, ручные настройки не требуются.
-
----
-
-## Настройка в Cursor
-
-[Cursor](https://www.cursor.com/) — это форк VS Code со встроенными функциями ИИ. Он использует ту же экосистему расширений, поэтому **расширение Intlayer для VS Code** работает без дополнительной настройки — установите его один раз, и Cursor подхватит его автоматически.
-
-Если вы предпочитаете ручную настройку, Cursor также считывает файл `.vscode/settings.json` из корня рабочей области, поэтому приведенный выше фрагмент кода для VS Code применяется напрямую.
-
----
-
-## Настройка в Windsurf
-
-[Windsurf](https://windsurf.com/) (от Codeium) — еще один редактор на базе VS Code. Установите расширение Intlayer из VS Code Marketplace, и языковой сервер активируется автоматически, точно так же, как в 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 @@ Claude Code добавит `"intlayer-lsp@intlayer": true` в список ва
     }
   },
   "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.
-
----
-
-## Настройка для интерфейсов командной строки ИИ-агентов (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).
+  </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 нажатие `gd` на ключе Intlayer вызовет функцию перехода к определению.
-
----
-
-## Ручная настройка в других редакторах
-
-Любой редактор с поддержкой Language Server Protocol может использовать `@intlayer/lsp`. Характеристики сервера:
+После перезапуска Neovim `gd` на ключе словаря выполняет переход к определению, а `gr` — поиск ссылок.
 
-- **Транспорт** – Node.js IPC / stdio (стандартный)
-- **Исполняемый файл** – `npx @intlayer/lsp` (или локально установленный бинарный файл `intlayer-lsp`)
-- **Возможности** – `definitionProvider: true`, `textDocumentSync: Incremental`
-
-Формат конфигурации для вашего редактора (например, `languageserver.json` для [coc.nvim](https://github.com/neoclide/coc.nvim) или настройки клиента LSP в [Helix](https://helix-editor.com)) смотрите в его документации.
-
-### Пример: 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` (символы-триггеры `"` `'` `` ` `` `.`), push-диагностика, `textDocumentSync: Incremental`
+- **Шаблоны корня** — `intlayer.config.ts`, `intlayer.config.js`, `package.json`
+
+Точный формат конфигурации смотрите в документации LSP вашего редактора.
+
+  </Tab>
+</Tabs>
+
 ---
 
-## Как это работает
+## Примечание об ИИ-агентах в терминале
 
-При запуске сервер считывает конфигурацию Intlayer из корня рабочей области с помощью `getConfiguration()`. Это указывает ему пути `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` установлен и редактор запускает его                 |
-| Неверный корень рабочей области            | Несколько папок рабочей области | Убедитесь, что папка с `intlayer.config.ts` является первой папкой рабочей области |
-| Определения не найдены для ключа           | Конфигурация не разрешена       | Убедитесь, что `intlayer.config.ts` (или `.js`) существует в корне рабочей области |
-| Сервер аварийно завершает работу на старте | Слишком старая версия Node.js   | Требуется Node.js ≥ 14.18                                                          |
+| Симптом                                      | Вероятная причина                 | Решение                                                                      |
+| -------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------- |
+| Ничего не происходит                         | Сервер не запущен                 | Убедитесь, что `@intlayer/lsp` установлен и редактор его запускает           |
+| Работает в редакторе, но не в Claude Code    | Плагин установлен во время сессии | Перезапустите Claude Code — языковые серверы загружаются при старте          |
+| Определения для ключа не найдены             | Словари не собраны                | Выполните `npx intlayer build` или запустите dev-сервер                      |
+| Все ключи отмечены как необъявленные         | Конфигурация не разрешена         | Проверьте, что `intlayer.config.ts` (или `.js`) есть в корне проекта         |
+| В монорепозитории используется не тот проект | Нет конфигурации в пакете         | Добавьте `intlayer.config.*` в каждый пакет, объявляющий собственный контент |
+| Сервер падает при запуске                    | Слишком старая версия Node.js     | Требуется Node.js ≥ 14.18                                                    |
+
+В VS Code сервер пишет логи в **Вид → Вывод → «Intlayer LSP»** — это помогает убедиться, какая конфигурация была разрешена и сколько словарей найдено.