Поддержка MacOS (проверено в Tahoe)

docs/cli/README.md

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

docs/cli/apply.md

@@ -8,7 +8,7 @@
 ./katana.py apply katana.yaml.example     # применить пример из репозитория
 ```
 
-Зависимость: PyYAML (`pip install pyyaml`, см. [INSTALL.md](../INSTALL.md)).
+Зависимость: PyYAML (`pip install pyyaml`, см. [install.md](../install.md)).
 
 ## Порядок применения и сохранение
 
@@ -72,7 +72,7 @@ paint:
   brightness: 15
 ```
 
-### `lighting` — режим подсветки (см. [COLOR-MODES.md](../COLOR-MODES.md))
+### `lighting` — режим подсветки (см. [color-modes.md](../color-modes.md))
 
 `mode` — имя или номер 1..19, а также `off` и `default` (применяются как команды `off`/`default`).
 

docs/cli/macro.md

@@ -1,7 +1,7 @@
 # macro — макросы
 
 Записывает содержимое макросов в прошивку (канал 04 19) и работает с вендорским XML.
-Формат протокола — в [PROTOCOL.md](../PROTOCOL.md).
+Формат протокола — в [protocol.md](../protocol.md).
 
 Макрос нужно привязать к клавише через `remap --key КЛЮЧ=macro<N>` (индексация 0-based: «Макрос 1» вендорской утилиты = 0).
 

docs/cli/paint.md

@@ -91,7 +91,7 @@ Shorthand для `--key`: покрасить горизонтальный ряд
 
 ### `--no-save`
 
-Не писать во флеш (см. `mode --no-save` в [COLOR-MODES.md](../COLOR-MODES.md)).
+Не писать во флеш (см. `mode --no-save` в [color-modes.md](../color-modes.md)).
 По умолчанию save выполняется.
 
 Без `--all` и `--key` команда завершается ошибкой.

docs/cli/raw.md

@@ -10,7 +10,7 @@ Payload до 64 байт (пробелы допустимы).
 
 ### `--no-save`
 
-Не писать во флеш (см. `mode --no-save` в [COLOR-MODES.md](../COLOR-MODES.md)).
+Не писать во флеш (см. `mode --no-save` в [color-modes.md](../color-modes.md)).
 По умолчанию save выполняется.
 
 ```
@@ -20,4 +20,4 @@ Payload до 64 байт (пробелы допустимы).
 Payload отправляется внутри штатной транзакции `begin → data → commit → save`.
 Для экспериментов с неописанными байтами.
 
-Формат payload'ов и назначение байтов — в [PROTOCOL.md](../PROTOCOL.md).
+Формат payload'ов и назначение байтов — в [protocol.md](../protocol.md).

docs/cli/remap.md

@@ -1,6 +1,6 @@
 # remap — переназначение клавиш
 
-Переназначает клавиши на кнопки мыши, функции текстового редактора, мультимедиа/веб-действия, эмуляцию горячих клавиш и макросы (канал 04 11, формат — в [PROTOCOL.md](../PROTOCOL.md)).
+Переназначает клавиши на кнопки мыши, функции текстового редактора, мультимедиа/веб-действия, эмуляцию горячих клавиш и макросы (канал 04 11, формат — в [protocol.md](../protocol.md)).
 
 ```
 ./katana.py remap --key caps=lmb                  # Caps → левая кнопка мыши
@@ -121,7 +121,7 @@
 
 ### `--no-save`
 
-Не писать во флеш (см. `mode --no-save` в [COLOR-MODES.md](../COLOR-MODES.md)).
+Не писать во флеш (см. `mode --no-save` в [color-modes.md](../color-modes.md)).
 
 **Важно:** каждый вызов перезаписывает ВСЮ таблицу переназначений (как вендорская утилита).
 Переназначения, не указанные в текущем вызове `--key`, сбрасываются в default.

docs/cli/scan.md

@@ -19,4 +19,4 @@ katana.py scan --from 1 --to 19 --delay 2
 В конце печатается список принятых и отклонённых прошивкой режимов.
 Полезно при реверсе: смотреть на клавиатуру и записывать, какой номер какой эффект показывает.
 
-Сами режимы и их названия — в [COLOR-MODES.md](../COLOR-MODES.md).
+Сами режимы и их названия — в [color-modes.md](../color-modes.md).

docs/cli/troubleshooting.md

@@ -3,4 +3,4 @@
 - Команда отклоняется со статусом `00`/`ff` — сессия залипла.
   Сначала повторить команду, затем `katana.py reset` (переподключение порта ~2–12 с, клавиатура не отваливается от системы).
 - `reset` не помог — выключить/включить клавиатуру физически.
-- Подробности и все известные грабли — в [PROTOCOL.md](../PROTOCOL.md) (раздел «Важные грабли»).
+- Подробности и все известные грабли — в [protocol.md](../protocol.md) (раздел «Важные грабли»).