From 76e208bf08c487c5dc07a7168bc461c6b37bc00a Mon Sep 17 00:00:00 2001 From: Hermes Agent Date: Sun, 11 Oct 2026 22:11:58 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D1=83=20?= =?UTF-8?q?=D0=B8=20=D0=B2=D0=B5=D1=80=D1=81=D0=B8=D1=8E=200.1.0+60?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Deployment.md | 4 ++-- Developer-Guide.md | 12 ++++++++++-- Home.md | 3 ++- User-Guide.md | 2 ++ 4 files changed, 16 insertions(+), 5 deletions(-) diff --git a/Deployment.md b/Deployment.md index 0993c68..0442a4d 100644 --- a/Deployment.md +++ b/Deployment.md @@ -11,7 +11,7 @@ | **Сервер приложения** | `spb-easy-dale` (`31.129.103.242`) | | **Бот** | [@post_master_bot](https://t.me/post_master_bot) | | **Группа поддержки** | супергруппа с темами, `chat.id = -1008000863273` | -| **Версия** | `VERSION`, сейчас `0.1.0+59` | +| **Версия** | `VERSION`, сейчас `0.1.0+60` | > Сервер управления Coolify и сервер приложения — **разные хосты**. Проверять контейнер нужно на сервере приложения, а не на хосте Coolify. @@ -49,7 +49,7 @@ ssh root@31.129.103.242 'docker logs --tail 60 ' Успешный запуск: ``` -INFO:__main__:Development deploy notice sent: version=0.1.0+59 +INFO:__main__:Development deploy notice sent: version=0.1.0+60 INFO:aiogram.dispatcher:Start polling INFO:aiogram.dispatcher:Run polling for bot @post_master_bot id=2201652808 - 'Мастер постинга' ``` diff --git a/Developer-Guide.md b/Developer-Guide.md index 521e1f3..6dffdee 100644 --- a/Developer-Guide.md +++ b/Developer-Guide.md @@ -77,6 +77,14 @@ update_tone_from_image → _handle_image_message --- +### Навигация справки (`help_message.py`) + +`help_menu_html()` и `help_section_html()` формируют только кнопки перехода к разделам справки. +Кнопки собираются последовательно в строки по бюджету ширины `HELP_BUTTON_ROW_WIDTH`; подписи +не сокращаются и переносятся целиком. Отдельной кнопки «В меню» нет; текущий раздел disabled. + +--- + ## Ключевые функции ### `bot.py` @@ -95,7 +103,7 @@ update_tone_from_image → _handle_image_message | `handle_successful_payment` | Активирует подписку после реальной оплаты | | `clear_command` | `/clear` и «Сбросить данные» — inline-подтверждение, сброс только в режиме обучения | | `style_command` | `/style` — профиль аккаунта | -| `help_command` / `help_navigation` | Справка Rich Message + переключение разделов | +| `help_command` / `help_navigation` | Справка Rich Message; разделы ведут друг к другу, без кнопки «В меню»; подписи целиком упаковываются в строки | | `notify_development_deploy` | Dev-уведомление о новой версии в `DEV_CHAT_ID` | | `typing_status` | Индикатор «печатает» | | `report_error` | Понятная ошибка пользователю; секреты вырезаны | @@ -259,7 +267,7 @@ SELECT payload FROM raw_updates WHERE update_id = ?; .venv/bin/python -m unittest discover -s tests -v ``` -Тесты: 251 (на версии `0.1.0+59`). Покрытие: STT, LLM, vision, ToV, reply-поля, изоляция пользователей, API-логи, **raw update log**, режимные клавиатуры и роутинг, платежи (Stars, защита от повторов, dev-подтверждение), ошибки, справка, онбординг, подписки, самостоятельная генерация поста, восстановление обрезанного JSON, индикатор «печатает», **поддержка** (топики, подписи, кнопка «Ответить», закрытие обращения). +Тесты: 251 (на версии `0.1.0+60`). Покрытие: STT, LLM, vision, ToV, reply-поля, изоляция пользователей, API-логи, **raw update log**, режимные клавиатуры и роутинг, платежи (Stars, защита от повторов, dev-подтверждение), ошибки, справка, онбординг, подписки, самостоятельная генерация поста, восстановление обрезанного JSON, индикатор «печатает», **поддержка** (топики, подписи, кнопка «Ответить», закрытие обращения). > Запускай через `.venv` проекта: вне виртуального окружения `aiogram` может быть не установлен. diff --git a/Home.md b/Home.md index 8825ae4..4efe6b3 100644 --- a/Home.md +++ b/Home.md @@ -6,7 +6,7 @@ - **Репозиторий:** `admin/social-post-writer-bot` - **Стек:** Python 3.12, aiogram 3.x, aiohttp, SQLite, APInex (LLM / STT / vision) - **Деплой:** Coolify, окружение `development`, приложение `social-post-writer-bot-development` -- **Версия разработки:** `0.1.0+59` +- **Версия разработки:** `0.1.0+60` --- @@ -22,6 +22,7 @@ | **Идеи** | «предложи тему» или `/idea` — одна идея (заголовок, угол, зачем) | | **Режимы** | «Обучение», «Генерация», «Подписка», «Помощь» — нижнее меню с кнопкой возврата | | **Поддержка** | «🆘 Поддержка» — переписка с оператором в личке, у него в персональном топике группы | +| **Помощь** | `/help` — меню разделов; кнопки расположены последовательно, переносятся целиком и ведут между разделами без кнопки «В меню» | | **Подписка** | Триал 3 дня, затем 30 дней за 100 звёзд (реальная оплата Telegram Stars) | --- diff --git a/User-Guide.md b/User-Guide.md index f4164ab..3fad220 100644 --- a/User-Guide.md +++ b/User-Guide.md @@ -11,6 +11,8 @@ Одновременно `/start` создаёт пробный период на **3 дня**. Справка автоматически не открывается — она доступна кнопкой «📖 Помощь» или командой `/help`. +В меню справки кнопки разделов идут друг за другом и переносятся на следующую строку целиком, когда не помещаются. Отдельной кнопки «В меню» нет; внутри раздела можно перейти к любому другому. + Внутри любого режима клавиатура содержит кнопку «🏠 Главное меню» (в «Обучении» — ещё «🗑 Сбросить данные», в «Генерации» — «✍️ Придумать пост», в «Помощи» — «🆘 Поддержка»). ---