279 lines
No EOL
13 KiB
Markdown
279 lines
No EOL
13 KiB
Markdown
# Mistral Chat App - Development Context
|
||
|
||
## Project Overview
|
||
|
||
Android-приложение для чата с Mistral AI. Перспективный проект с развитием в сторону AI-агента с памятью, tools и автономной работой.
|
||
|
||
**Основные технологии:**
|
||
- Kotlin + Android (minSdk 26, targetSdk 34)
|
||
- Room + SQLCipher (encrypted database)
|
||
- OkHttp для API
|
||
- Material Design 3
|
||
- Russian language UI
|
||
|
||
**Расположение проекта:**
|
||
```
|
||
/Users/alexabudaev/Documents/Zed/mistral-chat-app/
|
||
```
|
||
|
||
**⚠️ ВАЖНО: Принципы разработки**
|
||
- Приложение должно работать БЕЗ платных подписок и инвестиций
|
||
- Всегда использовать собственные разработки или бесплатные решения
|
||
- Не рассчитывать на имеющиеся платные API при планировании функций
|
||
- Сначала находим бесплатное решение, потом реализуем
|
||
- **Если что-то невозможно сделать без платных API или ты не можешь понять задачу - говори честно!**
|
||
- При планировании любого следующего этапа следует тщательно анализировать возможность реализовать ту или иную функцию не только исходя из программной совместимости, но и с учётом наличия бесплатных версий необходимых сервисов, API и других продуктов (или возможности написать собственное решение)
|
||
|
||
---
|
||
|
||
## Completed Work
|
||
|
||
### ✅ Core Features
|
||
- Чат с Mistral API (Chat Completion)
|
||
- Управление профилями (до 10 профилей)
|
||
- Управление сессиями (множественные чаты)
|
||
- **Генерация названия сессии** - после 2-го сообщения AI генерирует краткое название (3-5 слов)
|
||
- Шифрованное хранилище (SQLCipher + EncryptedSharedPreferences)
|
||
- Валидация API ключа (32+ символов, A-Z, a-z, 0-9)
|
||
- Левое drawer-меню с диалогами
|
||
- Тёмная/светлая тема
|
||
|
||
### ✅ UI/UX
|
||
- Material Design 3
|
||
- Русский язык интерфейса
|
||
- Отступы в поле ввода (12dp)
|
||
- Прокрутка к новым сообщениям
|
||
- **Долгий тап на сообщение** - меню Копировать/Редактировать/Удалить
|
||
- **Скролл в поле system prompt** - multiline text field scrollable
|
||
- **Адаптивные цвета AlertDialog** - Material Design 3 colors
|
||
|
||
### ✅ Bug Fixes
|
||
- Исправлена ошибка "ответ в Toast вместо чата" - теперь только явные ошибки показываются через Toast
|
||
- Сортировка drawer меню - профили, настройки, остальное
|
||
- **WakeLock** - приложение остаётся активным при выключенном экране (ожидание ответа API)
|
||
- **Timeout 120 сек** - увеличен с 60 до 120 секунд для больших ответов
|
||
- **Foreground Service** - приложение продолжает работу в фоне при выключенном экране (ожидание ответа API)
|
||
- **Уведомление о ответе ИИ** - при получении ответа в фоне показывается системное уведомление с текстом ответа и звуком/вибрацией, нажатие открывает сессию с ответом
|
||
|
||
### ✅ Security
|
||
- API ключ: EncryptedSharedPreferences (AES-256-GCM)
|
||
- Ключ БД: EncryptedSharedPreferences (AES-256-SIV + AES-256-GCM)
|
||
- Профили, сессии, сообщения: SQLCipher
|
||
- CalDAV данные: зашифрованы (url, username, password)
|
||
|
||
**⚠️ ВАЖНО: Все чувствительные данные должны храниться в EncryptedSharedPreferences:**
|
||
- API ключи, пароли (CalDAV, email), ключи БД, токены
|
||
|
||
---
|
||
|
||
## Tools
|
||
|
||
### 🌐 Web Search
|
||
- ✅ Russian Wikipedia API (бесплатно, без API ключа)
|
||
- ✅ English Wikipedia API
|
||
- Ограничение: 4000 символов на ответ
|
||
|
||
### 🌤️ Weather
|
||
- ✅ Open-Meteo API (полностью бесплатно)
|
||
- Geocoding API + Weather API
|
||
- Текущая погода + прогноз на 7 дней
|
||
|
||
### 🔗 OpenUrlTool
|
||
- ✅ HTTP GET к любому URL
|
||
- ✅ RSS/Atom парсинг (lenta.ru, kommersant.ru)
|
||
- Ограничение: 4000 символов, таймаут 10 сек
|
||
|
||
### ⏰ Time Tools
|
||
- ✅ get_local_time - возвращает timestamp в миллисекундах
|
||
- ✅ get_date - текущая дата
|
||
|
||
### 📅 CalDAV Calendar
|
||
- ✅ calendar_add_event - создание событий с VALARM (уведомления)
|
||
- ✅ calendar_get_events - получение списка событий
|
||
- ✅ calendar_delete_event - удаление событий
|
||
- Баikal сервер интеграция
|
||
|
||
### 💾 Memory Tools
|
||
- ✅ memory_store, memory_learn, memory_forget
|
||
- ✅ memory_reinforce, memory_preference
|
||
|
||
---
|
||
|
||
## Tool Execution Parameters
|
||
|
||
| Параметр | Значение |
|
||
|----------|----------|
|
||
| Max iterations | 15 |
|
||
| Timeout на итерацию | 120 сек |
|
||
| Retry при CANCEL | до 2 раз |
|
||
| Result truncation | 2000 символов |
|
||
| WakeLock | ✅ для длительных запросов |
|
||
|
||
---
|
||
|
||
## Active Plan
|
||
|
||
### Phase 3: CalDAV Calendar + Local Reminders (✅ В основном готово)
|
||
|
||
**Два режима:**
|
||
1. **CalDAV** — синхронизация с Baikal сервером
|
||
2. **Local** — автономная напоминалка в памяти AI
|
||
|
||
**CalDAV Status:**
|
||
| Задача | Статус |
|
||
|--------|--------|
|
||
| Подключение к Baikal | ✅ |
|
||
| calendar_add_event | ✅ Работает (с VALARM) |
|
||
| calendar_get_events | ✅ Работает (лимит 100 событий) |
|
||
| calendar_delete_event | ✅ Работает (только свои события) |
|
||
| VALARM (уведомления) | ✅ Добавляются к событиям |
|
||
| UID consistency | ✅ Исправлено |
|
||
| Timestamp (time_string) | ✅ AI передаёт строку, сервер парсит |
|
||
|
||
**Нерешённые проблемы:**
|
||
- При переустановке app старые события становятся "чужими" (новый UUID)
|
||
|
||
**Как помочь AI правильно работать с календарём:**
|
||
1. Обязательно вызвать get_local_time для получения текущего UTC timestamp
|
||
2. Использовать формулу: new_timestamp = current_timestamp + (часы * 3600000) + (минуты * 60000)
|
||
3. НЕ добавлять случайные минуты!
|
||
|
||
### Phase 4: Heartbeat (⏳ В очереди)
|
||
- WorkManager задача (каждые 30 минут)
|
||
- Active hours (8:00-22:00)
|
||
|
||
### Phase 5: Email (⏳ В очереди)
|
||
- IMAP/SMTP клиент (без OAuth)
|
||
|
||
### Phase 6: API Key Rotation (📋 Запланировано)
|
||
|
||
**Проблема:**
|
||
- При достижении лимита токенов или блокировке ключа приложение перестаёт работать
|
||
- Нужна система ротации для отказоустойчивости
|
||
|
||
**Механизм:**
|
||
|
||
1. **Хранение нескольких ключей:**
|
||
- До 5 API ключей в EncryptedSharedPreferences
|
||
- Каждый ключ имеет статус: active, disabled, blocked
|
||
- Приоритет использования (порядок)
|
||
|
||
2. **Автоматическая ротация:**
|
||
- При ошибке 429 (rate limit) → переключить на следующий ключ
|
||
- При ошибке 401/403 (blocked) → пометить ключ как blocked
|
||
- При успешном ответе → ключ working
|
||
|
||
3. **Логика переключения:**
|
||
```
|
||
При ошибке:
|
||
- 429 (Too Many Requests) → nextKey()
|
||
- 401/403 (Unauthorized) → markKeyBlocked(), nextKey()
|
||
- 500+ → markKeyDisabled(), nextKey()
|
||
|
||
При успехе:
|
||
- workingCount++ (счётчик успешных использований)
|
||
```
|
||
|
||
4. **Ручное управление:**
|
||
- UI для добавления/удаления ключей
|
||
- Просмотр статуса каждого ключа
|
||
- Ручное переключение
|
||
|
||
**UI реализация:**
|
||
- Настройки профиля → "API ключи" → список ключей
|
||
- Статус: ✅ рабочий, ⚠️ лимит, ❌ заблокирован
|
||
- Возможность добавить/удалить/переключить
|
||
|
||
**Files to modify:**
|
||
- `EncryptedPrefs.kt` - хранение нескольких ключей
|
||
- `MistralClient.kt` - логика ротации
|
||
- UI: dialog_settings.xml или новое диалоговое окно
|
||
|
||
---
|
||
|
||
## Key Files
|
||
- `app/src/main/java/com/mistral/chat/ui/MainActivity.kt` — главная активность
|
||
- `app/src/main/java/com/mistral/chat/api/MistralClient.kt` — API клиент
|
||
- `app/src/main/java/com/mistral/chat/api/ToolExecutor.kt` — менеджер tools
|
||
- `app/src/main/java/com/mistral/chat/api/CalDavClient.kt` — CalDAV клиент
|
||
- `app/src/main/java/com/mistral/chat/data/ChatDatabase.kt` — база данных
|
||
|
||
### Model Selection
|
||
- **Default:** mistral-medium-latest
|
||
- **OkHttp timeouts:** connect 60s, read 120s, write 60s
|
||
|
||
---
|
||
|
||
## ⚠️ ВАЖНЫЕ ПРАВИЛА РАЗРАБОТКИ
|
||
|
||
### Запрет на удаление реализованных функций
|
||
**НИКОГДА не удаляй уже реализованные функции!**
|
||
|
||
### Запрет на хардкодинг
|
||
**НИКОГДА не хардкодь значения, которые должны быть динамическими!**
|
||
|
||
### Сборка APK
|
||
```bash
|
||
JAVA_HOME=/opt/homebrew/opt/openjdk@17 ./gradlew assembleDebug
|
||
# Путь: app/build/outputs/apk/debug/app-debug.apk
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 Контекст сессии и оптимизация (📋 Запланировано)
|
||
|
||
### Текущая реализация
|
||
При каждом запросе отправляется полный контекст. При росте сессии возможны 503 ошибки.
|
||
|
||
### План реализации (Kai 9000 style)
|
||
|
||
**Источник:** https://kai9000.com/docs/features/tools/
|
||
|
||
**Часть 1: Trimming (меж-итеративный)**
|
||
- Обрезать историю ПОСЛЕ КАЖДОГО tool вызова
|
||
- После каждого tool execution - проверить размер контекста
|
||
- Если > MAX_CONTEXT - удалить старые сообщения (кроме system prompt)
|
||
- MAX_CONTEXT = ~16000 токенов (50% от лимита mistral-medium)
|
||
|
||
**Часть 2: Compaction (AI summary)**
|
||
- При 70% лимита (~22000 токенов) - запустить AI summary
|
||
- Последние 4 user обмена - оставить verbatim
|
||
- Остальное - одно summary message
|
||
- Сохранить summary в БД для персистентности
|
||
|
||
### Реализация
|
||
ToolExecutor.kt → модифицировать loop:
|
||
```kotlin
|
||
while (toolCalls.isNotEmpty()) {
|
||
result = executeTool()
|
||
messages.add(result)
|
||
|
||
// Trimming после каждого tool
|
||
if (getTokenCount(messages) > MAX_CONTEXT) {
|
||
trimOldMessages()
|
||
}
|
||
}
|
||
```
|
||
|
||
### Files to modify
|
||
- ToolExecutor.kt - добавить trimming в loop
|
||
- MistralClient.kt - добавить getTokenCount, trimOldMessages
|
||
|
||
---
|
||
|
||
## Conversation Context (for AI Agent)
|
||
|
||
**При начале новой сессии:**
|
||
Прочитай файл AGENTS.md для понимания текущего контекста.
|
||
|
||
**При запросе "продолжаем":**
|
||
Мы работаем над Phase 3 - CalDAV календарь. Тестируем: создание событий, получение списка, исправление timezone.
|
||
|
||
**Важно:**
|
||
- Пушить в GitHub только после подтверждения пользователя
|
||
- Не делать push автоматически
|
||
|
||
---
|
||
|
||
*Last updated: 2026-04-12*
|
||
*Version: 1.11* |