справочник команд из 28 записей, подключён к боту; устранены таймауты Matrix (74 -> 0)
This commit is contained in:
1 parent
8ab2c4251b
commit
5bcf1a512b
1 file changed
+60
@@ -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 ботов описано в справочнике |
|
||||
Reference in new issue
Block a user