🇷🇺 Hermes Desktop — русский мод (frozen maintenance)

🇷🇺 Русский · 🇬🇧 English

Полная русская локализация Hermes Desktop.

Последний релиз: v1.2.3.1 · Hermes 0.21.0 · 3 сентября 2026
Статус: frozen maintenance — новые переводы не добавляются, только поддержка хардкодов, пока апстрим их не вынесет.

Зачем этот мод

Официальный русский перевод (ru.ts) влит в Hermes Desktop коммитом a922dad9 (ветка main, v0.21+). Он покрывает каталог i18n: все кнопки, настройки, онбординг и сотни интерфейсных строк.

Однако часть UI остаётся на английском даже при выбранном русском — это хардкоды в компонентах, которые ещё не вынесены в t() ключи: Боты, канбан, сообщения главного процесса (gateway auth, boot-failure), подписи полей настроек, метаданные плагинов.

Этот мод закрывает эти хардкоды — пока апстрим не переведёт их в систему локалей.

Однако официальный ru.ts покрывает не всё и не всегда удачно. Например, один из самых заметных примеров: раздел Skills (EN Capabilities — «Skills, tools, and MCP servers») официально переведён как «Возможности» — слово, которое не отражает ни английское название, ни реальное содержимое раздела, и скорее путает русского пользователя, чем помогает (см. конвенции перевода ниже — там примеры более точного авторского перевода терминов).

А целые разделы меню официальный перевод не покрывает вовсе: вкладки и диалоги Bots (создание бота, групповые чаты, разделы), часть канбана, подписи полей настроек (ru-constants.ts), сообщения main-процесса. Всё это — зона мода, а не каталога.

Нужен Desktop из исходников (hermes desktop / git clone), не portable и не готовый установщик с сайта.

Windows — основной путь. Linux — установщик прогнан автором (Ubuntu 26); после установки — hermes desktop --skip-build. Иконка в меню на Linux — баг апстрима, не мода. macOS — экспериментально, живого прогона нет. Официальный подписанный .app / AppImage с сайта не патчим.

| | Официальный ru.ts (v0.21+) | Этот мод (хардкоды) | |---|---|---| | Каталог i18n (кнопки, настройки, онбординг) | ✅ ~2200 ключей | не трогает | | Хардкоды компонентов: поля настроек, splash, мессенджеры | ❌ | ✅ | | Боты, канбан, main-process (gateway auth, boot-failure) | ❌ | ✅ | | Реестр doctor (746 правил before→after) | — | ✅ | | После hermes update | строки из каталога обновляются | hermes-desktop-ru install |

Как выглядит

Установка

Нужны Node.js 18+ и закрытый Hermes Desktop (сборка 5–10 минут).

Обычный путь клона:

• Windows: %LOCALAPPDATA%\hermes\hermes-agent
• Linux / macOS: ~/.hermes/hermes-agent

npm install -g hermes-desktop-ru
hermes-desktop-ru install

| Команда | Что делает | |---|---| | hermes-desktop-ru install | установить / переустановить. Откатывает tracked-исходники клона к стоку | | hermes-desktop-ru doctor | сухая проверка: ничего не пишет, процессы не убивает | | hermes-desktop-ru uninstall | вернуть packaged app.asar из .stock.bak (клон не трогает) | | hermes-desktop-ru version | версия пакета | | hermes-desktop-ru help | справка |

Клон не там, где обычно:

hermes-desktop-ru install --root /path/to/hermes-agent

Подойдут и HERMES_AGENT_ROOT, и HERMES_HOME.

Без npm: скачайте release zip, распакуйте.

• Windows: install.bat (двойной клик) или install.ps1
• Linux / macOS: ./install.sh или node install.mjs (нужен Node 18+ в PATH; если Desktop уже собирался, его Node часто лежит в ~/.hermes/node)

Перед установкой Desktop должен быть хотя бы раз собран из этого клона (hermes desktop или cd apps/desktop && npm run pack). Установщик ищет app.asar только внутри apps/desktop/release/ (win-unpacked / win-arm64-unpacked / linux-unpacked / linux-arm64-unpacked / Hermes.app).

После УСТАНОВКА OK запускайте Desktop через hermes desktop --skip-build (если язык не сменился сам — Русский в настройках). Не кликайте иконку сразу после установки: обычный hermes desktop пересобирает pack и затирает русский asar.

На Mac после подмены asar установщик ставит ad-hoc подпись. Это не нотаризация Apple: Gatekeeper может всё равно ругнуться. Если Desktop «повреждён» — вы не в том .app (нужен self-built из клона, не скачанный с сайта).

После обновления Hermes

hermes update  →  hermes-desktop-ru install  →  запуск Desktop

hermes update сам по себе не пересобирает уже установленный asar. Старый русский UI может «казаться живым» — это старый бандл. Всегда прогоняйте установщик.

Установщик сначала возвращает tracked-исходники клона к стоку. Если в том же клоне лежат другие ваши патчи — они не переживут установку. doctor этого не делает.

Что покрывает мод (реестр хардкодов)

| Область | Покрытие | |---|---| | Хардкоды компонентов: поля настроек, splash, мессенджеры, темы | ✅ | | Канбан, плагин Bots, сообщения main-процесса (gateway auth, boot-failure) | ✅ | | Реестр doctor (якоря before→after) | ✅ 746 правил |

Официальный каталог ru.ts (v0.21+) покрывает i18n-строки отдельно — мод их не дублирует.

Конвенции перевода

• Имена собственные не трогаем: платформы, плагины, провайдеры, модели, команды, имена тем (Midnight, Catppuccin). Описания тем — переводим.
• Технические термины оставляем как есть: MCP, DIFF, URL, PR, YOLO, JSON.
• Устоявшиеся подписи UI: Artifacts → «Рабочие материалы», Maintenance → «Обслуживание и диагностика», Reasoning → «Рассуждения».
• То, что приходит из бэкенда (логи, CLI, traceback, JSON, сообщения ОС), не переводим.
• Информация от внешних источников (провайдеры памяти, сторонние сервисы) тоже не переводится.

Перед записью гоняется doctor: косметический пропуск или неоднозначный якорь (часто в Bots) оставит пятно по-английски — установка идёт. Остановка только если пропал файл критичного правила (канбан / connection-registry).

Актуальная совместимость и журнал апстрима — в релизах и UPSTREAM-WATCH.md.

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

| Симптом | Что сделать | |---|---| | «не найден клон hermes-agent» | --root или HERMES_AGENT_ROOT | | «не найден packaged app.asar» | соберите Desktop из клона (hermes desktop / npm run pack). Prebuilt с сайта не подойдёт | | Doctor FAIL | пропал файл критичного правила — issue | | Doctor WARN, часть UI на английском | нормально после большого апдейта Bots; дождитесь следующего релиза мода или поставьте как есть | | Пара сотен MISSING при установке на свежий Hermes | нормально: Hermes обновляется по несколько раз в день, а мод — нет. Крупное обновление иногда меняет целые паки локалей разом (так слетали 300+ правил в рамках одной минорной версии). Мод при этом почти всегда ставится и работает — критичные поломки он определяет сам. Если видите ошибку перевода или установщика — создавайте issue, так вы поможете и себе, и другим | | Linux: иконка в меню молчит, из терминала открывается | баг апстрима Hermes, не мод. Запуск: hermes desktop --skip-build | | После мода UI снова английский / иконка крутится | hermes desktop --skip-build. Обычный запуск пересобирает pack и затирает asar | | Access is denied / EBUSY / файл занят | закройте Desktop и шлюз, повторите | | macOS: «приложение повреждено» / Gatekeeper | мод только для self-built .app из клона, не для скачанного с сайта | | Долго на npm ci | нормально после hermes update (3–10 мин) | | Часть UI на английском | doctor, затем install, перезапуск | | Откатить мод | hermes-desktop-ru uninstall (нужен .stock.bak от прошлой установки). Или руками: закройте Desktop → замените resources/app.asar на resources/app.asar.stock.bak → запустите. Полный сброс клона — hermes update |

Баги и непереведённые места: GitHub Issues.

Как это устроено технически (реестр якорей, doctor, asar) — в английском README.

Основа

• warment/hermes-desktop-ru — ранняя база перевода
• anatolijlaptev1991-ctrl/hermes-ru — идеи structural/doctor
• DrMaks22 — словарь и PR #72250

MIT