ClassPulse
Живой статус студентов на уроке прямо в VS Code. Студенты пишут код, а преподаватель видит,
кто пишет, кто неактивен и кто нажал «Готово», не заглядывая никому в экран.
- Ничего не нужно настраивать студентам: ввели имя и код урока, дальше расширение работает само.
- Не зависит от языка программирования и не читает ваш код: статус определяется только по правкам и сохранениям.
- Урок завершается одной кнопкой, все данные студентов удаляются.
Слева панель преподавателя, справа панель студента. На скриншотах демо-данные.
Быстрый старт
Студент
- Откройте панель ClassPulse слева, в Activity Bar.
- Введите имя и 6-значный код урока, который назвал преподаватель.
- Работайте в своей папке как обычно. Закончили задание: нажмите «Готово».
Преподаватель
- Откройте панель ClassPulse и войдите своим аккаунтом.
- Нажмите «Начать урок» и продиктуйте группе код.
- Следите за списком: сверху те, кто ещё работает, ниже закончившие. В шапке «готово N из M».
- В конце нажмите «Завершить урок».
Если панель просит подключение, значит, расширению ещё не указан сервер. Выполните команду
ClassPulse: Настроить подключение к Supabase (подробности в разделе
«Установка и настройка») или попросите у преподавателя готовую версию.
Как это устроено
- Преподаватель входит в панель своим аккаунтом, нажимает «Начать урок» и диктует группе
6-значный код сессии.
- Студенты вводят имя и код. Расширение само определяет статус и отправляет его раз в несколько
секунд.
- Преподаватель видит список в реальном времени: сначала те, кто ещё не закончил (пишущие, затем неактивные),
потом закончившие. В шапке: «готово N из M».
- «Завершить урок» удаляет сессию и все данные студентов. Если забыли, сессия удаляется сама
через несколько часов (
classpulse.sessionTtlHours).
Статусы студента
Расширение не зависит от языка программирования и не смотрит на ошибки в коде: статус определяется
только по правкам и сохранениям.
| Статус |
Когда |
| пишет |
правка или сохранение файла в отслеживаемой папке были меньше 3 минут назад |
| неактивен |
правок и сохранений не было дольше 3 минут (серый) |
| готово |
студент нажал «Готово» |
Подробности:
- «Готово» ставится только вручную и главнее автоматических статусов: таймер бездействия его
не трогает. Оно сбрасывается только если студент снова начал править код (статус станет «пишет») или
нажал «Снять Готово» в панели, в строке состояния или через команду.
- Статус следит за одним окном. Расширение запоминает папку того окна VS Code, где студент вошёл
в сессию, и учитывает правки только внутри неё. Второе окно (например, с домашкой) на статус не
влияет. Если студент вошёл не в том окне, откройте панель ClassPulse в нужном окне и нажмите
«Привязать это окно» (или команда ClassPulse: привязать это окно).
- Порог 3 минуты задан константой
ACTIVITY_WINDOW_MS в src/shared/statusConfig.ts.
Команды
| Команда |
Что делает |
| ClassPulse: Готово |
отметить задание выполненным |
| ClassPulse: Снять Готово |
убрать отметку |
| ClassPulse: привязать это окно |
вести урок из этого окна |
| ClassPulse: Сменить роль |
студент / преподаватель |
| ClassPulse: Настроить подключение к Supabase |
ввести URL и publishable key |
Установка и настройка
Требуется VS Code 1.82 или новее.
Расширению нужен бэкенд на Supabase:
- В SQL Editor вашего проекта выполните
supabase/extension.sql.
Скрипт создаёт таблицы cp_sessions и cp_students, правила доступа и функции.
- Включите Authentication → Providers → Anonymous (студенты входят анонимно).
- Преподаватель должен быть в таблице
teachers (как в веб-версии ClassPulse).
- В VS Code выполните ClassPulse: Настроить подключение к Supabase и укажите Project URL и
publishable (anon) key. Они сохраняются в настройках VS Code (
classpulse.supabase.url,
classpulse.supabase.publishableKey), в коде расширения их нет.
Для группы можно собрать готовый .vsix с уже вписанными URL и ключом:
npm run build && node scripts/package-classroom.mjs --env-file путь/к/.env.local.
Настройки
| Настройка |
По умолчанию |
Смысл |
classpulse.supabase.url |
пусто |
Project URL |
classpulse.supabase.publishableKey |
пусто |
publishable (anon) key |
classpulse.staleAfterSeconds |
90 |
через сколько секунд без обновлений студент попадает в «давно не обновлялись» |
classpulse.sessionTtlHours |
4 |
через сколько часов сессия удаляется автоматически |
classpulse.pollIntervalSeconds |
3 |
как часто панель преподавателя обновляет список |
Значения по умолчанию заданы в одном месте: contributes.configuration в package.json.
Безопасность и данные
Защита данных держится на правилах безопасности базы (RLS, Row Level Security, и права функций
в Postgres), а не на скрытии публичных ключей.
Publishable (anon) key по задумке публичный: он попадает в каждый клиент и любой, кто установил
расширение, может его увидеть. Поэтому:
- Не рассчитывайте, что ключ «секретный». Прячьте не его, а данные: за них отвечают политики RLS из
supabase/extension.sql. Студент может только записать свой статус через функцию
cp_push_status (она проверяет, что сессия существует и не истекла) и прочитать/удалить
свою строку. Список студентов видит только преподаватель-владелец сессии. Анонимный доступ
(anon) к таблицам и функциям отозван.
- Никогда не кладите в расширение и в настройки
service_role / secret key: он обходит RLS.
Скрипт сборки .vsix отклоняет такие ключи, а окно настройки — ключи вида sb_secret_….
- Проверяйте политики после любого изменения схемы. Если RLS выключен или политика слишком
широкая, никакое «скрытие» ключа данные не защитит.
- Токены входа хранятся в VS Code SecretStorage, а не в
settings.json.
- ClassPulse не читает содержимое ваших файлов и не отправляет код. Отправляются имя, случайный ID,
код сессии и один из четырёх статусов.
Разработка
npm ci
npm run typecheck # tsc для расширения и webview
npm test # юнит-тесты логики (vitest)
npm run build # dist/extension.js, dist/webview.js, dist/webview.css
Откройте папку в VS Code и нажмите F5 (конфигурация «Teacher + Student (F5)» открывает окно учителя под отладчиком и отдельное окно студента).
Структура: src/shared/ — чистая логика без VS Code API (статусы, привязка окна),
покрытая тестами в test/; src/student, src/teacher, src/backend — работа с VS Code и
Supabase; webview/ — интерфейс панели (React + Tailwind).
Публикация: PUBLISHING.md.
Лицензия
MIT