split-trainer/docs/ИНСТРУКЦИЯ.md

Сплит-тренер: как пользоваться

1. Запуск

1. Откройте файл public/index.html двойным кликом (лучше в Chrome или Edge). Если приложение установлено на сервере, откройте его адрес в браузере.
2. Ничего устанавливать не нужно. Интернет не нужен.

Прогресс и статистика хранятся в самом браузере. Не переносите папку с приложением в другое место и не меняйте браузер или адрес сайта, иначе прогресс «потеряется» (он привязан к браузеру и адресу).

2. Главное правило: раскладка Windows

Тренер читает те символы, которые выдаёт система. Поэтому перед упражнением включите ту раскладку, на которой печатаете:

• русский урок: русская раскладка;
• английский урок: английская.

Переключение: Win + Пробел или Alt + Shift. Если включена не та, сверху появится жёлтая подсказка, ошибкой это не считается.

3. Как проходит упражнение

• Сверху текст, ниже экранная клавиатура. Следующая клавиша подсвечена, рядом написано, каким пальцем её нажимать. Если нужен Shift, подсвечивается Shift противоположной руки.
• Таймер запускается с первой нажатой клавиши.
• Неверная клавиша не засчитывается: курсор остаётся на месте, ошибка записывается. Нажмите правильную клавишу, чтобы идти дальше.
• Esc начинает упражнение заново.
• Если включён Caps Lock, тренер предупредит, а не будет считать это ошибками.

4. Разделы

Уроки

45 уроков для каждого языка, от простого к сложному. Идти лучше по порядку, но открыть можно любой.

Раздел	Что тренируем
A. Основной ряд	Исходная позиция, указательные к центру
B. Верхний ряд	Новые буквы по 2–3 за урок
C. Нижний ряд	То же для нижней строки
D. Сплит	Центр на стыке половинок, слова одной рукой, чередование рук, мизинцы и безымянные
E. Слова	Короткие, средние, длинные
F. Заглавные	Работа с Shift
G. Цифры	Ряд цифр, числа, даты, телефоны
H. Знаки препинания	Точка, запятая, ? ! : ; -, кавычки, скобки
I. Символы	@ # $ % & * [ ] { } и код (в русской раскладке: № % * ?)
J. Тексты	Предложения, абзацы, «Марафон»
K. Слои	Только с загруженной раскладкой Vial (см. раздел 6)

Звёзды: ★ за точность от 90%; ★★ за точность от 95% и целевую скорость урока; ★★★ за 98% и скорость на 25% выше цели. Кнопка «Продолжить» сверху ведёт к первому непройденному уроку.

Практика

Собственные упражнения: слова (можно добавить заглавные, цифры, знаки), предложения, абзацы, цифры, символы, режим «Слои» и свой текст (вставьте любой, символы, которых нет на раскладке, будут убраны).

Статистика

• скорость, точность, время, рекорды, графики по последним упражнениям;
• карта клавиш: красным отмечены клавиши с ошибками (или медленные, если переключить);
• кнопка «Тренировать слабые клавиши»: тренер соберёт текст из ваших проблемных букв (нужно хотя бы несколько упражнений).

Настройки

Тема, экранная клавиатура вкл/выкл, цвета пальцев, вид клавиатуры (со сдвигом или ортолинейная), размер текста, звук ошибки.

5. Что означают цифры в результате

• Скорость в знаках в минуту (зн/мин). Слов в минуту = зн/мин ÷ 5.
• Точность: доля верных нажатий среди всех нажатий.
• Ровность ритма: насколько ровные паузы между клавишами. Рваный ритм показывает места, которые пальцы ещё не выучили.
• Самые медленные клавиши и путаница («нужно Ф, нажато Ы») подсказывают, что повторять.

6. Ваша клавиатура из Vial и слои

Загрузка раскладки

1. В программе Vial: меню File → Save current layout, получится файл .vil.
2. В тренере откройте раздел Клавиатура, выберите файл или перетащите его в окно.
3. Проверьте, что слои распознаны. Слои можно переименовать (файл их названий не хранит).

Настройки на этой странице:

• Использовать в тренировках: экранная клавиатура рисуется по вашему файлу.
• Расположение клавиш: «Две половинки» (по умолчанию) или «Один блок», если у вашей модели матрица устроена иначе и схема выглядит неправильно.
• Слой с цифрами: какой слой тренер будет просить использовать для цифр и символов. По умолчанию определяется сам.

Тренировка со слоями

• Уроки раздела К в списке уроков и режим Практика → «Слои: текст, числа и формулы».
• Над клавиатурой видна полоска слоёв: сплошным закрашен слой, на котором тренер считает, что вы сейчас, а жёлтой рамкой отмечен нужный для следующего символа.
• Если нужно переключить слой, в подсказке написано действие (например, «Включите слой «Цифры»: TG(1)»), а нужная клавиша слоя мигает жёлтым. Дальше подсвечена сама клавиша символа на нужном слое.
• Уроки специально заставляют переключаться: цифры и символы нужно набирать через слой «Цифры», хотя на базовом слое есть цифровой ряд. В английских уроках есть символы [ ] { } \ | = ~, которых на базовом слое нет.
• В результатах появляется блок «Переключение слоёв»: число переключений и «цена переключения» (на сколько миллисекунд дольше символ сразу после смены слоя). Её и нужно сокращать.

Важно знать

• Нажатия клавиш слоёв (TG, MO и т. п.) обрабатывает прошивка клавиатуры, до тренера они не доходят. Тренер проверяет только набранные символы, а выполнение подсказок по слоям остаётся на вас.
• Если вы оказались на другом слое, чем думает тренер, нажмите на нужный слой над клавиатурой, и маршрут пересчитается.
• Для цифрового блока (KP_*) в системе должен быть включён NumLock.

Оверлей-подсказка (Windows)

Раздел Оверлей в меню описывает отдельную программу KeyOverlay: полупрозрачную раскладку вашей клавиатуры поверх любых окон, с автоопределением активного слоя по альтернативной прошивке. Там же ссылки на установщик, портативную версию, файлы прошивки .uf2 и краткая инструкция по запуску.

7. Как заниматься

• Лучше 20 минут каждый день, чем 2 часа раз в неделю.
• Точность важнее скорости: печатайте медленнее, чем хочется. Скорость придёт, когда пальцы запомнят путь.
• Если на уроке меньше ★: повторите его, а не переходите дальше.
• Раз в неделю заглядывайте в «Статистику» и запускайте слабые клавиши.
• Не смотрите на клавиши клавиатуры: подсказки на экране для этого и сделаны. Когда освоитесь, экранную клавиатуру можно выключить в «Настройках».

8. Если что-то не так

Проблема	Что делать
Жёлтая подсказка про раскладку	Переключите раскладку Windows на нужный язык
Подсказка про Caps Lock	Выключите Caps Lock
Клавиши не реагируют	Кликните по странице: фокус должен быть в окне приложения, а не в адресной строке
Уроки К закрыты замком	Загрузите файл .vil в разделе «Клавиатура» и включите «Использовать в тренировках»
Схема клавиатуры выглядит неправильно	В «Клавиатура → Расположение клавиш» выберите «Один блок»
«Этого символа нет на вашей раскладке»	Такой символ нельзя набрать на вашей клавиатуре; добавьте его в Vial или пропустите упражнение
Прогресс пропал	Он хранится в браузере: проверьте, тем ли браузером и тем же файлом вы пользуетесь
Нужно всё обнулить	«Статистика» → «Сбросить все данные»

9. Аккаунт и синхронизация (если сайт установлен на сервере с API)

Пункт «Войти» в меню появляется только на сервере, где установлен API. Без входа всё работает как раньше: прогресс хранится в этом браузере.

• Регистрация. Введите только почту. Придёт письмо со ссылкой (действует сутки): по ней вы подтверждаете адрес и придумываете пароль, и только после этого создаётся аккаунт. Если письма нет, загляните в «Спам» и проверьте адрес.
• Вход. Почта и пароль. Прогресс с устройства объединяется с тем, что уже лежит на сервере, и после каждого упражнения отправляется туда. На другом устройстве достаточно войти, и всё на месте.
• Забыли пароль. «Забыли пароль?» → письмо со ссылкой (действует час, работает один раз) → новый пароль. Все прежние входы на устройствах завершатся.
• Выход. Прогресс остаётся на устройстве. Если потом в этом же браузере войдёт другой человек, ваши локальные данные в его аккаунт не попадут: они будут очищены.
• Сброс данных. «Статистика» → «Сбросить все данные» при входе очищает и копию на сервере. На других устройствах локальные данные при следующей синхронизации вернутся: очистите их и там.
• Удаление аккаунта. «Аккаунт» → «Удалить аккаунт…» (нужен пароль): удаляются аккаунт и прогресс на сервере.
• Что синхронизируется. Прогресс по урокам, история упражнений и статистика клавиш. Настройки и раскладка Vial остаются на устройстве.

10. Файлы приложения

В папке public/: index.html (запуск), app.js (логика), vial.js (чтение Vial и маршруты по слоям), data.js (раскладки, слова и тексты упражнений), styles.css (оформление). Слова и предложения для упражнений можно править в data.js. Установка на сервер описана в docs/DEPLOY.md.