MindTrain — плагин
Плагин Codex для ежедневной тренировки знаний: ИИ задает вопросы, свой сервер считает баллы и планирует повторение.
- 129 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин запускает локальный мост MCP на Python и читает папку с материалами, которую вы укажете.
- Токен `MINDTRAIN_BOOTSTRAP_TOKEN` открывает доступ к вашему экземпляру: храните его вне репозитория.
Установка
- Работает в
Ручная установка
git clone https://github.com/shigella520/MindTrain.gitСерверная часть. Затем в `deploy/core-only` скопируйте `.env.example` в `.env`, задайте пароль PostgreSQL и токен и выполните `docker compose up -d --build`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин запускает локальный мост MCP на Python и читает папку с материалами, которую вы укажете.
- Токен `MINDTRAIN_BOOTSTRAP_TOKEN` открывает доступ к вашему экземпляру: храните его вне репозитория.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MindTrain превращает то, что вы хотите выучить, в ежедневные вопросы. Плагин для Codex подключает скилл `$mindtrain` и мост к Trainer MCP. ИИ задает вопросы и объясняет, а серверная часть на Java и PostgreSQL проверяет ответы, пишет историю и выбирает, что повторять. На любом вопросе можно спорить, просить подсказку или выяснять, почему вариант неверен: ответом считается только явно отправленный выбор. Единственный источник данных — Training Core на вашем сервере. Он ограничивает число новых вопросов в день и приостанавливает их, когда копится долг повторений. Темы строятся диалогом или из вашей папки с заметками в форматах MD, TXT, PDF, DOCX и PPTX.
Для кого. Тем, кто готовится к экзамену или собеседованию и хочет тренироваться в диалоге с Codex на собственном сервере без чужого облака.
Подходит, если
- Нужно подготовиться к собеседованию по Kubernetes и ежедневно закреплять Pod, Deployment и Service.
- Конспекты в PDF и DOCX хочется превратить в дерево тем и проверочные вопросы.
- Ответ оценивается строго по выбранным вариантам, мнение модели баллы не меняет.
- Повторение старых вопросов должно идти по расписанию, чтобы забытое не копилось.
Не подходит, если
- Нет Docker или своего сервера: без Training Core плагин не работает.
- Нужно общее обучение для команды: MindTrain рассчитан на одного пользователя.
- Нужны другие типы заданий, кроме одиночного и множественного выбора.
Пример запроса к агенту
$mindtrain Начни тренировку по Kubernetes и после каждого ответа объясняй, почему остальные варианты неверны.Ограничения
Требуются Docker с Docker Compose, четыре контейнера (Core, Trainer MCP, Web, PostgreSQL) и свой токен `MINDTRAIN_BOOTSTRAP_TOKEN`. Плагин сделан для Codex, другие клиенты в README не описаны. Разбор PDF берет только текст, распознавания сканов нет. Планировщик Anki и FSRS пока в планах, сейчас работает взвешенный. Проект рассчитан на одного пользователя. Перед обновлением сделайте резервную копию PostgreSQL: Flyway мигрирует схему при старте, а при сбое миграции откат делают по дампу.
Как отключить. Остановите серверную часть командой `docker compose down` в папке `deploy/core-only`, данные сохранятся. Плагин уберите через менеджер плагинов Codex, настройки лежат вне проекта.
Частые вопросы
Как поставить плагин MindTrain в Codex?
Выполните `codex plugin marketplace add shigella520/MindTrain --ref main` и `codex plugin add mindtrain@mindtrain`. Затем в новой задаче введите `$mindtrain Настрой мой экземпляр MindTrain` и укажите адрес MCP и токен.
Что сервер хранит у меня?
Training Core держит вопросы, сессии, ответы, состояние повторений и настройки в вашем PostgreSQL. Скилл ничего не сохраняет, исходные файлы материалов остаются на вашей машине.
Продолжается ли вопрос, если я задал уточнение?
Да. Ответ засчитывается только после явной отправки варианта, поэтому уточнения и подсказки вопрос не расходуют.
Как обновить MindTrain?
Сделайте дамп PostgreSQL, выполните `git pull --ff-only` и `docker compose up -d --build`. Плагин обновляют командами `codex plugin marketplace upgrade mindtrain` и `codex plugin add mindtrain@mindtrain`, затем начинают новую задачу.
Какие типы вопросов поддерживаются?
Одиночный и множественный выбор. Оценка идет по набору выбранных вариантов, поэтому модель не может «на глаз» поставить балл.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин для Codex и Claude Code: тренер учит на реальных проектах, ведет отладку и записывает доказательства освоения
Плагин, MCP-сервер и приложение для базы знаний в Markdown: ваш ИИ-инструмент ведет страницы, а вы видите правки и цитаты.
Плагин Claude Code строит план обучения по любой теме, гоняет адаптивные квизы и назначает повторы по алгоритму SM-2.
Плагин Claude Code, который в разговоре собирает под вас систему знаний из markdown-файлов: структуру папок, шаблоны заметок, конвейер обработки и хуки
Плагин-репетитор для учебы с СДВГ: короткие порции материала, вопросы по пройденному и пересказ своими словами.
Агент создает вопросы и экзамены на платформе EduBase, собирает квизы и разбирает результаты; ключ интеграции, режим чтения
Коротко о README
Проект состоит из Training Core, Trainer MCP, веб-интерфейса, плагина Codex и взвешенного планировщика. Веб-страница показывает панель, карту тренировки и управление банком вопросов. Версии плагина и сервера сверяются автоматически, несовместимые версии останавливают тренировку.