diff --git a/INSTALL.md b/INSTALL.md index 73e01c6..6e123e1 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,5 +1,17 @@ # Инструкция по установке +> ## ⛔ НЕ запускайте установку «от имени администратора» +> +> Откройте **обычное** окно PowerShell. **Не** «Запуск от имени администратора». +> +> Запуск с повышением прав — главная причина отказа: папки в доме агента создаются от +> другой учётной записи, и потом движок не может прочитать свой собственный Python. +> Установка встаёт мгновенно с `Access is denied`, ещё до любой загрузки. Подробно — +> раздел «Если установка остановилась» ниже. +> +> От администратора запускается только `FIX.cmd` (или `WIPE.cmd`) — и только если +> установка уже остановилась. + Агент **AILab SCRUME Agent** — Hermes Agent: личный помощник. Ключ API выдаёт владелец агента — его вы впишете один раз при установке. @@ -10,8 +22,8 @@ | Архив | Что внутри | Размер | |---|---|---| -| `ailab-setup-v<версия>.zip` | агент: персона, настройки, 58 скиллов, установщик | ~1 МБ | -| `hermes-desktop-scrum.zip` | приложение Hermes с фирменным логотипом на пустом чате | ~150 МБ | +| `agent-setup.zip` (в релизе он же `ailab-setup-v<версия>.zip`) | агент: персона, настройки, 58 скиллов, установщик | ~1,2 МБ | +| `app-setup.zip` (он же `hermes-desktop-scrum.zip`) | приложение Hermes с фирменным логотипом на пустом чате | ~158 МБ | Второй архив нужен, чтобы был графический интерфейс с логотипом. Без него агент работает, но только в командной строке и с обычной заставкой Hermes. @@ -43,14 +55,19 @@ 6. создаёт файл ключа и **открывает его в Блокноте** — впишите туда ключ от владельца; 7. проверяет, что агент отвечает; 8. **готовит окружение** (`hermes pm repair`) — окно приложения поднимает бэкенд и ждёт - его ответа 15 секунд, а на неподготовленной машине зависимости ставятся минутами; + его ответа считаные секунды, а на неподготовленной машине зависимости ставятся минутами; поэтому они ставятся заранее. Установка зависимостей идёт с отчётом на экране (на медленном интернете это может занять до 10 минут); -9. **готовит движок для окна** — проверяет, что окно поднимет его сразу, и даёт запас +8b. **готовит движок для окна** — проверяет, что окно поднимет его сразу, и даёт запас по времени. Без этого шага окно на холодной машине решало, что движок не работает, и само уходило в доустановку, где падало с ошибкой «Отказано в доступе»; -10. **скачивает и ставит окно приложения** (~158 МБ) и кладёт **ярлык «AILab SCRUME Agent» - на рабочий стол**. +9. **скачивает и ставит окно приложения** (~158 МБ) и кладёт **ярлык «AILab SCRUME Agent» + на рабочий стол**. + +> **Запускайте установку обычным пользователем — НЕ «от имени администратора».** +> Это главная причина отказа: папки в доме агента уходят другой учётной записи, и потом +> ни движок, ни `pm repair` не могут прочитать свой собственный Python. Подробности — +> в разделе «Если установка остановилась». Больше ничего делать не нужно: после установки запускайте агента ярлыком с рабочего стола. @@ -61,7 +78,7 @@ ### Если качать архивом вручную 1. Скачайте `agent-setup.zip` (в релизе он же `ailab-setup-v<версия>.zip`), распакуйте в пустую папку, запустите - `setup.cmd` двойным кликом — дальше как выше (шаги 1–10 делает скрипт). + `setup.cmd` двойным кликом — дальше как выше (шаги 1–9 делает скрипт). 2. Отдельно качать `hermes-desktop-scrum.zip` **не нужно** — установщик сам его скачает и поставит. Этот архив нужен, только если на машине нет интернета или хочется поставить приложение вручную: тогда распакуйте его в постоянную папку @@ -74,6 +91,40 @@ --- +## Если установка остановилась + +Рядом с `setup.cmd` (в той же распакованной папке) лежат файлы помощи. Запускаются +**двойным кликом** — вводить команды не нужно: + +| Файл | Что делает | От администратора? | +|---|---|---| +| `CHK.cmd` | показывает, что видит установщик: путь к агенту, пакеты и права на них | нет | +| `ACL.cmd` | показывает правила доступа к папке агента, отдельно помечает запреты | нет | +| `FIX.cmd` | починка прав: возврат владения и выдача прав пользователю. **Ключ сохраняется** | **да** | +| `WIPE.cmd` | полностью удаляет папку агента, чтобы поставить заново. **Ключ вписывать заново** | **да** | + +`CHK` и `ACL` ничего не меняют — их можно запускать в любой момент. + +**Запуск от администратора:** правой кнопкой по файлу → «Запуск от имени администратора». +Установку (`setup.cmd`) так запускать НЕЛЬЗЯ — только файлы починки. + +### Симптом: «Отказано в доступе» или «движок не запускается» + +**Причина — права, а не сеть.** Папки внутри `%LOCALAPPDATA%\hermes\tools` принадлежат +другой учётной записи: сама папка «видна», а войти внутрь нельзя. Движок не находит свой +Python и падает мгновенно, ещё до любой загрузки. + +Признак: установка встаёт **сразу**, с сообщением `Access is denied`, без попыток что-то +скачать. + +**Лечение:** запустите `FIX.cmd` от администратора и дождитесь окончания (несколько минут), +затем запустите `setup.cmd` **обычным** пользователем. + +Такое состояние создаёт запуск установки от администратора. Если один раз так вышло — +больше не повышайте права для установки. + +--- + ## 0. Что нужно заранее | Что | Проверка | Если нет | diff --git a/README.md b/README.md index 0603c94..b1565da 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,18 @@ Дистрибутив Hermes Agent: персона личного помощника, базовый конфиг, 58 скиллов. Автор: AI laboratory SCRUM company. +> ## ⛔ НЕ запускайте установку «от имени администратора» +> +> Откройте **обычное** окно PowerShell (Win+R → `powershell`). **Не** «Запуск от имени +> администратора». +> +> Запуск с повышением прав — главная причина отказа: папки в доме агента создаются от +> другой учётной записи, и потом движок не может прочитать свой собственный Python. +> Установка встаёт мгновенно с `Access is denied`, ещё до любой загрузки. +> +> Единственное, что запускается от администратора, — файл починки `FIX.cmd` +> (и `WIPE.cmd`), и только если установка уже остановилась. + **Получателю агента:** не нужно ничего скачивать и распаковывать руками. Откройте PowerShell (Win+R → `powershell`) и вставьте **целиком, одной строкой**: @@ -17,6 +29,19 @@ Ссылка постоянная — не меняется при выпуске новых версий, повторный запуск обновляет агента (ключ, память и переписка сохраняются). Подробности — [`INSTALL.md`](INSTALL.md). +### Если установка остановилась + +В той же распакованной папке лежат файлы помощи — запускаются **двойным кликом**: + +| Файл | Что делает | От администратора? | +|---|---|---| +| `CHK.cmd` | показывает, что видит установщик, и права на файлы | нет | +| `ACL.cmd` | показывает правила доступа к папке агента | нет | +| `FIX.cmd` | починка прав. **Ключ и переписка сохраняются** | **да** | +| `WIPE.cmd` | полный снос папки агента и установка заново. **Ключ вписывать заново** | **да** | + +`CHK` и `ACL` ничего не меняют. + **Автору:** это исходник дистрибутива. Пакет для передачи собирается скриптом `dist/vasily-setup/build-package.ps1` (имя папки историческое).