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.
30 KiB
Миссии
Миссии соединяют долговременный план проекта с нативными разговорами OpenCode. Координатор планирует и делегирует; дерево задач фиксирует зависимости и результаты. Сохранённый план, допущенный ввод и наблюдаемое выполнение — разные факты.
Создайте, затем явно запустите
- Откройте Миссии на правой панели и выберите Создать миссию.
- Заполните Что должна сделать миссия? и проверьте Название, предзаполненное из первого предложения (до 60 символов).
- В Когда выберите Один раз или Каждый день в. Для ежедневной работы проверьте показанный часовой пояс; Изменить позволяет указать зону IANA.
- Раскройте Параметры для Сценарий, Заметки, Агенты и модели, Сессии задач, сохранённых описаний и необязательных отслеживаемых разговоров. При Сравнить две модели переключатели Модель A и Модель B появляются в основной форме.
- Нажмите Создать. Выберите новую запись, затем отдельное действие ▶, когда готовы: Запустить миссию для разовой работы или Запустить расписание {id} для ежедневного расписания.
Создание никогда не запускает работу. Разовая миссия подготовлена; ежедневное расписание приостановлено. Ни создание, ни сохранение описания не включает таймер. Создание ограничено выбранным проектом/Location и фиксирует запрошенные профили и политику сессий задач. Проверка находится у соответствующего поля; отказ с указанием, что ничего не отправлено, оставляет черновик для исправления. Координатор разовой миссии также может подготовить для вас отдельную миссию, например продолжение: она появляется в списке как Подготовлена и, как любая миссия, запускается только своим действием ▶.
Сценарии
| Сценарий | Предназначенная работа |
|---|---|
| Гибкая миссия | Координатор выбирает учитывающий зависимости план для цели. |
| Отладка | Диагностика, реализация, отдельная проверка стандартов/спецификации и свежая валидация; этап устранения проблемы продолжает разговор с исполнителем. |
| Исследование | Карта неопределённостей и ограниченные решения с вопросами человеку. |
| Реализация продукта | Координация ролей продуктового анализа, архитектуры, реализации и качества. |
| Сравнить две модели | Выполняет одну и ту же задачу с одинаковыми заданиями на Модель A и Модель B, затем Слепой судья оценивает обе под нейтральными метками и выносит вердикт: Победила модель A, Победила модель B, Равнозначны или Недостаточно данных. |
Для Сравнить две модели обе модели обязательны и должны различаться; другой уровень Мышление сам по себе не делает модель другой. Если вы не выберете судью, он использует модель координатора; форма предупреждает, когда она совпадает с A или B, что может исказить сравнение. Обзор показывает вердикт, названия обеих моделей и оценки по критериям.
Сценарий направляет координацию; он не обходит нативные разрешения и не гарантирует успех. На вопросы решений исследования отвечайте через панель прерываний CodeNomad, чтобы зафиксировать явный ответ интерфейса, а не просите агента изобразить одобрение.
Следите за деревом и читайте результаты
- Выберите название миссии. Начальная стрелка держит список открытым; поле названия открывает временный выбор.
- Выберите Сводка (глаз) для центрального обзора или узел задачи для её точного результата, задания и доказательств.
- Следуйте ссылкам зависимостей и Отчёты; используйте Открыть разговор координатора для просмотра переписки.
- В Нужен ваш ответ нажмите Ответить, чтобы открыть разговор спрашивающего участника и панель прерываний.
| Индикатор | Что устанавливает |
|---|---|
| Назначено | Ввод допущен; обработка моделью/работа/завершение не доказаны. |
| Активно | Наблюдалась нативная активность. |
| Ожидание | Объявленные зависимости ещё не выполнены. |
| Заблокировано | Сообщено препятствие, не обязательно вопрос вам. |
| Ждёт вашего ответа | Открытая нативная форма/вопрос или разрешение требует ответа; она указана в Нужен ваш ответ. |
| Готово | Записан результат задачи; проверьте доказательства и оставшуюся нативную работу. |
| Сбой / Снята | Задача не удалась, либо координатор заменил её или отказался от неё. |
Граф включает завершённую и выведенную из плана работу. Вывод задачи из плана сам по себе не останавливает её разговор. В разовой миссии координатор может отдельно остановить разговоры выведенной задачи, которую он запустил как нативного субагента, не затрагивая другие задачи. Выполняется — состояние жизненного цикла миссии, не доказательство текущей работы координатора. Полный текст находится в центральном просмотрщике, а не списке задач панели; Технические сведения сворачивает идентификаторы и запрошенную информацию выполнения.
Сводки и запросы обновлений
Координатору предписано публиковать сводку проекта после начального плана, завершения задач, при ожидании человека и перед финальным отчётом. Это авторская оценка, не живой счётчик активности и не гарантированный периодический сигнал. Уведомление показывает изменение карты с момента сводки.
Используйте Запросить сводку под панелью инструментов для новой оценки координатора, затем читайте Сводка. Сводка запрошена… означает ожидание запроса, не ответ. Отправка не подтверждена не разрешает автоматическую повторную отправку: откройте разговор координатора перед отдельным новым запросом. Это обычный нативный ввод, не песочница только для чтения; координатор сохраняет обычные разрешения.
Профили, делегирование и глубина
- Используйте шестерёнку миссий или Настройки → Миссии для изменения Настройки новых миссий.
- В Применять к выберите Все миссии или один сценарий, затем задайте Сессии задач и в Агенты и модели по одной строке на роль (координатор, затем роли сценария). Каждый выбор сохраняется сразу; кнопки «Сохранить» нет.
- В области сценария строки показывают глобальные значения с пометкой Глобально. Изменение поля настраивает эту роль, начиная с этих значений; её значок возврата снова использует глобальные значения. Сбросить (после подтверждения) очищает только агентов и модели показанной области.
- При создании используйте Параметры → Агенты и модели для конкретных запрошенных профилей; Использовать сохранённые настройки возвращает сохранённые.
- Для нативного ограничения рекурсии измените Глубина вложенности подсессий → Глубина, заданная для проекта. Нажатие Enter или уход с поля сохраняет изменённое допустимое значение; Наследовать сохраняет сразу; Escape отменяет несохранённое значение.
| Настройка | Область и эффект |
|---|---|
| Настройки новых миссий | Значения всей конфигурации только для новых миссий; исключение сценария переопределяет общее значение. |
| Агент / Модель / Мышление | Запрошенный выбор координатора/ролей фиксируется при создании; занятого участника не переключают незаметно ради последующей работы. Ежедневные запуски повторно используют фиксированные запрошенные профили. |
| Нативные субагенты | Сессии задач используют нативных агентов subagent/all под координатором. |
| Независимые сессии | Объявленные сессии задач используют агентов primary/all и независимые разговоры; это не отключает внутренних нативных помощников. |
| Глубина вложенности подсессий | Конфигурация проекта для всех разговоров OpenCode там, не только миссий. Пустое значение наследуется. Сохранение не перезагружает OpenCode и не меняет работающие разговоры. |
Нативное значение по умолчанию и Глобально различаются: первое запрашивает собственные значения OpenCode, второе наследует глобальный выбор; выбор нативных значений в области сценария остаётся явным исключением. Доступность каталога проверяется; запрошенный профиль не доказывает текущий профиль разговора. Нативные разрешения и настроенная глубина по-прежнему управляют внутренними вызовами помощников в обоих режимах задач.
Отклонённый или неподтверждённый выбор никогда не отправляется повторно: снова показываются сохранённые значения, а Обновить появляется, только если их не удаётся прочитать. Если изменение глубины не подтверждено, ваше значение сохраняется; используйте Обновить глубину проекта перед новым изменением. Не трактуйте Действующая глубина OpenCode неизвестна как ноль или отключение.
Повторное использование описания
- При создании раскройте Параметры → Начать с сохранённого описания и выберите описание.
- Проверьте скопированные цель, заметки, сценарий, профили и делегирование перед Создать.
- Используйте Сохранить как описание, чтобы назвать повторно используемый черновик. Выбранная разовая миссия, включая завершённую, тоже предлагает Сохранить как описание.
Описания хранят инструкции и запрошенные варианты, не планы задач, результаты, разговоры, часы расписания или полномочия выполнения. Загрузка заполняет обычный черновик создания; она ничего не запускает и не планирует. Удаление описания сохраняет существующие миссии/разговоры. Настройки → Миссии → Сохранённые описания управляет библиотекой; если библиотека становится нечитаемой, Сбросить сохранённую библиотеку (после подтверждения) удаляет сохранённые описания, не исполнения. У самих расписаний нет сохранения как описания.
Ежедневное время, наверстывание и отслеживаемые разговоры
Ежедневные расписания используют сохранённый часовой пояс 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 не поможет. |
Пауза, остановка и неопределённые исходы
- Выберите запись и проверьте её текущее состояние и разговор перед действием.
- Используйте значок паузы для возобновляемой приостановки или значок остановки с подтверждением для окончательной остановки. Подсказки разовой миссии — Приостановить миссию и Окончательно остановить миссию; подсказки расписания называют расписание.
- Если результат не подтверждён, используйте Проверить статус / Проверить состояние управления для чтения существующего исхода. Не выдавайте заменяющее действие в обход неопределённости.
- Для разовых действий Обновить и повторно отправить неподтверждённое действие в заголовке сначала проверяет состояние и повторяет только то же точное всё ещё неподтверждённое действие по вашему явному нажатию.
Разовая пауза прерывает нативное семейство миссии и приостанавливает координацию; остановка также отменяет семейные входящие/доставки в очереди и окончательна. Операции ограничены: Некоторые субагенты, возможно, ещё работают. означает неполную остановку. Проверьте сохранённый результат и используйте явный повтор, а не предполагайте отмену всех последствий оболочки/инструментов. Возобновление сообщает координатору о прерванных потомках; он должен решить, как продолжать.
Ежедневные пауза/остановка отменяют расписание и запрашивают прерывание зарегистрированных корневых участников, включая координатора и независимых специалистов, но не доказывают, что эти разговоры или их потомки остановились. Проверьте нативные семейства. Остановка окончательна: остановленное расписание нельзя запустить, возобновить или запустить сейчас. Проверить прогон согласует ожидающий запуск без повторной отправки. Временные сбои плановой проверки показывают последнюю ошибку и повторяются автоматически; потерянный ответ пользовательского управления не вызывает автоматического повтора управления.
Для разового координатора, простаивающего без отчёта, основное действие ▶ может проверить и восстановить его; задачи имеют целевое восстановление пропавшего отчёта, когда допустимо. Сначала восстановление проверяет нативную активность, потомков и ожидания; неизвестная активность не допускает ввод. Оно не повторяет назначения и не заменяет план. Откройте разговоры для разрешения оставшихся вопросов, разрешений, оболочек или фоновой работы.
Если Создать не подтверждено, окно сохраняет отправленный запрос и блокирует дальнейшее создание для проекта; удаление worktree может оставаться удержанным. Обновление только читает состояние. Закрытие/открытие редактора не исправляет это. Перед перезагрузкой окна проверьте список миссий: перезагрузка снимает локальную блокировку, но это не доказательство неудачного создания. Не создавайте дубликат вслепую после перезагрузки или перезапуска.
Изменение, удаление и очистка разговоров
Используйте Изменить выбранную миссию для редактируемой разовой миссии; при конфликте закройте/откройте редактор для загрузки текущей ревизии, а не перезаписи. Ежедневные расписания не предлагают изменение/удаление.
- Для ненужной разовой миссии выберите Удалить выбранную миссию… и проверьте подтверждение.
- При желании выберите Также удалить разговоры специалистов, созданные для этой миссии перед подтверждением.
- Проверьте Очистка разговоров для количества удалённых/сохранённых/ожидающих. Повторяйте только оставшуюся записанную очистку, если предложено.
Удаление миссии не равно остановке; сначала остановите и проверьте оставшуюся работу. Координаторы и повторно используемые разговоры сохраняются. Общие, перемещённые, имеющие детей специалисты или специалисты с непроверяемой принадлежностью тоже могут сохраняться. Частичная очистка не откатывается и не завершается незаметно в фоне. История завершённой очистки остаётся в просмотрщике обзора.
Нативная работа и управление службой описаны в разделах Разрешения, Разговоры и Настройка OpenCode.