2. Руководство
2.1. Введение
blunderDB — программа для создания баз данных позиций нардов. Её главное преимущество — единое место для накопления позиций, с которыми игрок сталкивался (онлайн, на турнирах), и возможность их повторного изучения с фильтрацией по произвольно комбинируемым критериям. blunderDB также можно использовать для создания каталогов эталонных позиций.
Позиции хранятся в базе данных, представленной файлом .db.
2.2. Основные взаимодействия
Основные взаимодействия с blunderDB:
добавить новую позицию,
изменить существующую позицию,
скопировать изображение доски в буфер обмена (PNG) с помощью Ctrl+X или с полным анализом через Ctrl+X Ctrl+X,
удалить существующую позицию,
искать одну или несколько позиций,
импортировать матчи из различных источников (XG, GNUbg, BGBlitz, Jellyfish), включая комментарии из файлов XG,
навигировать по ходам импортированного матча,
организовывать позиции в коллекции,
организовывать матчи в турниры.
Пользователь может свободно присваивать позициям метки и аннотировать их комментариями.
2.3. Описание интерфейса
Интерфейс blunderDB состоит сверху вниз из:
[вверху] панель инструментов, объединяющая все основные операции с базой данных,
[по центру] основная область отображения, позволяющая отображать или редактировать позиции нардов,
[внизу] строка состояния, отображающая различную информацию о базе данных или текущей позиции и содержащая командную строку.
Панели могут быть отображены для:
отображения данных анализа текущей позиции из eXtreme Gammon (XG), GNUbg или BGBlitz,
отображения, добавления или изменения комментариев,
поиска и фильтрации позиций по комбинируемым критериям,
отображения и управления коллекциями позиций (панель коллекций),
отображения списка импортированных матчей и навигации по ходам матча (панель матчей),
отображения и управления турнирами (панель турниров),
отображения статистики производительности (панель Stats),
вычисления EPC (Effective Pip Count) позиции снятия шашек (панель EPC),
изучения позиций методом интервального повторения (панель Anki),
отображения метаданных базы данных (панель метаданных),
отображения журнала операций (панель журнала).
Модальные окна могут отображаться для:
отображения справки blunderDB,
открыть каталог обучающих туров (см. Обучающие туры и образец базы данных),
настройки экспорта базы данных,
настройки blunderDB, в том числе языка интерфейса (см. Конфигурация).
Основная область отображения предоставляет пользователю:
доску для отображения или редактирования позиции нардов,
уровень и владельца куба,
пипкаунт каждого игрока,
счёт каждого игрока,
кости для розыгрыша. Если на костях не показаны значения, положение костей указывает, чей ход, и что позиция является решением по кубу. Когда решение по кубу — это ответ на удвоение (тейк/пас), предложенный куб отображается в центре доски, на предложенном значении.
Строка состояния структурирована слева направо следующей информацией:
командная строка, доступная при нажатии клавиши ПРОБЕЛ,
информационное сообщение, связанное с выполненной пользователем операцией,
индекс текущей позиции, за которым следует количество позиций в текущей библиотеке (или информация о ходе/партии при навигации по матчу).
Примечание
В случае позиций, полученных в результате поиска пользователем, количество позиций в строке состояния соответствует числу отфильтрованных позиций.
2.4. Конфигурация
Кнопка настройки (значок шестерёнки) на панели инструментов, слева от кнопки справки, открывает окно конфигурации blunderDB.
Она позволяет выбрать язык интерфейса: английский, французский, немецкий, итальянский, испанский, финский, японский, греческий и русский. Весь интерфейс (панель инструментов, панели, сообщения, справка) переводится на выбранный язык. Выбор языка сохраняется между сеансами.
Окно настроек также позволяет настроить цвета доски. Каждый элемент имеет собственный выбор цвета: фон, граница, светлые и тёмные пункты, шашки игрока 1 и игрока 2, кости, точки костей и куб удвоения. Кнопка Сбросить восстанавливает все цвета по умолчанию. Как и язык, выбранные цвета сохраняются от сеанса к сеансу.
Окно конфигурации также содержит настройки отображения интерфейса. Ползунок масштаба интерфейса позволяет увеличить или уменьшить все элементы интерфейса, что полезно на экранах высокой плотности или для улучшения читаемости. Меню расположения панелей определяет, где панели (поиск, матчи, анализ) располагаются относительно доски: снизу, сбоку или автоматически (тогда на широких экранах выбирается боковое расположение, чтобы лучше использовать доступное пространство). Как и другие настройки, эти выборы сохраняются от сеанса к сеансу.
2.5. Обучающие туры и образец базы данных
Чтобы облегчить освоение, blunderDB предлагает обучающие туры по интерфейсу. Каталог туров открывается с панели инструментов или командой tour (псевдоним tutorial). Доступны четыре тура: общий тур по интерфейсу, а также туры, посвящённые поиску позиций, разбору матчей и разбору турниров. Каждый тур пошагово выделяет соответствующие элементы интерфейса и может быть повторён в любой момент. При первом запуске общий тур предлагается автоматически.
Команда demo загружает образец базы данных (матчи, турнир и анализы), позволяющий познакомиться с возможностями инструмента, не импортируя собственные партии. Обучающие туры опираются на эту базу, когда ни одна база не открыта.
2.7. Редактирование позиций
Нажатие клавиши TAB открывает панель поиска и позволяет редактировать позицию на доске для добавления в базу данных или для задания структуры позиции для поиска. Распределение шашек, куб, счёт и право хода можно изменять с помощью мыши (см. Редактирование позиции).
Совет
Смотрите Горячие клавиши для доступных горячих клавиш.
2.8. Командная строка
Командная строка, встроенная в строку состояния, позволяет выполнять все функции blunderDB, доступные в графическом интерфейсе: общие операции с базой данных, навигация по позициям, отображение анализа и/или комментариев, поиск позиций по фильтрам… После первоначального освоения интерфейса рекомендуется постепенно использовать командную строку для мощной и плавной работы с blunderDB, особенно для функций поиска позиций.
Для открытия командной строки нажмите клавишу ПРОБЕЛ. Для отправки запроса и закрытия командной строки нажмите клавишу ENTER.
blunderDB выполняет запросы пользователя при условии их корректности и немедленно изменяет состояние базы данных при необходимости. Явное сохранение пользователем не требуется.
Совет
Смотрите Раздел 4 для списка команд, доступных в командной строке.
2.9. Панель анализа
Панель Анализ (CTRL-L) отображает данные анализа текущей позиции, импортированные из eXtreme Gammon (XG), GNUbg или BGBlitz. Отображаются лучшие альтернативы (ходы шашками или решения куба) с их значениями эквити и соответствующими ошибками. Клавиша d переключает между анализом ходов шашками и анализом куба. При навигации по матчу фактически сыгранный ход выделяется в списке альтернатив. Нажмите CTRL-L или выполните команду list для отображения или скрытия панели.
2.10. Панель комментариев
Панель Комментарии (CTRL-P) отображает, добавляет и редактирует комментарии, связанные с текущей позицией. Комментарии, импортированные из файлов XG, автоматически связываются с соответствующими позициями. Нажмите CTRL-P или выполните команду comment для отображения или скрытия панели.
2.11. Панель поиска
Панель Поиск (CTRL-F или TAB) фильтрует позиции по свободно комбинируемым критериям: структура шашек, тип решения куба, величина ошибки, даты, метки и т.д. Клавиша TAB одновременно открывает панель поиска и редактор позиций, позволяя задать структуру шашек непосредственно на доске.
Для уточнения поиска среди текущих отфильтрованных позиций используйте команду ss с фильтрами (напр.: ss nc, ss E>40). Панель поиска также предлагает флажок Search in current results для той же функциональности.
Панель предлагает явное управление искомым типом решения: Безразлично (без фильтра), Шашки (решения по ходу) или Куб (решения по кубу). Когда выбран Куб, второй список уточняет подтип: Все, Дабл / Без дабла (игрок на ходу должен решить, удваивать ли) или Тейк / Пас (ответ на удвоение соперника). Управление синхронизировано с доской: изменение костей или куба на доске обновляет тип решения, и наоборот. В режиме Тейк / Пас куб отображается в центре доски на предложенном значении; это значение остаётся редактируемым.
Совет
Смотрите Раздел 4 для списка доступных фильтров.
2.12. Панель коллекций
Панель Коллекции (CTRL-B) управляет коллекциями позиций. Коллекции можно создавать, переименовывать и удалять. Позиции можно добавлять или удалять из них. Дважды щёлкните на коллекции для просмотра её позиций с помощью клавиш ВЛЕВО и ВПРАВО. Порядок коллекций и позиций внутри них можно изменять перетаскиванием. Нажмите CTRL-B или выполните команду collection для отображения или скрытия панели.
2.13. Панель матчей
Панель Матчи (CTRL-Tab) содержит список импортированных матчей. Дважды щёлкните на матче (или нажмите ENTER) для навигации по его ходам. Команда m возобновляет навигацию по последнему посещённому матчу.
Пользователь может:
просматривать ходы матча с помощью клавиш ВЛЕВО и ВПРАВО,
переключаться между партиями с помощью клавиш PageUp и PageDown,
отображать анализ ходов (шашки и куб) нажатием CTRL-L,
переключаться между анализом ходов шашками и куба клавишей d,
видеть фактически сыгранный ход, выделенный в анализе.
Последняя посещённая позиция в каждом матче запоминается и восстанавливается автоматически. Нажмите CTRL-Tab или выполните команду match для отображения или скрытия панели.
Когда матч открыт, над доской появляется информационная панель: она показывает участвующих игроков (игрок 1 против игрока 2), а также контекст матча (событие, место, раунд, дату и длину матча, когда эта информация доступна).
При открытии базы данных, содержащей матчи, панель Матчи отображается сразу же, а разбор начинается прямо с первой позиции, чтобы можно было немедленно приступить к навигации.
Совет
Смотрите Горячие клавиши для доступных горячих клавиш.
2.14. Панель турниров
Панель Турниры (CTRL-Y) группирует матчи в турниры для организованного отслеживания и статистического анализа по событиям. Турниры можно создавать, переименовывать и удалять; матчи можно назначать им. Статистика панели Stats может фильтроваться по турниру. Нажмите CTRL-Y для отображения или скрытия панели.
2.15. Панель Stats
2.15.1. Введение
Панель Stats позволяет анализировать уровень игры и отслеживать прогресс во времени на основе позиций, импортированных в базу данных. Вычисляет и отображает PR (Performance Rate) и MWC cost (Match Winning Chance cost) для всех позиций или отфильтрованного подмножества.
Панель Stats особенно полезна для:
определения своего уровня относительно эталонных порогов (world-class, expert, advanced…) с помощью общего PR;
отслеживания прогресса от турнира к турниру или от матча к матчу с помощью графиков вкладки Progression;
выявления слабых мест: вкладка Erreurs отображает соотношение ходов шашками и решений куба, а также распределение величин ошибок;
прямого перехода к соответствующим позициям щелчком по любому показателю (drill-down).
2.15.2. Открытие панели
Для открытия панели Stats:
Нажмите CTRL-D.
Введите команду
:statsили:stв командной строке.
Примечание
Панель автоматически обновляется при каждом изменении фильтра. При простом переключении PR ↔ MWC статистика не пересчитывается: обе метрики вычисляются одновременно на стороне сервера.
2.15.3. Панель фильтров
Панель фильтров в верхней части панели позволяет ограничить вычисление подмножеством позиций.
2.15.3.1. Перспектива игрока
Выпадающий список Игрок фильтрует статистику для анализируемого игрока. blunderDB автоматически выбирает игрока, имя которого наиболее часто встречается в базе данных — можно изменить в любой момент.
Совет
Смена игрока не приводит к потере данных; достаточно повторно выбрать предыдущего игрока в списке.
2.15.3.2. Доступные фильтры
Турнир(ы) — ограничение одним или несколькими турнирами. Можно одновременно выбрать несколько турниров.
Даты — временной диапазон (От … До). Если указана только начальная дата, включаются более поздние позиции.
Тип решения — Все / Ходы шашками / Решения куба.
Длина матча — ограничение конкретными длинами матча (1, 3, 5, 7, 9, 11, 13, 15, 21 очко). Можно комбинировать несколько длин.
Кнопка Reset сбрасывает все фильтры (кроме автоматически определённого игрока).
Примечание
Фильтры сохраняются в конфигурации blunderDB (config.yaml) и восстанавливаются при следующем запуске.
2.15.4. Переключение PR / MWC
Кнопка PR / MWC в верхней части панели переключает отображаемую метрику во всех вкладках.
PR (Performance Rate)
Измеряет качество игры money-game: сумма ошибок в миллипунктах нардов, делённая на количество решений. Не зависит от счёта матча.
Приблизительные эталонные пороги:
Уровень
PR
World-class
< 3
Expert
3 – 5
Продвинутый
5 – 8
Средний
8 – 12
Начинающий
> 12
MWC cost (Match Winning Chance cost)
Накопленная вероятность победы в матче, утраченная из-за ошибок, по всему отфильтрованному набору данных. Вычисляется с использованием MET Kazaross-XG2, встроенной в blunderDB.
Осторожно
MWC cost не применяется к позициям money-game (без ставки матча). Эти позиции исключаются из вычисления MWC. Значения MWC зависят от используемой MET; они не сопоставимы напрямую между программами, использующими разные MET.
Переключение PR ↔ MWC мгновенное: перерасчёт на стороне сервера не выполняется.
2.15.5. Вкладка Dashboard
Вкладка Dashboard даёт сводный обзор ключевых показателей.
2.15.5.1. Карточки уровня
Три карточки отображают PR (или MWC) для:
All — все решения (ходы + куб);
Checker — только ходы шашками;
Cube — только решения куба.
Щелчок по карточке загружает в панель анализа позиции соответствующего подмножества (drill-down).
Примечание
Общее количество решений отображается внизу каждой карточки при наведении.
2.15.5.2. Скользящий PR за последние N решений
Строка значений PR (или MWC), вычисленных по последним N решениям (N = 5, 10, 50, 100, 250, 500, 1000), позволяет оценить последнюю тенденцию. Серые значения соответствуют N, превышающему количество доступных решений.
Щелчок по значению загружает соответствующие последние N позиций.
2.15.5.3. Топ грубых ошибок
Список 10 худших ошибок (или MWC cost), отсортированных по убыванию величины. Щелчок по строке загружает соответствующую позицию в панель анализа.
2.15.6. Вкладка Progression
Вкладка Progression показывает динамику уровня игры во времени.
2.15.6.1. График по турнирам
Линейный график отображает PR (или MWC) для каждого турнира (ось X: порядок турниров, ось Y: значение метрики). Цветные полосы обозначают пороги уровня.
Щелчок по точке графика открывает контекстное меню с двумя вариантами:
Open tournament — открывает турнир в панели Tournois.
Open positions — загружает все позиции турнира в панель анализа.
2.15.6.2. Диаграмма рассеяния по матчам
Диаграмма рассеяния представляет каждый матч (ось X: дата, ось Y: PR или MWC). Размер точки пропорционален количеству решений в матче.
Щелчок по точке открывает контекстное меню:
Open match — открывает матч в панели матчей.
Open positions — загружает все позиции матча в панель анализа.
2.15.7. Вкладка Erreurs
Вкладка Erreurs разбивает источники ошибок.
2.15.7.1. Разбивка по действиям куба
Столбчатая диаграмма отображает PR (или MWC) для каждого типа решения куба: NoDouble, DoubleTake, DoublePass, TooGood. Каждый столбец также показывает количество решений и долю грубых ошибок в подсказке.
Щелчок по столбцу загружает позиции, соответствующие этому действию куба, только те, в которых была ошибка (drill-down).
2.15.7.2. Сравнение Checker / Cube
Сравнительная диаграмма размещает рядом PR ходов шашками и решений куба. Щелчок по столбцу загружает позиции подмножества с ошибкой.
2.15.7.3. Гистограмма величин ошибок
Гистограмма распределяет ошибки по величине в миллипунктах (диапазоны: 0–5, 5–10, 10–25, 25–50, 50–100, ≥ 100). Щелчок по столбцу загружает позиции данного диапазона.
2.15.8. Правило агрегации
Важно
PR турнира (или любого подмножества) вычисляется по правилу сумма/сумма — никогда как среднее PR отдельных матчей.
Формула:
Пример: игрок проводит два матча в турнире —
Матч A: 10 решений, общая ошибка 50 mp → PR = 5,0
Матч B: 90 решений, общая ошибка 270 mp → PR = 3,0
Наивное среднее PR: (5,0 + 3,0) / 2 = 4,0 (неверно)
Правило сумма/сумма: (50 + 270) / (10 + 90) = 320 / 100 = 3,2 (верно)
Правило сумма/сумма — единственное, которое корректно учитывает различную длину матчей (матч до 21 очка весит больше, чем матч до 1 очка).
2.15.9. MWC: ограничения
MWC cost вычисляется с использованием MET Kazaross-XG2 — де-факто эталонной таблицы в соревновательных нардах. Результаты не сопоставимы напрямую с программами, использующими другие MET.
Позиции money-game (без счёта матча) исключаются из вычисления MWC. Если ваша база данных содержит много позиций money-game, MWC cost может быть занижен или недоступен.
MWC cost является накопительным по всему отфильтрованному набору данных — не показателем на решение. Он измеряет суммарное влияние ваших ошибок на шансы победы.
2.16. Панель EPC
Панель EPC (CTRL-E) вычисляет EPC (Effective Pip Count) позиции снятия шашек. Активируется нажатием CTRL-E, щелчком на вкладке EPC в нижней панели или выполнением команды epc.
В этой панели пользователь редактирует позиции шашек в домашней таблице (последние 6 пунктов), и в реальном времени для каждого игрока отображается следующая информация:
EPC (Effective Pip Count),
среднее количество бросков (Mean Rolls),
стандартное отклонение (Standard Deviation),
пипкаунт,
wastage (разница между EPC и пипкаунтом).
Когда у обоих игроков есть шашки в домашней таблице, раздел сравнения показывает разницы EPC и пипкаунта.
Для закрытия панели EPC нажмите CTRL-E или переключитесь на другую вкладку.
Примечание
Вычисление основано на встроенной базе данных снятия шашек на 6 пунктах GNUbg.
2.17. Панель Anki
Панель Anki (CTRL-K) позволяет изучать позиции методом интервального повторения с использованием алгоритма FSRS. Пользователи могут создавать колоды из коллекций или результатов поиска.
Создание колод: Нажмите New Deck для создания колоды из коллекции или текущих результатов поиска. Колоды на основе поиска синхронизируются автоматически при открытии вкладки Anki.
Повторение: Выберите колоду и нажмите Study (или дважды щёлкните на колоде) для начала повторения карточек с наступившим сроком. Каждая карточка показывает соответствующую позицию на доске. Оцените своё запоминание клавишами 1 (Снова), 2 (Сложно), 3 (Хорошо) или 4 (Легко). Нажмите Esc для остановки и возврата к списку колод.
Свободная тренировка (cram): Кнопка Cram рядом с Study запускает сессию свободной тренировки: вам показываются случайные позиции из колоды без учёта расписания FSRS. Этот режим никогда не изменяет план интервального повторения — идеально для разминки перед турниром или интенсивного повторения тематической колоды, не нарушая её порядок. Значок Cram заменяет состояние карточки, а кнопка Далее (клавиши 1–4) перелистывает позиции. Esc возвращает к списку, не сохраняя прерванную сессию.
Пауза/Продолжение: Вы можете прервать сеанс повторения в любой момент с помощью Esc. Кнопка меняется на Resume и показывает ваш прогресс. Нажмите её, чтобы продолжить с того места, где остановились.
Управление колодами: Используйте кнопки действий для переименования, синхронизации, сброса или удаления колод. Параметры FSRS (целевое удержание, максимальный интервал, случайный фактор) можно настраивать для каждой колоды в Настройках (значок шестерёнки).
2.18. Панель метаданных
Панель Метаданные отображает общую информацию о текущей базе данных: имя, описание, количество позиций, матчей и партий, версия схемы. Доступна через команду meta.
2.19. Панель журнала
Панель Журнал отображает журнал последних операций: импорты, экспорты и операции с базой данных, с результатами и временными метками. Полезна для диагностики ошибок импорта.