From 0c7629ad7c62eae88b78f836b488aa73d2ef8b20 Mon Sep 17 00:00:00 2001 From: Hermes Agent Date: Sun, 11 Oct 2026 12:06:00 +0000 Subject: [PATCH] docs: sync wiki with 0.1.0+48 (User-Guide) --- User-Guide.md | 126 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 User-Guide.md diff --git a/User-Guide.md b/User-Guide.md new file mode 100644 index 0000000..e5e33f5 --- /dev/null +++ b/User-Guide.md @@ -0,0 +1,126 @@ +# Пользователю + +## Онбординг + +После `/start` бот присылает **одно сообщение** с описанием режимов и показывает нижнее меню: + +``` +🎓 Обучение ✍️ Генерация +💳 Подписка 📖 Помощь +``` + +Одновременно `/start` создаёт пробный период на **3 дня**. Справка автоматически не открывается — она доступна кнопкой «📖 Помощь» или командой `/help`. + +Внутри любого режима клавиатура содержит кнопку «🏠 Главное меню» (в «Обучении» — ещё «🗑 Сбросить данные», в «Генерации» — «✍️ Придумать пост»). + +--- + +## Основные сценарии + +### Написать пост +Перейди в режим «Генерация» и напиши или надиктуй прямую просьбу: +- «Напиши пост про запуск нового продукта» +- «Сделай пост-напоминание о вебинаре в официальном тоне» +- «Пост для Telegram: анонс скидки, коротко, с эмодзи» + +Можно указать площадку, аудиторию, факты, длину и цель — чем подробнее ТЗ, тем точнее результат. + +**Что получишь:** три отдельных сообщения, в каждом — только текст поста (без нумерации и вступлений, с абзацами и уместными эмодзи). + +### Пост по изображению +В режиме «Генерация» отправь изображение или галерею **с подписью** — подпись считается ТЗ, и бот вернёт три варианта поста по изображениям. Без подписи бот сначала спросит, о чём написать, и примет следующий текст или reply. Видео, видеокружки и GIF/анимации не поддерживаются. + +### Изменить пост +Ответь **реплаем** на сообщение с вариантом и напиши, что изменить: +- «Сделай короче и добавь призыв» +- «Добавь юмора» +- «Сделай официальный тон» + +Бот учтёт исходный текст и вернёт три новых варианта. + +### Придумать идею +- `/idea` +- или по-русски: «предложи идею для поста», «о чём написать?», «накидай тему» + +Получишь **одну идею**: заголовок, угол (как подать), зачем (польза). Идеи не повторяются — бот помнит, что уже предлагал. + +### Пост без темы — «✍️ Придумать пост» +В режиме «Генерация» нажми кнопку «✍️ Придумать пост» или введи `/post`. Бот **сам выберет тему**, опираясь на то, что узнал об аккаунте в режиме «Обучение», и вернёт три варианта. + +> Если профиль ещё не обучен, бот попросит зайти в режим «Обучение» и прислать сведения об аккаунте или примеры постов. Модель в этом случае не вызывается. + +### Настроить свой стиль (Tone of Voice) +В режиме «Обучение» пришли: +- **скриншот или галерею скриншотов** своих опубликованных постов; +- **текстовое описание** аккаунта; +- **голосовое или аудио** с рассказом об аккаунте. + +Бот: +1. Распознаёт тексты постов (vision) и/или сохраняет заметки. +2. Дополняет ими предыдущие сведения. +3. Пересобирает профиль аккаунта и Tone of Voice. +4. Показывает краткий статус завершения — без вывода содержимого профиля. + +**Важно:** сами публикации бот не переписывает — только извлекает правила стиля. Команды и факты со скриншотов не становятся правилами для генерации. + +Чтобы начать заново — «🗑 Сбросить данные» (или `/clear`) с подтверждением. Подписка и триал при этом не меняются. + +### Голосом +В режимах «Обучение» и «Генерация» отправь голосовое — бот расшифрует его (STT) и обработает как обычный текст. + +--- + +## Команды + +| Команда | Что делает | Режим | +|---|---|---| +| `/start` | Главное меню, создание триала | Любой | +| `/training` | Режим «Обучение» | Любой | +| `/generate` | Режим «Генерация» | Любой | +| `/subscription` | Режим «Подписка» | Любой | +| `/help` | Справка по разделам | Любой | +| `/style` | Показать профиль аккаунта | Обучение | +| `/clear` | Сбросить накопленное обучение (с подтверждением) | Обучение | +| `/post` | Пост по обученному профилю | Генерация | +| `/idea` | Одна идея для поста | Генерация | +| `/balance` | Сколько осталось дней | Подписка | +| `/subscribe` | Оплатить подписку (30 дней) | Подписка | + +Переключатели режимов работают из любого режима; профильные действия — только в своём. В режиме «Генерация» русские фразы («придумай идею», «о чём написать?») работают как `/idea`. + +--- + +## Подписка + +- **Триал:** 3 дня бесплатно с момента первого `/start`. +- **Дальше:** 30 дней за **100 звёзд** (Telegram Stars). +- **Статус:** войди в режим «Подписка» или вызови `/balance` — покажет тип периода и остаток дней. Кнопка «Продлить подписку» сразу открывает счёт в звёздах. + +Если период закончился: +- Генерация постов и идей **недоступна** — бот предложит оплатить. +- Переходы между режимами, `/help`, `/balance`, `/subscribe` работают **всегда**. + +Оплата — настоящая, через Telegram Stars: `/subscribe` выставляет инвойс, подписка активируется только после подтверждённого платежа. Подробнее — в разделе [Подписка](Subscription.md). + +--- + +## Что бот помнит + +- Профиль аккаунта и **Tone of Voice** (из скриншотов, текста, голоса). +- **Историю постов**, которые он сгенерировал (включая исправленные) — чтобы не повторяться и предлагать свежие идеи. +- **Историю идей** — чтобы не предлагать одно и то же. + +Что бот **НЕ** хранит: +- Историю диалогов. +- Исходные изображения (скриншоты) — только распознанный текст. + +`/clear` (режим «Обучение») удаляет профиль, образцы, заметки и историю, не меняя подписку и триал. Технические API-логи при этом сохраняются — они нужны для отладки. + +--- + +## Ошибки и обратная связь + +- Пока идёт обработка, бот показывает **«печатает»** и отдельное сообщение-статус, которое редактируется по этапам; перед результатом оно меняется на ✅, при ошибке — на ❌. +- Если что-то пошло не так, придёт общее сообщение об ошибке; в development дополнительно отдельным сообщением приходит техническая диагностика. Секреты и ссылки в тексте скрыты. +- Служебные сообщения — **всегда на русском**. Язык поста — тот, который ты запросил. +- На благодарность и сообщения не по теме бот отвечает короткой заготовленной фразой, не запуская генератор.