installer/install-linux.sh

@@ -49,51 +49,8 @@ echo ""
 # крутить старый код в памяти, и владелец видел прежний интерфейс при новом
 # номере сборки. Три сборки подряд ставились в файлы, но не в работу.
 echo "[0/6] Остановка работающего Hermes Hub..."
-
+# shellcheck source=./lib_stop_running_hub.sh
-stop_running_hub() {
+. "$SCRIPT_DIR/lib_stop_running_hub.sh"
-    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
-}
-
 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 <<EOF > "$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

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
+}

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                 "

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

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 не убирает лаунчер остановки"