Установка Yenpo и открытие первого репозитория

Для чтения кода в Yenpo аккаунт модели не нужен. Просмотр, поиск и навигация через языковой сервер работают локально. Подключите провайдера позже, когда захотите задать AI Reader вопросы о коде.

Проверьте Mac

Текущая Early Access Preview работает на Mac с Apple silicon и Intel под macOS 14 или новее; одна загрузка подходит для обоих. Версию macOS можно проверить в Об этом Mac.

Каждая сборка истекает в фиксированную дату рядом с кнопкой загрузки. Дата задаётся при создании сборки; более поздняя загрузка или переустановка её не сдвигает. Установите новую сборку заранее.

Установка

1. Скачайте .dmg с главной страницы.
2. Откройте его и перетащите Yenpo в Программы.
3. Запустите Yenpo из «Программ», затем извлеките образ диска.

Проверьте установленную версию

Выберите Yenpo → О Yenpo в строке меню. Сравните версию с указанной рядом с кнопкой загрузки. Окно также показывает срок EAP сборки в часовом поясе Mac; сайт указывает дату в UTC.

Если после обновления видна старая версия, закройте Yenpo и снова откройте копию из «Программ». Шаги замены описаны в разделе Обновитесь до истечения срока.

Откройте проект

Откройте папку проекта, который хотите читать. Выберите корень репозитория с README, файлом сборки и .git. Если открыть подпапку, тесты и конфигурация в других частях репозитория не войдут в проект.

Нажмите Command-P (Перейти к файлу…), введите часть имени или пути и откройте знакомый файл. Держите README или связанный тест в другой вкладке. Другой проект открывайте в отдельном окне.

Не можете найти существующий файл? Убедитесь, что он находится в открытой папке, затем проверьте, не скрыты ли скрытые или игнорируемые Git файлы. Подробнее — Поиск файлов и переходы по символам.

Попробуйте небольшую задачу

Выберите вопрос с проверяемым ответом, например где считывается настройка:

1. Используйте «Искать во всех файлах», чтобы найти точное имя настройки или характерное сообщение.
2. Откройте найденную функцию и выясните, откуда она получает входные данные.
3. Используйте Перейти к определению или Найти ссылки, если доступен языковой сервер. Иначе ищите символ как текст.
4. Прочитайте вызывающий код или тест, передающий входные данные.

Для начала достаточно точки входа, значения для отслеживания и вызова или теста, показывающего его использование. Не нужно сначала понимать всю архитектуру.

Спросите AI Reader (необязательно)

Настройте провайдера по руководству подключения, откройте AI Reader и спросите о прочитанном коде. Можно добавить файл, папку или выделение как отправную точку либо описать поведение и позволить ему найти код в рабочей области.

Например:

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

Нажмите ссылку на исходник, чтобы увидеть код в Быстром просмотре, затем Открыть файл, чтобы оставить его во вкладке. Проверьте одно утверждение по коду, прежде чем задавать более широкий вопрос.

По умолчанию AI Reader только читает. Можно разрешить правки файлов на один запуск; раздел Что отправляется и что можно изменять объясняет механизм и передачу данных модели.

Обновитесь до истечения срока

1. Проверьте версию и срок рядом с кнопкой загрузки на главной. Скачайте новый .dmg, когда он доступен.
2. Сохраните несохранённые файлы и закройте Yenpo. Откройте новый образ и перетащите Yenpo в «Программы», заменив существующую копию по запросу Finder.
3. Запустите Yenpo из «Программ», снова проверьте Yenpo → О Yenpo, затем извлеките образ.

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

Если что-то не работает

Проблема	Что проверить сначала
Файл не найден	Корень проекта, путь, настройки скрытых и игнорируемых Git файлов
«Перейти к определению» не действует	Установлен ли языковой сервер и понимает ли он проект
AI Reader не отвечает	Активный провайдер, тип API, endpoint, ID модели, API-ключ
Код не соответствует ожиданиям	Показывает ли вкладка историческую версию Git или текущий файл

При описании ошибки укажите версии Yenpo и macOS, ожидаемый и фактический результат и шаги воспроизведения. Не включайте закрытый код и API-ключи в публичные материалы.

Выберите следующий шаг

Продолжите с поиском файлов, переходами по символам и проверкой ссылок. Начните с поиска файлов, затем используйте навигацию по символам при наличии сервера. Можно также сравнивать коммиты и ветки без аккаунта модели.

Чтобы спрашивать AI Reader о коде, подключите провайдера моделей. Перед отправкой вопроса ознакомьтесь с передаваемым провайдеру кодом и его тарифами.