DeepSeek Engineer: экспериментальный помощник для кодирования на основе API DeepSeek с подсказками.

Общее введение

DeepSeek Engineer - это мощный помощник программиста, разработанный на основе DeepSeek API, способный взаимодействовать с пользователем через интуитивно понятный интерфейс командной строки для помощи в решении различных задач по разработке программного обеспечения. Инструмент сочетает в себе мощь большой языковой модели с практическими функциями манипулирования файловой системой и интеллектуальной обработки кода, позволяя не только вести диалоги с обычным кодом, но и поддерживать чтение, создание и модификацию локальных файлов в режиме реального времени. Благодаря механизму структурированных ответов в формате JSON, DeepSeek Engineer способен точно понять намерения пользователя и обеспечить разнообразную поддержку разработки, такую как генерация кода и редактирование файлов. Он поддерживает многострочный потоковый вывод ответов, может быстро импортировать и точно редактировать содержимое файлов с помощью простых команд, что делает его мощным помощником для разработчиков, повышающим эффективность программирования.

Список функций

• Интеграция API-клиента DeepSeek с поддержкой потокового диалогового завершения в стиле GPT
• Файловая операционная система с безопасным типом на основе Pydantic
• Интеллектуальные подсказки системы обеспечивают строгое соответствие всех ответов формату вывода JSON
• Функции чтения и анализа содержимого локальных файлов
• Поддержка операций создания и обновления файлов
• Визуализация различий в коде
• Функции модификации файлов на уровне фрагментов
• Команда "/add" быстро импортирует содержимое файла.
• Постоянное отслеживание истории диалога
• Поддержка интерактивных терминальных сессий
• Механизм подтверждения изменения документа в режиме реального времени

Извлечение ключевых слов для программирования

You are an elite software engineer called DeepSeek Engineer with decades of experience across all programming domains.
Your expertise spans system design, algorithms, testing, and best practices.
You provide thoughtful, well-structured solutions while explaining your reasoning.
Core capabilities:
1. Code Analysis & Discussion
- Analyze code with expert-level insight
- Explain complex concepts clearly
- Suggest optimizations and best practices
- Debug issues with precision
2. File Operations:
a) Read existing files
- Access user-provided file contents for context
- Analyze multiple files to understand project structure
b) Create new files
- Generate complete new files with proper structure
- Create complementary files (tests, configs, etc.)
c) Edit existing files
- Make precise changes using diff-based editing
- Modify specific sections while preserving context
- Suggest refactoring improvements
Output Format:
You must provide responses in this JSON structure:
{
"assistant_reply": "Your main explanation or response",
"files_to_create": [
{
"path": "path/to/new/file",
"content": "complete file content"
}
],
"files_to_edit": [
{
"path": "path/to/existing/file",
"original_snippet": "exact code to be replaced",
"new_snippet": "new code to insert"
}
]
}
Guidelines:
1. For normal responses, use 'assistant_reply'
2. When creating files, include full content in 'files_to_create'
3. For editing files:
- Use 'files_to_edit' for precise changes
- Include enough context in original_snippet to locate the change
- Ensure new_snippet maintains proper indentation
- Prefer targeted edits over full file replacements
4. Always explain your changes and reasoning
5. Consider edge cases and potential impacts
6. Follow language-specific best practices
7. Suggest tests or validation steps when appropriate
Remember: You're a senior engineer - be thorough, precise, and thoughtful in your solutions.

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

1. Подготовка окружающей среды

Прежде всего, вам необходимо подготовить следующее:

1. Получить ключ API DeepSeek
2. создать.envфайл и настройте ключ API:

DEEPSEEK_API_KEY=your_api_key_here

2. Этапы установки

DeepSeek Engineer предлагает два варианта установки:

Установка с помощью pip (традиционный способ)

pip install -r requirements.txt
python3 main.py

Установка с помощью uv (более быстрая альтернатива)

uv venv
uv run main.py

3. Руководство по использованию основных функций

Функции Поток операций

1. Начало интерактивного сеанса: Запустите сценарий (например:python3 main.py), чтобы запустить интерактивный цикл в терминале. Введите свой запрос или вопрос о коде.
2. Добавьте содержимое файла: Вход /add path/to/file чтобы добавить содержимое файла в диалог. Вы также можете ввести /add path/to/folder чтобы добавить все файлы в каталоге (за исключением исполняемых и скрытых файлов).
3. Подтверждение изменений в документах: Когда помощник предлагает новые или отредактированные файлы, вы можете подтвердить изменения непосредственно в локальной среде.
4. конец сессии: Вход exit возможно quit чтобы завершить сеанс.

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

• Конфигурация клиента DeepSeek: Автоматическая настройка клиента API на использование действительного DEEPSEEK_API_KEY и подключение к конечной точке DeepSeek, указанной в переменной окружения, для потокового завершения класса GPT.
• модель данных: Безопасная для типов обработка файловых операций с помощью Pydantic, включая FileToCreate, описывающий файл, который нужно создать или обновить, FileToEdit, описывающий замену определенных сегментов кода в существующем файле, и AssistantResponse, структурирующий ответы чата и потенциальные файловые операции.
• системное оповещение: Всеобъемлющий системный_PROMPT направляет диалог, гарантируя, что все ответы будут строго соответствовать выводу JSON, с возможностью создания или редактирования файлов.
• вспомогательная функция:: Включает read_local_file для чтения содержимого локального файла, create_file для создания или перезаписи файла, show_diff_table для представления предлагаемых изменений в файле в виде богатой многострочной таблицы и apply_diff_edit для применения изменений на уровне фрагментов к существующему файлу.
• Команда "/add": Пользователь может ввести /add path/to/file Быстрое чтение содержимого файла и вставка его в диалог в качестве системного сообщения. Пользователь также может набрать /add path/to/folder добавить все файлы в каталоге (за исключением двоичных и скрытых файлов), что позволит ассистенту обращаться к содержимому файлов для дальнейшего обсуждения, генерации кода или предложений по диффузии.
• Поток диалогов: Ведение списка conversation_history для отслеживания сообщений между пользователем и ассистентом, передача ответов ассистента через DeepSeek API, разбор их в JSON для сохранения текстовых ответов и инструкций по модификации файлов.

устранение неисправностей

1. Проблемы с подключением к API:
   • Проверьте, правильно ли настроен ключ API
   • Подтвердите состояние сетевого подключения
2. Ошибка файловой операции:
   • Проверка параметров разрешения файлов
   • Убедитесь, что путь назначения доступен для записи
3. Проблемы с разбором ответа:
   • Проверьте правильность формата входных данных
   • Попробуйте перезапустить сессию