Просмотр кода страницы Kuzya2-0

= Кузя — интеллектуальный администратор Telegram-сообщества =

'''Кузя''' — Telegram-бот для администрирования и сопровождения сообщества. Проект развивается от классического административного бота к интеллектуальному помощнику и AI-модератору, способному анализировать происходящее в чате, помогать участникам и администраторам и самостоятельно выявлять нарушения.

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

== Текущее состояние проекта ==

Кузя уже является рабочим Telegram-ботом и используется для выполнения административных и информационных задач.

На данный момент реализованы следующие возможности:

* выдача мута;
* снятие мута;
* временный и постоянный бан;
* система предупреждений;
* указание причины нарушения;
* хранение истории предупреждений;
* отдельный список администраторов Кузи;
* приветствие новых участников;
* публикация информационных сообщений;
* вывод правил сообщества;
* публикация ссылок;
* приглашения;
* информация о поддержке проекта;
* взаимодействие с публикациями Telegram-канала;
* автоматическая публикация информационного сообщения под новым видео;
* хранение истории сообщений Telegram-чата;
* изменение ряда настроек и текстов через команды администратора;
* базовые функции AI-ассистента.

== База данных сообщества ==

Кузя работает с MySQL и ведёт собственную историю чата.

На август 2026 года в базе сохранено около:

'''497 000 сообщений.'''

Для сообщений сохраняются, в частности:

* дата и время;
* Telegram ID пользователя;
* username;
* отображаемое имя;
* текст сообщения;
* Telegram message ID.

Отдельно существует база предупреждений.

В ней сохраняются:

* пользователь;
* сообщение, за которое выдано предупреждение;
* причина;
* номер предупреждения;
* администратор, принявший решение;
* дата и время.

Большинство предупреждений связано с исходным сообщением через '''message_id'''.

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

Эти данные в дальнейшем могут использоваться для разработки интеллектуальной системы модерации.

== Концепция дальнейшего развития ==

В перспективе Кузя должен состоять из трёх основных подсистем:

<pre>
                    КУЗЯ
                      |
        +-------------+-------------+
        |             |             |
        v             v             v
 Telegram Admin   AI Assistant    Guardian
        |             |             |
   mute / ban       диалог       модерация
   warnings         память       антиспам
   rules            поиск       конфликты
   channel           RAG         репутация
        |             |             |
        +-------------+-------------+
                      |
                      v
                  RAMBA AI
              Local AI Router
</pre>

== Локальный искусственный интеллект ==

Основной AI Кузи планируется сделать '''локальным'''.

Для обработки запросов используется инфраструктура RAMBA AI с несколькими локальными нейронными моделями.

Архитектура предусматривает три специализированные модели, работающие на локальном сервере с NVIDIA GeForce GTX 1080.

<pre>
Telegram
    |
    v
  Кузя
    |
    v
RAMBA AI Router
    |
    +------ Model 1
    |
    +------ Model 2
    |
    +------ Model 3
    |
    +------ OpenAI API
            дополнительный уровень
</pre>

AI Router определяет, какая модель лучше подходит для конкретной задачи.

OpenAI API при этом не является основным интеллектом Кузи. Он рассматривается как дополнительный инструмент для отдельных сложных задач и сценариев, в которых возможностей локальных моделей недостаточно.

Это также позволяет не передавать всю историю сообщества внешним AI-сервисам.

== Kuzya 2.0 — новая архитектура ==

Первым этапом развития станет создание '''Kuzya 2.0'''.

Главный принцип:

'''Сначала переносим все существующие возможности без потери функциональности, затем добавляем AI.'''

Текущая рабочая версия сохраняется как:

'''Kuzya Legacy Stable'''

Новая версия разрабатывается отдельно.

В Kuzya 2.0 существующий монолитный код планируется разделить на независимые компоненты:

<pre>
kuzya/
|
+-- bot/
|   +-- moderation/
|   +-- commands/
|   +-- channel/
|   +-- users/
|   +-- handlers/
|
+-- database/
|   +-- messages
|   +-- warnings
|   +-- admins
|   +-- settings
|
+-- ai/
|   +-- assistant
|   +-- moderation
|   +-- context
|   +-- memory
|
+-- services/
|
+-- config/
|
+-- main.py
</pre>

Это позволит развивать отдельные возможности Кузи независимо друг от друга.

== Kuzya 2.1 — развитие базы данных ==

Существующая MySQL-база сохраняется.

История почти из полумиллиона сообщений является ценным архивом и не должна изменяться или удаляться в процессе модернизации.

Для новой версии предполагается постепенно перейти к единой структуре данных:

* chats;
* users;
* messages;
* warnings;
* moderation_actions;
* admins;
* chat_settings.

Каждое административное действие сможет дополнительно содержать источник решения:

* '''human''' — решение администратора;
* '''ai''' — решение AI;
* '''rule''' — автоматическое правило.

Это позволит впоследствии анализировать качество работы AI.

== Kuzya 2.2 — AI Router ==

Кузя подключается к RAMBA AI Router.

Telegram-бот при этом не запускает и не управляет моделями непосредственно.

<pre>
Кузя
 |
 | запрос
 v
RAMBA AI Router
 |
 +--> разговорная модель
 |
 +--> модель сложных задач
 |
 +--> специализированная модель
 |
 +--> внешний AI (при необходимости)
</pre>

Это позволит менять модели независимо от Telegram-бота и использовать одну AI-инфраструктуру для нескольких проектов.

== Kuzya 2.3 — полноценный AI-ассистент ==

Кузя сможет поддерживать обычный разговор.

Например:

<pre>
Кузя, что сегодня обсуждали?

Кузя, объясни подробнее.

Кузя, какие правила относятся к публикации ссылок?
</pre>

При ответе AI сможет учитывать:

* текущий вопрос;
* предыдущие сообщения разговора;
* контекст Telegram-чата;
* правила сообщества;
* настройки конкретного чата.

Таким образом появляется краткосрочная память.

== Kuzya 2.4 — долговременная память ==

История сообщений не должна целиком передаваться нейронной модели.

Для этого предполагается использовать технологию RAG.

<pre>
История MySQL
      |
      v
  индексация
      |
      v
 Vector DB
      |
      v
поиск нужной истории
      |
      v
     AI
</pre>

Например, участник сможет спросить:

<pre>
Кузя, мы раньше обсуждали эту проблему?
</pre>

Кузя найдёт связанные старые обсуждения и использует их при формировании ответа.

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

= Kuzya Guardian =

'''Kuzya Guardian''' — ключевое направление дальнейшего развития проекта.

Это интеллектуальная система модерации Telegram-чата.

== Анализ сообщений ==

Новые сообщения смогут проходить через несколько уровней проверки:

<pre>
Telegram message
       |
       v
простые правила
       |
       v
AI-анализ
       |
       v
оценка риска
       |
       v
решение
</pre>

AI сможет определять, например:

* спам;
* флуд;
* нежелательную рекламу;
* оскорбления;
* провокации;
* нарушения правил сообщества;
* эскалацию конфликтов;
* повторные нарушения.

При этом анализироваться сможет не только одно сообщение, но и контекст разговора.

== Shadow Mode ==

На первом этапе AI '''не получает право самостоятельно наказывать пользователей'''.

Кузя работает в теневом режиме — Shadow Mode.

При обнаружении возможного нарушения в административный чат поступает сообщение:

<pre>
Кузя обнаружил возможное нарушение.

Пользователь: @username
Тип: оскорбление
Уверенность: 87 %

Предлагаемое действие:
Предупреждение

[Нарушение]
[Не нарушение]
[Мут]
[Бан]
</pre>

Окончательное решение принимает человек.

Решение администратора сохраняется в базе.

== Обучение на решениях администраторов ==

Shadow Mode одновременно позволяет собирать новый качественный набор данных.

Для каждого случая можно сохранять:

<pre>
сообщение
+
контекст
+
решение AI
+
решение администратора
+
причина
+
применённое действие
</pre>

Таким образом Кузя постепенно получает примеры того, '''как именно администрация данного сообщества трактует его правила'''.

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

== Полуавтоматическая модерация ==

После накопления статистики отдельные очевидные нарушения можно будет обрабатывать автоматически.

Примерная модель:

<pre>
низкая уверенность
        |
        +--> никаких действий

средняя уверенность
        |
        +--> запись в журнал

высокая уверенность
        |
        +--> сообщение администраторам

очень высокая уверенность
+ безопасная категория
        |
        +--> автоматическое действие
</pre>

Порог автоматизации будет зависеть от типа нарушения.

Например, очевидный массовый спам можно обрабатывать автоматически, тогда как спорные конфликты между людьми должны передаваться администратору.

== Репутация пользователей ==

В перспективе Guardian сможет учитывать историю поведения пользователя.

Учитываются:

* предупреждения;
* муты;
* баны;
* повторные нарушения;
* частота конфликтов;
* длительные периоды без нарушений.

Репутация является внутренним параметром системы и не обязательно должна отображаться участникам.

Она используется только как дополнительный контекст для принятия решения.

== Анализ конфликтов ==

Одна из перспективных функций — обнаружение развивающегося конфликта.

Кузя анализирует последовательность сообщений нескольких участников и может определить постепенную эскалацию.

Вместо немедленного наказания бот сначала сможет предложить участникам прекратить спор.

Если конфликт продолжается, информация передаётся администраторам.

Таким образом система должна оценивать не только отдельные слова, но и развитие разговора.

= Аналитика сообщества =

Кузя сможет формировать статистику Telegram-чата.

Например:

<pre>
Статистика за сутки

Сообщений: 2351
Активных участников: 187
Новых участников: 14

Предупреждений: 3
Мутов: 1
Удалено спама: 9
</pre>

Дополнительно AI сможет определять основные темы обсуждения.

== Ежедневный дайджест ==

В перспективе возможно автоматическое формирование краткого отчёта:

<pre>
Что произошло сегодня

Обсудили:
* ...
* ...
* ...

Важные ссылки:
* ...
* ...

Модерация:
* 2 предупреждения
* 1 мут
</pre>

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

= Знание правил сообщества =

Правила конкретного сообщества становятся частью базы знаний Кузи.

Участник сможет спросить:

<pre>
Кузя, можно здесь публиковать ссылку на YouTube?
</pre>

Ответ будет основан именно на действующих правилах данного сообщества.

Кузя также сможет объяснять административные решения:

<pre>
Почему сообщение удалено?
</pre>

Например:

<pre>
Сообщение нарушает пункт 2 правил:
ссылка опубликована без необходимого описания.
</pre>

= Этапы разработки =

{| class="wikitable"
! Версия
! Основная задача
|-
| '''Legacy'''
| Текущий рабочий Кузя
|-
| '''2.0'''
| Новая архитектура и полный перенос существующих функций
|-
| '''2.1'''
| Новая структура MySQL и сохранение существующей истории
|-
| '''2.2'''
| Интеграция с RAMBA AI Router
|-
| '''2.3'''
| Полноценные AI-диалоги и краткосрочный контекст
|-
| '''2.4'''
| RAG и долговременная память по истории Telegram-чата
|-
| '''3.0'''
| Kuzya Guardian
|-
| '''3.1'''
| Shadow Mode
|-
| '''3.2'''
| Полуавтоматическая модерация
|-
| '''3.3'''
| Репутационная система
|-
| '''3.4'''
| Анализ конфликтов
|-
| '''4.0'''
| Аналитика сообщества и дайджесты
|-
| '''4.1'''
| Глубокая интеграция AI с правилами сообщества
|-
| '''5.0'''
| Полноценный интеллектуальный Community Guardian
|}

= Принципы проекта =

При разработке Кузи предлагается придерживаться нескольких основных принципов.

'''1. Существующие функции не должны быть потеряны.'''

Новая версия сначала достигает функционального паритета с текущей и только затем заменяет её.

'''2. Решение человека важнее решения AI.'''

Администратор всегда должен иметь возможность отменить или изменить решение системы.

'''3. Автоматизация вводится постепенно.'''

Сначала наблюдение, затем рекомендации и только после проверки качества — автоматические действия.

'''4. История сообщества является ценным активом.'''

Существующая MySQL-база сохраняется и используется для построения памяти и системы модерации.

'''5. Основной AI работает локально.'''

Локальные модели являются основой интеллектуальных функций Кузи. Внешние AI API используются только как дополнительный инструмент.

'''6. Кузя остаётся специализированным ботом.'''

Его основная область ответственности — Telegram-сообщество.

Управление серверами, Proxmox, GitLab, Matrix и другой инфраструктурой RAMBA выносится в отдельный RAMBA Bot.

= Конечная цель =

Конечная цель проекта — превратить Кузю из набора административных Telegram-команд в полноценного интеллектуального помощника сообщества:

<pre>
                 КУЗЯ
                   |
     +-------------+-------------+
     |             |             |
     v             v             v
Администратор  AI-ассистент    Guardian
     |             |             |
 команды          диалог       модерация
 правила          память       антиспам
 warnings         RAG          конфликты
 канал            поиск       репутация
     |             |             |
     +-------------+-------------+
                   |
                   v
               RAMBA AI
            Local AI Router
               GTX 1080
</pre>

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