Сплит-тренер: тренажёр печати для сплит-клавиатур

Русская и английская раскладки, уроки от простых к сложным, цифры и знаки
препинания, статистика, чтение раскладки Vial (.vil) и упражнения на
переключение слоёв.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

ИНСТРУКЦИЯ.md

@@ -0,0 +1,113 @@
+# Сплит-тренер: как пользоваться
+
+## 1. Запуск
+
+1. Откройте файл `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.
+
+## 7. Как заниматься
+
+- Лучше **20 минут каждый день**, чем 2 часа раз в неделю.
+- **Точность важнее скорости**: печатайте медленнее, чем хочется. Скорость придёт, когда пальцы запомнят путь.
+- Если на уроке меньше ★: повторите его, а не переходите дальше.
+- Раз в неделю заглядывайте в «Статистику» и запускайте **слабые клавиши**.
+- Не смотрите на клавиши клавиатуры: подсказки на экране для этого и сделаны. Когда освоитесь, экранную клавиатуру можно выключить в «Настройках».
+
+## 8. Если что-то не так
+
+| Проблема | Что делать |
+|---|---|
+| Жёлтая подсказка про раскладку | Переключите раскладку Windows на нужный язык |
+| Подсказка про Caps Lock | Выключите Caps Lock |
+| Клавиши не реагируют | Кликните по странице: фокус должен быть в окне приложения, а не в адресной строке |
+| Уроки К закрыты замком | Загрузите файл `.vil` в разделе «Клавиатура» и включите «Использовать в тренировках» |
+| Схема клавиатуры выглядит неправильно | В «Клавиатура → Расположение клавиш» выберите «Один блок» |
+| «Этого символа нет на вашей раскладке» | Такой символ нельзя набрать на вашей клавиатуре; добавьте его в Vial или пропустите упражнение |
+| Прогресс пропал | Он хранится в браузере: проверьте, тем ли браузером и тем же файлом вы пользуетесь |
+| Нужно всё обнулить | «Статистика» → «Сбросить все данные» |
+
+## 9. Файлы приложения
+
+`index.html` (запуск), `app.js` (логика), `vial.js` (чтение Vial и маршруты по слоям), `data.js` (раскладки, слова и тексты упражнений), `styles.css` (оформление). Слова и предложения для упражнений можно править в `data.js`.