[позже] Сценарии (общие)

Глава 11. Реальные сценарии использования: от идеи до готового результата

В предыдущих главах вы прошли весь путь: установили DSH, настроили профиль, подключили GitHub и сервер, научились писать промпты и контролировать безопасность. Теперь самое время посмотреть, как всё это работает в реальной жизни.

Эта глава — сборник типовых сценариев с готовыми промптами. Считайте их шаблонами, а не гарантией «скопировал — и на проде всё ок». Версии DSH меняются; ваш стек (Docker, Caddy, feature-ветки) важнее чужого «успешного кейса».

Важно: начинайте с тестового репозитория. На прод — только после главы «Страховка» (Cursor → DSH) и приёмки URL/git. Фраза агента «готово» без проверки — не результат.

11.1. Сценарий 1: Создание сайта-визитки с нуля (с деплоем)

Это самый частый запрос от маркетологов. Вы хотите получить готовый сайт, который сразу открывается в браузере. Раньше вы просили Cursor написать код, а потом сами загружали его на сервер. Теперь агент делает всё сам.

Что нужно:

• Установленный профиль с плагинами dsh-github (Глава 4) и SSH-доступом к серверу (Глава 5).
• Тестовый репозиторий на GitHub.
• Сервер (VPS или хостинг) с доступом по SSH.

Готовый промпт (копируйте и подставляйте свои данные):

ЦЕЛЬ: Создать одностраничный сайт-визитку для компании «[название]».

Что должно быть на сайте:
- Логотип (заглушка — просто текст с названием компании)
- Блок «О нас» с текстом-заглушкой
- Блок «Услуги» с 3–5 пунктами (придумай сам, исходя из названия компании)
- Блок «Контакты»: телефон, email, адрес
- Форма обратной связи (имя, телефон, сообщение) — без реальной отправки, просто заглушка

Дизайн: минималистичный, основной цвет #1a5276 (тёмно-синий), шрифт Roboto из Google Fonts.

Технологии: HTML + CSS + JavaScript (один файл index.html, можно встроить стили и скрипты внутрь).

РЕСУРСЫ:
- Репозиторий: [ссылка на ваш GitHub-репозиторий]
- Сервер: [имя сервера из настроек SSH]
- Папка на сервере: /home/dsh-agent/www/[название_проекта]

ШАГИ:
1. Склонируй репозиторий на локальный компьютер (или используй существующий).
2. Создай index.html с указанным дизайном и содержанием.
3. Открой index.html в браузере (через open index.html или start index.html) и проверь, что всё выглядит нормально.
4. Закоммить изменения с сообщением «feat: add landing page for [название]».
5. Запушь на GitHub.
6. Подключись к серверу [имя сервера] и скопируй файлы в папку /home/dsh-agent/www/[название_проекта] (используй git pull или rsync).
7. Проверь, что сайт открывается по адресу [URL вашего сайта].

ОГРАНИЧЕНИЯ: Не используй фреймворки (React, Vue и т.д.) — только чистый HTML/CSS/JS. Не трогай другие файлы на сервере.

ОБРАБОТКА ОШИБОК: Если страница не открывается после деплоя, проверь права доступа к папке и попробуй перезапустить веб-сервер. Если не получится — сообщи мне текст ошибки и остановись.

ФИНАЛ: Пришли ссылку на GitHub-репозиторий и URL работающего сайта.

Что вы получите на выходе:

• Готовый HTML-файл в вашем репозитории на GitHub.
• Работающий сайт по вашему URL.
• Уведомление от агента со ссылками.

Сколько времени занимает: 5–15 минут (в зависимости от скорости модели и интернета).

11.2. Сценарий 2: Сбор и парсинг данных с сайта

Вы хотите регулярно собирать информацию с какого-то сайта — например, цены конкурентов, курсы валют, новости. Раньше вы писали скрипт сами или просили Cursor. Теперь агент может написать скрипт, настроить его выполнение по расписанию и отправлять вам результат.

Что нужно:

• Плагин dsh-automation для расписания.
• Плагин для уведомлений — например, dsh-telegram-notify.

Готовый промпт:

ЦЕЛЬ: Настроить автоматический сбор курса USD/RUB с сайта [например, cbr.ru] и отправку отчёта в Telegram.

РЕСУРСЫ:
- Используй плагин dsh-automation для создания расписания.
- Используй Telegram-бот для отправки уведомлений.

ШАГИ:
1. Напиши скрипт на Python, который:
- Заходит на сайт ЦБ РФ (https://cbr.ru)
- Парсит текущий курс USD/RUB
- Выводит результат в формате «Курс USD на [дата]: X.XX руб.»
2. Сохрани скрипт в файл get_usd_rate.py в рабочей папке.
3. Проверь скрипт локально (запусти и убедись, что он выдаёт корректный курс).
4. Настрой расписание: запускать скрипт каждый день в 10:00 по московскому времени.
5. Настрой отправку результата в Telegram-канал [укажите ID канала или чата].

ОГРАНИЧЕНИЯ: Не используй Selenium — только requests и BeautifulSoup. Не храни токены в коде, используй переменные окружения.

ОБРАБОТКА ОШИБОК: Если сайт недоступен, попробуй повторить через 5 минут до 3 раз. Если не получится — отправь мне сообщение об ошибке и остановись.

ФИНАЛ: Покажи мне лог первого выполнения, чтобы я убедился, что всё работает.

Что вы получите на выходе:

• Готовый Python-скрипт для парсинга.
• Настроенное расписание (задача появится в Settings → Scheduled Tasks).
• Ежедневные уведомления в Telegram с курсом валют.

11.3. Сценарий 3: Автоматизация контента для соцсетей

Вы ведёте блог или соцсети и тратите часы на придумывание тем, написание постов и планирование публикаций. DSH может стать вашим личным контент-менеджером.

Что нужно:

• Плагин dsh-content-lab — «контентная фабрика».

Установка плагина:

dsh plugin --profile web add dsh-content-lab

Готовый промпт:

ЦЕЛЬ: Создать контент-план для Instagram-блога на неделю. Тема блога: [ваша тема, например, «здоровое питание» или «цифровой маркетинг»].

РЕСУРСЫ:
- Используй плагин dsh-content-lab.

ШАГИ:
1. Сгенерируй 7 тем для постов (по одной на каждый день) — используй инструмент content_topic_generator.
2. Для каждой темы сгенерируй 3 варианта заголовков (разных стилей: с цифрами, с вопросами, эмоциональные) — используй content_title_rewriter.
3. Выбери лучший вариант для каждого дня и напиши полноценный пост для Instagram (текст + хештеги) — используй content_post_writer.
4. Сформируй календарь публикаций на неделю с датами и временем — используй content_calendar.

ФИНАЛ: Покажи мне готовый контент-план в виде таблицы: день, тема, заголовок, текст поста, хештеги.

Что вы получите на выходе:

• 7 готовых тем для постов.
• Заголовки и тексты для каждого поста.
• Календарь публикаций на неделю.
• Всё это в структурированном виде — можно сразу копировать и публиковать.

11.4. Сценарий 4: Создание игры или интерактивной страницы

DSH отлично справляется с созданием небольших игр и интерактивных страниц. В одном из тестов агент успешно создал игру «Сапёр» и «Русскую рулетку».

Что нужно:

• Стандартный профиль (без дополнительных плагинов).

Готовый промпт (адаптировано из реального теста):

ЦЕЛЬ: Создать игру «Сапёр» в одном HTML-файле.

Требования:
- Поле 9×9 с 10 минами.
- При клике на клетку — открывается число мин вокруг (или пустота).
- При клике на мину — игра заканчивается, показывается сообщение «Вы проиграли!».
- Есть кнопка «Новая игра» для перезапуска.
- Дизайн — минималистичный, в стиле ретро.

ШАГИ:
1. Создай файл sapper.html.
2. Реализуй всю логику на чистом JavaScript внутри одного HTML-файла (без внешних библиотек).
3. Открой файл в браузере и проверь, что игра работает.
4. Если есть баги — исправь их.

ФИНАЛ: Покажи мне готовый файл и скажи, работает ли игра.

Что вы получите на выходе:

• Готовый HTML-файл с игрой.
• Можно открыть в браузере и играть.

11.5. Сценарий 5: Агент создаёт свои собственные инструменты

Это, пожалуй, самая впечатляющая возможность DSH. Агент может обнаружить, что ему не хватает какого-то инструмента, написать его сам и использовать — прямо в процессе выполнения задачи.

Реальный пример из тестов: агенту нужно было сжать 60 изображений (83 МБ) в WebP. Вместо того чтобы обрабатывать каждое изображение по одному (60 вызовов модели, куча токенов, замусоренный диалог), агент написал плагин для массового сжатия изображений, загрузил его, выполнил задачу за один вызов и удалил плагин.

Как это выглядит в диалоге:

Вы просто даёте задачу, которая требует нестандартного действия. Агент сам поймёт, что ему нужен новый инструмент, и создаст его.

Пример промпта:

«В папке /images лежит 50 фотографий в формате PNG. Сожми их все в WebP с качеством 80% и сохрани в папку /images/webp. Если для этого потребуется создать новый инструмент — создай его и используй. После выполнения удали временный инструмент.»

Что произойдёт:

1. Агент поймёт, что у него нет встроенного инструмента для массового сжатия.
2. Он напишет код плагина (определение инструмента).
3. Загрузит плагин в текущую сессию.
4. Выполнит задачу за один вызов.
5. Удалит плагин после завершения.

Результат: вы получаете сжатые изображения, а диалог остаётся чистым — без 50 промежуточных ответов. Агент сам решает, когда ему нужен новый инструмент, и создаёт его «на лету».

Это как если бы у вас был помощник, который не просто пользуется готовыми инструментами, а сам делает новые инструменты под конкретную задачу, а потом убирает их.

11.6. Сценарий 6: SDR-агент для поиска клиентов (для B2B-маркетологов)

Для тех, кто занимается B2B-маркетингом или продажами, есть специальный плагин — SDR-агент (Sales Development Representative). Он выполняет полный цикл поиска и обработки потенциальных клиентов.

Что нужно:

• Плагин @xuxchloris/dsh-sdr.

Установка:

dsh plugin --profile web add @xuxchloris/dsh-sdr

Как работает:

После установки в веб-интерфейсе появляется новый режим — «SDR digital employee» (цифровой SDR-сотрудник). Вы просто даёте задачу, например:

«Найди 3 компании в США, которые продают товары для кемпинга и походов»

Агент проходит 9 этапов:
1. Анализ задачи — понимает, что вы ищете.
2. Поиск компаний — находит потенциальных клиентов.
3. Анализ компаний — изучает их сайты и соцсети.
4. Оценка — оценивает, насколько компания подходит.
5. Написание писем — генерирует персонализированные письма.
6. Согласование — останавливается и ждёт вашего одобрения писем.
7. Планирование — составляет план дальнейших действий.
8. Подготовка материалов — готовит коммерческие предложения.
9. Закрытие — формирует итоговый отчёт.

Важно: письма и сообщения по умолчанию работают в безопасном режиме (dry-run) — они не отправляются по-настоящему, пока вы не проверите и не дадите добро.

Что вы получите на выходе:

• Список компаний с контактами.
• Готовые письма для каждого контакта.
• Полный аудит всех действий агента.

11.7. Сводная таблица: какой сценарий выбрать

11.8. Итоговый чек-лист: вы готовы к реальным задачам

После прочтения этой главы вы:

• [x] Знаете, как создать сайт-визитку от начала до деплоя.
• [x] Умеете настраивать автоматический парсинг данных по расписанию.
• [x] Можете использовать DSH как контент-фабрику для соцсетей.
• [x] Понимаете, как агент может создавать свои собственные инструменты «на лету».
• [x] Знаете о SDR-плагине для B2B-маркетинга.
• [x] Можете выбрать подходящий сценарий для своей задачи.