Hermes Agent · Учебник 11

Установите Oh My Hermes и запустите проверенный рабочий процесс

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

Бумажный рабочий процесс ручной резки, направляющий запрос через именованные возможности, активное выполнение и отдельный пункт проверки человеком
Время чтения
16 мин
Последнее обновление
Август 2026

0 из 24 завершено

Завершить & далее →

Последнее тестирование и обновление: 12 августа 2026 года против Oh My Hermes 1.0.5 из коммита репозитория 79da09b. Этот проект развивается быстро; проверьте прилагаемое руководство по установке, если какая-либо команда была изменена.

Oh My Hermes (OMH) — это операционный слой для Агент Hermes. Он добавляет маршрутизацию, планирование, исследование, передачу кода, память проекта, контроль качества и отслеживание статуса с учетом доказательств. Он не не заменяет Hermes, не патчит ядро Hermes и не запускает тайно кодового агента самостоятельно.

Это различие — причина его установки: Hermes остается помощником, с которым вы общаетесь. OMH помогает этому помощнику превратить размытый запрос в именованный рабочий процесс, ответственного исполнителя, полезное следующее действие и четкое заявление о том, что произошло или не произошло на самом деле.

Бумажная диорама ручной работы, изображающая пустой запрос, проходящий через три маршрутизирующих шлюза над терминалом, сходящийся на оранжевой печати проверки и выходящий как готовый артефакт

Рисунок 1: OMH располагается поверх разговора с Hermes: уточняет запрос, выбирает возможность и исполнителя, а затем сохраняет окончательное утверждение за верификационным фильтром.

Что вы завершите

К концу этого руководства вы сможете:

  1. установил изолированную omh команду обслуживания;
  2. зарегистрировал стандартный пакет рабочих процессов ядра в Hermes;
  3. использовано omh doctor чтобы отделить локальную готовность от использования Hermes в реальном времени;
  4. перезапустил Hermes и попробовал одну ограниченную задачу с поддержкой доказательств; и
  5. узнал, как обновлять, ремонтировать или удалять интеграцию без догадок.

Это дополнительный урок. Сначала завершите L02: Установите Hermes Agent первый. Вы уже должны уметь открывать Hermes и выполнять базовый чат.

Что добавляет OMH — и что не добавляет

Публичный сайт проекта в настоящее время представляет 103 устанавливаемые навыки, 11 ulw-* долгосрочных рабочих процессов, семь семейств возможностей и маршрутизацию для восьми языков. Рассматривайте эти числа как быстро меняющийся снимок, а не как обещание совместимости; установленный манифест и omh doctor являются локальным источником правды.

Скриншот официального сайта Oh My Hermes, показывающий версию 1.0.5 и текущий рабочий процесс, возможности и количество языков

Рисунок 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.

Скриншот официального раздела установки Oh My Hermes, показывающий команды для macOS, Linux, Windows и настройки

Рисунок 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-среды, которыми не владеет.

Ваш контроль завершения

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

  1. omh --version возвращает версию.
  2. omh doctor имеет нулевые блокирующие проверки.
  3. Hermes был перезапущен или перезагружен после установки.
  4. Одна небольшая задача Hermes произвела ответ с поддержкой OMH, состояния подготовки, выполнения и проверки которого были явно разделены.

Вот в чём разница между «файлы были установлены» и «рабочий процесс готов к использованию».

Источники и дополнительная литература