Руководство пользователя системы Kodik

Содержание

1. Введение
2. Начало работы
3. Основные функции
4. Работа с проектами
5. Продвинутые возможности
6. Решение проблем

1. Введение

1.1. О системе Kodik

Kodik — это интеллектуальный редактор кода с искусственным интеллектом, который помогает разработчикам программного обеспечения создавать код быстрее и эффективнее.

Основные возможности:

• Генерация кода на основе описаний на естественном языке
• Интеллектуальный анализ и рефакторинг кода
• Автоматическая отладка и исправление ошибок
• Понимание больших кодовых баз
• Ускорение разработки в 3-5 раз

1.2. Для кого предназначена эта документация

Данное руководство предназначено для:

• Разработчиков программного обеспечения (от начинающих до опытных)
• Команд разработки
• DevOps инженеров
• Технических лидеров
• Студентов, изучающих программирование

1.3. Системные требования

Минимальные требования:

• Процессор: 2-ядерный, 2.0 GHz
• Оперативная память: 4 GB RAM
• Дисковое пространство: 500 MB + место для проектов
• Интернет: Постоянное подключение для работы с ИИ

Рекомендуемые требования:

• Процессор: 4-ядерный, 2.5 GHz и выше
• Оперативная память: 8 GB RAM и выше
• SSD для быстрой работы
• Интернет: 10 Mbps и выше

Поддерживаемые операционные системы:

• Windows 10/11 (64-bit)
• macOS 11+ (Intel и Apple Silicon)
• Ubuntu 20.04+, Debian 11+, другие Linux дистрибутивы

2. Начало работы

2.1. Установка Kodik

2.1.1. Скачивание приложения

1. Перейдите на официальный сайт: https://aikodik.ru/downloads
2. Выберите версию для вашей операционной системы:
   • Windows: KodikSetup-x.x.x.exe
   • macOS: Kodik-x.x.x.dmg
   • Linux: .AppImage
3. Скачайте установщик

2.1.2. Установка на Windows

1. Запустите скачанный файл KodikSetup-x.x.x.exe
2. Подтвердите UAC, если появится запрос
3. Следуйте инструкциям мастера установки:
   • Примите лицензионное соглашение
   • Выберите директорию установки
   • Создайте ярлыки (рекомендуется)
4. Нажмите «Установить»
5. Дождитесь завершения установки

2.1.3. Установка на macOS

1. Откройте скачанный файл Kodik-x.x.x.dmg
2. Перетащите иконку Kodik в папку Applications
3. При первом запуске:
   • Откройте System Preferences → Security & Privacy
   • Нажмите «Open Anyway» для Kodik
4. Приложение готово к использованию

2.1.4. Установка на Linux

chmod +x Kodik-x.x.x.AppImage

./Kodik-x.x.x.AppImage

2.2. Первый запуск и настройка

2.2.1. Создание аккаунта

1. Зарегистрируйтесь на сайте:
   • Откройте браузер и перейдите на https://aikodik.ru
   • Нажмите «Регистрация» или «Создать аккаунт»
   • Введите email и придумайте пароль
   • Подтвердите email (проверьте почту)
2. Запустите Kodik:
   • Windows: через ярлык на рабочем столе или меню Пуск
   • macOS: из папки Applications
   • Linux: из меню приложений или команда kodik
3. Войдите в аккаунт:
   • Введите email и пароль, созданные на сайте
   • Нажмите «Войти»

2.3. Начало работы с проектом

2.3.1. Открытие папки проекта

Kodik работает с вашими существующими проектами как расширение редактора кода:

1. Откройте папку проекта:
   • File → Open Folder (или Ctrl+K O / Cmd+K O)
   • Выберите директорию с вашим кодом
   • Kodik автоматически проанализирует структуру проекта
2. Kodik готов к работе:
   • Боковая панель Kodik появится справа
   • Теперь можно взаимодействовать с кодом через ИИ

Примечание: Kodik не имеет отдельной функции «создания проекта». Создавайте проекты обычным способом (через терминал, шаблоны или вручную), затем открывайте папку в Kodik.

2.3.2. Первый запрос к ИИ

Способ 1: Через контекстное меню

1. Выделите код в редакторе
2. Правый клик → «Добавить в Kodik»
3. В панели чата Kodik введите ваш запрос

Примеры:

• «Объясни, что делает этот код»
• «Оптимизируй эту функцию»
• «Добавь обработку ошибок»

Способ 2: Через встроенный чат редактора

1. Установите курсор в нужное место кода
2. Откройте встроенный чат (Ctrl+I / Cmd+I)
3. Введите запрос прямо в редакторе

Примеры:

• «Рефактори этот код для использования async/await»
• «Добавь комментарии к этой функции»
• «Исправь эту ошибку»

Способ 3: Через меню лампочки

1. При наличии ошибок появится значок лампочки
2. Нажмите на лампочку
3. Выберите команду Kodik:
   • «Исправить с Kodik» — автоматическое исправление ошибок
   • «Объяснить с Kodik» — объяснение сложного кода
   • «Улучшить с Kodik» — предложения по улучшению

2.3.3. Работа с терминалом

Отладка ошибок:

1. Запустите код в терминале и получите ошибку
2. Правый клик на выводе терминала → «Добавить в Kodik»
3. Или используйте упоминание: «@terminal исправь эту ошибку»

Kodik:

1. Прочитает вывод терминала
2. Проанализирует stack trace
3. Найдет причину ошибки в коде
4. Предложит исправление
5. Применит изменения (с вашего согласия)

Примеры запросов:

• «@terminal что означает эта ошибка?»
• «@terminal помоги установить эту зависимость»
• «@terminal почему тесты падают?»

3. Основные функции

3.1. Работа с кодом

3.1.1. Генерация кода

Как использовать:

1. Опишите, что вы хотите создать
2. Kodik сгенерирует код
3. Просмотрите и одобрите изменения

Примеры запросов:

• «Создай React компонент кнопки с пропсами: text, onClick, disabled»
• «Напиши функцию сортировки массива объектов по полю date»
• «Создай REST API endpoint для получения списка пользователей»
• «Добавь валидацию формы с проверкой email и пароля»

Советы для лучших результатов:

• Будьте конкретны в описании
• Укажите предпочитаемые технологии
• Опишите ожидаемое поведение
• Уточните граничные случаи

3.1.2. Редактирование кода

Точечные правки через контекстное меню:

1. Выделите код для изменения
2. Правый клик → «Добавить в Kodik»
3. Опишите изменения в чате:
   • «Добавь обработку ошибок в эту функцию»
   • «Оптимизируй этот цикл для лучшей производительности»
   • «Переименуй переменные для лучшей читаемости»

Через встроенный чат:

1. Установите курсор в нужном месте
2. Нажмите Ctrl+I / Cmd+I
3. Введите запрос прямо в редакторе:
   • «Рефактори этот класс, используя паттерн Factory»
   • «Упрости эту функцию, разбив на меньшие»
   • «Примени принцип DRY к этому коду»

3.1.3. Отладка и исправление ошибок

Метод 1: Через терминал

1. Запустите код и получите ошибку
2. В Kodik: «@terminal»
3. Kodik прочитает вывод и предложит решение

Метод 2: Через Problems

1. В Kodik: «@problems»
2. Kodik покажет все ошибки и предупреждения
3. Можно попросить исправить все или конкретные

Метод 3: Прямое описание

«При вызове getUserById(123) получаю ошибку null reference. Исправь это»

3.1.4. Документирование кода

• «Добавь JSDoc документацию ко всем функциям в этом файле»
• «Создай README.md для этого проекта с инструкциями по установке и использованию»
• «Документируй этот API endpoint в формате OpenAPI/Swagger»

3.2. Система @ упоминаний

Упоминания позволяют явно указать контекст для Kodik.

3.2.1. Упоминание файлов

Синтаксис: @/путь/к/файлу

Примеры:

• «@/src/App.js добавь обработку loading состояния»
• «Проанализируй @/utils/validator.js и улучши его»
• «Используя логику из @/old-module.js создай новую версию»

3.2.2. Упоминание папок

Синтаксис: @/путь/к/папке/

Примеры:

• «@/components/ создай единый стиль для всех кнопок»
• «Проанализируй @/services/ и создай документацию по архитектуре»

3.2.3. Упоминание терминала

Синтаксис: @terminal

Использование:

• «@terminal что означает эта ошибка?»
• «@terminal помоги установить эту зависимость»
• «@terminal почему тесты падают?»

3.2.4. Упоминание проблем

Синтаксис: @problems

Использование:

• «@problems покажи все ошибки в проекте»
• «@problems исправь все предупреждения TypeScript»
• «@problems какие проблемы наиболее критичны?»

3.2.5. Git упоминания

Незакоммиченные изменения:

• «@git-changes создай осмысленное описание коммита»
• «@git-changes проверь, всё ли готово для PR»

Конкретный коммит:

• «@a3f5d92 объясни, что было изменено в этом коммите»
• «@a3f5d92 восстанови логику из этого коммита»

3.2.6. URL упоминания

Синтаксис: @https://...

Примеры:

• «@https://docs.react.dev/reference/react/useState используй эту документацию для примера»
• «@https://api.example.com/openapi.json создай TypeScript типы на основе этой спецификации»

3.3. Команды и горячие клавиши

3.3.1. Основные горячие клавиши

Примечание: Для добавления кода в Kodik используйте правый клик → «Добавить в Kodik», а не горячую клавишу.

3.3.2. Slash-команды

В чате Kodik можно использовать:

Примеры:

• /newtask — начать новую задачу без контекста предыдущей
• /smol — Kodik сожмёт историю, сохранив важные детали
• /deep-planning — запустит 4-этапное планирование для сложной задачи

3.3.3. Команды контекстного меню

В редакторе:

• Правый клик на выделенном коде → «Добавить в Kodik»
• Через меню лампочки (при ошибках) → «Исправить с Kodik»
• Через меню лампочки → «Объяснить с Kodik»
• Через меню лампочки → «Улучшить с Kodik»

В терминале:

• Правый клик на выводе → «Добавить в Kodik»

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

3.4. Управление контекстом

3.4.1. Что такое контекст?

Контекст — вся информация, которую Kodik учитывает при генерации ответа:

• Файлы проекта, которые он прочитал
• История вашего разговора
• Правила Kodik
• Упомянутые файлы и данные

Окно контекста — ограничение на объём информации (измеряется в токенах).

3.4.2. Автоматическое управление

Auto-Compact (Автосжатие):

• Когда контекст приближается к лимиту, Kodik автоматически сжимает историю
• Сохраняются важные технические детали и решения
• Удаляются избыточные объяснения

Как включить: Settings → Features → Auto-Compact

3.4.3. Ручное управление

Сжать контекст: /smol или /compact

Начать новую задачу: /newtask — создаёт новую задачу с чистым контекстом

Проверить использование:

• В интерфейсе Kodik отображается индикатор использования токенов
• При приближении к лимиту появится предупреждение

4. Работа с проектами

4.1. Структура проекта

4.1.1. Анализ проекта

При открытии проекта Kodik автоматически:

1. Сканирует структуру директорий
2. Определяет тип проекта и технологии
3. Читает конфигурационные файлы
4. Строит граф зависимостей
5. Понимает архитектурные паттерны

Вы можете попросить:

• «Создай карту этого проекта с описанием модулей»
• «Объясни архитектуру этого приложения»
• «Какие паттерны используются в этом проекте?»

4.1.2. Правила проекта (Kodik Rules)

Создание правил:

1. В чате: /newrule
2. Или вручную: создайте .Kodikrules/ в корне проекта
3. Добавьте файл project-rules.md:

# Правила проекта MyApp

## Стандарты кодирования

- Использовать TypeScript для всех новых файлов
- Следовать ESLint конфигурации
- Максимальная длина строки: 100 символов

## Архитектура

- Следовать Clean Architecture
- Слои: UI → Domain → Data
- Зависимости только вниз

## Тестирование

- Покрытие тестами минимум 80%
- Unit тесты для всей бизнес-логики
- Integration тесты для API

Применение правил:

• Локальные правила (в .Kodikrules/) применяются только к текущему проекту
• Глобальные правила применяются ко всем проектам
• Локальные перекрывают глобальные при конфликте

4.1.3. Workflow (Рабочие процессы)

Что это: Рабочие процессы позволяют определить серию шагов для повторяющихся задач.

Создание workflow:

1. Создайте Markdown файл в директории .Kodikrules/:

# code-review.md

1. Получи описание PR и комментарии
2. Изучи diff изменений
3. Проверь окружающие файлы для контекста
4. Проанализируй потенциальные проблемы
5. Спроси меня, можно ли одобрить PR

2. Используйте в чате: /code-review.md

Kodik выполнит все шаги последовательно.

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

• Обзор PR
• Релизы с автоматическим созданием changelog
• Настройка новых проектов
• Создание отчётов с визуализацией

Примечание: Workflow файлы хранятся рядом с Правилами Kodik в директории .Kodikrules/

4.2. Работа с Git

4.2.1. Основные операции

Просмотр изменений: «@git-changes покажи что изменилось»

Создание коммита: «@git-changes создай описание коммита для этих изменений». Kodik проанализирует diff и сгенерирует осмысленное сообщение коммита.

Анализ истории:

• «@a3f5d92 что было изменено в этом коммите?»
• «Покажи историю изменений файла @/src/App.js»

4.2.2. Контрольные точки (Checkpoints)

Что это:

• Автоматические снимки состояния после каждого использования инструмента
• Работают параллельно с Git, используя теневой репозиторий
• Позволяют откатить изменения без влияния на основной Git репозиторий

Как создаются: Kodik автоматически создаёт контрольную точку после каждого:

• Редактирования файлов
• Выполнения команд
• Любого другого использования инструмента

Просмотр и восстановление:

1. Просмотреть изменения:
   • Нажмите кнопку «Сравнить» после использования инструмента
   • Увидите список изменённых файлов
2. Восстановить к предыдущей точке:
   • Нажмите кнопку «Восстановить» рядом с любым шагом
   • Выберите опцию:
     • Восстановить Задачу и Рабочее Пространство — сбросить код и контекст
     • Восстановить Только Задачу — вернуть контекст, сохранив изменения кода
     • Восстановить Только Рабочее Пространство — откатить код, сохранив контекст

Лучшие практики:

• Используйте контрольные точки как сетку безопасности при экспериментах
• Смело используйте режим авто-подтверждения, зная что всегда можете откатиться
• Восстанавливайте избирательно в зависимости от потребностей

4.3. Тестирование и отладка

4.3.1. Написание тестов

• «Создай unit тесты для функции @/utils/validator.js»
• «Добавь integration тесты для API endpoint /users»
• «Создай E2E тест для процесса регистрации»

4.3.2. Запуск и анализ тестов

1. Запустить тесты в терминале
2. В Kodik: «@terminal проанализируй падающие тесты»

Kodik:

1. Прочитает вывод
2. Определит причины падения
3. Предложит исправления

4.3.3. Отладка production ошибок

«@terminal вот stack trace ошибки из production. Помоги найти причину: [вставить stack trace]»

Kodik:

1. Проанализирует stack trace
2. Найдёт проблемный код
3. Объяснит причину
4. Предложит исправление

5. Продвинутые возможности

5.1. Режимы работы

5.1.1. Режим Планирования (Plan Mode)

Когда использовать:

• Для сложных задач
• Когда нужно понять, как лучше реализовать функцию
• Перед значительными изменениями

Как работает:

1. Kodik исследует проект без внесения изменений
2. Задаёт уточняющие вопросы
3. Создаёт детальный план реализации
4. Показывает план для одобрения

Пример. Вы: «Помоги спланировать добавление аутентификации через OAuth»

Kodik (в режиме планирования):

1. Какие OAuth провайдеры нужны? (Google, GitHub, etc.)
2. Где хранить токены?
3. Как обрабатывать refresh tokens?

[После ответов создаёт план]

План:

1. Установить библиотеку oauth2
2. Создать auth middleware
3. Добавить routes для /auth/google, /auth/github
4. Реализовать callback handlers
5. Настроить хранение токенов в Redis
6. Добавить refresh token logic
7. Создать tests

Продолжить реализацию?

5.1.2. Режим Действия (Act Mode)

Когда переключается:

• Автоматически после одобрения плана
• При прямых запросах на изменения

Что делает:

• Вносит изменения в файлы
• Создаёт новые файлы
• Применяет рефакторинг
• Показывает diff для одобрения

5.1.3. Глубокое планирование (/deep-planning)

Для максимально сложных задач: /deep-planning

Вы: «Добавь real-time чат в приложение»

Kodik:

Этап 1 (Тихое исследование):

• Изучает существующую архитектуру
• Определяет технологии (WebSocket/Socket.io)
• Находит точки интеграции

Этап 2 (Обсуждение):

• Уточняет требования
• Обсуждает технические решения

Этап 3 (Детальное планирование):

• Создаёт пошаговый план
• Определяет зависимости

Этап 4 (Структурированные задачи):

• Разбивает на подзадачи
• Создаёт отслеживаемый список

5.2. Цепочка фокуса (Focus Chain)

Что это: Автоматическое управление списком задач.

Как использовать. Вы: «Создай систему уведомлений: email, push, SMS»

Kodik создаёт Focus Chain:

1. Создать базовую структуру уведомлений
2. Реализовать email уведомления
3. Добавить push уведомления
4. Интегрировать SMS
5. Создать тесты
6. Добавить документацию

[Работает последовательно, отмечая выполненные]

Преимущества:

• Видите прогресс в реальном времени
• Можно прервать и продолжить позже
• Не забываются подзадачи

5.3. MCP Интеграции

5.3.1. Что такое MCP

Model Context Protocol — открытый протокол для расширения возможностей Kodik.

Доступные интеграции:

• GitHub/GitLab
• Базы данных (PostgreSQL, MySQL)
• API сервисы
• Файловые системы
• И другие

5.3.2. Настройка MCP сервера

Пример: GitHub интеграция

1. Settings → MCP Servers → Add Server
2. Заполните:
   • Название: GitHub Integration
   • Команда: npx -y @modelcontextprotocol/server-github
   • Переменные окружения: GITHUB_TOKEN=ghp_your_token_here
3. Сохраните и включите

Использование:

• «Создай Issue в GitHub с описанием этого бага»
• «Получи информацию о PR #123»
• «Создай новый релиз версии 2.0.0»

5.3.3. Настройка MCP серверов

Способ 1: Через UI

1. Нажмите значок «MCP Серверы» в панели Kodik
2. Нажмите «Настроить MCP Серверы»
3. Откроется файл Kodik_mcp_settings.json

Способ 2: Редактирование конфигурации вручную

Файл Kodik_mcp_settings.json содержит настройки всех MCP серверов:

{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

Управление серверами:

• Включить/отключить: переключатель рядом с сервером
• Перезапустить: кнопка «Перезапуск» или «Перезапустить Сервер»
• Удалить: значок корзины или кнопка «Удалить Сервер»

Использование: «Выполни SELECT * FROM users LIMIT 10 и создай TypeScript интерфейс»

5.4. Удалённый браузер

Что это: Kodik может использовать удаленный экземпляр Chrome для взаимодействия с веб-контентом.

Возможности:

• Посещение веб-сайтов и просмотр их содержимого
• Тестирование локально запущенных веб-приложений
• Заполнение форм и клики на элементах
• Создание скриншотов
• Мониторинг логов консоли браузера

Использование (через команды):

• «Используй браузер для проверки http://localhost:3000»
• «Нажми кнопку входа на странице»
• «Введи test@example.com в поле email»
• «Прокрути вниз, чтобы увидеть больше содержимого»
• «Сделай скриншот текущей страницы»
• «Закрой браузер сейчас»

Важные ограничения:

• Kodik может использовать только один браузер за раз
• Размер области просмотра: 900x600 пикселей (фиксированный)
• Браузер должен быть закрыт перед использованием других инструментов (редактирование файлов, команды)
• Kodik делится скриншотами после каждого действия

Возможности:

• Скриншоты страниц
• Тестирование UI
• Проверка responsive дизайна
• Отладка фронтенда

5.5. Настройки Auto-Approve

Управление разрешениями: Settings → Auto-Approve

Доступные разрешения:

Безопасная настройка:

• Читать файлы проекта
• Читать все файлы
• Редактировать файлы проекта (используйте Git для отката)
• Выполнять команды терминала

Для автоматизации:

• Все разрешения
• Используйте Checkpoints для безопасности!

6. Часто задаваемые вопросы

6.1. Общие вопросы

Q: Kodik заменит программистов?
A: Нет. Kodik — это инструмент, который помогает программистам работать эффективнее. Требуется понимание задачи, архитектуры, проверка сгенерированного кода.

Q: Безопасно ли использовать Kodik для коммерческих проектов?
A: Да. Для полной безопасности рекомендуется On-Premise развертывание, где код не покидает вашу инфраструктуру.

Q: Поддерживает ли Kodik мой язык программирования?
A: Kodik поддерживает большинство популярных языков: JavaScript/TypeScript, Python, Java, C/C++, Go, PHP, C#, и другие.

Q: Сколько стоит использование?
A: От бесплатного пробного периода до 15 999 ₽/мес для Super Pro. Enterprise тарифы — по запросу.

6.2. Технические вопросы

Q: Как Kodik понимает мой проект?
A: При открытии проекта Kodik:

1. Сканирует структуру файлов
2. Читает конфигурационные файлы
3. Анализирует зависимости и импорты
4. По запросу читает конкретные файлы
5. Учитывает ваши правила (Kodik Rules)

Q: Что делать, если Kodik не понимает задачу?
A:

1. Уточните запрос, будьте конкретнее
2. Добавьте контекст через @ упоминания
3. Разбейте на более мелкие задачи
4. Используйте /deep-planning для сложных задач

Q: Как экономить токены?
A:

1. Используйте /newtask для новых задач
2. Не добавляйте лишний контекст
3. Используйте @-упоминания вместо копирования кода
4. Включите Auto-Compact
5. Периодически используйте /smol

Q: Что делать, если сгенерированный код содержит ошибки?
A:

1. Опишите проблему Kodik
2. Используйте @terminal для отладки
3. Попросите исправить конкретные части
4. Используйте Checkpoints для отката

6.3. Работа с проектами

Q: Можно ли использовать Kodik для legacy проектов?
A: Да! Kodik отлично справляется с:

• Анализом и пониманием старого кода
• Рефакторингом
• Добавлением документации
• Модернизацией технологий

Q: Как Kodik работает с большими проектами (миллионы строк)?
A: Kodik работает выборочно:

• Не загружает весь проект в контекст
• Читает только релевантные файлы
• Использует интеллектуальный поиск
• Строит граф зависимостей для навигации

Q: Поддерживает ли Kodik монорепозитории?
A: Да. Kodik понимает структуру монорепозиториев и может работать с отдельными пакетами.

6.4. Безопасность и конфиденциальность

Q: Что происходит с моим кодом?
A:

• SaaS версия: Код отправляется на серверы для обработки моделями ИИ
• On-Premise: Код остаётся на ваших серверах

Q: Используется ли мой код для обучения моделей?
A: Нет. Политика Kodik — не использовать код клиентов для обучения.

Q: Как защищены мои данные?
A:

• Шифрование при передаче (TLS)
• Шифрование в хранилище (AES-256)
• Изоляция данных между пользователями
• Соответствие ФЗ-152 (для РФ)

Q: Можно ли отключить отправку данных в облако?
A: Да, через On-Premise развертывание.

7. Решение проблем

7.1. Проблемы при установке

Проблема: «Не удаётся установить на Windows»

• Проверьте, что у вас права администратора
• Отключите антивирус временно
• Скачайте установщик заново
• Убедитесь, что система 64-bit

Проблема: «macOS не позволяет открыть приложение»

Решение:

1. System Preferences → Security & Privacy
2. Нажмите «Open Anyway» для Kodik
3. Или в терминале: xattr -cr /Applications/Kodik.app

Проблема: «Linux: missing dependencies»

# Для Ubuntu/Debian
sudo apt-get install -f

# Для Fedora
sudo dnf install --best --allowerasing

7.2. Проблемы с подключением

Проблема: «Не могу войти в аккаунт»

• Проверьте интернет-соединение
• Убедитесь, что email и пароль верны
• Проверьте email на письмо с подтверждением
• Попробуйте сбросить пароль

Проблема: «Kodik не отвечает»

• Проверьте интернет: ping api.aikodik.ru
• Перезапустите приложение
• Проверьте firewall и proxy
• Обновите Kodik до последней версии

Проблема: «Ошибка подключения к моделям ИИ»

• Проверьте настройки API ключей (для On-Premise)
• Убедитесь, что есть доступные запросы в тарифе
• Проверьте status page: https://status.aikodik.ru

7.3. Проблемы с производительностью

Проблема: «Kodik медленно работает»

Причины и решения:

1. Недостаточно RAM:
   • Закройте другие приложения
   • Увеличьте RAM (рекомендуется 8GB+)
2. Медленный интернет:
   • Проверьте скорость
   • Используйте проводное подключение
   • Выберите более быструю модель (Qwen-Flash)
3. Большой проект:
   • Используйте @-упоминания вместо загрузки всего
   • Регулярно используйте /smol
   • Создавайте новые задачи через /newtask

Проблема: «Генерация кода занимает много времени»

• Нормально: 5-30 секунд в зависимости от сложности
• Слишком долго (>1 мин):
  • Упростите запрос
  • Разбейте на части
  • Выберите более быструю модель

7.4. Проблемы с качеством кода

Проблема: «Сгенерированный код не работает»

Решения:

1. Уточните запрос:
   • Добавьте технические детали
   • Укажите предпочитаемые библиотеки
   • Опишите ожидаемое поведение
2. Добавьте контекст:
   • @-упомяните связанные файлы
   • Создайте правила проекта
   • Покажите примеры кода
3. Итеративное улучшение:
   • Попросите исправить конкретные проблемы
   • Используйте @terminal для отладки

Проблема: «Код не соответствует стилю проекта»

Решение:

1. Создайте Kodik Rules: .Kodikrules/coding-standards.md
2. Опишите стиль:
   • Форматирование
   • Именование
   • Паттерны
   • Библиотеки
3. Kodik будет следовать правилам

7.5. Проблемы с лицензией

Проблема: «Закончились запросы»

• Проверьте использование: Settings → Usage
• Дождитесь начала нового периода
• Или обновите тариф

Проблема: «Не могу активировать Enterprise лицензию»

• Свяжитесь с поддержкой: info@aikodik.ru
• Предоставьте лицензионный ключ
• Следуйте инструкциям от поддержки

7.6. Куда обращаться за помощью

Форум (рекомендуется):

• https://forum.aikodik.ru
• Поиск по существующим темам
• Создание новой темы

Email поддержка:

• support@aikodik.ru — технические вопросы
• info@aikodik.ru — аккаунт и оплата

Документация:

• https://docs.aikodik.ru
• Полная документация
• Видеоуроки
• FAQ

Срочная поддержка (Enterprise):

• emergency@aikodik.ru
• Круглосуточная телефонная линия (24/7)

Приложение A: Полезные ресурсы

Официальные ссылки:

• Сайт: https://aikodik.ru
• Документация: https://docs.aikodik.ru
• Форум: https://forum.aikodik.ru
• Загрузки: https://aikodik.ru/downloads
• Статус: https://status.aikodik.ru

Обучающие материалы:

• Видеоуроки на YouTube
• Примеры проектов
• Best practices: https://docs.aikodik.ru/best-practices

Сообщество:

• Telegram чат
• Discord сервер
• GitHub Discussions

Приложение B: Глоссарий

• @-упоминание — способ явно указать контекст через символ @
• Auto-Approve — автоматическое одобрение действий
• Auto-Compact — автоматическое сжатие контекста
• Checkpoint — контрольная точка, снимок состояния
• Context Window — окно контекста, лимит информации
• Deep Planning — глубокое планирование (4 этапа)
• Focus Chain — цепочка фокуса, список задач
• Kodik Rules — правила для кастомизации поведения
• MCP — Model Context Protocol, протокол расширений
• Slash-команды — команды, начинающиеся с /
• Token — токен, единица текста (~3/4 слова)
• Workflow — рабочий процесс, автоматизация

Документ подготовлен: ООО «АрхиТех ИИ», 2025 год. Версия документа: 1.0.

Для получения помощи:

• Форум: https://forum.aikodik.ru
• Email: support@aikodik.ru
• Документация: https://docs.aikodik.ru

С уважением, команда Kodik. Создавайте код быстрее с искусственным интеллектом!