Hermes Agent · Учебник 11
Установите Oh My Hermes и запустите проверенный рабочий процесс
Добавьте Oh My Hermes к существующей настройке Hermes Agent, проверьте локальную интеграцию, запустите первый рабочий процесс с учётом доказательств и выполните чистое восстановление.

0 из 24 завершено
Последнее тестирование и обновление: 12 августа 2026 года против Oh My Hermes 1.0.5 из коммита репозитория 79da09b. Этот проект развивается быстро; проверьте прилагаемое руководство по установке, если какая-либо команда была изменена.
Oh My Hermes (OMH) — это операционный слой для Агент Hermes. Он добавляет маршрутизацию, планирование, исследование, передачу кода, память проекта, контроль качества и отслеживание статуса с учетом доказательств. Он не не заменяет Hermes, не патчит ядро Hermes и не запускает тайно кодового агента самостоятельно.
Это различие — причина его установки: Hermes остается помощником, с которым вы общаетесь. OMH помогает этому помощнику превратить размытый запрос в именованный рабочий процесс, ответственного исполнителя, полезное следующее действие и четкое заявление о том, что произошло или не произошло на самом деле.
Рисунок 1: OMH располагается поверх разговора с Hermes: уточняет запрос, выбирает возможность и исполнителя, а затем сохраняет окончательное утверждение за верификационным фильтром.
Что вы завершите
К концу этого руководства вы сможете:
- установил изолированную
omhкоманду обслуживания; - зарегистрировал стандартный пакет рабочих процессов ядра в Hermes;
- использовано
omh doctorчтобы отделить локальную готовность от использования Hermes в реальном времени; - перезапустил Hermes и попробовал одну ограниченную задачу с поддержкой доказательств; и
- узнал, как обновлять, ремонтировать или удалять интеграцию без догадок.
Это дополнительный урок. Сначала завершите L02: Установите Hermes Agent первый. Вы уже должны уметь открывать Hermes и выполнять базовый чат.
Что добавляет OMH — и что не добавляет
Публичный сайт проекта в настоящее время представляет 103 устанавливаемые навыки, 11 ulw-* долгосрочных рабочих процессов, семь семейств возможностей и маршрутизацию для восьми языков. Рассматривайте эти числа как быстро меняющийся снимок, а не как обещание совместимости; установленный манифест и omh doctor являются локальным источником правды.
Рисунок 2: Официальная страница проекта на 12 августа 2026 года. Это документальное свидетельство текущей публичной позиции, а не переработанный макет.
Полезная ментальная модель состоит из четырех уровней:
| Слой | Owns | Что считается доказательством |
|---|---|---|
| Агент Hermes | Чат, уточнения, инструменты, навыки и хост-сессия | Ответ или событие инструмента, которое вы фактически наблюдаете в Hermes |
| ОМХ | Выбор рабочего процесса, планы, контракты передачи, локальный статус и политика памяти проекта | Локальная запись OMH, такая как настройка, маршрутизация или подготовленная передача |
| Кодирование или специализированный исполнитель | Реализация, проверка, работа с изображениями, развертывание или другая специализированная работа | Выходные данные и логи, созданные этим исполнителем |
| Контрольная точка верификации | Тесты, обзор, CI, визуальное QA, проверки развертывания или другой явный шаг подтверждения | Названная проверка, которая была успешно выполнена |
OMH может подготовить передачу кода для Codex, Claude Code или другого исполнителя. Подготовленная передача не является доказательством того, что исполнитель выполнил задачу. Слова исполнителя "выполнено" не являются доказательством того, что тесты прошли. Эта граница — самая важная идея продукта.
Перед установкой
Проверьте предварительные условия в том же терминале, где работает Hermes:
python3 --version
Гермес версия
OMH требует Python 3.11 или новее. Для установки из исходников и путей разработки необходим Git. На нативной Windows установщик требует Windows PowerShell 5.1 или новее и загрузчик Python 3.11+.
Решите, где должны храниться навыки:
- Пользовательская область является обычным выбором для одного человека, использующего одно и то же окружение Hermes в разных проектах. Она записывает состояние OMH в
~/.omhи обновляет конфигурацию Hermes в~/.hermes. - Проектная область изолирует навыки и настройки OMH одного репозитория. Выберите её, когда проект требует других рабочих процессов, политики памяти или конфигурации по сравнению с вашей другой работой в Hermes.
Настройка по умолчанию использует память проекта с предварительным просмотром. OMH может собирать локальные кандидаты памяти, но проверенные записи требуются перед тем, как воспоминание перейдет на последующую передачу кодирования. Это память OMH в рамках .omh/memory/; настройка не претендует на редактирование непрозрачной памяти Hermes.
Выберите core или full перед установкой
Используйте профиль по умолчанию core сначала. Он устанавливает маршрутизацию и этаж здоровья, а также основные навыки общения, планирования, статуса, готовности к передаче и наблюдаемости. В моем изолированном тесте текущий профиль core создал девять установленных каталогов навыков OMH и стабильный результат проверки врача.
С full устанавливает значительно более широкий каталог специалистов. Каждый установленный навык вносит руководство, которое Hermes может использовать в своем контексте маршрутизации, поэтому full жертвует большим количеством начального контекста ради мгновенного доступа к большему числу рабочих процессов.
| Выбрать | Когда это подходит | Команда |
|---|---|---|
| Ядро (рекомендуется) | Первоначальная установка; обычное планирование, передача статусов и кодирования | omh setup |
| Полный | Вам уже нужен более широкий каталог исследований, обзоров специалистов, создания или операций | omh setup --full |
Не устанавливайте полную версию только потому, что большее количество кажется лучше. Начните с ядра, выполните одну полезную задачу и расширяйтесь только тогда, когда отсутствующий рабочий процесс блокирует реальную работу.
Установите команду
Официальный установщик для macOS/Linux:
curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh
В Windows PowerShell 5.1 или новее:
irm https://raw.githubusercontent.com/рлаопе/о-мой-Гермес/главный/install.ps1 | iex
Установщик создает изолированную виртуальную среду и предоставляет omh команду. На macOS и Linux команда обычно связывается с ~/.local/bin. В Windows создается omh.cmd shim в %LOCALAPPDATA%\omh\bin и обычно добавляет этот каталог к пользователю PATH.
Рисунок 3: Официальная страница установки разделяет установку команд и omh setup. Эта граница является намеренной: загрузка команды пока не регистрирует навыки с Hermes.
Подтвердите, что команда доступна:
омх --version
Если оболочка говорит omh: command not found, не переустанавливайте сразу. Используйте абсолютный путь команды, напечатанный установщиком, или добавьте напечатанный каталог bin в PATH, откройте новую оболочку и попробуйте снова.
Подключите OMH к Hermes
Запустите настройку явно:
омх настройка
В реальном терминале настройка спрашивает, использовать ли область пользователя или проекта. Обычный результат для области пользователя:
- сгенерированные управляемые навыки в
~/.omh/skills; - эта директория зарегистрирована в Hermes
skills.external_dirs; - управляемый плагин-мост в
~/.hermes/plugins/omh; и - локальная настройка и записи политики памяти в
~/.omh.
Для установки, специфичной для репозитория, выполните:
омх настройка --scope проект
омх --scope проект врач
Настройке не нужны учетные данные Discord, Slack, GitHub, для развертывания или провайдера модели. Не вставляйте нерелевантные секреты в процесс установки.
Проверьте локальную интеграцию
Выполнить:
омх врач
В изолированном профиле macOS я установил OMH 1.0.5, применил сгенерированную регистрацию Hermes и воспроизвел этот результат:
Врач OMH завершен.
Сводка
Статус: ок
Проверки: 34/34 пройдено
Проблемы: 0 критических, 1 предупреждение(ий)
Доступность команд: ок (1/1)
Управляемые навыки: ок (11/11)
Состояние выполнения: ок (3/3)
Регистрация Hermes: ок (4/4)
Цели Hermes: ок (2/2)
Оставшееся предупреждение гласило, что мост плагина готов локально, но использование живого плагина Hermes еще не было зафиксировано. Это честное предупреждение, а не неудачная установка. Перезапустите или перезагрузите Hermes перед утверждением, что сеанс чата может видеть OMH.
Перезапустите Hermes и выполните первую задачу
Закройте и снова откройте Hermes Agent или перезапустите размещённый обёртку или процесс бота, который владеет сессией Hermes. Затем начните с небольшой задачи репозитория, результат которой легко проверить:
Я хочу добавить экспорт CSV в этот репозиторий.
Сначала уточните критерии приемки, затем подготовьте план.
Скажите мне, что готово, что действительно выполнено и что ещё нужно проверить.
Вы должны видеть рекомендацию по рабочему процессу, ответственного или владельца, следующее действие и границу доказательства. Вы должны не не предполагайте, что код написан просто потому, что существует план или передача.
Если вашему обертке нужен явный триггер, текущий quickstart предлагает:
Используйте запрос OMH-to-handoff для: Я хочу безопасно добавить функцию в этот репозиторий.
После настройки, omh quickstart локально выводит подходящие идеи для первой задачи и текущую границу готовности. Это полезная карточка для обслуживания; обычная работа по-прежнему происходит в чате Hermes.
Используйте семейство workflow без запоминания списка команд
Текущий проект группирует работу по выполняемой задаче. Эти представительные ulw-* рабочие процессы полезны после того, как вы подключитесь к более широкому каталогу:
| Скажите это в Hermes | Идея рабочего процесса | Используйте его, когда |
|---|---|---|
| «Интервьюируй меня по одному вопросу за раз, пока бриф не станет ясным.» | ulw-interview | Запрос неоднозначен или дорого стоит ошибка |
| «Сравните варианты, назовите риски и дайте критерии приемки.» | ulw-plan | Вам нужен проверенный план перед выполнением |
| «Исследуйте это по первоисточникам и держите видимой нерешенную неопределенность.» | ulw-research | Ответ зависит от текущих внешних данных |
| «Разделите принятый план на непересекающиеся рабочие потоки.» | ulw-work | Параллельная работа может избежать пересечения файлов и владения |
| «Атакуйте результат враждебными сценариями и исправляйте ошибки.» | ulw-qa | Выпуск или рабочий процесс требует проверки на враждебность |
| «Сохраняйте этот долгосрочный план с контрольными точками через потерянный контекст.» | ulw-goal | Работа переживет одно окно разговора |
Запрос на естественном языке — это входная дверь. Точные названия рабочих процессов — это аварийные выходы для операторов и обертки, а не словарь, который должен запоминать каждый ученик.
Держите подготовленные, выполняемые и проверенные отдельно
Рисунок 4: Подготовленная работа, активная работа и проверенная работа — это разные состояния. Готовая лоток находится после проверки, а не рядом с планом.
Используйте этот язык при проверке состояния OMH:
- План · не запускался: существует полезный план, но ничего не было выполнено.
- Код · выполняется: исполнитель начал работу, и выполнение наблюдается.
- Код · завершено по отчету: исполнитель заявляет о завершении; никто ещё не проверил результат.
- Тест · проверен: наблюдалось прохождение именованного теста, ревью, CI или другого контроля.
Этот словарь предотвращает самую дорогую ошибку агента: принятие скопированного статуса владения языком за доказательство.
Устранение неполадок
| Симптом | Что это значит | Исправить |
|---|---|---|
omh не найдено | Изолированная команда существует, но её каталог bin не находится в этом shell PATH | Используйте абсолютный путь, указанный установщиком, или добавьте этот каталог bin, затем откройте новый shell |
| Доктор сообщает, что конфигурация Hermes или внешний каталог отсутствуют | Файлы рабочего процесса существуют, но регистрация обнаружения Hermes неполная | Запуск omh setup, затем omh doctor; если диагностика конкретно называет регистрацию, продвинутые операторы могут выполнить omh apply |
| Доктор в порядке, но Hermes не показывает OMH | Рабочий процесс Hermes не перезагрузил свою конфигурацию и навыки | Перезапустите или перезагрузите Hermes, затем попробуйте небольшую задачу на естественном языке |
plugin_runtime_observed остаётся предупреждением | Локальный импорт/регистрация прошла проверку, но активное событие плагина Hermes не наблюдалось | Используйте OMH из перезапущенной сессии Hermes перед тем, как заявлять об использовании нативного времени выполнения |
| Область пользователя работает, но область проекта выглядит пустой | Команда обращается к другой домашней директории OMH/Hermes | Запустите доктора с указанием области: omh --scope project doctor |
| Полная версия была установлена, и настройка ядра все еще кажется тяжелой | Настройка не является разрушительной; управляемые навыки только полной версии остаются на диске | Запуск omh skill-profile status, затем предварительный просмотр omh skill-profile reconcile --to core --dry-run перед применением |
| Hermes не установлен или недоступен | OMH может подготовить локальные файлы, но готовность, видимая Hermes, не может быть подтверждена | Сначала установите или исправьте Hermes; не отмечайте интеграцию как активную |
Не использовать --force потому что обычный ремонт не удался. Прочитайте проверку блокировки, сохраните локальные изменения и используйте наиболее узкую команду ремонта, которую она рекомендует.
Обновление без пересборки установки с нуля
Обычный путь обновления:
омх обновление
омх врач
Когда omh поступил от официального изолированного установщика, обновление обновляет как пакет команд, так и управляемые потоки работы. Установка через pip, pipx, distro или настраиваемый Python может обновлять потоки работы, но сообщать, что сам пакет команд не был обновлен. В этом случае следуйте конкретной инструкции установщика, которую он выводит.
Запускайте установку снова только тогда, когда doctor сообщает, что регистрация Hermes требует ремонта. Перезапустите Hermes после изменения регистрации или плагина.
Удалите OMH чисто
Сначала просмотрите очистку:
омх удалить --dry-run
Затем удалите состояние, управляемое OMH, и интеграционные файлы:
омх удалить
Документированный деинсталлятор снимает регистрацию каталога управляемых навыков, удаляет состояние управляемого OMH и пакет управляемого плагина, а также удаляет управляемую установщиком командную среду, если может безопасно её идентифицировать. Он не удаляет несвязанные файлы Hermes, несвязанные плагины или Python-среды, которыми не владеет.
Ваш контроль завершения
Не отмечайте этот учебник как завершённый при выходе установщика. Отмечайте как завершённый, когда выполняются все четыре утверждения:
omh --versionвозвращает версию.omh doctorимеет нулевые блокирующие проверки.- Hermes был перезапущен или перезагружен после установки.
- Одна небольшая задача Hermes произвела ответ с поддержкой OMH, состояния подготовки, выполнения и проверки которого были явно разделены.
Вот в чём разница между «файлы были установлены» и «рабочий процесс готов к использованию».