справочник команд из 28 записей, подключён к боту; устранены таймауты Matrix (74 -> 0)

This commit is contained in:
root committed 2026-10-15 16:00:50 +03:00
1 parent 8ab2c4251b
commit 5bcf1a512b
1 file changed
+60
+60
View File
@@ -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 ботов описано в справочнике |