diff --git a/INSTALL.md b/INSTALL.md index 2a9c808..c5f47d6 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,13 +1,16 @@ # Инструкция по установке -Агент **Dionis** — профиль Hermes Agent: личный помощник. Ключ API выдаёт владелец +Агент **Dionis** — Hermes Agent: личный помощник руководителя. Ключ API выдаёт владелец агента — его вы впишете один раз при установке. +Агент ставится в **единственный профиль** Hermes. Переключателей профилей и лишних +настроек в сборке нет: получается один помощник и больше ничего. + Вам передают **два архива**: | Архив | Что внутри | Размер | |---|---|---| -| `vasily-setup-v<версия>.zip` | агент: персона, настройки, 58 скиллов, установщик | ~1 МБ | +| `dionis-setup-v<версия>.zip` | агент: персона, настройки, 58 скиллов, установщик | ~1 МБ | | `hermes-desktop-scrum.zip` | приложение Hermes с фирменным логотипом на пустом чате | ~150 МБ | Второй архив нужен, чтобы был графический интерфейс с логотипом. Без него агент @@ -17,7 +20,25 @@ ## Быстрый путь -### Шаг 1. Приложение +### Шаг 1. Агент + +Распакуйте `dionis-setup-v<версия>.zip` (все файлы должны лежать рядом) и **запустите +`setup.cmd` двойным кликом**. Скрипт сам: + +1. найдёт рядом файл агента; +2. снимает метку «скачано из интернета» (иначе Windows блокирует запуск); +3. при необходимости поставит Git и Hermes Agent; +4. проверит, что установка свободна, и **остановится**, если на машине уже работает + другой агент Hermes — чтобы не потерять чужие данные; +5. поставит агента (при повторном запуске — обновит); +6. создаст файл ключа и **откроет его в Блокноте** — впишите туда ключ от владельца; +7. проверит, что агент отвечает. + +Windows может один раз спросить подтверждение (SmartScreen) — это нормально. +Первый запуск занимает несколько минут, окно закрывать нельзя. +Протокол установки сохраняется рядом: `setup-log.txt`. + +### Шаг 2. Приложение Распакуйте `hermes-desktop-scrum.zip` в постоянную папку, например: @@ -25,31 +46,11 @@ C:\Hermes ``` -В папке окажется `win-unpacked\Hermes.exe`. **Не запускайте пока.** +В папке окажется `win-unpacked\Hermes.exe` — запустите его. > Распаковывать нужно в постоянное место: папку «Загрузки» Windows периодически чистит, > и приложение сломается. -### Шаг 2. Агент - -Распакуйте `vasily-setup-v<версия>.zip` (например, в `Downloads`) и **запустите -`setup.cmd` двойным кликом**. Скрипт сам: - -1. найдёт рядом файл агента; -2. снимает метку «скачано из интернета» (иначе Windows блокирует запуск); -3. при необходимости поставит Git и Hermes Agent; -4. поставит агента (при повторном запуске — обновит); -5. создаст файл ключа и **откроет его в Блокноте** — впишите туда ключ от владельца; -6. проверит, что агент отвечает. - -Windows может один раз спросить подтверждение (SmartScreen) — это нормально. -Первый запуск занимает несколько минут, окно закрывать нельзя. -Протокол установки сохраняется рядом: `setup-log.txt`. - -### Шаг 3. Запуск приложения - -Запустите `Hermes.exe` из папки шага 1. Дальше — раздел 6. - Остальные разделы нужны, только если что-то пошло не так или вы ставите агента вручную. --- @@ -60,12 +61,15 @@ |---|---|---| | Windows 10/11 | — | — | | Git | `git --version` | `winget install Git.Git` | -| Hermes Agent | `hermes --version` | см. шаг 1 | -| Свой ключ Polza.ai | — | см. шаг 4 | -| Файл агента `vasily-*.bundle` | — | получить у владельца (шаг 2) | +| Hermes Agent | `hermes --version` | см. раздел 1 (setup.cmd поставит сам) | +| Свой ключ Polza.ai | — | получить у владельца агента | +| Файл агента `dionis-*.bundle` | — | получить у владельца (раздел 2) | -Данные Hermes лежат в `%LOCALAPPDATA%\hermes`. Агент встанет в -`%LOCALAPPDATA%\hermes\profiles\vasily`. +Данные Hermes лежат в `%LOCALAPPDATA%\hermes` — это и есть дом агента. + +> **Важно.** Если здесь уже стоит рабочий агент (своя персона, ключи, память, переписка) +> — этот комплект ставить нельзя, он рассчитан на единственного агента. setup.cmd это +> проверит и остановится сам. --- @@ -88,7 +92,7 @@ ## 2. Что вам передаёт владелец -Один файл: **`vasily-<версия>.bundle`** (например `vasily-v1.0.1.bundle`). +Один файл: **`dionis-<версия>.bundle`** (например `dionis-v1.2.4.bundle`). Внутри — весь агент с историей версий. Больше ничего не нужно, доступ к репозиторию не требуется. @@ -96,20 +100,30 @@ ## 3. Установить агента (вручную) -Положить файл, например, в `Downloads`, открыть PowerShell: +Если не хотите запускать `setup.cmd`, положите файл, например, в `Downloads` и откройте +PowerShell: ```powershell cd $env:USERPROFILE\Downloads -git clone vasily-<версия>.bundle vasily-dist -hermes profile install .\vasily-dist --yes +git clone dionis-<версия>.bundle dionis-dist +Remove-Item -Recurse -Force .\dionis-dist\.git ``` -В конце появится: +Скопируйте персону, настройки и скиллы в дом агента: +```powershell +Copy-Item .\dionis-dist\SOUL.md $env:LOCALAPPDATA\hermes\ -Force +Copy-Item .\dionis-dist\config.yaml $env:LOCALAPPDATA\hermes\ -Force +Copy-Item .\dionis-dist\skills $env:LOCALAPPDATA\hermes\ -Recurse -Force ``` -✓ Installed 'vasily' v1.2.3 - Profile path: C:\Users\<вы>\AppData\Local\hermes\profiles\vasily - Next: copy .env.EXAMPLE to .env and fill in required keys + +Строка с удалением `.git` — не украшение: git помечает файлы внутри `.git/objects/pack` +атрибутом «только чтение», и копирование может упасть с `PermissionError: [WinError 5]`. + +Проверить, что стало: + +```powershell +hermes doctor ``` --- @@ -128,18 +142,15 @@ Если Блокнот закрылся, а ключ вписать не успели — откройте файл вручную: ```powershell -cd $env:LOCALAPPDATA\hermes\profiles\vasily -notepad .env +notepad $env:LOCALAPPDATA\hermes\.env ``` Проверить, что Hermes видит файл: ```powershell -hermes -p vasily config env-path +hermes config env-path ``` -Должен вернуться путь `...\profiles\vasily\.env`. - ### Куда ключ не вписывать Ключ в `config.yaml` **не вписывать** — там только имя переменной @@ -151,32 +162,21 @@ ## 5. Запустить ```powershell -hermes -p vasily chat +hermes chat ``` Первое сообщение для проверки: `Как тебя зовут и кому ты помогаешь?` Ответ должен быть про Dionis и вас. -Короткая команда `vasily chat` вместо длинной — по желанию: - -```powershell -hermes profile alias vasily # создаёт C:\Users\<вы>\.local\bin\vasily.bat -vasily chat -``` - -> На Windows обёртка кладётся в `C:\Users\<вы>\.local\bin`, а этой папки нет в PATH — -> в новом терминале команда `vasily` не найдётся. Либо добавьте папку в PATH, либо -> пользуйтесь полной формой `hermes -p vasily chat`. - --- ## 6. Что где менять под себя | Что | Файл | Как правильно | |---|---|---| -| Имя владельца, персона, тон | `%LOCALAPPDATA%\hermes\profiles\vasily\SOUL.md` | открыть в редакторе, править текст | -| Модель | `config.yaml` | только через `hermes -p vasily config set model.default <модель>` — правка файла руками ломает конфиг | -| Список моделей | `config.yaml` | `hermes -p vasily model` (интерактивный выбор) | +| Имя владельца, персона, тон | `%LOCALAPPDATA%\hermes\SOUL.md` | открыть в редакторе, править текст | +| Модель | `config.yaml` | только через `hermes config set model.default <модель>` — правка файла руками ломает конфиг | +| Список моделей | `config.yaml` | `hermes model` (интерактивный выбор) | | Ключ API | `.env` | правка строки `HERMES_CUSTOM_POLZA_AI_API_KEY=` | | Память о вас | — | набирается в чате само; чистится через `/memory` в чате | @@ -186,30 +186,19 @@ ## 7. Обновление агента -**Автоматически:** положить новый `vasily-<новая версия>.bundle` в ту же папку, где лежит +**Автоматически:** положить новый `dionis-<новая версия>.bundle` в ту же папку, где лежит `setup.cmd`, и снова запустить `setup.cmd`. Скрипт увидит установленного агента, обновит его и оставит ваш ключ, память и переписку. Прежний бандл можно не удалять — берётся самый свежий по имени. -**Вручную**, если предпочитаете команды: - -```powershell -cd $env:USERPROFILE\Downloads -git clone vasily-v1.0.2.bundle vasily-dist-new -Remove-Item -Recurse -Force .\vasily-dist-new\.git - -hermes profile install .\vasily-dist-new --force --yes -``` - -Строка с удалением `.git` — не украшение: git помечает файлы внутри `.git/objects/pack` -атрибутом «только чтение», и установщик падает с `PermissionError: [WinError 5]`. -Если этой папки нет, строка ничего не делает. +**Вручную**, если предпочитаете команды: повторите раздел 3 с новым файлом — три команды +`Copy-Item` перезапишут персону, настройки и скиллы. Ключ и память лежат в других файлах +и не трогаются. Посмотреть, что стоит: ```powershell -hermes profile info vasily -hermes profile list +hermes doctor ``` --- @@ -218,14 +207,14 @@ | Возможность | Команда / где | |---|---| -| MCP-серверы (внешние инструменты) | `hermes -p vasily mcp catalog`, затем `hermes -p vasily mcp add` | -| Мессенджеры (Telegram и др.) | `hermes -p vasily gateway setup`, затем `hermes -p vasily gateway start` | -| Задачи по расписанию | `hermes -p vasily cron add` или через десктоп-приложение | -| Графическое приложение | `hermes desktop` (общее для всех профилей, профиль выбирается внутри) | +| MCP-серверы (внешние инструменты) | `hermes mcp catalog`, затем `hermes mcp add` | +| Мессенджеры (Telegram и др.) | `hermes gateway setup`, затем `hermes gateway start` | +| Задачи по расписанию | `hermes cron add` или через десктоп-приложение | +| Графическое приложение | `Hermes.exe` (из распакованного архива) | Скиллы (58 штук: Word, Excel, PDF, поиск, почта, заметки, карты, код) уже внутри — их доустанавливать не нужно. Свой скилл добавляется командой -`hermes -p vasily skills install <источник>`. +`hermes skills install <источник>`. --- @@ -233,12 +222,11 @@ | Симптом | Причина / решение | |---|---| +| Установка остановилась с перечнем чужих данных | на машине уже работает другой агент — ставить нельзя, данные сохранены | | `hermes: command not found` | терминал не перезапущен после установки Hermes | -| `Profile 'vasily' does not exist` | агент не установлен — вернуться к шагу 3 | -| Ответы вида «нет доступа к модели», 401 | ключ в `.env` пустой/с опечаткой — проверить строку и `hermes -p vasily config env-path` | -| Установка не находит файл агента | файл не в текущем каталоге — проверить `cd $env:USERPROFILE\Downloads` и имя файла | -| `PermissionError: [WinError 5]` при обновлении | удалить папку `.git` в распакованном дистрибутиве перед установкой (шаг 7) | +| Ответы вида «нет доступа к модели», 401 | ключ в `.env` пустой/с опечаткой — проверить строку и `hermes config env-path` | +| Установка не находит файл агента | файл не рядом со скриптом — положить `setup.cmd` и `dionis-*.bundle` в одну папку | +| `PermissionError: [WinError 5]` при установке вручную | удалить папку `.git` в распакованном дистрибутиве (раздел 3) | | `WinError 32` — файл занят другим процессом | запущено приложение Hermes: значок в трее → Выход, затем запустить `setup.cmd` снова | | Установка идёт слишком долго | первый запуск качает Python, Node и зависимости — это минуты, не ошибка | -| `vasily: команда не найдена` | `C:\Users\<вы>\.local\bin` не в PATH — использовать `hermes -p vasily chat` | -| Общий диагноз | `hermes -p vasily doctor` | +| Общий диагноз | `hermes doctor` | diff --git a/distribution.yaml b/distribution.yaml index fb12056..af27b35 100644 --- a/distribution.yaml +++ b/distribution.yaml @@ -1,5 +1,5 @@ name: dionis -version: 1.2.4 +version: 1.2.5 description: "Личный помощник руководителя: документы, письма, договоры, расчёты, поиск, задачи." hermes_requires: ">=0.21.6" author: "AI laboratory SCRUM company"