OpenCode TUI (интерфейс терминала)

OpenCode предоставляет интерактивный терминальный интерфейс (TUI, терминальный пользовательский интерфейс) для эффективной совместной разработки с ИИ в командной строке.

TUI — основной способ использования OpenCode; весь анализ, изменение и выполнение кода выполняются через этот интерфейс.

OpenCode TUI по сути представляет собой диалоговый терминал с ИИ, который может выполнять команды, объединяя разработку, командную строку и ИИ.

Все команды TUI используют слэш/для вызова.

В поле ввода TUI введите/, и он покажет список предлагаемых команд:

Команды OpenCode TUI

Ниже приведена таблица команд OpenCode TUI:

Команда Описание Горячая клавиша
/connect Добавить провайдера LLM и настроить API-ключ —
/compact (/summarize) Уплотнить контекст текущей сессии ctrl + x → c
/details Переключить отображение деталей выполнения инструментов ctrl + x → d
/editor Открыть внешний редактор для написания сообщений ctrl + x → e
/exit (/quit / /q) Выйти из TUI ctrl + x → q
/export Экспортировать текущую беседу как Markdown ctrl + x → x
/help Открыть панель справки ctrl + x → h
/init Создать/обновить AGENTS.md ctrl + x → i
/models Список доступных моделей ctrl + x → m
/new (/clear) Новая сессия ctrl + x → n
/redo Повторить/undoотменённые операции ctrl + x → r
/sessions (/resume / /continue) Список сессий и переключение ctrl + x → l
/share Поделиться текущей сессией ctrl + x → s
/themes Список/Переключение тем ctrl + x → t
/thinking Показать/Скрыть процесс рассуждения модели —
/undo Отменить последнее сообщение (включая изменения файлов) ctrl + x → u
/unshare Отменить общий доступ к сеансу —

Дополнение к основному взаимодействию TUI (команды без слэша)

Type Синтаксис Описание
Запуск opencode Запустить TUI в текущем каталоге
Указать каталог opencode /path Открыть указанный проект
Ссылка на файл @file Нечёткий поиск и внедрение содержимого файла
Выполнить команду !command Выполнить команду оболочки и вернуть результат

TUI в OpenCode — это по сутиLLM + контекст проекта + управление состоянием Git + палитра команд— составной слой взаимодействия:

  • /→ Управление поведением (аналогично палитре команд IDE)
  • @→ Внедрить контекст (RAG уровня файла)
  • !→ Выполнить операции окружения (вызовы инструмента Shell)
  • ctrl+x→ Префикс для эффективных быстрых операций

I. Запуск TUI

1. Запуск в текущем каталоге

opencode

Если вы видитеEACCES: permission denied, open ''это проблема с правами доступа; мы можем исправить разрешения каталога:

sudo chown -R $(whoami) ~/.local

Затем выполните:

chmod -R 755 ~/.local

Можно также пойти более грубым путём и просто использоватьsudo：

sudo opencode

автоматически загрузит текущий проект в качестве рабочего каталога:

2. Запуск в указанном каталоге проекта

opencode /path/to/project

Подходит для быстрого переключения между проектами

II. Базовое взаимодействие

После входа в TUI вы можете напрямую вводить текст на естественном языке:

Help me quickly summarize the structure of this project.

OpenCode предоставит результаты анализа на основе кода проекта:

III. Ссылки на файлы (основная функция)

Вы можете использовать@для ссылки на файлы в проекте:

这个项目的认证逻辑是如何实现的？查看 @packages/functions/src/api/index.ts

Возможности:

  • Поддерживает нечёткий поиск путей к файлам
  • Автоматически читает содержимое файла
  • Не нужно копировать код

Отлично подходит для чтения незнакомого кода

IV. Выполнение команд Bash

Нажмите!, чтобы переключиться в режим shell; содержимое в этом режиме будет выполняться как команды shell:

!

Выполнить команду:

ls -la

Результаты выполнения будут автоматически добавлены в контекст диалога.

Так мы можем спрашивать ИИ во время выполнения системных команд.

V. Слэш-команды (/ команды)

Введите/, чтобы выполнить встроенные команды, например:

/help

Откройте панель помощи.

Основные команды: краткий обзор

Команда Описание
/connect Настроить API модели
/models Просмотреть доступные модели
/init Инициализировать конфигурацию проекта (сгенерировать AGENTS.md)
/new Новая сессия
/sessions Переключить сессию
/undo Отменить изменения (включая код)
/redo Повторить изменения
/share Поделиться текущим разговором
/export Экспортировать разговор в Markdown
/exit Выйти из OpenCode

VI. Сочетания клавиш (повышение эффективности)

OpenCode поддерживает сочетания клавиш:

Функция Горячая клавиша
Палитра команд Ctrl + X → H
Новая сессия Ctrl + X → N
Отменить Ctrl + X → U
Повторить Ctrl + X → R
Список моделей Ctrl + X → M

Примечание:

  • Ctrl + X — это "leader key" по умолчанию
  • Аналогично режиму привязки клавиш Vim

VII. Интеграция с редактором (/editor)

Вы можете использовать внешний редактор для написания сложных промптов:

/editor

Требуется предварительная настройка:

export EDITOR="code --wait"

Поддерживаемые редакторы:

  • VS Code (code)
  • Cursor (cursor)
  • Vim / Neovim
  • Nano

VIII. Управление сессиями

Просмотр сессий

/sessions

Новая сессия

/new

Вы можете переключаться между несколькими задачами

IX. Отмена и повтор (важно)

Отменить

/undo

Функции:

  • Отмена сообщений
  • Откат изменений кода

Повторить

/redo

Примечание:

  • Зависит от Git для управления изменениями кода
  • Рекомендуется включить Git для проекта

X. Настройка TUI

Вы можете настроить поведение с помощью файлов конфигурации:

opencode.json

Пример:

{
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

Пояснение:

  • scroll_speed: скорость прокрутки
  • scroll_acceleration: плавная прокрутка (рекомендуется включить)

XI. Рекомендации по использованию

  • Чаще используйте@ссылки на файлы для повышения точности
  • Для сложных задач сначала используйте режим планирования; используйтеTabклавишу для переключения режимов.
  • Итерируйте небольшими шагами; не делайте ничего слишком сложного сразу.
  • Перед важными операциями убедитесь, что изменения закоммичены в Git.
Другие расширения