CodeNomad/docs/help/ru/missions.md
Pascal André 1dabb5110f
docs(help): bring the user guide back in line with the current app (#1079)
docs(help): bring the user guide back in line with the current app

The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer.

Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages.

The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English.

Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
2026-10-21 14:38:29 +02:00

30 KiB
Raw Permalink Blame History

Миссии

Миссии соединяют долговременный план проекта с нативными разговорами OpenCode. Координатор планирует и делегирует; дерево задач фиксирует зависимости и результаты. Сохранённый план, допущенный ввод и наблюдаемое выполнение — разные факты.

Создайте, затем явно запустите

  1. Откройте Миссии на правой панели и выберите Создать миссию.
  2. Заполните Что должна сделать миссия? и проверьте Название, предзаполненное из первого предложения (до 60 символов).
  3. В Когда выберите Один раз или Каждый день в. Для ежедневной работы проверьте показанный часовой пояс; Изменить позволяет указать зону IANA.
  4. Раскройте Параметры для Сценарий, Заметки, Агенты и модели, Сессии задач, сохранённых описаний и необязательных отслеживаемых разговоров. При Сравнить две модели переключатели Модель A и Модель B появляются в основной форме.
  5. Нажмите Создать. Выберите новую запись, затем отдельное действие ▶, когда готовы: Запустить миссию для разовой работы или Запустить расписание {id} для ежедневного расписания.

Создание никогда не запускает работу. Разовая миссия подготовлена; ежедневное расписание приостановлено. Ни создание, ни сохранение описания не включает таймер. Создание ограничено выбранным проектом/Location и фиксирует запрошенные профили и политику сессий задач. Проверка находится у соответствующего поля; отказ с указанием, что ничего не отправлено, оставляет черновик для исправления. Координатор разовой миссии также может подготовить для вас отдельную миссию, например продолжение: она появляется в списке как Подготовлена и, как любая миссия, запускается только своим действием ▶.

Сценарии

Сценарий Предназначенная работа
Гибкая миссия Координатор выбирает учитывающий зависимости план для цели.
Отладка Диагностика, реализация, отдельная проверка стандартов/спецификации и свежая валидация; этап устранения проблемы продолжает разговор с исполнителем.
Исследование Карта неопределённостей и ограниченные решения с вопросами человеку.
Реализация продукта Координация ролей продуктового анализа, архитектуры, реализации и качества.
Сравнить две модели Выполняет одну и ту же задачу с одинаковыми заданиями на Модель A и Модель B, затем Слепой судья оценивает обе под нейтральными метками и выносит вердикт: Победила модель A, Победила модель B, Равнозначны или Недостаточно данных.

Для Сравнить две модели обе модели обязательны и должны различаться; другой уровень Мышление сам по себе не делает модель другой. Если вы не выберете судью, он использует модель координатора; форма предупреждает, когда она совпадает с A или B, что может исказить сравнение. Обзор показывает вердикт, названия обеих моделей и оценки по критериям.

Сценарий направляет координацию; он не обходит нативные разрешения и не гарантирует успех. На вопросы решений исследования отвечайте через панель прерываний CodeNomad, чтобы зафиксировать явный ответ интерфейса, а не просите агента изобразить одобрение.

Следите за деревом и читайте результаты

  1. Выберите название миссии. Начальная стрелка держит список открытым; поле названия открывает временный выбор.
  2. Выберите Сводка (глаз) для центрального обзора или узел задачи для её точного результата, задания и доказательств.
  3. Следуйте ссылкам зависимостей и Отчёты; используйте Открыть разговор координатора для просмотра переписки.
  4. В Нужен ваш ответ нажмите Ответить, чтобы открыть разговор спрашивающего участника и панель прерываний.
Индикатор Что устанавливает
Назначено Ввод допущен; обработка моделью/работа/завершение не доказаны.
Активно Наблюдалась нативная активность.
Ожидание Объявленные зависимости ещё не выполнены.
Заблокировано Сообщено препятствие, не обязательно вопрос вам.
Ждёт вашего ответа Открытая нативная форма/вопрос или разрешение требует ответа; она указана в Нужен ваш ответ.
Готово Записан результат задачи; проверьте доказательства и оставшуюся нативную работу.
Сбой / Снята Задача не удалась, либо координатор заменил её или отказался от неё.

Граф включает завершённую и выведенную из плана работу. Вывод задачи из плана сам по себе не останавливает её разговор. В разовой миссии координатор может отдельно остановить разговоры выведенной задачи, которую он запустил как нативного субагента, не затрагивая другие задачи. Выполняется — состояние жизненного цикла миссии, не доказательство текущей работы координатора. Полный текст находится в центральном просмотрщике, а не списке задач панели; Технические сведения сворачивает идентификаторы и запрошенную информацию выполнения.

Сводки и запросы обновлений

Координатору предписано публиковать сводку проекта после начального плана, завершения задач, при ожидании человека и перед финальным отчётом. Это авторская оценка, не живой счётчик активности и не гарантированный периодический сигнал. Уведомление показывает изменение карты с момента сводки.

Используйте Запросить сводку под панелью инструментов для новой оценки координатора, затем читайте Сводка. Сводка запрошена… означает ожидание запроса, не ответ. Отправка не подтверждена не разрешает автоматическую повторную отправку: откройте разговор координатора перед отдельным новым запросом. Это обычный нативный ввод, не песочница только для чтения; координатор сохраняет обычные разрешения.

Профили, делегирование и глубина

  1. Используйте шестерёнку миссий или Настройки → Миссии для изменения Настройки новых миссий.
  2. В Применять к выберите Все миссии или один сценарий, затем задайте Сессии задач и в Агенты и модели по одной строке на роль (координатор, затем роли сценария). Каждый выбор сохраняется сразу; кнопки «Сохранить» нет.
  3. В области сценария строки показывают глобальные значения с пометкой Глобально. Изменение поля настраивает эту роль, начиная с этих значений; её значок возврата снова использует глобальные значения. Сбросить (после подтверждения) очищает только агентов и модели показанной области.
  4. При создании используйте Параметры → Агенты и модели для конкретных запрошенных профилей; Использовать сохранённые настройки возвращает сохранённые.
  5. Для нативного ограничения рекурсии измените Глубина вложенности подсессий → Глубина, заданная для проекта. Нажатие Enter или уход с поля сохраняет изменённое допустимое значение; Наследовать сохраняет сразу; Escape отменяет несохранённое значение.
Настройка Область и эффект
Настройки новых миссий Значения всей конфигурации только для новых миссий; исключение сценария переопределяет общее значение.
Агент / Модель / Мышление Запрошенный выбор координатора/ролей фиксируется при создании; занятого участника не переключают незаметно ради последующей работы. Ежедневные запуски повторно используют фиксированные запрошенные профили.
Нативные субагенты Сессии задач используют нативных агентов subagent/all под координатором.
Независимые сессии Объявленные сессии задач используют агентов primary/all и независимые разговоры; это не отключает внутренних нативных помощников.
Глубина вложенности подсессий Конфигурация проекта для всех разговоров OpenCode там, не только миссий. Пустое значение наследуется. Сохранение не перезагружает OpenCode и не меняет работающие разговоры.

Нативное значение по умолчанию и Глобально различаются: первое запрашивает собственные значения OpenCode, второе наследует глобальный выбор; выбор нативных значений в области сценария остаётся явным исключением. Доступность каталога проверяется; запрошенный профиль не доказывает текущий профиль разговора. Нативные разрешения и настроенная глубина по-прежнему управляют внутренними вызовами помощников в обоих режимах задач.

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

Повторное использование описания

  1. При создании раскройте Параметры → Начать с сохранённого описания и выберите описание.
  2. Проверьте скопированные цель, заметки, сценарий, профили и делегирование перед Создать.
  3. Используйте Сохранить как описание, чтобы назвать повторно используемый черновик. Выбранная разовая миссия, включая завершённую, тоже предлагает Сохранить как описание.

Описания хранят инструкции и запрошенные варианты, не планы задач, результаты, разговоры, часы расписания или полномочия выполнения. Загрузка заполняет обычный черновик создания; она ничего не запускает и не планирует. Удаление описания сохраняет существующие миссии/разговоры. Настройки → Миссии → Сохранённые описания управляет библиотекой; если библиотека становится нечитаемой, Сбросить сохранённую библиотеку (после подтверждения) удаляет сохранённые описания, не исполнения. У самих расписаний нет сохранения как описания.

Ежедневное время, наверстывание и отслеживаемые разговоры

Ежедневные расписания используют сохранённый часовой пояс IANA и гражданское время, не истекший интервал 24 часа. Время показывается в зоне расписания с подписью, если отличается от зоны читателя. Каждый запуск получает собственного координатора и изолированную карту миссии; выбранное расписание показывает текущее дерево и историю дат/исходов. Выберите прошлый запуск для чтения в центре. История ограничена 30 результатами.

Ситуация Поведение расписания
Пропущено несколько назначенных дней Выполняет только последний наступивший день новее маркера завершённого дня, не очередь всех пропущенных дней.
Пропуск при переходе часов вперёд Сдвигает к первой следующей допустимой минуте; пропуск в конце дня переносит через границу.
Повторяющийся час Использует первое вхождение; не создаёт второй ежедневный запуск.
Полностью пропущенный гражданский день Для него запуска нет.
Часы переведены назад Уже обработанный день не становится назначенным снова.
Имеющийся запуск ещё ожидает Не совмещает его с новым ежедневным запуском.

Время создания тоже ограничивает допустимую ежедневную работу; старт нового расписания не разрешает обрабатывать даты до его существования. Запустить сейчас начинает отдельный ручной запуск, когда доступно; не заменяет ежедневные часы и не обходит ожидающий запуск. Показанное следующее время — проекция, не гарантия точного выполнения.

Отслеживаемые разговоры (необязательно) добавляет ограниченный контекст выбранных разговоров. Только завершённый запуск продвигает курсоры обработанных сообщений; неудачный/прерванный запуск не поглощает этот контекст незаметно. Если инструкции с контекстом превышают вместимость, сократите инструкции или уберите отслеживаемые разговоры, не предполагая чтение неограниченной истории.

Время жизни и перезапуск службы

Компонент Что означает закрытие
Вкладка проекта CodeNomad Закрывает проект в CodeNomad; нативные сессии продолжаются в OpenCode. Откройте проект снова, чтобы найти их.
Всё окно, выход из приложения или перезагрузка интерфейса Сохраняет подключения проектов для восстановления; не останавливает нативную работу или службу OpenCode.
Серверная часть CodeNomad Не останавливает OpenCode. Разовая координация CodeNomad зависит от присутствия серверной части; не предполагайте доступность новых назначений/управления разовой работой, пока она закрыта.
Работающее ежедневное расписание Часы и выполнение проходов работают в плагине/службе OpenCode, в том числе при закрытых интерфейсе и серверной части CodeNomad. Хост выполнения и служба OpenCode должны оставаться запущенными.
Перезапуск службы OpenCode Теряет задания расписания в памяти процесса. Расписание с желаемым состоянием работы становится Прервано до явного Возобновить; повторное открытие CodeNomad не включает его заново.

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

Миссии работают в настольных приложениях и с отдельным сервером CodeNomad. Когда панель показывает Центр миссии недоступен, её сообщение называет причину:

Причина Что делать
Рабочая область OpenCode не готова Переподключите проект, затем обновите.
OpenCode не загрузил плагин миссий Обновите чуть позже; если не помогло, используйте Перезагрузить конфигурацию OpenCode в Настройки → OpenCode.
OpenCode не смог загрузить плагин миссий Прочитайте его ошибку в списке плагинов, затем обновите после исправления.
Сервер CodeNomad не смог открыть локальное подключение для миссий (127.0.0.1) Проверьте журнал сервера; перезагрузка OpenCode не поможет.

Пауза, остановка и неопределённые исходы

  1. Выберите запись и проверьте её текущее состояние и разговор перед действием.
  2. Используйте значок паузы для возобновляемой приостановки или значок остановки с подтверждением для окончательной остановки. Подсказки разовой миссии — Приостановить миссию и Окончательно остановить миссию; подсказки расписания называют расписание.
  3. Если результат не подтверждён, используйте Проверить статус / Проверить состояние управления для чтения существующего исхода. Не выдавайте заменяющее действие в обход неопределённости.
  4. Для разовых действий Обновить и повторно отправить неподтверждённое действие в заголовке сначала проверяет состояние и повторяет только то же точное всё ещё неподтверждённое действие по вашему явному нажатию.

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

Ежедневные пауза/остановка отменяют расписание и запрашивают прерывание зарегистрированных корневых участников, включая координатора и независимых специалистов, но не доказывают, что эти разговоры или их потомки остановились. Проверьте нативные семейства. Остановка окончательна: остановленное расписание нельзя запустить, возобновить или запустить сейчас. Проверить прогон согласует ожидающий запуск без повторной отправки. Временные сбои плановой проверки показывают последнюю ошибку и повторяются автоматически; потерянный ответ пользовательского управления не вызывает автоматического повтора управления.

Для разового координатора, простаивающего без отчёта, основное действие ▶ может проверить и восстановить его; задачи имеют целевое восстановление пропавшего отчёта, когда допустимо. Сначала восстановление проверяет нативную активность, потомков и ожидания; неизвестная активность не допускает ввод. Оно не повторяет назначения и не заменяет план. Откройте разговоры для разрешения оставшихся вопросов, разрешений, оболочек или фоновой работы.

Если Создать не подтверждено, окно сохраняет отправленный запрос и блокирует дальнейшее создание для проекта; удаление worktree может оставаться удержанным. Обновление только читает состояние. Закрытие/открытие редактора не исправляет это. Перед перезагрузкой окна проверьте список миссий: перезагрузка снимает локальную блокировку, но это не доказательство неудачного создания. Не создавайте дубликат вслепую после перезагрузки или перезапуска.

Изменение, удаление и очистка разговоров

Используйте Изменить выбранную миссию для редактируемой разовой миссии; при конфликте закройте/откройте редактор для загрузки текущей ревизии, а не перезаписи. Ежедневные расписания не предлагают изменение/удаление.

  1. Для ненужной разовой миссии выберите Удалить выбранную миссию… и проверьте подтверждение.
  2. При желании выберите Также удалить разговоры специалистов, созданные для этой миссии перед подтверждением.
  3. Проверьте Очистка разговоров для количества удалённых/сохранённых/ожидающих. Повторяйте только оставшуюся записанную очистку, если предложено.

Удаление миссии не равно остановке; сначала остановите и проверьте оставшуюся работу. Координаторы и повторно используемые разговоры сохраняются. Общие, перемещённые, имеющие детей специалисты или специалисты с непроверяемой принадлежностью тоже могут сохраняться. Частичная очистка не откатывается и не завершается незаметно в фоне. История завершённой очистки остаётся в просмотрщике обзора.

Нативная работа и управление службой описаны в разделах Разрешения, Разговоры и Настройка OpenCode.