Обновить Telegram-бота, документацию и связанные доработки

SHiNE-agent-bot-coder/README.md

@@ -8,6 +8,7 @@
 - обрабатывает задачи строго последовательно;
 - поддерживает текстовые и голосовые сообщения (voice/audio через OpenAI transcription);
 - вызывает Codex CLI и отправляет ответ в Telegram;
+- в личном чате умеет работать в двух персонально переключаемых режимах: через одно редактируемое статусное сообщение или через отдельные сообщения по этапам;
 - умеет персонально для каждого пользователя озвучивать финальный ответ через OpenAI TTS;
 - при рестарте восстанавливает незавершённые задачи;
 - отправляет аварийный статус только если Codex молчит 2 минуты подряд во время активной задачи;
@@ -60,6 +61,13 @@ python3 SHiNE-agent-bot-coder/py_bot_service.py --selftest-codex "Ответь
 - Если Telegram заранее сообщает большой размер файла, бот больше не отказывается сразу: сначала явно пишет, что пробует скачать файл, затем отдельно сообщает, удалось ли скачивание, и только после успешной загрузки переходит к подготовке аудио и OpenAI.
 - Для очень больших файлов упираемся не только в OpenAI, но и в лимит обычного облачного Telegram Bot API на скачивание файла ботом. Для таких случаев нужно использовать локальный `telegram-bot-api` сервер и указать его через `TELEGRAM_API_BASE_URL`.
 
+## Статусы в личке
+- Для `private`-чата бот поддерживает персональную настройку режима ответа.
+- По умолчанию он старается не засорять переписку промежуточными сообщениями: создаёт одно статусное сообщение и редактирует его по этапам.
+- Если включить `/single_message_off`, бот возвращается к старому режиму и отправляет отдельные сообщения по этапам и финальный ответ отдельно.
+- Если финальный текст в режиме одного сообщения не помещается целиком, бот оставляет первую часть в отредактированном статусном сообщении и отправляет максимум ещё одно дополнительное текстовое сообщение с хвостом ответа.
+- Голосовой ответ, если он включён, всегда приходит отдельным новым сообщением.
+
 ## Запуск как systemd-сервис
 Файлы для установки:
 - `scripts/systemd/shine-agent-bot-coder.service`
@@ -77,6 +85,7 @@ python3 SHiNE-agent-bot-coder/py_bot_service.py --selftest-codex "Ответь
 
 ## Telegram-команды
 - `/status` — активная задача и размер очереди.
+- `/settings` — текущие пользовательские настройки и команды для их изменения.
 - `/queue` — список задач в очереди.
 - `/stop` — остановить текущую задачу.
 - `/cancel <id|all>` — удалить задачу по id/префиксу или очистить очередь.
@@ -85,5 +94,7 @@ python3 SHiNE-agent-bot-coder/py_bot_service.py --selftest-codex "Ответь
 - `/voice_off` — выключить озвучивание финальных ответов для текущего пользователя.
 - `/voice_rewrite_on` — включить адаптацию текста перед озвучкой.
 - `/voice_rewrite_off` — выключить адаптацию текста перед озвучкой.
+- `/single_message_on` — вести ответ в личке через одно редактируемое сообщение.
+- `/single_message_off` — слать отдельные сообщения по этапам и отдельный финальный ответ.
 - `/restart` или `/restart_service` — отложенный рестарт после текущей задачи, до взятия следующей (только для Айдара).
 - `/restart_hard` — жёсткий рестарт прямо сейчас (только для Айдара).