Файн-тюнинг обучения: сглаживание уточняющих правок яркости (XIC-32)

[Oksion]

Закрывает XIC-32. Решает жалобу «клавишами только 10 ступеней, хочется на половину» — но не борьбой с Windows, а в самом обучении.

Суть

Железо принимает все 101 уровень (проверено: WmiMonitorBrightness.Level) — шаг 10% накладывает Windows на своих клавишах. Значит комфортное значение между ступенями руками недостижимо, человек колеблется (60, 50, снова 60), а кривая раньше скакала вслед за ним на всю ступень.

Теперь правка в пределах одной ступени сдвигает прежнее мнение навстречу наполовину:

pct_new = round( pct_old + β·(pct_user − pct_old) ),  β = 0.5, AwayFromZero

Колебание 65/55 сходится к 60 — значению, которое кривая выставить может, а клавиши нет. Побочный эффект важнее основного: у колебаний исчезает причина, и система обучения перестаёт осциллировать сама по себе (идея владельца — она же оказалась и более чистой по сходимости).

Крупная правка (70 → 40) записывается точно — это осознанная смена, а не поиск середины.

Детали, которые легко упустить

• Округление AwayFromZero, а не банковское: иначе 50.5 → 50, и настойчивый пользователь застревал бы на полпути. Тест Learn_Persistence_ReachesExactValue это стережёт — повтор одного значения доводит якорь ровно до него за 3–4 правки.
• Вытеснение считается по итоговому значению, а не по «сырому» выбору — иначе инвариант монотонности мог бы порваться. Тест Learn_Smoothing_KeepsCurveMonotonic.
• UI и строки не менялись: параметры (AutoBrightnessLearnBlend, AutoBrightnessFineStep) — в config.json.

Что решили не делать

Вариант с перехватом штатных клавиш (доводить их 10-шаг до 5%) отклонён, хотя эксперимент показал его выполнимость: Windows шагает ±10 от текущего значения, а не притягивает к сетке (25 → 35 → 45 → …), так что залипания не было бы. Отклонён из-за видимого отскока яркости (35 → 30 на доли секунды) и возни с автоповтором клавиши. Результаты пробы сохранены в задаче на случай возврата.

Проверка

dotnet build 0/0, dotnet test — 368 зелёных (+5: сглаживание, буквальная запись крупной правки, сходимость колебаний, настойчивость, монотонность после серии сглаживаний). Все прежние тесты не тронуты — новое поведение включается только для мелких правок.

Живьём: поколебаться между двумя ступенями при одном свете — на графике видно, как якорь встаёт между ними, вместо прыжков.

🤖 Generated with Claude Code