Руководство пользователя Zeronix AI Chat

Адрес сервиса: http://ai.zeronix.ru

Добро пожаловать в Zeronix AI Chat!

Zeronix AI Chat — это современный веб-интерфейс для работы с искусственным интеллектом. Он позволяет вам взаимодействовать с различными моделями ИИ, как локальными (через Ollama), так и облачными (OpenAI, Anthropic, GigaChat, Gemini, DeepSeek). Сервис поддерживает многопользовательский режим, автосохранение чатов, управление промптами и другие удобные функции.

1. Вход в систему

Для начала работы с сервисом необходимо войти в свой аккаунт.

Перейдите по адресу: http://ai.zeronix.ru/login.html
Введите ваш логин и пароль.
Нажмите кнопку Войти.

💡 Если вы новый пользователь, обратитесь к администратору для создания учетной записи.

После успешного входа вы будете перенаправлены на главную страницу интерфейса.

2. Интерфейс и основные функции

2.1. Основной чат

Главная страница предоставляет доступ к чату с ИИ. Вы можете:

Вводить текст в поле внизу.
Получать ответы от выбранной модели ИИ.
Использовать автосохранение чатов (включено по умолчанию).

2.2. Выбор модели ИИ

Вы можете выбрать модель для общения:

Ollama — локальные модели (если доступны).
OpenAI — модели GPT-4o, GPT-5 и др.
Anthropic — Claude Sonnet.
GigaChat — российская модель.
Gemini — Google.
DeepSeek — китайская модель.

🎯 Для выбора модели нажмите значок 🤖 рядом с полем ввода. Откроется окно с доступными провайдерами и моделями.

3. Управление ключами API

Чтобы использовать внешние провайдеры (OpenAI, Anthropic, GigaChat, Gemini, DeepSeek), требуется ваш личный ключ API.

Нажмите кнопку 🔑 Мои ключи API в верхней части интерфейса.
В открывшемся окне:

Выберите провайдера.
Вставьте ваш ключ API.
Нажмите Сохранить.

⚠️ Если администратор запретил использование глобальных ключей, система будет использовать именно ваш личный ключ.

4. Промпты

Промпты — это шаблоны или начальные инструкции для модели ИИ. Они помогают получать более точные и структурированные ответы.

4.1. Быстрый выбор промпта

Нажмите значок 📝 рядом с полем ввода.
Выберите нужный промпт из списка радиокнопок.
Текст промпта автоматически добавится в поле ввода.

4.2. Создание и редактирование промптов

Нажмите 📝 Промпты в меню.
Чтобы создать новый промпт:

Введите название.
Введите текст промпта.
Нажмите Создать.

Чтобы отредактировать или удалить промпт — используйте соответствующие кнопки в списке.

🌐 Администратор может создавать глобальные промпты, доступные всем пользователям.

5. Автосохранение и история чатов

5.1. Автосохранение

Функция автосохранения включена по умолчанию.
Чаты сохраняются каждые 30 секунд (интервал можно изменить в настройках).
Сохранённые чаты доступны в разделе Автосохранённые чаты.

5.2. Управление чатами

Переименование: Нажмите на имя чата → выберите "Переименовать".
Удаление: Нажмите на имя чата → выберите "Удалить".
Открытие: Нажмите на имя чата, чтобы продолжить разговор.

📁 Каждый пользователь имеет свою отдельную историю чатов.

6. Настройки

6.1. Настройки Ollama

Если вы используете локальные модели через Ollama:

Нажмите ⚙️ Настройки Ollama.
Укажите хост и порт сервера Ollama (по умолчанию `localhost:11434`).
Включите/выключите автосохранение.
Сохраните изменения.

6.2. Настройки пользователя

В профиле вы можете:

Изменить предпочтения (провайдер, модель, промпт).
Управлять своими API-ключами.
Просмотреть свои права и роль.

7. Роли и доступ

7.1. Пользователь (`user`)

Имеет доступ к основным функциям: чат, промпты, автосохранение.
Может использовать личные API-ключи.
Не имеет доступа к административной панели.

7.2. Администратор (`admin`)

Имеет расширенные права.
Доступ к админ-панели (`/admin.html`).
Может:

Управлять пользователями (создание, удаление, смена ролей).
Настроить доступ к моделям и провайдерам.
Управлять глобальными ключами и промптами.
Настроить прокси и базовые URL для провайдеров.

🔒 Только администратор может получить доступ к `/admin.html`.

8. Поддержка и помощь

Если у вас возникли вопросы или проблемы:

Проверьте частые проблемы и решения в конце документа.
Обратитесь к администратору системы.
Посмотрите исходный код (для продвинутых пользователей) в файле `server.js`.

9. Частые проблемы и решения

Проблема	Решение
Ошибка 403 при использовании OpenAI (ключ `sk-proj-...`)	В админ-панели укажите Project ID. Это добавит заголовок `OpenAI-Project`.
Ошибка 401 или SSL-ошибка при работе с GigaChat	Убедитесь, что предоставлены правильные `clientId/clientSecret`, и установлены доверенные сертификаты НУЦ Минцифры. Для тестирования можно использовать `NODE_TLS_REJECT_UNAUTHORIZED=0` (не рекомендуется для продакшена).
Модели Ollama не видны	Проверьте, запущен ли сервер Ollama и доступен ли он по указанному хосту и порту.
Не работает Gemini (`gemini-2.5`)	Убедитесь, что используется заголовок `x-goog-api-key`, а не query-параметр. При выборе `gemini-2.5` автоматически применяется `gemini-2.5-flash`.

10. Безопасность

Не используйте дефолтные учетные данные (логин admin, пароль admin).
Храните свои API-ключи в секрете.
Не передавайте свои ключи третьим лицам.
Все ключи хранятся на сервере в защищённых файлах (для отладки). В продакшене используются секрет-хранилища и базы данных.

11. Поддержка

Если у вас есть предложения или вы нашли баг, пожалуйста, сообщите администратору сервиса.