diff --git a/docs/NIGHT-JOURNAL.md b/docs/NIGHT-JOURNAL.md index 0b6d08d..3f18c75 100644 --- a/docs/NIGHT-JOURNAL.md +++ b/docs/NIGHT-JOURNAL.md @@ -550,3 +550,63 @@ Bazarr (Python/waitress) поднимает веб-сервер через 60– **Все службы, поддерживающие PostgreSQL, переведены на центральную базу.** Осталась Uptime Kuma — её версия 1.23.17 PostgreSQL не поддерживает. + +--- + +## ✅ СПРАВОЧНИК КОМАНД И ПЕРЕВОД БОТА В MATRIX (15.10.2026) + +### 1. Справочник команд — команды больше не в голове + +Создан **единственный источник правды**: `ops/bots/commands.yaml`. +Из него генерируется всё: справка `/help` для каждого бота и общий +справочник `docs/COMMANDS.md` в репозитории. + +``` +ops/bots/commands.yaml ← правим только здесь + ↓ gen_help.py + ├── /help в каждом боте (только его команды) + ├── /help <команда> (подробно: вызов, примеры, доступ) + ├── опечатка → «возможно, вы имели в виду /status?» + └── docs/COMMANDS.md (общий справочник в Gitea) +``` + +**28 команд, 5 ботов.** Добавить команду = добавить запись в справочник. + +Генератор работает **без внешних библиотек**: если PyYAML нет — +используется встроенный разбор. Проверено, справка формируется в обоих случаях. + +### 2. Бот подключён к справочнику + +Зашитая в код справка (четыре строки) заменена вызовом генератора. +Проверено внутри контейнера: `из справочника: True`, длина 444 знака. +Если справочник недоступен — бот возвращается к прежнему тексту и +продолжает работать. + +Копия исходного файла: `/app/bot.py.before-help`. + +### 3. Найдена и устранена причина таймаутов Matrix + +В журнале бота было **74 предупреждения `Timed out`** от Matrix-клиента. + +**Причина:** бот обращается к Matrix по публичному адресу, а в его +окружении задан `HTTP_PROXY` — тот самый, что нужен для обхода +блокировок Telegram. Matrix стоит **в соседнем контейнере** +(192.168.1.155), и ходить к нему через внешний прокси не нужно. + +**Исправление:** адрес Matrix добавлен в `NO_PROXY`. + +**Результат: таймаутов 74 → 0**, в журнале появилось +**«Matrix-слушатель запущен»**, события из комнат обрабатываются. + +Это важный вывод на будущее: **внутренние службы не должны ходить +через прокси, предназначенный для внешнего доступа.** + +### 4. Что это даёт + +| Было | Стало | +|---|---| +| справка из четырёх строк в коде | справочник из 28 команд, генерируется | +| команды надо помнить | `/help` показывает, `/help <команда>` объясняет | +| опечатка ничего не подсказывает | подсказка похожей команды | +| Matrix-связь таймаутила | 0 таймаутов, слушатель работает | +| всё в одном боте | разделение на 5 ботов описано в справочнике |