Python Tutor — Руководство пользователя

🐍

Что такое Python Tutor

Python Tutor — это интерактивная среда обучения, в которой каждая сессия создаётся персонально для вас. Вы формулируете свою цель (например, «хочу разобраться с рекурсией»), и ИИ генерирует индивидуальный учебный блок: теорию, практические задания и тесты.

В отличие от фиксированных курсов, здесь нет заранее написанных лекций — содержание адаптируется под ваш уровень, желаемое время и предпочтения.

🎯

Персональный план

ИИ строит учебный маршрут под вашу конкретную цель и уровень.

⚡

Живой редактор

Пишите и запускайте Python прямо в браузере — без установки.

🤖

ИИ-тьютор рядом

Задавайте вопросы, просите намёки — тьютор не даёт готовый ответ, а направляет.

✅

Автоматические тесты

Каждое задание проверяется по чётким критериям с мгновенной обратной связью.

🚀

Как начать занятие

Откройте главную страницу (/) — это страница настройки цели. Заполните форму и нажмите «Сформировать учебный блок».

1

Введите API-ключ DeepSeek — вставьте ключ в поле и нажмите «Проверить». После успешной проверки форма настройки откроется ниже. Ключ нужен для генерации плана и работы тьютора.
2

Введите цель — опишите, что хотите изучить. Например: «Хочу научиться писать рекурсивные функции» или «Разобраться с классами и ООП». Можно выбрать тему быстрым нажатием на одну из готовых кнопок-чипов.
3

Выберите уровень: Новичок (базовый синтаксис), Средний (знакомы с основами) или Продвинутый (комфортно с функциями и структурами данных).
4

Укажите время: 15 минут (быстрый урок), 45 минут (стандартное занятие) или 2 часа (глубокое погружение).
5

Выберите фокус: Практика (больше кода, меньше теории), Баланс (смешанный формат) или Теория (концептуальное понимание).
6

Оцените уверенность — шкала от 1 до 5: насколько уверены, что справитесь с поставленной целью? Тьютор учитывает этот показатель: при низкой уверенности даёт больше поддержки и объяснений.
7

Нажмите «✨ Сформировать учебный блок» — ИИ создаст персональный план. Просмотрите результат: цели занятия, шаги, критерий успеха.
8

Нажмите «🚀 Начать занятие» — откроется рабочее пространство, где начнётся ваша сессия.

Совет: Если сгенерированный план не подходит — нажмите «🔄 Пересобрать», и ИИ создаст другой вариант.

⚠️ Таймаут сессии: если не совершать никаких действий более 15 минут, рабочее окружение автоматически останавливается. При следующем действии вы увидите ошибку — нужно вернуться на главную и начать новое занятие. Ваш код при этом не сохраняется, поэтому не делайте длинных перерывов в середине задания.

📋

Рабочее пространство

Рабочее пространство разделено на три колонки. Каждая выполняет свою роль:

← Левая панель

📋 План занятия
📝 Текущее задание
✅ Критерий успеха
▶ Кнопки Run / Test
📊 Метрики сессии

⬛ Центр (редактор)

🐍 starter_code.py
📖 theory.md (теория)
▶ Run / ✓ Test
Консоль внизу
Результаты тестов

→ Правая панель

💬 Чат с тьютором
💡 Намёки
❓ Объяснить ошибку
→ Следующий шаг
Ввод сообщения

На мобильных устройствах три колонки переключаются через вкладки внизу экрана: 📋 План, 💻 Код, 💬 Чат.

В шапке страницы отображаются: название цели, номер текущего шага, таймер сессии и статус подключения. В правом углу показывается ваш уровень (Новичок / Средний / Продвинутый) — он задаётся при настройке цели.

💻

Редактор кода

Центральная панель — полноценный редактор Python с подсветкой синтаксиса, автодополнением скобок и нумерацией строк.

Основные действия:

▶ Run

✓ Test

▶

Run — выполняет ваш код и показывает результат в консоли внизу. Используйте для быстрой проверки вывода и отладки. Результат появляется во вкладке Output.
✓

Test — запускает автоматические тесты для текущего задания. Показывает, какие тесты прошли (✅), а какие упали (❌). Кликните на упавший тест, чтобы увидеть подробный вывод и понять, что пошло не так.

Задание засчитано, когда ≥60% тестов проходит — появится кнопка «→ Следующий шаг». При 100% показывается 🎉-поздравление. Стремитесь к 100%.

Индикаторы шагов в левой панели меняют цвет в зависимости от прогресса:

✓

Зелёный — шаг завершён (≥60% тестов пройдено).
!

Жёлтый — частичный результат: тесты запущены, ≥60% пройдено, но ещё не 100%.
✗

Красный — тесты провалены (менее 60% пройдено).
🔒

Серый / замочек — шаг «Рефлексия» заблокирован. Сначала завершите все предыдущие шаги (Теория, Разбор примера, Практическое задание).

Код сохраняется по шагам: если переключились на другой шаг и вернулись — ваш код будет на месте. Каждый шаг хранит свой код независимо.

В нижней части экрана находится консоль с двумя вкладками:

📤

Output — стандартный вывод вашего кода (print, ошибки).
⬛

Terminal — полноценный терминал внутри контейнера Python, для ручного запуска команд.

💬

Чат с тьютором

Правая панель — ваш персональный тьютор на базе ИИ. Он видит ваш текущий код, историю попыток и контекст задания.

Быстрые кнопки действий:

💬 Задай вопрос

💡 Дай подсказку

🔍 Разбери ошибку

✅ Проверь код

1

💬 Задай вопрос — тьютор задаёт наводящий вопрос, который помогает вам самому найти решение. Ответ не раскрывается.
2

💡 Дай подсказку — конкретная подсказка с направлением. При необходимости тьютор покажет небольшой фрагмент кода.
3

🔍 Разбери ошибку — тьютор разберёт упавшие тесты: объяснит причину, покажет где искать и как исправить. Кнопка активна только после запуска тестов с ошибками.
4

✅ Проверь код — отправляет текущий код тьютору на ревью. Тьютор даст обратную связь: что сделано хорошо и что можно улучшить.

Совет: Не ограничивайтесь кнопками — задавайте любые вопросы в текстовом поле. Тьютор отвечает в потоковом режиме (ответ появляется по мере генерации). Спрашивайте «почему это работает», «в чём разница» — тьютор объяснит в контексте вашей задачи.

📖

Шаги теории

Некоторые шаги плана — теоретические (иконка 📖). Вместо задания ИИ генерирует объяснение концепции с примерами кода.

Теория открывается в центральной панели как вкладка theory.md: форматированный текст с заголовками, блоками кода и примерами.

1

Прочитайте материал — теория генерируется специально под вашу цель и уровень.
2

Нажмите «📚 Расширить теорию» внизу страницы, чтобы углубиться в любой аспект. Введите запрос («объясни подробнее наследование», «покажи больше примеров») — ИИ добавит новый раздел прямо на страницу.
3

Когда готовы двигаться дальше — нажмите кнопку «→ Следующий шаг» в левой панели.

Кэш теории: если вернуться к уже просмотренному теоретическому шагу, теория откроется мгновенно — без повторной генерации. Все расширения тоже сохранятся.

🗂️

Типы шагов

В плане занятия каждый шаг имеет иконку, обозначающую его тип:

📖

Теория micro_lesson

Теоретическое объяснение концепции с примерами кода. Читаете материал, задаёте вопросы тьютору, можете расширить через «📚 Расширить теорию». Завершается автоматически при переходе к следующему шагу.

✏️

Разбор примера exercise

Управляемое упражнение — часто содержит образец или частично заполненный код. Нужно написать решение и пройти ≥60% автотестов.

🔧

Практическое задание task

Самостоятельная задача с чётким условием. Нужно написать код с нуля и пройти ≥60% автотестов.

💭

Рефлексия reflection

Финальная самооценка занятия: что удалось, что было трудным, что сделать иначе. Обсуждается с тьютором в чате. 🔒 Заблокирована до завершения всех предыдущих шагов. После отправки рефлексии в левой панели появляется кнопка 📊 Показать аналитику сессии — откроется страница с графиками вашей учебной сессии.

Отличие exercise от task: exercise — управляемое упражнение (часто с образцом или подсказками в коде), task — самостоятельная задача. Оба типа требуют ≥60% тестов для завершения.

📊

Метрики

В нижней части левой панели отображаются метрики текущей сессии. Тьютор использует их для адаптации своих подсказок и объяснений.

Точность

—

Доля успешно пройденных тестов от общего числа попыток.

Подсказки

—

Сколько раз вы обращались за намёками в текущей сессии.

SRL фаза

—

Фаза по модели Зиммерманна: 🧭 Планирование → ⚙️ Выполнение → 🪞 Рефлексия. Тьютор адаптирует подсказки под текущую фазу.

Эмоции

—

Аффективное состояние, определяемое тьютором по тону сообщений.

Зачем это нужно? Метрики помогают тьютору понять, как вы себя чувствуете в процессе обучения, и скорректировать стиль объяснений — например, дать больше поддержки при высоком числе подсказок или похвалить за высокую точность.

⌨️

Горячие клавиши

Используйте клавиатурные сочетания, чтобы работать быстрее:

Клавиша	Действие
`Ctrl` + `Enter`	Запустить код (Run)
`Shift` + `Enter`	Запустить код (Run) — альтернатива
`Tab`	Добавить отступ (4 пробела)
`Shift` + `Tab`	Убрать отступ
`Ctrl` + `Z`	Отменить последнее действие
`Ctrl` + `Y`	Повторить отменённое действие
`Ctrl` + `/`	Закомментировать / раскомментировать строку

На Mac используйте ⌘ Cmd вместо Ctrl.

Добро пожаловать в Python Tutor