y83 code / справочник

Фичи Codex

Экран «Features» — это переключатель экспериментальных возможностей движка Codex, к которому подключено приложение. Каждая строка в списке — отдельная фича: что она делает, насколько проверена и можно ли её включить. Переключатель работает сразу, но часть фич вступает в силу только после перезапуска.

раздел
Чат с агентом (Codex)
пунктов возможностей
20
источник
docs/codex/features.md

Возможности

  • Список фич. Каждая строка — название фичи, короткое пояснение одним предложением и тумблер вкл/выкл.
  • Значки под названием. Стадия зрелости (beta, in development, stable, deprecated), default — у фичи заводское значение, no UI — в приложении нет экрана для этой фичи, needs consent — нужно подтверждение.
  • Раскрытие строки. Тап по строке открывает подробности: что делает, на что влияет, в чём риск, описание от разработчиков Codex, ключ в конфиге.
  • Поиск по кнопке с лупой в шапке. Ищет по названию, описанию, стадии и ключевым словам. Слова вводятся через пробел, и подойдут только фичи, где нашлись все.
  • Фильтр по стадиям. Четыре чипа: beta, in development, stable, deprecated. По умолчанию включены первые два — только экспериментальные.
  • Чип «enabled only». Оставляет в списке только включённые фичи.
  • Кнопка копирования в шапке. Кладёт в буфер весь список построчно: имя, стадия, on или off, default или custom. Удобно приложить к вопросу или сравнить состояние до и после.
  • Кнопка обновления в шапке. Перечитывает список у движка.

Технические данные

ПараметрЗначение
Стадии в спискеbeta, underDevelopment, stable, deprecated
Стадии по умолчаниюbeta, underDevelopment
Сколько фич видит приложение126 на текущей версии движка
Сколько под фильтром по умолчанию70 на текущей версии движка
Размер страницы при загрузке200 фич
Максимум страниц загрузки5
Пояснений, написанных в приложении42
Из них помечено как предположение21
Из них требует подтверждения13
Из них помечено «экрана нет»11
Где хранится включённое~/.codex/config.toml, секция features
Ключ конкретной фичиfeatures.<имя флага>

Что показывает раздел

Список приходит от самого движка Codex, а не из приложения. Фичи, помеченные движком как удалённые, приложение убирает совсем: включать в них нечего. Зато к списку добавляются пояснения, написанные вручную, — что фича делает, на что влияет и в чём её риск.

Таких пояснений 42 из 126, и почти половина из них помечена как предположение: текст собран по имени флага, потому что разработчики Codex для этой стадии описания не дают. Такая пометка видна, когда строка раскрыта. Остальные фичи показывают заглушку: «серверный флаг из реестра app-server». Считать её за документацию нельзя.

Сортировка списка простая: сначала включённые, потом по свежести стадии, потом по названию. Так активные фичи всегда сверху и их не нужно искать.

Цифры в шапке

Над списком две цифры: сколько фич включено сейчас и сколько движок вообще знает. Счётчик у заголовка списка — другое: он показывает, сколько строк попало под текущий фильтр. Если включить «enabled only» или добавить стадию, счётчик заголовка уменьшится, а цифры в шапке не изменятся.

Подтверждение для рискованных фич

Если у фичи в приложении описан риск, включение идёт в два шага. Сначала появляется окно с текстом: что делает фича, на что влияет и чем опасна. Только после нажатия «Enable» тумблер переключается. Выключение подтверждения не требует — ломать и так нечего.

Как переключение попадает в движок

Тумблер делает две вещи, и это разные вещи.

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

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

Сообщение о результате уходит не на этот экран, а в список тредов или в чат, поэтому на самом экране результат не видно — ориентируйтесь на положение тумблера.

Что агент умеет

Агент может открыть этот раздел через мост командой app_navigate на экран codex_features, а затем прочитать список командой app_ui_tree — так видно названия фич, стадии и состояние тумблеров.

Сам переключатель агент выполнить не может: MCP-инструмента для управления фичами нет. Это сознательно — часть фич меняет протокол обмена с моделью, и включать их должен человек, который прочитал описание.

Ограничения

  • Фичи, меняющие протокол, могут сделать текущий тред нерабочим. Отдельного «отката всех фич» на экране нет.
  • Часть фич вступает в силу только после перезапуска приложения — это зависит от самой фичи, а не от экрана.
  • Если агент недоступен, список не грузится, а под фильтром висит надпись «Loading…» — снять её можно только перезаходом на экран.
  • Если убрать все чипы стадий, список пустеет и показывается подсказка «выберите хотя бы одну стадию».
  • Если под фильтром ничего нет, показывается надпись «No flags match the filter» — это не ошибка загрузки.
  • Закрытие поиска кнопкой с лупой стирает и сам запрос.
  • Удалённые движком фичи скрыты совсем — найти и отключить их нельзя.
  • Стабильные и устаревшие фичи по умолчанию не показаны: их видно только после явного выбора чипа.
  • Пояснения почти к половине фич — предположения приложения по имени флага, а не документация от разработчиков Codex.
  • Все тексты на экране английские.

Источник: docs/codex/features.md. Страница собрана из документации проекта при сборке сайта — без пересказа.