diff --git a/installer/install-linux.sh b/installer/install-linux.sh index 3f9556d..dd89f24 100644 --- a/installer/install-linux.sh +++ b/installer/install-linux.sh @@ -49,51 +49,8 @@ echo "" # крутить старый код в памяти, и владелец видел прежний интерфейс при новом # номере сборки. Три сборки подряд ставились в файлы, но не в работу. echo "[0/6] Остановка работающего Hermes Hub..." - -stop_running_hub() { - local pattern="antigravity_provider.router.web|hermes_hub_web_entry" - local pids - # Только процессы ЭТОГО пользователя и только те, что относятся к хабу. - pids="$(pgrep -u "$(id -u)" -f "$pattern" 2>/dev/null | tr ' -' ' ')" - - if [ -z "$pids" ]; then - echo " Работающий хаб не найден — останавливать нечего." - return 0 - fi - - echo " Найдены процессы хаба: $pids" - # shellcheck disable=SC2086 - kill $pids 2>/dev/null || true - - local waited=0 - while [ "$waited" -lt 10 ]; do - sleep 1 - waited=$((waited + 1)) - pids="$(pgrep -u "$(id -u)" -f "$pattern" 2>/dev/null | tr ' -' ' ')" - [ -z "$pids" ] && break - done - - if [ -n "$pids" ]; then - echo " Не завершились за 10 секунд, снимаю принудительно: $pids" - # shellcheck disable=SC2086 - kill -9 $pids 2>/dev/null || true - sleep 1 - pids="$(pgrep -u "$(id -u)" -f "$pattern" 2>/dev/null | tr ' -' ' ')" - fi - - if [ -n "$pids" ]; then - # Не прерываем установку: файлы обновятся, а владельцу скажем правду. - echo " ⚠ Остались процессы: $pids. Снимите их вручную, иначе будет работать старый код." - return 1 - fi - - echo " Хаб остановлен." - return 0 -} - +# shellcheck source=./lib_stop_running_hub.sh +. "$SCRIPT_DIR/lib_stop_running_hub.sh" stop_running_hub || true echo "" @@ -266,9 +223,35 @@ mkdir -p "$HERMES_HOME/bin" cp "$LAUNCHER_SRC" "$HERMES_HOME/bin/hermes-hub-web" chmod +x "$HERMES_HOME/bin/hermes-hub-web" +# Лаунчер остановки — эквивалент «Exit» из системного трея Windows. +# +# На Windows сервер стартует из HermesHubWeb.exe, который держит значок в +# трее: закрыть его оттуда может сам владелец. На Linux сервер после закрытия +# окна остаётся в фоне без единого способа его остановить — ни кнопки в +# интерфейсе (её нет ни на одной платформе), ни трея, ни пункта меню. Кладём +# lib_stop_running_hub.sh рядом со скриптом остановки: он ищет её сначала +# рядом с собой. +STOP_LAUNCHER_SRC="$REPO_ROOT/launcher/hermes-hub-stop.sh" +if [ ! -f "$STOP_LAUNCHER_SRC" ]; then + STOP_LAUNCHER_SRC="$SCRIPT_DIR/../launcher/hermes-hub-stop.sh" +fi +STOP_LAUNCHER_BIN="$HOME/.local/bin/hermes-hub-stop" +if [ -f "$STOP_LAUNCHER_SRC" ]; then + cp "$STOP_LAUNCHER_SRC" "$STOP_LAUNCHER_BIN" + chmod +x "$STOP_LAUNCHER_BIN" + cp "$SCRIPT_DIR/lib_stop_running_hub.sh" "$HOME/.local/bin/lib_stop_running_hub.sh" +fi + # Create .desktop file +# +# Иконка — PNG, не .ico. Измерено на настоящем GTK-рабочем столе: +# GdkPixbuf.Pixbuf.new_from_file на HermesHub.ico падает с "Compressed icons +# are not supported", а .desktop-файл с несуществующей или неподдерживаемой +# иконкой Nautilus и меню приложений просто показывают пустое место — без +# ошибки, молча. Значок был бы вечно пустым на любом GTK-окружении (GNOME, +# большинство производных). PNG в тех же ассетах уже есть и загружается. DESKTOP_FILE="$HOME/.local/share/applications/hermes-hub-web.desktop" -ICON_PATH="$HERMES_HOME/plugins/antigravity-provider/assets/branding/app/HermesHub.ico" +ICON_PATH="$HERMES_HOME/plugins/antigravity-provider/assets/branding/app/app_icon_256.png" if [ ! -f "$ICON_PATH" ]; then ICON_PATH="utilities-terminal" fi @@ -289,6 +272,28 @@ StartupWMClass=hermes-hub-web EOF chmod +x "$DESKTOP_FILE" + +# Второй пункт меню — «Остановить». Terminal=true: без окна владелец не +# увидит, остановился ли хаб на самом деле, и не заметит «⚠ Остались +# процессы» из lib_stop_running_hub.sh, если что-то пошло не так. +if [ -f "$STOP_LAUNCHER_BIN" ]; then + STOP_DESKTOP_FILE="$HOME/.local/share/applications/hermes-hub-stop.desktop" + cat < "$STOP_DESKTOP_FILE" +[Desktop Entry] +Version=1.0 +Type=Application +Name=Stop Hermes Hub +GenericName=Stop the Hermes Hub background server +Comment=Останавливает фоновый сервер Hermes Hub +Exec=$STOP_LAUNCHER_BIN +Icon=$ICON_PATH +Terminal=true +Categories=Development;Utility; +StartupNotify=false +EOF + chmod +x "$STOP_DESKTOP_FILE" +fi + if command -v update-desktop-database >/dev/null 2>&1; then update-desktop-database "$HOME/.local/share/applications" 2>/dev/null || true fi diff --git a/installer/lib_stop_running_hub.sh b/installer/lib_stop_running_hub.sh new file mode 100644 index 0000000..23ad09c --- /dev/null +++ b/installer/lib_stop_running_hub.sh @@ -0,0 +1,54 @@ +#!/usr/bin/env bash +# ============================================================================== +# Hermes Hub — общая функция остановки работающего хаба (Linux/POSIX). +# +# До этого файла одна и та же функция была отдельно вписана в install-linux.sh +# и в uninstall-linux.sh — две копии, которые разошлись бы при первой же +# правке одной из них незамеченной для другой. Источник источается («source») +# обоими скриптами и лаунчером остановки, поэтому логика одна. +# +# Использование: `source "$(dirname "$0")/lib_stop_running_hub.sh"`, затем +# вызвать `stop_running_hub`. Функция сама печатает ход дела и возвращает +# 0 (остановлен или нечего было останавливать) либо 1 (что-то осталось — +# вызывающий решает, прерывать ли из-за этого). +# ============================================================================== + +stop_running_hub() { + local pattern="antigravity_provider.router.web|hermes_hub_web_entry" + local pids + # Только процессы ЭТОГО пользователя и только те, что относятся к хабу. + pids="$(pgrep -u "$(id -u)" -f "$pattern" 2>/dev/null | tr '\n' ' ')" + + if [ -z "$pids" ]; then + echo " Работающий хаб не найден — останавливать нечего." + return 0 + fi + + echo " Найдены процессы хаба: $pids" + # shellcheck disable=SC2086 + kill $pids 2>/dev/null || true + + local waited=0 + while [ "$waited" -lt 10 ]; do + sleep 1 + waited=$((waited + 1)) + pids="$(pgrep -u "$(id -u)" -f "$pattern" 2>/dev/null | tr '\n' ' ')" + [ -z "$pids" ] && break + done + + if [ -n "$pids" ]; then + echo " Не завершились за 10 секунд, снимаю принудительно: $pids" + # shellcheck disable=SC2086 + kill -9 $pids 2>/dev/null || true + sleep 1 + pids="$(pgrep -u "$(id -u)" -f "$pattern" 2>/dev/null | tr '\n' ' ')" + fi + + if [ -n "$pids" ]; then + echo " ⚠ Остались процессы: $pids. Снимите их вручную." + return 1 + fi + + echo " Хаб остановлен." + return 0 +} diff --git a/installer/uninstall-linux.sh b/installer/uninstall-linux.sh index e7e8fa3..fb1d2f8 100644 --- a/installer/uninstall-linux.sh +++ b/installer/uninstall-linux.sh @@ -7,6 +7,8 @@ set -e +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" + DEFAULT_HERMES_HOME="$HOME/.hermes" HERMES_HOME="${HERMES_HOME:-$DEFAULT_HERMES_HOME}" @@ -23,18 +25,35 @@ echo "======================================================================" echo "Hermes Home : $HERMES_HOME" echo "" +# 0. Остановка работающего хаба. +# +# Тот же порядок, что в install-linux.sh, и по той же причине: файлы под +# работающим процессом здесь не просто устаревают, а исчезают. С +# --purge-user-data это ещё и rm -rf каталогов, на которые у живого процесса +# открыты файловые дескрипторы — на Linux это не роняет процесс, но он +# продолжает отвечать по старому порту после «успешного» удаления, и +# следующая попытка что-то с ним сделать бьётся об уже удалённые файлы. +echo "[0/4] Остановка работающего Hermes Hub..." +# shellcheck source=./lib_stop_running_hub.sh +. "$SCRIPT_DIR/lib_stop_running_hub.sh" +stop_running_hub || true +echo "" + # 1. Remove Plugin Integration -echo "[1/3] Removing plugin integration..." +echo "[1/4] Removing plugin integration..." if [ -d "$HERMES_HOME/plugins/antigravity-provider" ]; then rm -rf "$HERMES_HOME/plugins/antigravity-provider" echo " Removed $HERMES_HOME/plugins/antigravity-provider" fi # 2. Remove Launchers and Shortcuts -echo "[2/3] Removing application launchers and desktop entries..." +echo "[2/4] Removing application launchers and desktop entries..." rm -f "$HOME/.local/bin/hermes-hub-web" rm -f "$HERMES_HOME/bin/hermes-hub-web" +rm -f "$HOME/.local/bin/hermes-hub-stop" +rm -f "$HOME/.local/bin/lib_stop_running_hub.sh" rm -f "$HOME/.local/share/applications/hermes-hub-web.desktop" +rm -f "$HOME/.local/share/applications/hermes-hub-stop.desktop" if command -v update-desktop-database >/dev/null 2>&1; then update-desktop-database "$HOME/.local/share/applications" 2>/dev/null || true @@ -42,17 +61,26 @@ fi # 3. User Data Handling if [ "$PURGE_USER_DATA" = "true" ]; then - echo "[3/3] Purging user data (--purge-user-data specified)..." + echo "[3/4] Purging user data (--purge-user-data specified)..." rm -f "$HERMES_HOME/config/router_profiles.yaml" rm -rf "$HERMES_HOME/agy_profiles" rm -rf "$HERMES_HOME/codex_profiles" rm -rf "$HERMES_HOME/opencode_profiles" echo " User configuration and profiles purged." else - echo "[3/3] Preserving user data and credentials." + echo "[3/4] Preserving user data and credentials." echo " Your router profiles, auth keys, and settings in $HERMES_HOME remain intact." fi +# 4. Post-uninstall verification: пойманный хаб действительно молчит. +echo "[4/4] Verifying no hub process remains..." +REMAINING="$(pgrep -u "$(id -u)" -f "antigravity_provider.router.web|hermes_hub_web_entry" 2>/dev/null | tr '\n' ' ')" +if [ -n "$REMAINING" ]; then + echo " ⚠ Всё ещё работает: $REMAINING — удаление файлов это не остановило." +else + echo " Хаб не работает." +fi + echo "" echo "======================================================================" echo " HERMES HUB UNINSTALLED SUCCESSFULLY FROM LINUX " diff --git a/launcher/hermes-hub-stop.sh b/launcher/hermes-hub-stop.sh new file mode 100644 index 0000000..03eb744 --- /dev/null +++ b/launcher/hermes-hub-stop.sh @@ -0,0 +1,49 @@ +#!/usr/bin/env bash +# ============================================================================== +# Hermes Hub — Stop (Linux) +# +# На Windows фоновый сервер запускается из HermesHubWeb.exe, который держит +# значок в системном трее — оттуда «Exit» останавливает процесс. На Linux +# сервер стартует через nohup и остаётся в фоне после закрытия окна браузера +# (так и задумано: не переустанавливать при каждом перезапуске окна), но +# остановить его после этого было решительно нечем — ни кнопки в интерфейсе +# (её нет ни на одной платформе), ни трея, ни пункта меню. Только терминал и +# pkill вручную, либо переустановка/удаление, которые останавливают хаб +# только как побочный эффект. +# +# Этот скрипт — тот недостающий эквивалент «Exit из трея»: доступен из меню +# приложений через собственный .desktop-пункт, использует ту же проверенную +# функцию остановки, что installer/install-linux.sh и uninstall-linux.sh. +# ============================================================================== + +set -e + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" + +# Устанавливается рядом (в ~/.hermes/bin) install-linux.sh — оттуда и берём +# общую функцию. Если скрипт запущен не из установленного места (например, +# прямо из репозитория), ищем installer/ на уровень выше. +LIB="" +for candidate in \ + "$SCRIPT_DIR/lib_stop_running_hub.sh" \ + "$SCRIPT_DIR/../installer/lib_stop_running_hub.sh" +do + if [ -f "$candidate" ]; then + LIB="$candidate" + break + fi +done + +if [ -z "$LIB" ]; then + echo "❌ Не найдена installer/lib_stop_running_hub.sh — переустановите Hermes Hub." >&2 + exit 1 +fi + +# shellcheck source=../installer/lib_stop_running_hub.sh +. "$LIB" + +echo "Останавливаю Hermes Hub..." +if stop_running_hub; then + exit 0 +fi +exit 1 diff --git a/tests/test_installer_windows_and_linux.py b/tests/test_installer_windows_and_linux.py index 44aa558..37af70a 100644 --- a/tests/test_installer_windows_and_linux.py +++ b/tests/test_installer_windows_and_linux.py @@ -87,6 +87,17 @@ def test_linux_installer_script_structure(): assert "HERMES_HOME" in install_sh assert "antigravity-provider" in install_sh + # Значок .desktop-записи должен быть растровым (PNG/SVG), не .ico. + # + # Измерено на настоящем GTK-рабочем столе: GdkPixbuf.Pixbuf.new_from_file + # на .ico падает с "Compressed icons are not supported", а .desktop-файл + # с нерендерящейся иконкой меню приложений и файловый менеджер просто + # показывают пустым — без ошибки, молча. HermesHub.ico в тех же ассетах + # существует и раньше подставлялся сюда, поэтому мало проверить, что путь + # не пуст — нужно, чтобы это не был именно .ico. + icon_line = next(line for line in install_sh.splitlines() if line.startswith("ICON_PATH=")) + assert ".ico" not in icon_line, f"иконка .desktop-записи — .ico, GTK его не рендерит: {icon_line!r}" + def test_linux_launcher_script_headless_and_app_mode(): """Verify hermes-hub-web.sh checks DISPLAY, prints SSH port forwarding on headless, and uses --app on desktop.""" @@ -111,3 +122,49 @@ def test_linux_uninstaller_preserves_user_data(): assert "--purge-user-data" in uninstall_sh assert "Preserving user data and credentials" in uninstall_sh assert "hermes-hub-web.desktop" in uninstall_sh + + +def test_linux_uninstaller_stops_running_hub(): + """A61/A62: uninstall-linux.sh must stop the hub before deleting its files. + + Раньше удаление не трогало работающий процесс: rm -rf уходил под живым + сервером, а с --purge-user-data ещё и сносил каталоги, на которые у + процесса были открыты файловые дескрипторы. Хаб продолжал отвечать по + старому порту после «успешного» удаления. Измерено живым прогоном: + сервер, запущенный в песочнице, оставался в списке процессов после + uninstall-linux.sh до этой правки. + """ + uninstall_sh = (INSTALLER_DIR / "uninstall-linux.sh").read_text(encoding="utf-8") + assert "lib_stop_running_hub.sh" in uninstall_sh + assert "stop_running_hub" in uninstall_sh + + +def test_linux_stop_launcher_exists_and_reuses_shared_logic(): + """A61/A62: должен существовать способ остановить хаб не из терминала руками. + + На Windows это «Exit» из системного трея HermesHubWeb.exe. На Linux до + этого не было ничего — ни кнопки в интерфейсе (её нет ни на одной + платформе), ни трея, ни пункта меню: сервер, оставленный в фоне после + закрытия окна браузера, можно было остановить только pkill'ом из + терминала. launcher/hermes-hub-stop.sh — недостающий эквивалент, + устанавливается install-linux.sh как второй пункт меню приложений. + """ + stop_sh = (LAUNCHER_DIR / "hermes-hub-stop.sh").read_text(encoding="utf-8") + assert "#!/usr/bin/env bash" in stop_sh + assert "stop_running_hub" in stop_sh + + lib_sh = (INSTALLER_DIR / "lib_stop_running_hub.sh").read_text(encoding="utf-8") + assert "stop_running_hub()" in lib_sh + # Общий источник, а не третья копия той же функции: install и uninstall + # обязаны ссылаться на тот же файл, а не хранить свою версию. + install_sh = (INSTALLER_DIR / "install-linux.sh").read_text(encoding="utf-8") + uninstall_sh = (INSTALLER_DIR / "uninstall-linux.sh").read_text(encoding="utf-8") + for script_name, script_text in (("install-linux.sh", install_sh), ("uninstall-linux.sh", uninstall_sh)): + assert "lib_stop_running_hub.sh" in script_text, f"{script_name} не источает общую функцию" + assert script_text.count("stop_running_hub() {") == 0, ( + f"{script_name} держит собственную копию функции вместо общего источника" + ) + + assert "hermes-hub-stop" in install_sh, "install-linux.sh не разворачивает лаунчер остановки" + assert "hermes-hub-stop.desktop" in install_sh, "у лаунчера остановки нет пункта меню" + assert "hermes-hub-stop" in uninstall_sh, "uninstall-linux.sh не убирает лаунчер остановки"