Контракт бота и секреты
Контракт бота и секреты — Telegram-бот с локальной AI-моделью. Один приватный сценарий; Token не является текстом prompt; Сначала инъекция зависимостей. Практическое задание: Практика: Контракт бота и секреты.
Демо-версия. Материалы проходят редакторскую проверку.
Что рассмотрим
- Один приватный сценарий
- Token не является текстом prompt
- Сначала инъекция зависимостей
Один приватный сценарий
Учебный бот получает короткий текст разрешённого пользователя, передаёт локальной Ollama и готовит ответ в том же приватном чате. Он не публикует каналы, не выполняет shell и не читает файлы по просьбе модели. Нужны Node.js с fetch, отдельный тестовый бот и установленная локальная модель. Первую половину курса можно пройти на офлайн-fixtures без Telegram-токена. Fixtures проверяют программу, но не доказывают настоящую доставку сообщений или скорость модели на вашем оборудовании.
Token не является текстом prompt
BotFather выдаёт token для управления ботом; создание или отзыв выполняет владелец отдельно. В курсе token не создаём и не публикуем. Храните настоящее значение в защищённом файле либо secret-manager, не в коде, screenshot или shell history. Bot API включает token в URL, поэтому необработанный fetch-error или debug-журнал может его раскрыть. Программа должна возвращать очищенный код ошибки, не полный URL. Если token попал в чужой доступ, удаление строки из Git не заменяет отзыв.
Сначала инъекция зависимостей
Разделите Telegram transport, проверку доступа, model adapter и обработку update на функции. Основной handler получает зависимости аргументами, поэтому тест подставляет фиктивную модель и send-функцию, только записывающую вызов в массив. В этом режиме сети нет вообще. Не маскируйте fixture под ответ настоящей модели: обозначьте её явно. Учебный набор файлов — policy.mjs, model.mjs, transport.mjs, worker.mjs и offline.test.mjs. Добавляйте постепенно; ранние модули не должны автоматически запускать polling при импорте в тест.
Практическое задание
Практика: Контракт бота и секреты
Перейти к обучению