Remove AGENTS.md from repo (local only)
This commit is contained in:
Алексей Будаев
parent
16720a035a
commit
24d401943b
1 changed files with 0 additions and 279 deletions
279
AGENTS.md
279
AGENTS.md
|
|
@ -1,279 +0,0 @@
|
|||
# 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*
|
||||
Loading…
Add table
Add a link
Reference in a new issue