Обновление десктоп-приложения

Приложение пока не обновляется автоматически: новую версию нужно скачать и поставить поверх старой вручную. Аккаунт, агенты, история диалогов и настройки при этом сохраняются — установщик обновляет приложение на месте, а не ставит рядом второе.

Как обновить

1. Закройте AgentHere. Если агент сейчас выполняет длинную задачу, дождитесь ответа: закрытие приложения прервёт ход.
2. Скачайте установщик на странице загрузки — сайт сам предложит сборку под вашу систему.
3. Запустите установщик. Удалять предыдущую версию не нужно.
4. Запустите приложение. Обычно вход сохраняется; если приложение попросит войти — это вход по коду устройства, как при первой установке (подробнее).

Windows

1. Закройте все окна AgentHere.
2. Скачайте установщик: agenthere-electron-win-x64.exe для большинства компьютеров, agenthere-electron-win-arm64.exe — для Windows на ARM (например, ноутбуки на Snapdragon).
3. Запустите скачанный файл. Windows может показать предупреждение «Система Windows защитила ваш компьютер»: сборка пока не подписана цифровым сертификатом. Нажмите «Подробнее», затем «Выполнить в любом случае».
4. Дождитесь завершения установки и запустите AgentHere.

Установщик ставит приложение в профиль пользователя, права администратора не нужны.

Как проверить версию

Откройте «Параметры» → «Приложения» → «Установленные приложения» и найдите AgentHere — версия указана в списке.

macOS

1. Закройте приложение (Cmd+Q).

2. Скачайте образ: agenthere-electron-mac-arm64.dmg для Apple Silicon (M1 и новее) или agenthere-electron-mac-x64.dmg для Intel.

3. Откройте скачанный .dmg, перетащите AgentHere в папку «Программы» и подтвердите замену предыдущей копии.

4. Снимите с приложения атрибут карантина — сборка пока не нотаризована. Откройте Терминал (Cmd+Пробел, введите «Терминал») и выполните:

   bashCopy

   sudo xattr -cr /Applications/AgentHere.app

   Если приложение лежит в другом месте, подставьте свой путь.

5. Запустите AgentHere. Если macOS предупредит о неопознанном разработчике, нажмите «Открыть».

Как проверить версию

В Finder выделите AgentHere, нажмите Cmd+I и посмотрите поле «Версия». Или откройте меню «AgentHere» → «О программе AgentHere».

Linux

1. Закройте приложение.

2. Скачайте agenthere-electron-linux-x86_64.AppImage со страницы загрузки.

3. Замените старый файл новым — имя файла не меняется, поэтому достаточно положить новый на место прежнего. Если файл потерял право на запуск, верните его:

   bashCopy

   chmod +x agenthere-electron-linux-x86_64.AppImage

4. Запустите AppImage. Если ярлык на рабочем столе или в доке указывал на другую папку, поправьте путь в ярлыке на новое расположение файла.

AppImage не требует установки: обновление — это замена одного файла. Настройки и история диалогов хранятся отдельно и переживают замену.

Что сохраняется при обновлении

Всё, что относится к вашей работе, лежит не в папке установки, а в папке данных приложения:

• %APPDATA%\ru.agenthere.desktop — Windows;
• ~/Library/Application Support/ru.agenthere.desktop — macOS;
• ~/.config/ru.agenthere.desktop — Linux.

Там же хранится вход в аккаунт и история сессий. Установщик эту папку не трогает, поэтому после обновления вы остаётесь в своём аккаунте, а агенты и диалоги остаются на месте. Удалять эту папку не нужно: вместе с ней пропадут вход и история.

Обновляйтесь в момент, когда агент не выполняет задачу: незавершённый ход прервётся, и его придётся запустить заново.

Если что-то пошло не так

• Приложение не устанавливается на Windows. Проверьте, что окно AgentHere действительно закрыто, и повторите запуск установщика. Если мешает антивирус, добавьте установщик в исключения на время установки.
• macOS не даёт запустить приложение. Повторите шаг с xattr -cr — атрибут карантина возвращается, если образ был распакован заново.
• Linux: файл не запускается. Проверьте право на запуск (chmod +x) и скачайте AppImage повторно, если загрузка оборвалась.
• Приложение просит войти заново. Это штатный вход по коду устройства: подтвердите код в браузере — инструкция.
• После обновления что-то работает не так. Напишите в поддержку и укажите вашу систему, версию приложения и что именно произошло.

Если приложение зависает, не входит в аккаунт или ведёт себя странно, его можно вернуть к состоянию «как после установки» — об этом ниже.

Сброс приложения

Сброс помогает, когда приложение не запускается, зависает, не пускает в аккаунт или странно себя ведёт после обновления.

Сначала попробуйте мягкий вариант: выйдите из аккаунта и войдите снова — кнопка «Выйти» в разделе «Настройки» → «AgentHere». Это чинит проблемы со входом и синхронизацией, а история диалогов и установленные агенты остаются на месте.

Полный сброс — крайняя мера: приложение удаляет свои локальные данные и выходит из аккаунта.

Как сбросить

• В приложении: «Настройки» → «AgentHere» → «Сбросить приложение», затем подтвердите.
• Если приложение не открывается: на экране ошибки нажмите «Сбросить всё». Перед этим там же можно нажать «Экспорт логов» и приложить файл к обращению в поддержку — по логам видно причину.

Приложение закроется, удалит свои данные и запустится заново — как в первый раз.

Что удаляется

• Вход в аккаунт: после сброса нужно войти заново по коду устройства.
• Локальная история диалогов, которая была в приложении: она хранится на компьютере и после сброса не восстанавливается.
• Скачанные копии агентов и навыков (папка ~/.agenthere: файлы агентов, навыков и список установленного).
• Настройки приложения и кэши.

Что остаётся на месте

• Аккаунт и баланс.
• Ваши агенты, навыки и всё, что создано в аккаунте: сброс касается компьютера, а не аккаунта.
• Облачные агенты, которые работают на сервере, — их сброс не затрагивает.
• История в веб-чате и в Telegram — это отдельные истории, они живут на сервере.
• Файлы ваших проектов на диске: приложение их не трогает.

После сброса

1. Войдите в аккаунт по коду устройства — как при первой установке.
2. Поставьте нужных агентов: они лежат в аккаунте, а не на компьютере. Когда приложение заметит, что локальных копий нет, оно предложит их установить (баннер синхронизации); то же можно сделать вручную в настройках агентов.

Если приложение вообще не запускается

Тогда сброс из интерфейса недоступен — удалите локальные данные вручную. Закройте приложение и переименуйте папки: переименование оставит копию на случай, если она понадобится.

Windows: в Проводнике введите %APPDATA% в адресную строку и переименуйте папку ru.agenthere.desktop; затем переименуйте папку .agenthere в %USERPROFILE%.

macOS:

mv "$HOME/.agenthere" "$HOME/.agenthere.old"
mv "$HOME/Library/Application Support/ru.agenthere.desktop" "$HOME/Library/Application Support/ru.agenthere.desktop.old"

Linux:

mv ~/.agenthere ~/.agenthere.old
mv ~/.config/ru.agenthere.desktop ~/.config/ru.agenthere.desktop.old
mv ~/.local/share/agenthere ~/.local/share/agenthere.old
mv ~/.cache/agenthere ~/.cache/agenthere.old

После этого запустите приложение и войдите в аккаунт. Удалять переименованные папки сразу не нужно: убедитесь, что всё в порядке.

Частые вопросы

Обновление придёт само?

Нет. Автообновление в приложении пока не подключено, поэтому обновляться нужно вручную по этой инструкции. Пункт меню «Проверить обновления…» (в macOS) сейчас вернёт ошибку — он начнёт работать, когда автообновление включат.

Нужно ли сначала удалять старую версию?

Нет. Установщик обновляет приложение на месте. Удалять нужно только в том случае, если приложение работает неправильно и вы хотите поставить его с нуля — но тогда сначала сохраните нужные диалоги, потому что вместе с приложением удалится и папка данных.

Потеряются ли агенты, навыки и история диалогов?

Нет. Они хранятся в папке данных, а не в папке установки, и переживают обновление.

Можно ли вернуться на предыдущую версию?

На сайте выложена только актуальная сборка, старые мы не храним. Если новая версия мешает работать, напишите в поддержку — поможем.

Сброс удалит моих агентов и переписку?

Агенты — нет: они живут в аккаунте, а на компьютере лежат только их скачанные копии, которые после сброса можно поставить заново. А вот история диалогов, которая была в приложении, при сбросе удаляется и не восстанавливается — как и настройки. Истории в веб-чате и Telegram сброс не затрагивает. Подробности — в разделе «Сброс приложения».

Как понять, что я уже на новой версии?

Посмотрите версию приложения способом для вашей системы (см. разделы выше). Если сомневаетесь, что сборка свежая, просто скачайте установщик со страницы загрузки и поставьте его ещё раз: повторная установка ничего не ломает и оставляет данные на месте.