Практические советы для максимального использования Pastukhov Code, ответы на общие вопросы и шаги по устранению неполадок, когда что-то работает не так, как ожидалось.
Советы для эффективного AI-кодирования
- Будьте конкретны — Чем больше деталей вы дадите, тем лучше AI поймёт ваш запрос. Вместо “исправь кнопку” скажите “кнопка отправки на контактной форме не проверяет формат электронной почты — добавь проверку электронной почты с использованием регулярного выражения”
- Разбивайте большие задачи на меньшие — Вместо “построй всё приложение”, начните с одной функции за раз. AI работает лучше всего с сфокусированными, хорошо определёнными запросами
- Используйте навыки — Выберите правильный навык для задачи с помощью селектора навыков. Навык “code review” даст другие результаты, чем навык “development” для одного и того же кода
- Итерируйте — Если первый ответ не идеален, попросите улучшения, вместо того чтобы начинать заново. “Сделай заголовок крупнее и измени цвет на синий” быстрее, чем переописывать всё требование
- Предоставляйте контекст — Упомяните соответствующие имена файлов, имена функций или шаблоны, которые вы хотите, чтобы AI следовал. “Обнови функцию formatDate в src/utils/date.ts для обработки европейского формата даты”
Общие вопросы
Как подключить свой собственный проект?
Перенастройте ваши переменные среды (путь к проекту, URL git, учётные данные) и перезапустите Pastukhov Code. Смотрите раздел Начало работы и руководства по установке для Windows или Docker для получения подробной информации.
Могу ли я использовать несколько AI-моделей?
Да. Создайте несколько окружений в настройках, каждое с другой моделью и API-ключом. Переключайтесь между ними с помощью селектора окружений в поле ввода чата.
Что происходит, когда AI совершает ошибку?
AI видит ошибки сборки и может исправить их автоматически, если включена функция AutoFix. Вы также можете сказать AI, что пошло не так, и попросить его исправить проблему. AI читает сообщения об ошибках из панели сборки и использует их как контекст для исправлений.
Могу ли я делиться навыками между проектами?
Да. Навыки хранятся в отдельном git-репозитории. Укажите нескольким экземплярам Pastukhov Code один и тот же URL репозитория навыков для совместного использования навыков между проектами и участниками команды. Смотрите раздел Навыки для получения подробной информации.
Как создать резервную копию моих данных?
Ваши файлы проекта находятся в вашем git-репозитории — регулярно делайте коммиты и отправляйте их. История чата и настройки хранятся в локальной базе данных. Создайте резервную копию файла базы данных или настройте постоянную базу данных для производственного использования.
Являются ли мои данные частными?
Ваш код работает локально в вашем собственном контейнере или экземпляре. Сообщения чата отправляются поставщику AI, который вы настроили (например, Anthropic или OpenAI). Данные аналитики остаются локальными, если вы не настроили отправку в ClickHouse для централизованной отчётности.
Проблемы с подключением
Не удается связаться с AI: Проверьте, что ваш API-ключ действителен и что у вас есть доступные API-кредиты у вашего поставщика. Проверьте API-ключ в вашей конфигурации окружения.
Не удается отправить или получить изменения Git: Убедитесь, что ваши учётные данные git (логин, токен личного доступа) настроены в переменных среды. Смотрите раздел Git для получения подробной информации.
Контейнер не запускается: Проверьте журналы Docker на наличие ошибок запуска. Общие причины включают неправильные переменные среды, конфликты портов или отсутствующие файлы конфигурации.
Порт уже используется: Другая служба использует порт, на котором настроен Pastukhov Code. Измените порт в вашей конфигурации или остановите конфликтующую службу.
Советы по производительности
- Большие проекты — Pastukhov Code обрабатывает большие кодовые базы, но производительность зависит от выделенных ресурсов вашего контейнера. Увеличьте память и CPU, если вы работаете с очень большими проектами
- Длинные разговоры — Очень длинные сессии чата используют больше токенов и могут замедлиться. Начните новую сессию, когда контекст разговора больше не актуален для вашей текущей задачи
- Скорость сборки — Если вам не нужна полная среда разработки, используйте минимальный образ Docker для более быстрых сборок и развёртываний
- База данных — Для лучшей производительности со временем при многих сессиях чата рассмотрите возможность использования PostgreSQL вместо SQLite
Получение помощи
Если вы попробовали вышеуказанные шаги по устранению неполадок и всё ещё нужна помощь:
- Telegram — Напишите
@maxedantдля прямой поддержки (самый быстрый ответ) - Электронная почта — Отправьте сообщение на
support@pastukhov.com - Страница FAQ — Посетите FAQ для дополнительных ответов на общие вопросы
Время ответа обычно в течение 12 часов, включая выходные. При обращении в поддержку включите описание проблемы, любые сообщения об ошибках и шаги для воспроизведения проблемы.