1dabb5110f
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.
18 KiB
Разговоры
CodeNomad представляет нативные сессии OpenCode как разговоры с иерархией делегированной работы и отдельными средствами управления следующей отправкой.
Сообщения отображают Markdown, код, диффы и поддерживаемые изображения из результатов инструментов. Копирование текста, поиск по всей истории и озвучивание используют текстовые проекции, а не байты встроенных изображений. Содержимое сообщений меняет видимость без удаления сохранённых частей; раздел История различает управление отображением и очистку.
Заголовки рассуждений и инструментов показывают, сколько длился каждый шаг, с живым отсчётом во время выполнения; длительность меньше секунды не показывается. Когда в Содержимое сообщений показываются Токены (их показывает набор Всё), каждое сообщение агента завершается одной строкой токенов и стоимости после его последнего текста. Эта строка суммирует само сообщение и сообщения с инструментами и рассуждениями, которые охватывает его действие Удалить инструменты и рассуждения из этого ответа, в пределах загруженной переписки; разверните её, чтобы увидеть счётчики рассуждений и кэша. Шаги, которые только запускали инструменты, собственной строки не имеют.
Поиск разговоров и навигация
- Выберите строку в Сессии или нажмите Новая сессия, чтобы начать родительский разговор.
- Раскройте стрелку родителя для просмотра подсессий. Свёрнутая стрелка показывает самое срочное состояние потомков: ожидание ввода, работа или недавнее завершение (простой); её подсказка подсчитывает их.
- Используйте Поиск сессий…, Основные сессии / Подсессии, фильтр worktree и сортировку Активность, Имя или Worktree, чтобы сузить список.
- Используйте Назад и Вперёд на боковой панели, чтобы вернуться к просмотренным разговорам.
Обычный просмотр иерархический; результаты поиска/фильтра — плоские записи с собственной идентичностью и worktree каждого разговора. Начавшая работу подсессия автоматически показывается только в семействе активного разговора. Сворачивание ветки отменяет этот автоматический показ для выполняющихся сейчас потомков.
Назад/Вперёд — история посещений для каждой вкладки проекта и окна, а не порядок списка. Она хранится в памяти, пропускает недоступные/удалённые разговоры и не восстанавливается после перезапуска. Выбор нового разговора после возврата назад заменяет путь вперёд. Команды палитры Предыдущая сессия / Следующая сессия, напротив, перебирают видимый список.
Выбор агента, модели и мышления
- Перед отправкой используйте переключатели агента и модели внизу поля ввода.
- Если модель предоставляет варианты, выберите уровень Мышление; По умолчанию оставляет нативное значение по умолчанию.
- Отправьте следующий запрос; при диагностике результата проверьте метаданные агента/модели ответа.
Новый разговор начинается с агента, которого OpenCode определяет как агента по умолчанию (его может задать плагин), если вы не выберете другого. Подсказки переключателей показывают их сочетания клавиш.
Это выбор выполнения для последующих отправок, а не изменение прошлых ответов. Чтение старого участка таймлайна не заменяет текущий выбор в поле ввода историческими метаданными. Видимость моделей, избранное и подключения провайдеров настраиваются в разделе Провайдеры.
Черновики и вложения
- Пишите в выбранном разговоре. Переключение разговора сохраняет черновик, а не отправляет его.
- Для файлов с этого устройства выберите Прикрепить файл… в меню Больше действий поля ввода либо перетащите или вставьте их; или введите
@, чтобы выбрать файлы проекта, агентов или навыки. - Проверьте метки вложений и удалите всё, что не предназначено для следующей отправки.
| Ввод | Источник и эффект |
|---|---|
| Вложение с устройства | Выбор файла, перетаскивание или буфер обмена читают байты с устройства, где работает интерфейс; это не серверный путь |
Ссылка проекта @ |
Разрешается в проекте/Location разговора на серверной части, включая его worktree |
| Упоминание агента | Прикрепляет ссылку на выбранного агента, не меняя прошлые сообщения |
| Навык | Ищет навыки Location по имени/описанию и прикрепляет удаляемый выбранный навык |
Файлы устройства должны быть читаемыми и укладываться в лимиты вложений: не более 5 МиБ каждый, 10 файлов и 20 МиБ суммарно. Отклонённый файл не прикрепляется; прочитайте уведомление, не предполагая успех всего выбора.
Выбор навыка удаляет токен @query и добавляет метку. Отправка очищает выбор в поле ввода, но не инструкции, уже сохранённые OpenCode с отправленным сообщением. Исторические сообщения сохраняют названия навыков. Удаление навыка при редактировании запроса в очереди сохраняется и в заменяющей отправке.
На настольных устройствах отправка переводит фокус клавиатуры на разговор, поэтому стрелки, листание и пробел прокручивают его; ввод символа возвращает в поле ввода вместе с этим символом. Очистить текст prompt в Больше действий (по умолчанию Ctrl/Cmd+K) очищает черновик в поле ввода.
Черновики — клиентское рабочее состояние, а не общие нативные сообщения. Восстановление при запуске может сохранять поддерживаемое состояние поля ввода, но не считайте неотправленный черновик или вложение резервной копией и не предполагайте их наличие на другом устройстве. Сохраните важный текст перед очисткой данных запуска или закрытием клиента с отключённым восстановлением; см. настольное приложение.
Команды и режим Shell
- Введите
/, выберите обнаруженную пользовательскую команду и укажите аргументы. - Для прямой команды оболочки введите
!в начале пустого поля ввода, чтобы включить Режим shell. - Отправьте команду. Чтобы выйти из режима Shell без выполнения, нажмите Escape или Backspace в пустом поле.
Только известные имена команд со слешем идут по пути пользовательских команд; неизвестный /text — обычный запрос. Пользовательские команды используют своё нативное определение. Вложения файлов/изображений не отправляются этим путём и остаются для следующего запроса; вставленный текст, используемый в аргументах, включается в аргументы.
Режим Shell выполняет нативный запрос оболочки сессии, а не просит модель предложить команду. Он может менять файлы и запускать процессы на хосте выполнения. Настройки окружения профиля применяются перед следующим запросом, пользовательской командой или запросом оболочки; они не перезапускают существующую службу. См. интеграции и настройку OpenCode.
Направление, очередь и редактирование последующих запросов
- В Настройки → Общие включите Ставить отправленные промпты в очередь, чтобы последующие запросы, отправленные во время работы сессии, вставали в очередь; оставьте выключенным (по умолчанию), чтобы направлять текущую задачу.
- Пока сессия занята, отправьте последующий запрос с этим поведением. Для другого поведения выберите Поставить сообщение в очередь или Направить сейчас в меню Больше действий поля ввода либо используйте альтернативное сочетание отправки (по умолчанию Alt+Enter в Windows и Linux, Cmd+Shift+Return в macOS; см. Горячие клавиши).
- Пока запись ожидает в очереди запросов, используйте Направить сейчас, Переместить в очередь, Изменить запрос в очереди или Удалить запрос из очереди.
| Доставка | Эффект |
|---|---|
| Направить | Нативный направляющий ввод для текущего выполнения |
| В очередь | Нативный последующий запрос в очереди для дальнейшей обработки |
В состоянии покоя обычная отправка использует стандартный немедленный путь независимо от этого переключателя, а альтернатива в Больше действий недоступна. Редактирование возвращает ожидающий запрос и его удаляемые вложения в поле ввода; Отменить редактирование завершает редактирование. Уже принятый в обработку OpenCode запрос больше не является редактируемой ожидающей записью. Удаление записи не отменяет выполненную работу.
При ошибке изменения очереди проверьте её актуальное состояние перед повтором. Допуск запроса не доказывает, что модель обработала его, а переподключение не даёт основания отправлять его снова.
Побочный вопрос через /btw
- Отправьте
/btw your questionв существующем разговоре или/btw, чтобы открыть окно побочного вопроса. - Прочитайте ответ, используйте Копировать ответ или Отменить вопрос, пока он ожидает.
- Закончив, закройте окно.
Это один отдельный запрос модели с использованием контекста сессии. Он не запускает цикл инструментов, не выполняет действия и не добавляет вопрос/ответ в разговор. Вложения файлов/изображений остаются в поле ввода; вставленный текст вопроса включается как текст. Это не новый долговременный разговор и не альтернативный способ поручать работу.
Закрытие отменяет ожидающий побочный запрос, не прерывая основную сессию. Уход из активного разговора очищает это временное окно; сначала скопируйте нужное. Пустые ответы/ошибки показываются здесь, не становясь сообщениями переписки.
Форк, отмена и восстановление неудачного запуска
- В сообщении выберите Создать форк после этого сообщения, чтобы создать разговор после этой точки, не заменяя исходный.
- Для отмены внимательно проверьте Отменить изменения до этого места (удалит сообщения). Палитра предлагает Отменить последнее сообщение и Повторить последнее сообщение для подготовленной отмены.
- При сбое выполнения изучите Ошибка сессии, ошибку ответа и подробности Не удалось отправить перед повторной отправкой.
Форк копирует контекст разговора до выбранной точки включительно; он не создаёт worktree Git и не изолирует файлы. Откат — не просто навигация. Перед продолжением проверьте последствия для файлов и границу отмены; используйте форк для альтернативного обсуждения без переписывания исходного пути.
Статус Повтор с обратным отсчётом означает, что OpenCode сам повторяет запрос после ошибки провайдера; дождитесь его или остановите сессию, а не отправляйте снова. Неудачная отправка восстанавливает отправлявшийся черновик и вложения, если это не затрёт более новый ввод. Неудачный запуск мог уже выполнить инструменты: проверьте файлы, ожидающие запросы и нативную активность перед повтором. Перезагрузить сообщения и Обновить сессию читают состояние, а не требуют повторить изменение. Остановить сессию прерывает выполнение, но не откатывает изменения файлов или внешних служб.