docs: конкретные команды в шаге 5 doctor и предупреждение о предрелизных тегах

plugin/commands/doctor.md

@@ -32,15 +32,18 @@ description: Диагностика установки плагина КОМПА
      `%LOCALAPPDATA%\kompas-mcp\<version>` и дай серверу переустановиться при следующем запуске.
 
 4. **Бинарь на месте и версия совпадает.** Проверь, что `kompas-mcp.exe` лежит рядом с
-   `install.json` в том же каталоге, и его версия (флаг `--version`) совпадает с версией из
-   `server.lock.json`. Расхождение или ошибка запуска — тот же диагноз, что и в пункте 3: удали
-   каталог версии и дай серверу переустановиться.
+   `install.json` в том же каталоге, и что его версия совпадает с версией из `server.lock.json`:
+   `& "$env:LOCALAPPDATA\kompas-mcp\<version>\kompas-mcp.exe" --version` — команда печатает версию
+   и сразу выходит, КОМПАС при этом не запускается. Расхождение или ошибка запуска — тот же
+   диагноз, что и в пункте 3: удали каталог версии и дай серверу переустановиться.
 
-5. **КОМПАС-3D запущен или доступен для запуска.** Сервер подключается к КОМПАС лениво — не при
-   старте MCP-сервера, а при первом вызове инструмента. Убедись, что КОМПАС-3D установлен на этой
-   машине. Если он уже запущен, сервер присоединится к нему; если нет — попробует запустить новый
-   экземпляр сам. Если КОМПАС не установлен вовсе — это и есть причина сбоя: попроси пользователя
-   установить КОМПАС-3D.
+5. **КОМПАС-3D установлен и, возможно, уже запущен.** Сервер подключается к КОМПАС лениво — не при
+   старте MCP-сервера, а при первом вызове инструмента. Проверь двумя командами:
+   `Get-Process KOMPAS* -ErrorAction SilentlyContinue` (запущен ли сейчас) и
+   `Get-ChildItem 'HKLM:\SOFTWARE\Classes\KOMPAS.Application.5' -ErrorAction SilentlyContinue`
+   (зарегистрирован ли COM-класс, то есть установлен ли КОМПАС вообще). Запущен — сервер
+   присоединится к нему; не запущен, но зарегистрирован — попробует запустить новый экземпляр сам;
+   не зарегистрирован — это и есть причина сбоя: попроси пользователя установить КОМПАС-3D.
 
 6. **Проверка соединения инструментами MCP.** Вызови инструмент `kompas_connect` — он либо
    присоединится к уже запущенному КОМПАС, либо запустит новый и покажет окно, и вернёт версию и

src/Kompas.Mcp.Core/Startup/CliArguments.cs

@@ -1,6 +1,13 @@
 namespace Kompas.Mcp.Core.Startup;
 
 /// <summary>Аргументы командной строки хоста, разбираемые до поднятия MCP-сервера.</summary>
+/// <remarks>
+/// Версия печатается из <c>AssemblyVersion</c> (три компонента) и сверяется командой
+/// <c>/kompas:doctor</c> со строкой из <c>server.lock.json</c> посимвольно. <c>AssemblyVersion</c>
+/// хранит только числа, поэтому тег вида <c>v1.2.3-rc.1</c> собрался бы молча, а <c>--version</c>
+/// напечатал бы <c>1.2.3</c> — сверка дала бы ложное расхождение. Предрелизные теги вводить
+/// нельзя, не пересмотрев этот вывод.
+/// </remarks>
 public static class CliArguments
 {
     /// <summary>Запрошена ли печать версии (<c>--version</c> / <c>-v</c>).</summary>