diff --git a/INSTALL.md b/INSTALL.md index c68d37e..188d3fa 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -20,43 +20,45 @@ ## Быстрый путь -### Шаг 1. Агент +### Одна команда — и всё готово -Распакуйте `ailab-setup-v<версия>.zip` (все файлы должны лежать рядом) и **запустите -`setup.cmd` двойным кликом**. Скрипт сам: +Вставьте в PowerShell (Win+R → `powershell`), **целиком, одной строкой**: -1. найдёт рядом файл агента; +``` +cd $env:TEMP; curl.exe -L -o ailab.zip "https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/latest/download/agent-setup.zip"; Expand-Archive ailab.zip ailab -Force; .\ailab\setup.cmd +``` + +Установщик сам делает всё по порядку: + +1. находит рядом файл агента; 2. снимает метку «скачано из интернета» (иначе Windows блокирует запуск); -3. при необходимости поставит Git и Hermes Agent; -4. проверит, что установка свободна, и **остановится**, если на машине уже работает +3. при необходимости ставит Git и Hermes Agent; +4. проверяет, что установка свободна, и **останавливается**, если на машине уже работает другой агент Hermes — чтобы не потерять чужие данные; -5. поставит агента (при повторном запуске — обновит); -6. создаст файл ключа и **откроет его в Блокноте** — впишите туда ключ от владельца; -7. проверит, что агент отвечает. +5. ставит агента (при повторном запуске — обновляет); +6. создаёт файл ключа и **открывает его в Блокноте** — впишите туда ключ от владельца; +7. проверяет, что агент отвечает; +8. **скачивает и ставит окно приложения** (~158 МБ) и кладёт **ярлык «AILab SCRUME Agent» + на рабочий стол**. + +Больше ничего делать не нужно: после установки запускайте агента ярлыком с рабочего стола. Windows может один раз спросить подтверждение (SmartScreen) — это нормально. -Первый запуск занимает несколько минут, окно закрывать нельзя. -Протокол установки сохраняется рядом: `setup-log.txt`. +Установка занимает несколько минут (качается приложение ~158 МБ), окно закрывать нельзя. +Протокол сохраняется рядом: `setup-log.txt`. -### Шаг 2. Приложение +### Если качать архивом вручную -Распакуйте `hermes-desktop-scrum.zip` в постоянную папку, например: +1. Скачайте `agent-setup.zip` (в релизе он же `ailab-setup-v<версия>.zip`), распакуйте в пустую папку, запустите + `setup.cmd` двойным кликом — дальше как выше (шаги 1–8 делает скрипт). +2. Отдельно качать `hermes-desktop-scrum.zip` **не нужно** — установщик сам его скачает + и поставит. Этот архив нужен, только если на машине нет интернета или хочется + поставить приложение вручную: тогда распакуйте его в постоянную папку + (например `C:\Hermes`), запустите `Hermes.exe`, затем `make-shortcut.cmd`. -``` -C:\Hermes -``` - -Проверка: в папке `C:\Hermes` должен лежать **`Hermes.exe`** (он распаковывается -в корень папки, а не во вложенную). Рядом — `make-shortcut.cmd`. - -1. Запустите `Hermes.exe` — приложение откроется. -2. Затем запустите `make-shortcut.cmd` **двойным кликом** — он положит на рабочий стол - ярлык «AILab SCRUME Agent» с фирменной иконкой. Дальше запускайте агента ярлыком. - -> Распаковывать нужно в постоянное место: папку «Загрузки» Windows периодически чистит, -> и приложение сломается. Сама папка `C:\Hermes` должна остаться на месте — -> ярлык ведёт на неё. - +> Приложение ставится в `%LOCALAPPDATA%\AILabSCRUME\App`. Ярлык ведёт на неё — +> папку не удаляйте и не переносите. В «Загрузки» распаковывать нельзя: Windows +> их периодически чистит, и приложение сломается. Остальные разделы нужны, только если что-то пошло не так или вы ставите агента вручную. --- @@ -241,30 +243,25 @@ ## 10. Установка одной командой (PowerShell) -Если не хочется возиться с распаковкой вручную — откройте PowerShell (обычный, без -администратора) и вставьте блок целиком: +Откройте PowerShell (обычный, без администратора) и вставьте **целиком, одной +строкой**: ```powershell -$b = 'https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/download/v1.3.2' -$t = Join-Path $env:TEMP 'ailab' -Invoke-RestMethod "$b/ailab-setup-v1.3.2.zip" -OutFile "$t.zip" -Expand-Archive "$t.zip" $t -Force -& "$t\setup.cmd" +cd $env:TEMP; curl.exe -L -o ailab.zip "https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/latest/download/agent-setup.zip"; Expand-Archive ailab.zip ailab -Force; .\ailab\setup.cmd ``` -Дальше всё делает установщик: Git, Hermes, агент, Блокнот для ключа, проверка. +Установщик делает всё сам: Git, Hermes, агент, Блокнот для ключа, проверка, +**скачивание и установка окна приложения, ярлык на рабочем столе**. Второй команды +не требуется. -> Пути собираются через `Join-Path` намеренно. Строка вида `$t="$env:TEMP\ailab"` -> при копировании легко теряет кавычки, и PowerShell падает с -> `Непредвиденная лексема "\ailab"`. `Join-Path` таких кавычек не требует. +Ссылка `releases/latest/download/...` всегда указывает на последний выпуск — при +выходе новой версии команду менять не нужно. -Приложение (158 МБ) ставится отдельно: +> Строка дана **одной строкой с `;`** намеренно: многострочный блок при копировании +> из письма или мессенджера легко приезжает побитым (пустые `$b`/`$t`, ошибка +> `Непредвиденная лексема "\ailab"`). Каждую часть можно выполнить и по отдельности — +> результат тот же. -```powershell -$b = 'https://github.com/AILABSCRUME/AI_Lab_SCRUME_Co/releases/download/v1.3.2' -$z = Join-Path $env:USERPROFILE 'hermes-desktop-scrum.zip' -Invoke-RestMethod "$b/hermes-desktop-scrum.zip" -OutFile $z -Expand-Archive $z 'C:\Hermes' -Force -& 'C:\Hermes\Hermes.exe' -& 'C:\Hermes\make-shortcut.cmd' -``` +Приложение качать отдельно не нужно. Если же интернета нет или приложение хочется +поставить вручную — распакуйте `hermes-desktop-scrum.zip` в постоянную папку +(например `C:\Hermes`), запустите `Hermes.exe`, затем `make-shortcut.cmd`. diff --git a/distribution.yaml b/distribution.yaml index 8464e8d..83c2dba 100644 --- a/distribution.yaml +++ b/distribution.yaml @@ -1,5 +1,5 @@ name: ailab_scrume_agent -version: 1.3.3 +version: 1.3.4 description: "Личный помощник: документы, письма, договоры, расчёты, поиск, задачи." hermes_requires: ">=0.21.6" author: "AI laboratory SCRUM company"