Команды утилиты katana.py
Справочник команд и аргументов.
Все команды идут через транзакцию begin → data → commit → save и безопасны: печать не прерывается, прошивка остаётся живой.
Исключение — macro set/macro clear: вендор после записи макросов save не делает (подробности в protocol.md).
Низкоуровневое описание транзакций — в protocol.md.
Режимы подсветки и их аргументы вынесены в отдельный документ: color-modes.md.
Состав справочника
| Документ | Тема |
|---|---|
| colors.md | Именованные цвета CSS вместо RRGGBB. |
| keys.md | Имена клавиш: канонические, символы, синонимы, hex-индексы. |
| paint.md | paint — per-key раскраска и shorthand-алиасы (--wasd, --row1…--row6). |
| scan.md | scan — визуальный перебор режимов. |
| raw.md | raw — произвольный payload для экспериментов. |
| remap.md | remap — переназначение клавиш на мышь, шорткаты редактора, мультимедиа, горячие клавиши и макросы. |
| macro.md | macro — запись макросов, работа с вендорским XML. |
| apply.md | apply — применение YAML-конфига целиком (профиль настроек). |
| commands.md | Команды без аргументов: keys, reset, off, default. |
| troubleshooting.md | Что делать, если команда отклоняется или прошивка залипла. |