Kletka 1.5.0 — Export Tree to Polyglot Book

🇷🇺 Русский

🌐 Веб-сайт: https://andreykhrypach.github.io/Kletka/

🚀 Клетка 1.5.0 — Экспорт дерева в Polyglot-книгу

🔥 Главные изменения

1. Экспорт дерева в Polyglot-книгу

• Создавайте личный репертуар из проанализированных вариантов.
• Меню Книги → Экспорт в Polyglot книгу...
• Все ходы из дерева (главная линия + все варианты) попадают в книгу.
• Транспозиции и дубликаты автоматически дедуплицируются.
• Совместимость со Stockfish, Leela, ChessBase, Scid, Arena.
• Нестандартные начальные позиции — поддержка.
• Правильная работа с развилками — без дублирования.

2. Улучшения работы с Polyglot книгами

• ✅ Выгрузка книги не показывает ложный диалог сохранения партии.
• ✅ Сохранение перед выгрузкой — диалог «Сохранить / Не сохранять / Отмена».
• ✅ Единое поведение проверки несохранённых изменений: Ctrl+N, закрытие программы, выгрузка книги.
• ✅ Разделение логики партии и книги — больше нет путаницы состояний.
• ✅ Удаление кеша ходов — правильное подтягивание вариантов из книги по позиции, полученной разными путями.

3. Инструменты тренера

• ✅ Кружок добавлен к стрелкам и крестикам.
• ✅ Автозакрытие панели тренера перед переворотом доски и скрытием координат.
• ✅ Красный маркер стал ярче и насыщеннее.

4. Режим книги

• ✅ Названия вариантов теперь показываются для текущей позиции (не только для главной линии).

🐛 Известные проблемы на macOS

Drag-and-drop: фигура «хватается за угол»

• Симптомы: фигура визуально берётся за угол, а не за центр; курсор может исчезнуть.
• Причина: известный баг JavaFX JDK-8333919 — на macOS игнорируются смещения dragViewOffsetX/Y.
• Исправлен в JavaFX 23 (требует JDK 21+). Клетка сейчас на Java 17 + JavaFX 17.
• Обходной путь: используйте click-to-move (клик на фигуру → клик на клетку).
• Статус: будет исправлено при миграции Клетка на JDK 25 + JavaFX 25.

📦 Для пользователей

Важно

• Все ваши PGN файлы, книги и настройки сохраняются при обновлении.
• Настройки хранятся в:
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

Что нового попробовать

• Откройте партию с вариантами.
• Меню Книги → Экспорт в Polyglot книгу...
• Выберите папку и имя файла.
• Загрузите полученную книгу в Kletka или Stockfish.

🛠️ Для разработчиков

Что было сделано

• Экспорт дерева в Polyglot-книгу через PolyglotBookWriter.
• Разделение логики партии и книги в MainController.
• Единый механизм проверки несохранённых изменений.
• Кеш ходов для Polyglot книги удаляется при смене позиции.
• Отдельные сборки для Debian и Ubuntu.
• Автозакрытие тренерских инструментов через ChessBoardView.
• Исправлен AppPreferencesTest — тест больше не зависит от файловой системы.

🙏 Благодарности

Спасибо всем пользователям за обратную связь и поддержку!

---

Скачать Клетка 1.5.0:

• Windows (.exe)
• Linux Debian (.deb)
• Linux Ubuntu (.deb)
• macOS (.dmg)

---

⭐ Если вам понравился проект, поставьте звезду на GitHub!

---

🇬🇧 English

🚀 Kletka 1.5.0 — Export Tree to Polyglot Book

🔥 Key Changes

1. Export tree to Polyglot book

• Create your personal repertoire from analyzed variations.
• Menu Books → Export to Polyglot book...
• All moves from the tree (main line + all variations) go into the book.
• Transpositions and duplicates are automatically deduplicated.
• Compatible with Stockfish, Leela, ChessBase, Scid, Arena.
• Non-standard starting positions — supported.
• Correct handling of forks — no duplication.

2. Polyglot book improvements

• ✅ Unloading a book no longer shows a false save dialog.
• ✅ Save before unload — dialog «Save / Don't save / Cancel».
• ✅ Unified behavior for unsaved changes: Ctrl+N, app close, book unload.
• ✅ Separated logic of game and book — no more state confusion.
• ✅ Move cache removal — correct loading of book variations for positions reached via different move paths.

3. Coach tools

• ✅ Circle added to arrows and crosses.
• ✅ Auto-close of coach panel before board flip and coordinate toggle.
• ✅ Red marker is brighter and more saturated.

4. Book mode

• ✅ Variation names now show for the current position (not just the main line).

🐛 Known Issues on macOS

Drag-and-drop: piece «grabs by the corner»

• Symptoms: piece visually grabs by the corner, not center; cursor may disappear.
• Cause: known JavaFX bug JDK-8333919 — macOS ignores dragViewOffsetX/Y.
• Fixed in JavaFX 23 (requires JDK 21+). Kletka currently on Java 17 + JavaFX 17.
• Workaround: use click-to-move (click piece → click square).
• Status: will be fixed when Kletka migrates to JDK 25 + JavaFX 25.

📦 For Users

Important

• All your PGN files, books and settings are preserved during upgrade.
• Settings are stored in:
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

What to try

• Open a game with variations.
• Menu Books → Export to Polyglot book...
• Choose folder and file name.
• Load the resulting book in Kletka or Stockfish.

🛠️ For Developers

What was done

• Tree export to Polyglot book via PolyglotBookWriter.
• Separated game/book logic in MainController.
• Unified unsaved-changes check.
• Move cache cleared on position change.
• Separate builds for Debian and Ubuntu.
• Auto-close of coach tools via ChessBoardView.
• Fixed AppPreferencesTest — no longer depends on filesystem.

🙏 Acknowledgements

Thanks to all users for feedback and support!

---

Download Kletka 1.5.0:

• Windows (.exe)
• Linux Debian (.deb)
• Linux Ubuntu (.deb)
• macOS (.dmg)

---

⭐ If you like the project, please give it a star on GitHub!

---

🇨🇳 中文

🚀 Kletka 1.5.0 — 将棋谱树导出为 Polyglot 开局库

🔥 主要变化

1. 将棋谱树导出为 Polyglot 开局库

• 从分析过的变例中创建 个人开局库。
• 菜单 书籍 → 导出为 Polyglot 开局库...
• 棋谱树中的所有走法（主变 + 所有变例）都会写入开局库。
• 换位和重复 自动去重。
• 兼容 Stockfish、Leela、ChessBase、Scid、Arena。
• 支持非标准起始局面。
• 正确处理分叉 — 无重复。

2. Polyglot 开局库改进

• ✅ 卸载开局库 不再显示错误的 保存对话框。
• ✅ 卸载前保存 — 对话框「保存 / 不保存 / 取消」。
• ✅ 统一行为 检查未保存的更改：Ctrl+N、关闭程序、卸载开局库。
• ✅ 分离逻辑 对局与开局库 — 不再混淆状态。
• ✅ 删除走法缓存 — 正确处理通过不同走法路径到达局面的开局库变例。

3. 教练工具

• ✅ 箭头和叉号添加了 圆圈。
• ✅ 在 翻转棋盘 和 切换坐标 前 自动关闭 教练面板。
• ✅ 红色标记 更亮、更饱和。

4. 开局库模式

• ✅ 变例名称 现在对 当前局面 显示（不再仅限主变）。

🐛 macOS 已知问题

拖放：棋子「抓在角落」

• 症状： 棋子视觉上抓在角落而非中心；光标可能消失。
• 原因： JavaFX 已知 bug JDK-8333919 — macOS 忽略 dragViewOffsetX/Y。
• 已在 JavaFX 23 修复（需要 JDK 21+）。Kletka 目前使用 Java 17 + JavaFX 17。
• 解决方法： 使用 点击移动（点击棋子 → 点击格子）。
• 状态： 将在 Kletka 迁移至 JDK 25 + JavaFX 25 时修复。

📦 对于用户

重要提示

• 升级时您的所有 PGN 文件、开局库和设置都将保留。
• 设置存储位置：
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

试试新功能

• 打开一个含变例的对局。
• 菜单 书籍 → 导出为 Polyglot 开局库...
• 选择文件夹和文件名。
• 在 Kletka 或 Stockfish 中加载生成的开局库。

🛠️ 对于开发者

已完成的工作

• 通过 PolyglotBookWriter 将棋谱树导出为 Polyglot 开局库。
• 在 MainController 中分离对局/开局库逻辑。
• 统一的未保存更改检查。
• 局面变化时清除走法缓存。
• 分别为 Debian 和 Ubuntu 构建。
• 通过 ChessBoardView 自动关闭教练工具。
• 修复 AppPreferencesTest — 不再依赖文件系统。

🙏 致谢

感谢所有用户的反馈和支持！

---

下载 Kletka 1.5.0：

• Windows (.exe)
• Linux Debian (.deb)
• Linux Ubuntu (.deb)
• macOS (.dmg)

---

⭐ 如果您喜欢这个项目，请在 GitHub 上给它一个星标！

Kletka 1.4

🌐 Website: https://andreykhrypach.github.io/Kletka/

🚀 Kletka 1.4.0 — Обновление Polyglot книги

🔥 Главные изменения

1. Редактирование Polyglot книги прямо во время игры

• Добавляйте новые варианты в книгу, не выходя из программы
• Отмена добавленного хода до сохранения книги
• Кнопка сохранения книги — все изменения применяются в один клик
• Переработанное контекстное меню: корректное удаление вариантов, ходов и перестроение дерева
• В режиме книги разрешён анализ движка, но выполнение хода недоступно

2. Мгновенная загрузка книг через MappedByteBuffer

• Большие и малые Polyglot книги загружаются практически мгновенно, даже на HDD
• Загрузка через MMap ускоряет работу с книгами в разы
• Никаких задержек при открытии книги на 500 МБ+

3. Улучшения работы с доской

• Смена цвета при расстановке позиции — удобно, если вы играли чёрными и лучше помните позицию с этой стороны
• Инструменты тренера: стрелки и крестики теперь корректно совпадают с клетками после скрытия координат и при перевороте доски

4. Исправление критических багов

• ✅ Выбор варианта на развилке главной линии — теперь всегда применяется выбранный вариант, а не главная линия
• ✅ Загрузка Polyglot книги — исправлена ошибка с отрицательным числом при фильтрации ходов
• ✅ Навигация по панели кнопок в режиме книги
• ✅ Открытие страницы GitHub на Linux (Debian)
• ✅ Отображение хода при перетаскивании фигуры при создании нового варианта
• ✅ Индексация при сохранении позиции в неиндексированный PGN файл

---

📦 Для пользователей

Важно

• Все ваши PGN файлы, книги и настройки сохраняются при обновлении
• Настройки хранятся в:
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

Что нового попробовать

• Откройте Polyglot книгу и попробуйте добавить новый вариант прямо во время игры
• Нажмите Alt+Z, чтобы отменить добавленный ход до сохранения
• Используйте кнопку сохранения, чтобы применить изменения в книгу

---

🛠️ Для разработчиков

Что было сделано

• Узел-развилка (currentNode) теперь всегда корректно привязан к currentVariation через owningVariation
• findVariationForNode использует owningVariation с fallback по parent
• switchToVariation вызывается безусловно — «умолчание на главную линию» убрано
• MarkerOverlay больше не кеширует координаты клеток — берёт их динамически через localToScene

---

🙏 Благодарности

Спасибо всем пользователям за обратную связь и поддержку!

---

Скачать Kletka 1.4.0:

• Windows (.exe)
• Linux (.deb)
• macOS (.dmg)

---

⭐ Если вам понравился проект, поставьте звезду на GitHub!

---

🇬🇧 English

🚀 Kletka 1.4.0 — Polyglot Book Update

🔥 Key Changes

1. Polyglot book editing directly during the game

• Add new variations to the book without leaving the app
• Undo added move before saving the book
• Save Book button — all changes applied in one click
• Redesigned context menu: correct deletion of variations, moves and tree rebuilding
• Book mode allows engine analysis, but move execution is disabled

2. Instant book loading via MappedByteBuffer

• Large and small Polyglot books load almost instantly, even on HDD
• MMap loading speeds up book handling significantly
• No delays when opening books of 500 MB+

3. Board handling improvements

• Board flip during position setup — convenient if you played as Black and remember the position better from that side
• Coach tools: arrows and crosses now correctly align with squares after hiding coordinates and when flipping the board

4. Critical bug fixes

• ✅ Variation selection at a main line fork — the chosen variation is now always applied instead of falling back to the main line
• ✅ Polyglot book loading — fixed the negative number during move filtering
• ✅ Navigation panel buttons in book mode
• ✅ GitHub page opening on Linux (Debian)
• ✅ Move display when dragging a piece during new variation creation
• ✅ Indexing when saving a position to a non-indexed PGN file

---

📦 For Users

Important

• All your PGN files, books and settings are preserved during upgrade
• Settings are stored in:
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

What to try

• Open a Polyglot book and try adding a new variation directly during the game
• Press Alt+Z to undo the added move before saving
• Use the Save Book button to apply changes to the book

---

🛠️ For Developers

What was done

• The fork node (currentNode) is now always correctly bound to currentVariation via owningVariation
• findVariationForNode uses owningVariation with a parent-based fallback
• switchToVariation is called unconditionally — the "default to main line" behavior removed
• MarkerOverlay no longer caches square coordinates — reads them dynamically via localToScene

---

🙏 Acknowledgements

Thanks to all users for feedback and support!

---

Download Kletka 1.4.0:

• Windows (.exe)
• Linux (.deb)
• macOS (.dmg)

---

⭐ If you like the project, please give it a star on GitHub!

---

🇨🇳 中文

🚀 Kletka 1.4.0 — Polyglot 开局库更新

🔥 主要变化

1. 对局中直接编辑 Polyglot 开局库

• 无需离开程序即可向开局库 添加新变例
• 保存开局库前可 撤销添加的走法
• 保存开局库按钮 — 一键应用所有更改
• 重新设计的 上下文菜单：正确删除变例、走法和重建变例树
• 开局库模式允许 引擎分析，但禁止执行走法

2. 通过 MappedByteBuffer 实现瞬间加载开局库

• 大型和小型 Polyglot 开局库加载 几乎瞬间完成，即使在 HDD 上
• MMap 加载使开局库操作速度 显著提升
• 打开 500 MB+ 的开局库无任何延迟

3. 棋盘操作改进

• 摆棋时翻转棋盘 — 如果您执黑棋且更容易从黑方角度记住局面，这会非常方便
• 教练工具：隐藏坐标后和翻转棋盘时，箭头和叉号现在能与棋盘格子正确对齐

4. 关键错误修复

• ✅ 在主变分叉点选择变例 — 现在始终应用所选变例，而不再回退到主变
• ✅ Polyglot 开局库加载 — 修复了过滤走法时出现的负数错误
• ✅ 开局库模式下的导航面板按钮
• ✅ 在 Linux (Debian) 上打开 GitHub 页面
• ✅ 创建新变例时拖动棋子的走法显示
• ✅ 将局面保存到未索引 PGN 文件时的索引

---

📦 对于用户

重要提示

• 升级时您的所有 PGN 文件、开局库和设置都将保留
• 设置存储位置：
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

试试新功能

• 打开 Polyglot 开局库，尝试在对局中 添加新变例
• 按 Alt+Z 撤销保存前添加的走法
• 使用 保存开局库按钮 将更改应用到开局库

---

🛠️ 对于开发者

已完成的工作

• 分叉节点 (currentNode) 现在通过 owningVariation 始终正确绑定到 currentVariation
• findVariationForNode 使用 owningVariation，并以 parent 作为回退
• switchToVariation 现在无条件调用 —— 移除了“默认回退到主变”的行为
• MarkerOverlay 不再缓存格子坐标 —— 通过 localToScene 动态获取

---

🙏 致谢

感谢所有用户的反馈和支持！

---

下载 Kletka 1.4.0：

• Windows (.exe)
• Linux (.deb)
• macOS (.dmg)

---

⭐ 如果您喜欢这个项目，请在 GitHub 上给它一个星标！

Kletka 1.3

🚀 Kletka 1.3.0 — Major Update

🔥 Главные изменения

1. Полный переход на бинарный индекс (вместо JSON)

• Индекс PGN файлов теперь полностью бинарный
• Скорость работы с большими PGN файлами выросла в 5-10 раз
• Памяти потребляется в разы меньше
• JSON-индекс больше не используется — все файлы .idx можно удалить

2. Улучшенная навигация по Polyglot дебютным книгам

• Перемещение по вариантам книги теперь работает и по клику мыши
• Удобный просмотр дебютных вариантов
• Интуитивное управление

3. Исправление критических багов

• ✅ Исправлено закрытие диалога выбора вариантов на macOS
• ✅ Исправлено закрытие диалога выбора вариантов на Linux (Debian)
• ✅ Убрана ненужная зависимость libjpeg-turbo для Debian Linux

4. Работа с индексом

• Полный отказ от JSON-индекса
• Бинарный индекс — новый стандарт
• Пользователи могут безопасно удалять старые файлы индексации с расширением .idx

---

📦 Для пользователей

Обновление с версии 1.2.x

1. Установите новую версию
2. Старые .idx файлы можно удалить — они больше не нужны
3. Индекс будет перестроен автоматически

Важно

• Все ваши PGN файлы, книги и настройки сохраняются при обновлении
• Настройки хранятся в:
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

---

🛠️ Для разработчиков

Что было сделано

• Замена JSON-индекса на бинарный
• Переход на LazyPgnIndex с ленивой загрузкой
• Улучшение производительности и стабильности

---

🙏 Благодарности

Спасибо всем пользователям за обратную связь и поддержку!

---

Скачать Kletka 1.3.0:

• [Windows (.exe)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/Kletka-1.3.0.exe)
• [Linux (.deb)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/kletka_1.3.0-1_amd64.deb
• [macOS (.dmg)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/Kletka-1.3.0.dmg)

---

⭐ Если вам понравился проект, поставьте звезду на GitHub!

---

🚀 Kletka 1.3.0 — Major Update

🔥 Key Changes

1. Full Migration to Binary Index (replacing JSON)

• PGN file index is now fully binary
• Performance with large PGN files improved 5-10x faster
• Memory consumption significantly reduced
• JSON index is no longer used — all .idx files can be safely deleted

2. Improved Polyglot Opening Book Navigation

• Book navigation now works with mouse clicks (not just keyboard)
• Convenient browsing of opening variations
• Intuitive controls

3. Critical Bug Fixes

• ✅ Fixed variant selection dialog closing on macOS
• ✅ Fixed variant selection dialog closing on Linux (Debian)
• ✅ Removed unnecessary libjpeg-turbo dependency for Debian Linux

4. Index Management

• Complete removal of JSON index
• Binary index is the new standard
• Users can safely delete old index files with .idx extension

---

📦 For Users

Upgrading from version 1.2.x

1. Install the new version
2. Old .idx files can be deleted — they are no longer needed
3. Index will be rebuilt automatically

Important

• All your PGN files, books and settings are preserved during upgrade
• Settings are stored in:
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

---

🛠️ For Developers

What was done

• Replaced JSON index with binary format
• Migrated to LazyPgnIndex with lazy loading
• Performance and stability improvements

---

🙏 Acknowledgements

Thanks to all users for feedback and support!

---

Download Kletka 1.3.0:

• [Windows (.exe)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/Kletka-1.3.0.exe)
• [Linux (.deb)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/kletka_1.3.0-1_amd64.deb)
• [macOS (.dmg)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/Kletka-1.3.0.dmg)

---

⭐If you like project, please make star on GitHub!

---

🚀 Kletka 1.3.0 — 重大更新

🔥 主要变化

1. 完全迁移到二进制索引（替代 JSON）

• PGN 文件索引现已完全改为二进制格式
• 处理大型 PGN 文件的速度提升 5-10 倍
• 内存消耗 大幅降低
• 不再使用 JSON 索引 — 所有 .idx 文件可以安全删除

2. 改进 Polyglot 开局库导航

• 现在可以通过 鼠标点击 浏览开局库（不仅限于键盘）
• 方便查看开局变例
• 直观的操作控制

3. 关键错误修复

• ✅ 修复 macOS 上变体选择对话框无法关闭的问题
• ✅ 修复 Linux (Debian) 上变体选择对话框无法关闭的问题
• ✅ 移除 Debian Linux 不必要的 libjpeg-turbo 依赖

4. 索引管理

• 完全移除 JSON 索引
• 二进制索引成为新标准
• 用户可以 安全删除 旧的 .idx 索引文件

---

📦 对于用户

从 1.2.x 版本升级

1. 安装新版本
2. 旧的 .idx 文件可以 删除 — 它们不再需要
3. 索引将自动重建

重要提示

• 升级时您的所有 PGN 文件、开局库和设置都将保留
• 设置存储位置：
  • Windows: %APPDATA%\Kletka\
  • Linux: ~/.config/kletka/
  • macOS: ~/Library/Application Support/Kletka/

---

🛠️ 对于开发者

已完成的工作

• 将 JSON 索引替换为二进制格式
• 迁移到带有懒加载功能的 LazyPgnIndex
• 性能和稳定性改进

---

🙏 致谢

感谢所有用户的反馈和支持！

---

下载 Kletka 1.3.0：

• [Windows (.exe)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/Kletka-1.3.0.exe)
• [Linux (.deb)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/kletka_1.3.0-1_amd64.deb)
• [macOS (.dmg)] (https://github.com/AndreyKhrypach/Kletka/releases/download/1.3.0/Kletka-1.3.0.dmg)

---

⭐ 如果您喜欢这个项目，请在 GitHub 上给它一个星标！

Kletka 1.2

📝 Релизные заметки для Kletka 1.2

---

🎉 Kletka 1.2.0

Kletka — кроссплатформенный шахматный анализатор с поддержкой дебютных книг Polyglot, движка Stockfish и PGN файлов.

---

🚀 Новые возможности

📚 Дебютные книги Polyglot

• Загрузка и навигация по дебютным книгам в формате .bin

• Режим BOOK с навигацией по вариантам: ↑ ↓ → ← Enter

• Рекомендуемая книга: uho-pohl.bin

• Источник книг: Polyglot Books Repository

🎯 Улучшения движка

• Автоматическое создание вариантов при ходе движка в развилках

• Улучшенная проверка легальности позиции (короли, пешки, шахи)

🖌️ Тренерские инструменты

• Переработана отрисовка стрелок и крестиков через Canvas

• Устранены конфликты отображения маркеров

• Улучшен Undo/Redo для маркеров

💾 Улучшения пользовательского опыта

• Запоминание последней папки сохранения (межсессионно)

• Защита от сохранения/копирования в режиме BOOK

• Обновленное меню (кнопки с выпадающими списками)

• Добавлена поддержка апгрейда в Windows-инсталляторе

🌍 Языки

• Автоматическое определение языка из системной локали

• Поддержка 3 языков: Русский, English, 中文

---

🐛 Исправления

• Исправлено создание вариантов при ходе движка в развилках

• Исправлена проверка шахов с учетом стороны хода

• Исправлено сохранение последней папки (межсессионно)

• Исправлено отображение стрелок и крестиков в тренерских инструментах

• Исправлена проверка нелегальных позиций (тройной шах, короли)

• Запрещено сохранение PGN в режиме книги

---

⚡ Улучшения

• Добавлен BookHtmlVisitor для отображения дебютных книг

• Добавлен BookManager для управления книгами

• Улучшена обработка нелегальных позиций

• Обновлен GitHub Actions workflow

• Обновлен README.md с актуальными скриншотами

---

📦 Скачать

Выберите установщик для вашей платформы:

Платформа	Скачать
Windows	Kletka-1.2.0.exe
Linux	kletka_1.2.0-1_amd64.deb
macOS	Kletka-1.2.0.dmg

---

⭐ Если вам понравился проект, поставьте звезду на GitHub!

📝 Релизные заметки для Kletka 1.2 🎉 Kletka 1.2.0

Kletka — кроссплатформенный шахматный анализатор с поддержкой дебютных книг Polyglot, движка Stockfish и PGN файлов.
🚀 Новые возможности
📚 Дебютные книги Polyglot

Загрузка и навигация по дебютным книгам в формате .bin

Режим BOOK с навигацией по вариантам: ↑ ↓ → ← Enter

Рекомендуемая книга: uho-pohl.bin

Источник книг: [Polyglot Books Repository](https://github.com/ChrisWhittington/polyglot-books)

🎯 Улучшения движка

Автоматическое создание вариантов при ходе движка в развилках

Улучшенная проверка легальности позиции (короли, пешки, шахи)

🖌️ Тренерские инструменты

Переработана отрисовка стрелок и крестиков через Canvas

Устранены конфликты отображения маркеров

Улучшен Undo/Redo для маркеров

💾 Улучшения пользовательского опыта

Запоминание последней папки сохранения (межсессионно)

Защита от сохранения/копирования в режиме BOOK

Обновленное меню (кнопки с выпадающими списками)

Добавлена поддержка апгрейда в Windows-инсталляторе

🌍 Языки

Автоматическое определение языка из системной локали

Поддержка 3 языков: Русский, English, 中文

🐛 Исправления

Исправлено создание вариантов при ходе движка в развилках

Исправлена проверка шахов с учетом стороны хода

Исправлено сохранение последней папки (межсессионно)

Исправлено отображение стрелок и крестиков в тренерских инструментах

Исправлена проверка нелегальных позиций (тройной шах, короли)

Запрещено сохранение PGN в режиме книги

⚡ Улучшения

Добавлен BookHtmlVisitor для отображения дебютных книг

Добавлен BookManager для управления книгами

Улучшена обработка нелегальных позиций

Обновлен GitHub Actions workflow

Обновлен README.md с актуальными скриншотами

📦 Скачать

Выберите установщик для вашей платформы:

Платформа	Скачать
Windows	Kletka-1.2.0.exe
Linux	kletka_1.2.0-1_amd64.deb
macOS	Kletka-1.2.0.dmg
📚 Дебютные книги

Kletka поддерживает книги Polyglot (.bin). Скачать бесплатные книги можно здесь:
🔗 Polyglot Books Repository

Рекомендуемая книга: uho-pohl.bin
📄 Лицензия

Этот проект распространяется под лицензией GNU General Public License v3.0.
👨‍💻 Автор

Andrey Khrypach
GitHub

⭐ Если вам понравился проект, поставьте звезду на GitHub!

🇬🇧 English Version

---

🎉 Kletka 1.2.0

Kletka is a cross-platform chess analyzer with support for Polyglot opening books, the Stockfish engine, and PGN files.

---

🚀 New Features

📚 Polyglot Opening Books

• Load and browse opening books in .bin format

• BOOK mode with navigation: ↑ ↓ → ← Enter

• Recommended book: uho-pohl.bin

• Book source: Polyglot Books Repository

🎯 Engine Improvements

• Automatic variation creation when the engine makes a mov...

Kletka 1.1.0

🚀 Новые возможности

• Пакетная обработка PGN файлов - удаление и вставка до 100 000 партий за раз
• WDL (Win-Draw-Loss) - отображение шансов на победу/ничью/поражение в анализе движка
• Черный цвет в инструментах тренера для разметки доски
• Кнопка "Donate" в панели меню для поддержки проекта

🐛 Исправления

• Загрузка партий теперь открывается в начальной позиции (без автоматического выполнения первого хода)
• Диалог выбора вариантов всегда показывается при наличии развилки
• Сохранение настроек движка больше не сбрасывается
• Исправлена обработка нелегальных позиций при сбросе игры
• Исправлено отображение неоднозначных ходов в анализе движка

⚡ Улучшения

• Ускорение пакетных операций в 5 раз (BATCH_SIZE=500)
• Стрелки тренера стали тоньше (10px → 6.5px)
• Удалены бэкапы для операций с PGN - операции выполняются быстрее
• Улучшена цветовая схема в панели анализа
• Добавлена кнопка "Donate" с Bitcoin адресом и QR-кодом
• В меню "Язык" добавлены галочки для активного языка

🧹 Технические

• Удален неиспользуемый стек навигации
• Добавлены тесты для пакетных операций
• Обновлен GitHub Actions workflow

---

📦 Скачать

Выберите установщик для вашей платформы:

• Windows: Kletka-Setup-1.1.0.exe
• Linux: kletka_1.1.0-1_amd64.deb
• macOS: Kletka-1.1.0.dmg

---

❤️ Поддержать проект

Bitcoin: 15HGcdu67yy3pMb2roANr2GAJZDPefB1HS

---

🚀 New Features

• Batch PGN processing - delete/insert up to 100,000 games at once
• WDL (Win-Draw-Loss) - display win/draw/loss chances in engine analysis
• Black color in coach tools for board markings
• "Donate" button in the menu bar to support the project

🐛 Bug Fixes

• Game loading now opens in starting position (no automatic first move)
• Fork dialog always shows when options exist
• Engine settings persistence fixed
• Illegal position handling fixed in resetGame()
• Ambiguous move display fixed in engine analysis

⚡ Improvements

• Batch operations 5x faster (BATCH_SIZE=500)
• Coach arrows thinner (10px → 6.5px)
• Removed PGN operation backups - faster operations
• Improved color scheme in analysis panel
• Added "Donate" button with Bitcoin address and QR code
• Language menu now shows checkmarks for active language

🧹 Technical

• Removed unused navigation stack
• Added tests for batch operations
• Updated GitHub Actions workflow

---

📦 Download

Choose installer for your platform:

• Windows: Kletka-Setup-1.1.0.exe
• Linux: kletka_1.1.0-1_amd64.deb
• macOS: Kletka-1.1.0.dmg

---

❤️ Support the project

Bitcoin: 15HGcdu67yy3pMb2roANr2GAJZDPefB1HS

---

🚀 新功能

• PGN 批量处理 - 一次删除/插入多达 100,000 个对局
• WDL（胜/和/负） - 在引擎分析中显示胜/和/负概率
• 黑色标记 - 教练工具中新增黑色标记
• "Donate" 按钮 - 菜单栏中添加支持项目按钮

🐛 修复

• 对局加载现在从起始位置开始（不自动执行第一步）
• 分支对话框在有选项时始终显示
• 引擎设置持久化修复
• 非法位置处理修复
• 引擎分析中歧义走法显示修复

⚡ 改进

• 批量操作速度提升 5 倍（BATCH_SIZE=500）
• 教练箭头变细（10px → 6.5px）
• 移除 PGN 操作备份 - 操作更快
• 分析面板配色方案改进
• 添加 "Donate" 按钮，支持比特币地址和二维码
• 语言菜单现在显示当前语言的勾选标记

📦 下载

选择您平台的安装包：

• Windows: Kletka-Setup-1.1.0.exe
• Linux: kletka_1.1.0-1_amd64.deb
• macOS: Kletka-1.1.0.dmg

---

❤️ 支持项目

比特币: 15HGcdu67yy3pMb2roANr2GAJZDPefB1HS

---

Kletka 1.0.11

🇬🇧 English

Kletka 1.0 — first stable release!

• Full PGN support (open, edit, save)
• Stockfish engine integration for analysis
• Variations and annotations
• Customizable board themes
• Multilingual: English, Russian, Chinese
• Installers for Windows, Linux, macOS

---

🇷🇺 Русский

Kletka 1.0 — первый стабильный релиз!

• Полная поддержка PGN (открытие, редактирование, сохранение)
• Интеграция с движком Stockfish для анализа
• Варианты и аннотации
• Настраиваемые темы доски
• Мультиязычность: русский, английский, китайский
• Установщики для Windows, Linux, macOS

---

🇨🇳 中文 (Chinese)

Kletka 1.0 — 首个稳定版本！

• 完整的 PGN 支持（打开、编辑、保存）
• 集成 Stockfish 引擎用于分析
• 变体和注释
• 可自定义的棋盘主题
• 多语言支持：中文、英语、俄语
• 适用于 Windows、Linux、macOS 的安装程序

Kletka 1.0

🇬🇧 English

Kletka 1.0 — first stable release!

• Full PGN support (open, edit, save)
• Stockfish engine integration for analysis
• Variations and annotations
• Customizable board themes
• Multilingual: English, Russian, Chinese
• Installers for Windows, Linux, macOS

---

🇷🇺 Русский

Kletka 1.0 — первый стабильный релиз!

• Полная поддержка PGN (открытие, редактирование, сохранение)
• Интеграция с движком Stockfish для анализа
• Варианты и аннотации
• Настраиваемые темы доски
• Мультиязычность: русский, английский, китайский
• Установщики для Windows, Linux, macOS

---

🇨🇳 中文 (Chinese)

Kletka 1.0 — 首个稳定版本！

• 完整的 PGN 支持（打开、编辑、保存）
• 集成 Stockfish 引擎用于分析
• 变体和注释
• 可自定义的棋盘主题
• 多语言支持：中文、英语、俄语
• 适用于 Windows、Linux、macOS 的安装程序