qwen-alpha 1.0.20 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,116 @@
+# Changelog
+
+Все изменения в проекте Qwen Alpha.
+
+## [2.0.0] — 2026-03-02
+
+### ✨ Новые возможности
+
+- **Системные промпты** — кастомизация поведения бота под разные задачи
+  - Команда `/setSystemPrompt <промт>` — установка промпта
+  - Команда `/getSystemPrompt` — просмотр текущего промпта
+  - Команда `/resetSystemPrompt` — сброс к промпту по умолчанию
+  - Промпт сохраняется в БД и переживает перезапуск бота
+  - Автоматическая инициализация при первом запуске
+
+- **Команда `/instructions`** — подробные инструкции по настройке
+  - Для супер-админа: настройка промпта, примеры, управление админами
+  - Для всех: работа с кодом, контекст, безопасность
+
+- **Система безопасности**
+  - `DANGEROUS_PATTERNS` — блокировка опасных запросов (shell, файлы, секреты)
+  - `SENSITIVE_PATTERNS` — скрытие чувствительной информации в ответах
+  - Middleware `securityMiddleware` — проверка запросов ДО отправки в Qwen
+  - Фильтр `filterResponse` — очистка ответов ПОСЛЕ получения от Qwen
+  - Супер-админ обходит все проверки
+
+- **Интеграция с Qwen Code**
+  - Передача ID пользователя в запросе
+  - Добавление информации о правах в системный промпт
+  - Разные промпты для супер-админа и обычных пользователей
+
+- **Улучшенное форматирование**
+  - Переход на HTML вместо Markdown (стабильнее)
+  - Обработка заголовков: `#` → `**🔸 Заголовок**`
+  - Обработка цитат: `>` → обычный текст
+  - Предобработка `preprocessMarkdown()` для неподдерживаемых элементов
+
+- **Приветствие супер-админа**
+  - Расширенное сообщение при первом `/start`
+  - Пошаговые инструкции по настройке
+  - Примеры системных промптов
+
+### 🔧 Исправления
+
+- Исправлены ошибки парсинга Markdown (незакрытые теги)
+- Исправлено форматирование Prettier
+- Увеличен таймаут Qwen: 120с → 300с (5 минут)
+- Увеличен таймаут Telegraf: 120с → 360с (6 минут)
+- Удалена функция `escapeMarkdownV2()` (не нужна с HTML)
+
+### 📦 Изменения
+
+- Версия: `1.0.20` → `2.0.0`
+- Обновлён README.md с полным описанием v2.0
+- Обновлён `.env.example` с новыми опциями
+- Создан `CHANGELOG.md`
+- Обновлён `PUBLISH.md` с инструкциями для v2.0
+
+### 🎯 Сценарии использования
+
+1. **Консультант магазина**
+
+   ```
+   /setSystemPrompt Ты — консультант магазина электроники...
+   ```
+
+2. **Техподдержка SaaS**
+
+   ```
+   /setSystemPrompt Ты — техподдержка CRM-системы...
+   ```
+
+3. **Юридический бот**
+
+   ```
+   /setSystemPrompt Ты — юридический консультант по праву РФ...
+   ```
+
+4. **AI-ассистент кода**
+   ```
+   /setSystemPrompt Ты — AI-ассистент для работы с кодом...
+   ```
+
+---
+
+## [1.0.20] — 2026-03-01
+
+### Добавлено
+
+- Базовая функциональность Telegram-бота
+- Интеграция с Qwen Code (headless режим)
+- Code review, генерация кода, объяснение
+- Сессии и контекст диалога
+- Админ-панель (`/admin`)
+- Статистика пользователей
+- Rate limiting
+- Логирование (pino)
+- JSON хранилище (~/.qwen-alpha/)
+
+### Исправлено
+
+- Ошибки обработки сообщений
+- Проблемы с таймаутами
+- Форматирование ответов
+
+---
+
+## Формат
+
+Следуем [Semantic Versioning](https://semver.org/lang/ru/).
+
+Формат версий: `[MAJOR.MINOR.PATCH]`
+
+- **MAJOR** — несовместимые изменения API
+- **MINOR** — новые возможности (обратная совместимость)
+- **PATCH** — исправления багов (обратная совместимость)

package/PUBLISH.md

@@ -1,12 +1,15 @@
-# 🚀 Инструкция по публикации и запуску Qwen Alpha
+# 🚀 Инструкция по публикации и запуску Qwen Alpha v2.0
 
 ## ✅ Чек-лист перед публикацией
 
 - [ ] Все зависимости установлены (`npm install`)
 - [ ] Тесты проходят (`npm test`)
 - [ ] Линтинг проходит (`npm run lint`)
+- [ ] Форматирование в порядке (`npm run format:check`)
 - [ ] README.md актуален
-- [ ] Version в package.json обновлён
+- [ ] CHANGELOG.md обновлён
+- [ ] Version в package.json обновлён (2.0.0)
+- [ ] .env.example актуален
 
 ---
 
@@ -30,7 +33,7 @@ npm pkg get
 npm pack --dry-run
 
 # Просмотр содержимого .tgz
-tar -tzf qwen-alpha-1.0.0.tgz
+tar -tzf qwen-alpha-2.0.0.tgz
 ```
 
 ### 3. Публикация
@@ -39,8 +42,8 @@ tar -tzf qwen-alpha-1.0.0.tgz
 # Публикация стабильной версии
 npm publish
 
-# Публикация beta версии (не затронет latest)
-npm publish --tag beta
+# Публикация с тегом latest (явно)
+npm publish --tag latest
 ```
 
 ### 4. Проверка публикации
@@ -59,7 +62,7 @@ npm view qwen-alpha
 ### 1. Глобальная установка
 
 ```bash
-npm install -g qwen-alpha
+npm install -g qwen-alpha@2.0.0
 ```
 
 ### 2. Проверка CLI
@@ -85,9 +88,7 @@ qwen-alpha --token <YOUR_BOT_TOKEN>
 
 ---
 
-## 🔄 Обновление версии
-
-### SemVer (Semantic Versioning)
+## 🔄 Обновление версии (SemVer)
 
 ```
 MAJOR.MINOR.PATCH
@@ -100,16 +101,16 @@ MAJOR.MINOR.PATCH
 ### Команды для обновления версии
 
 ```bash
-# Исправление багов (1.0.0 → 1.0.1)
+# Исправление багов (2.0.0 → 2.0.1)
 npm version patch
 
-# Новые функции (1.0.0 → 1.1.0)
+# Новые функции (2.0.0 → 2.1.0)
 npm version minor
 
-# Ломающие изменения (1.0.0 → 2.0.0)
+# Ломающие изменения (2.0.0 → 3.0.0)
 npm version major
 
-# Pre-release версии (1.0.0 → 1.0.1-beta.0)
+# Pre-release версии (2.0.0 → 2.0.1-beta.0)
 npm version prerelease --preid=beta
 ```
 
@@ -187,11 +188,20 @@ npm-views qwen-alpha
    - Или через переменную окружения `BOT_TOKEN`
 
 3. **npm audit**
+
    ```bash
    npm audit
    npm audit fix
    ```
 
+4. **Проверка .gitignore**
+
+   ```bash
+   cat .gitignore
+   ```
+
+   Должны быть: `node_modules/`, `.env`, `*.log`, `~/.qwen-alpha/`
+
 ---
 
 ## 📝 Примеры использования
@@ -214,40 +224,85 @@ qwen-alpha --token <TOKEN> --log-level debug
 qwen-alpha --token <TOKEN> --allowed-users 123456789,987654321
 ```
 
-### Через Docker (пример)
+### Через переменную окружения
 
-```dockerfile
-FROM node:18-alpine
-RUN npm install -g qwen-alpha @qwen-code/qwen-code
-CMD ["qwen-alpha", "--token", "$BOT_TOKEN"]
+```bash
+export BOT_TOKEN=your_token_here
+qwen-alpha --token $BOT_TOKEN
 ```
 
 ---
 
-## 🎯 Следующие шаги после публикации
+## 🎯 Настройка v2.0 после установки
 
-1. **Добавить бота в Telegram**
-   - Откройте https://t.me/BotFather
-   - Создайте нового бота если ещё не создан
-   - Получите токен
+### 1. Первый запуск
 
-2. **Настроить бота**
-   - Установите аватар (логотип)
-   - Настройте description и about
+```bash
+qwen-alpha --token <TOKEN>
+```
 
-3. **Протестировать функционал**
-   - `/start` — приветствие
-   - `/help` — справка
-   - Отправить код на анализ
+Бот автоматически:
+
+- Инициализирует хранилище `~/.qwen-alpha/`
+- Создаст системный промпт по умолчанию
+- Зарегистрирует первого пользователя как супер-админа
+
+### 2. Настройка системного промпта
+
+В Telegram (супер-админ):
+
+```
+/setSystemPrompt Ты — консультант магазина электроники. Ассортимент: телевизоры, холодильники. Отвечай кратко.
+```
+
+### 3. Проверка промпта
+
+```
+/getSystemPrompt
+```
+
+### 4. Инструкции
+
+```
+/instructions
+```
+
+### 5. Добавление администраторов
+
+```
+/admin add <user_id>
+```
+
+---
+
+## 📚 Документация v2.0
+
+### Новые возможности
+
+- **Системные промпты** — кастомизация поведения бота
+- **Команда `/instructions`** — подробные инструкции
+- **Система безопасности** — защита от опасных запросов
+- **Фильтрация ответов** — скрытие чувствительной информации
+- **HTML-форматирование** — стабильная работа с Telegram
+
+### Сценарии использования
+
+| Сценарий             | Пример промпта                                |
+| -------------------- | --------------------------------------------- |
+| Консультант магазина | `Ты — консультант магазина электроники...`    |
+| Техподдержка         | `Ты — техподдержка CRM-системы...`            |
+| Юридический бот      | `Ты — юридический консультант по праву РФ...` |
+| AI-ассистент кода    | `Ты — AI-ассистент для работы с кодом...`     |
+
+---
 
-4. **Добавить в группы** (опционально)
-   - Добавьте бота в группу
-   - Проверьте работу `/qwen` команд
+## 🔗 Ссылки
 
-5. **Мониторинг**
-   - Следите за логами в `~/.qwen-alpha/logs/`
-   - Проверяйте `/admin stats`
+- **Репозиторий**: https://github.com/JeBance/QwenAlpha
+- **NPM**: https://www.npmjs.com/package/qwen-alpha
+- **Issues**: https://github.com/JeBance/QwenAlpha/issues
+- **CHANGELOG**: https://github.com/JeBance/QwenAlpha/blob/main/CHANGELOG.md
 
 ---
 
-**Удачи с публикацией! 🚀**
+**Удачи с публикацией v2.0! 🚀**