DeepSeek Engineer: un asistente de codificación experimental basado en la API DeepSeek, con palabras clave.

Introducción general

DeepSeek Engineer es una potente herramienta asistente de programación desarrollada a partir de la API DeepSeek, capaz de interactuar con el usuario a través de una intuitiva interfaz de línea de comandos para ayudarle en diversas tareas de desarrollo de software. La herramienta combina la potencia de un amplio modelo de lenguaje con prácticas funciones de manipulación del sistema de archivos y manejo inteligente de código, permitiendo no sólo diálogos de código regulares, sino también soportando la lectura, creación y modificación en tiempo real de archivos locales. A través de un mecanismo de respuesta JSON estructurado, DeepSeek Engineer es capaz de comprender con precisión la intención del usuario y proporcionar diversos soportes de desarrollo, como la generación de código y la edición de archivos. Cuenta con soporte para la salida de respuesta de flujo de varias líneas, y puede importar rápidamente y editar con precisión el contenido del archivo con comandos simples, por lo que es un poderoso asistente para los desarrolladores para mejorar la eficiencia de la programación.

Lista de funciones

• Integración de la API DeepSeek en el cliente y compatibilidad con la finalización de diálogos en tiempo real al estilo GPT
• Sistema operativo de archivos de tipo seguro basado en Pydantic
• Avisos inteligentes del sistema para garantizar que todas las respuestas siguen estrictamente el formato de salida JSON
• Funciones locales de lectura de archivos y análisis de contenido
• Soporte de operaciones de creación y actualización de archivos
• Visualización de las diferencias de código
• Modificación de archivos por fragmentos
• El comando "/add" importa rápidamente el contenido de un fichero.
• Seguimiento continuo del historial de diálogo
• Soporte de sesión de terminal interactiva
• Mecanismo de confirmación de modificación de documentos en tiempo real

Extracción de palabras clave de programación

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.

Utilizar la ayuda

1. Preparación medioambiental

En primer lugar, tienes que preparar lo siguiente:

1. Obtener clave API de DeepSeek
2. establecer.envy configure la clave API:

DEEPSEEK_API_KEY=your_api_key_here

2. Pasos de la instalación

DeepSeek Engineer ofrece dos opciones de instalación:

Instalación mediante pip (método tradicional)

pip install -r requirements.txt
python3 main.py

Instalación mediante uv (alternativa más rápida)

uv venv
uv run main.py

3. Orientación sobre el uso de las funciones básicas

Función Flujo de operaciones

1. Iniciar una sesión interactivaEjecuta el script (por ejemplo:python3 main.py) para iniciar un bucle interactivo en el terminal. Introduzca su solicitud o pregunta de código.
2. Añadir contenido de archivo: Entrada /add path/to/file para añadir el contenido del archivo al diálogo. También puede escribir /add path/to/folder para añadir todos los archivos del directorio (excluyendo binarios y archivos ocultos).
3. Confirmación de cambios en los documentos: Cuando el asistente sugiere archivos nuevos o editados, puede confirmar los cambios directamente en su entorno local.
4. fin de la sesión: Entrada exit tal vez quit para finalizar la sesión.

Funciones principales

• Configuración del cliente DeepSeekConfigurar automáticamente el cliente API para utilizar una DEEPSEEK_API_KEY válida y conectarse al punto final DeepSeek especificado en la variable de entorno para transmitir la finalización de la clase GPT.
• modelo de datos: Procesamiento de operaciones de archivo de tipo seguro con Pydantic, incluyendo FileToCreate describiendo un archivo a ser creado o actualizado, FileToEdit describiendo el reemplazo de segmentos de código específicos en un archivo existente, y AssistantResponse estructurando respuestas de chat y potenciales operaciones de archivo.
• alerta del sistema: Un completo system_PROMPT guía el diálogo, asegurando que todas las respuestas siguen estrictamente la salida JSON, con la opción de crear o editar archivos.
• función de ayuda:: Incluye read_local_file para leer el contenido de un archivo local, create_file para crear o sobrescribir un archivo, show_diff_table para presentar los cambios sugeridos en el archivo en una tabla multilínea enriquecida, y apply_diff_edit para aplicar cambios a nivel de fragmento a un archivo existente.
• "Comando "/addEl usuario puede introducir /add path/to/file Lea rápidamente el contenido de un archivo e insértelo en un diálogo como mensaje del sistema. El usuario también puede escribir /add path/to/folder para añadir todos los archivos del directorio (excluyendo los binarios y los archivos ocultos), lo que permite al asistente consultar el contenido de los archivos para su posterior discusión, generación de código o sugerencias de diferencias.
• Flujo del diálogoMantenimiento de una lista conversation_history para realizar un seguimiento de los mensajes entre el usuario y el asistente, transmisión de las respuestas del asistente a través de la API DeepSeek, analizándolas en JSON para conservar las respuestas de texto y las instrucciones de modificación de archivos.

resolución de averías

1. Problemas de conectividad de la API:
   • Compruebe que la clave API está configurada correctamente
   • Confirmar el estado de la conexión de red
2. Error de operación de archivo:
   • Verificar la configuración de permisos de archivos
   • Asegúrese de que la ruta de destino es escribible
3. Problemas de análisis de respuestas:
   • Compruebe que el formato de entrada es correcto
   • Prueba a reiniciar la sesión