Avtex/DEEPSEEK_SETUP.md

🤖 DeepSeek AI - Настройка

Что такое DeepSeek?

DeepSeek - это мощная китайская нейросеть с открытым API, которая:

• 🚀 По качеству на уровне GPT-4
• 💰 В 10-20 раз дешевле OpenAI
• 🌐 Поддерживает русский язык
• 🔑 Даёт бесплатные токены при регистрации

---

📝 Как получить API ключ

Шаг 1: Регистрация

1. Перейди на https://platform.deepseek.com
2. Нажми Sign Up или Login
3. Зарегистрируйся через email или Google

Шаг 2: Получение API ключа

1. После входа перейди в API Keys: https://platform.deepseek.com/api_keys
2. Нажми Create API Key
3. Скопируй ключ (начинается с sk-)

Важно: Сохрани ключ в надёжном месте! Показать его можно только один раз.

Шаг 3: Пополнение баланса (опционально)

DeepSeek даёт бесплатные токены новым пользователям (~$2-5).

Для пополнения:

1. Перейди в Billing: https://platform.deepseek.com/billing
2. Выбери способ оплаты
3. Минимальное пополнение: ~$10

---

💰 Тарифы

Модель	Цена (за 1M токенов)
DeepSeek Chat	~$0.14 (input) / ~$0.28 (output)
DeepSeek Coder	~$0.14 (input) / ~$0.28 (output)

Для сравнения:

• GPT-4: ~$30 / $60 за 1M токенов
• DeepSeek: ~$0.14 / $0.28 за 1M токенов

Экономия: в 200+ раз! 💰

---

🔧 Настройка в проекте

1. Создай файл .env

Скопируй .env.example в .env:

cp .env.example .env

2. Добавь API ключ

Открой .env и вставь ключ:

DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

3. Обновите lib/core/deepseek_service.dart

final deepSeekService = DeepSeekService(
  apiKey: 'sk-xxxxxxxxxxxxxxxxxxxxxxxx', // Твой ключ
);

Или используй пакет flutter_dotenv:

// В main.dart
import 'package:flutter_dotenv/flutter_dotenv.dart';

Future<void> main() async {
  await dotenv.load(fileName: ".env");
  
  final deepSeekService = DeepSeekService(
    apiKey: dotenv.env['DEEPSEEK_API_KEY'],
  );
  
  runApp(...);
}

---

📱 Примеры использования

Генерация подзадач

import 'package:nanaxe_crm/core/deepseek_service.dart';

final subtasks = await deepSeekService.generateSubtasks(
  title: 'Создать CRM систему',
  description: 'Разработка CRM для управления задачами команды с AI',
);

print(subtasks);
// [
//   {"title": "Анализ требований", "estimatedHours": 2, "description": "..."},
//   {"title": "Проектирование", "estimatedHours": 3, "description": "..."},
//   ...
// ]

Приоритизация задачи

final priority = await deepSeekService.prioritizeTask(
  title: 'Срочный баг',
  description: 'Пользователи не могут войти',
  dueDate: DateTime.now().add(Duration(hours: 2)),
);

print(priority); // TaskPriority.urgent

Умное планирование

final schedule = await deepSeekService.smartSchedule(
  tasks: myTasks,
  startDate: DateTime.now(),
  endDate: DateTime.now().add(Duration(days: 7)),
  availableHoursPerDay: 6,
);

print(schedule);
// [
//   {"taskId": 0, "date": "2026-03-27", "hours": 3},
//   {"taskId": 1, "date": "2026-03-27", "hours": 3},
//   ...
// ]

Генерация mind-карты проекта

final mindMapNodes = await deepSeekService.generateMindMap(
  projectName: 'CRM App',
  description: 'Мобильное CRM приложение с AI планированием',
);

print(mindMapNodes);
// [
//   {"level": 0, "title": "CRM App", "parentId": null},
//   {"level": 1, "title": "Планирование", "parentId": 0},
//   {"level": 1, "title": "Разработка", "parentId": 0},
//   ...
// ]

---

🆘 Troubleshooting

Ошибка: "Invalid API key"

1. Проверь что ключ начинается с 'sk-'
2. Убедись что нет лишних пробелов
3. Проверь что ключ активен в Dashboard

Ошибка: "Insufficient balance"

1. Проверь баланс в Billing: https://platform.deepseek.com/billing
2. Пополни счёт
3. Или используй mock данные (по умолчанию)

Ошибка: "Rate limit exceeded"

DeepSeek ограничивает запросы. Подожди немного или увеличь лимиты в настройках.

---

📊 Статистика использования

Для отслеживания расходов:

1. Перейди в Usage: https://platform.deepseek.com/usage
2. Просматривай статистику по дням/моделям
3. Настрой алерты при достижении лимита

---

🔒 Безопасность

Никогда не публикуй API ключ в GitHub!

✅ Правильно:

# Добавить .env в .gitignore
echo ".env" >> .gitignore

✅ Использовать в коде:

// Загружать из .env файла
final apiKey = dotenv.env['DEEPSEEK_API_KEY'];

❌ Неправильно:

// Хардкод ключа в коде
final apiKey = 'sk-xxxxx'; // НЕ ДЕЛАЙ ТАК!

---

📚 Ресурсы

• Официальная документация: https://platform.deepseek.com/docs
• API Reference: https://platform.deepseek.com/api-docs
• Цены: https://platform.deepseek.com/pricing
• Dashboard: https://platform.deepseek.com

---

🎯 Следующие шаги

1. ✅ Получить API ключ
2. ✅ Добавить в .env
3. ✅ Протестировать генерацию подзадач
4. ✅ Интегрировать в UI приложения
5. ✅ Настроить отслеживание расходов

---

DeepSeek готов к работе! 🚀