# Команды утилиты katana.py

Справочник команд и аргументов.
Все команды идут через транзакцию `begin → data → commit → save` и безопасны: печать не прерывается, прошивка остаётся живой.
Исключение — `macro set`/`macro clear`: вендор после записи макросов save не делает (подробности в [protocol.md](../protocol.md)).
Низкоуровневое описание транзакций — в [protocol.md](../protocol.md).

Режимы подсветки и их аргументы вынесены в отдельный документ: [color-modes.md](../color-modes.md).

## Состав справочника

| Документ                              | Тема                                                                          |
| ------------------------------------- | ----------------------------------------------------------------------------- |
| [colors.md](colors.md)                | Именованные цвета CSS вместо `RRGGBB`.                                        |
| [keys.md](keys.md)                    | Имена клавиш: канонические, символы, синонимы, hex-индексы.                   |
| [paint.md](paint.md)                  | `paint` — per-key раскраска и shorthand-алиасы (`--wasd`, `--row1`…`--row6`). |
| [scan.md](scan.md)                    | `scan` — визуальный перебор режимов.                                          |
| [raw.md](raw.md)                      | `raw` — произвольный payload для экспериментов.                               |
| [remap.md](remap.md)                  | `remap` — переназначение клавиш на мышь, шорткаты редактора, мультимедиа, горячие клавиши и макросы. |
| [macro.md](macro.md)                  | `macro` — запись макросов, работа с вендорским XML.                           |
| [apply.md](apply.md)                  | `apply` — применение YAML-конфига целиком (профиль настроек).                 |
| [commands.md](commands.md)            | Команды без аргументов: `keys`, `reset`, `off`, `default`.                    |
| [troubleshooting.md](troubleshooting.md) | Что делать, если команда отклоняется или прошивка залипла.                 |