Initial commit

docs/cli/scan.md

@@ -0,0 +1,22 @@
+# scan — визуальный перебор режимов
+
+## Аргументы `scan`
+
+| Аргумент       | Значения        | По умолчанию | Описание               |
+| -------------- | --------------- | ------------ | ---------------------- |
+| `--from`       | `1`–`19`        | `1`          | Первый режим перебора. |
+| `--to`         | `1`–`19`        | `19`         | Последний режим.       |
+| `--color`      | hex или имя     | `ff0000`     | Цвет для всех режимов. |
+| `--brightness` | `1`–`15`        | `15`         | Яркость.               |
+| `--speed`      | `2`–`15`        | `10`         | Скорость.              |
+| `--delay`      | секунды (float) | `2.0`        | Пауза между режимами.  |
+
+```
+katana.py scan --from 1 --to 19 --delay 2
+```
+
+Каждый режим отправляется с записью во флеш.
+В конце печатается список принятых и отклонённых прошивкой режимов.
+Полезно при реверсе: смотреть на клавиатуру и записывать, какой номер какой эффект показывает.
+
+Сами режимы и их названия — в [COLOR-MODES.md](../COLOR-MODES.md).