DeepSeek Engineer : un assistant de codage expérimental basé sur l'API DeepSeek, avec des mots repères.

Introduction générale

DeepSeek Engineer est un puissant outil d'aide à la programmation développé sur la base de l'API DeepSeek, capable d'interagir avec l'utilisateur par le biais d'une interface de ligne de commande intuitive afin de l'assister dans diverses tâches de développement de logiciels. L'outil combine la puissance d'un grand modèle de langage avec une manipulation pratique du système de fichiers et des fonctions intelligentes de traitement du code, permettant non seulement des dialogues de code réguliers, mais aussi la lecture, la création et la modification en temps réel de fichiers locaux. Grâce à un mécanisme de réponse JSON structuré, DeepSeek Engineer est capable de comprendre avec précision l'intention de l'utilisateur et de fournir divers supports de développement tels que la génération de code et l'édition de fichiers. Il prend en charge la sortie de réponses en continu sur plusieurs lignes et peut rapidement importer et modifier avec précision le contenu des fichiers à l'aide de commandes simples, ce qui en fait un assistant puissant pour les développeurs afin d'améliorer l'efficacité de la programmation.

Liste des fonctions

• Intégration du client API DeepSeek avec prise en charge de la complétion des dialogues en continu de type GPT
• Système d'exploitation de fichiers à sécurité de type basé sur la pydantique
• Des messages-guides intelligents garantissent que toutes les réponses respectent strictement le format de sortie JSON.
• Fonctions de lecture de fichiers locaux et d'analyse de contenu
• Prise en charge des opérations de création et de mise à jour de fichiers
• Visualisation des différences de code
• Fonctionnalité de modification des fichiers au niveau des fragments
• La commande "/add" importe rapidement le contenu d'un fichier.
• Suivi de l'historique du dialogue en cours
• Support de session de terminal interactif
• Mécanisme de confirmation de la modification des documents en temps réel

Extraire les mots-clés de la programmation

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.

Utiliser l'aide

1. préparation à l'environnement

Tout d'abord, vous devez préparer les éléments suivants :

1. Obtenir la clé API de DeepSeek
2. établir.envet configurer la clé API :

DEEPSEEK_API_KEY=your_api_key_here

2. les étapes de l'installation

DeepSeek Engineer propose deux options d'installation :

Installation à l'aide de pip (méthode traditionnelle)

pip install -r requirements.txt
python3 main.py

Installation à l'aide d'uv (alternative plus rapide)

uv venv
uv run main.py

3. des orientations sur l'utilisation des fonctions essentielles

Fonction Opération Déroulement

1. Démarrer une session interactive: Exécutez le script (par exemple :python3 main.py) pour démarrer une boucle interactive dans le terminal. Saisissez votre demande ou votre question de code.
2. Ajouter le contenu du fichier: Entrée /add path/to/file pour ajouter le contenu du fichier au dialogue. Vous pouvez également taper /add path/to/folder pour ajouter tous les fichiers du répertoire (à l'exception des fichiers binaires et des fichiers cachés).
3. Confirmation des modifications apportées aux documentsLorsque l'assistant propose des fichiers nouveaux ou modifiés, vous pouvez confirmer les modifications directement dans votre environnement local.
4. fin de la session: Entrée exit peut-être quit pour mettre fin à la session.

Principales fonctions

• Configuration du client DeepSeekConfiguration automatique du client API pour utiliser une clé DEEPSEEK_API_KEY valide et se connecter au point de terminaison DeepSeek spécifié dans la variable d'environnement pour diffuser en continu la complétion de la classe GPT.
• modèle de donnéesTraitement des opérations de fichier à sécurité intrinsèque avec Pydantic, y compris FileToCreate décrivant un fichier à créer ou à mettre à jour, FileToEdit décrivant le remplacement de segments de code spécifiques dans un fichier existant, et AssistantResponse structurant les réponses de chat et les opérations de fichier potentielles.
• alerte systèmeLe dialogue est guidé par un system_PROMPT complet, qui garantit que toutes les réponses respectent strictement la sortie JSON, avec la possibilité de créer ou d'éditer des fichiers.
• fonction d'aide: : Comprend read_local_file pour lire le contenu d'un fichier local, create_file pour créer ou écraser un fichier, show_diff_table pour présenter les modifications suggérées dans un fichier sous la forme d'un tableau riche à plusieurs lignes, et apply_diff_edit pour appliquer des modifications au niveau des bribes à un fichier existant.
• "Commande "/addL'utilisateur peut saisir /add path/to/file Lire rapidement le contenu d'un fichier et l'insérer dans un dialogue en tant que message système. L'utilisateur peut également taper /add path/to/folder pour ajouter tous les fichiers du répertoire (à l'exclusion des fichiers binaires et des fichiers cachés), ce qui permet à l'assistant de se référer au contenu des fichiers pour une discussion plus approfondie, la génération de code ou des suggestions de diff.
• Flux du dialogueLes réponses de l'assistant sont transmises via l'API DeepSeek et analysées en JSON afin de préserver les réponses textuelles et les instructions de modification des fichiers.

résolution des problèmes

1. Problèmes de connectivité de l'API :
   • Vérifier que la clé API est correctement configurée
   • Confirmer l'état de la connexion au réseau
2. Erreur d'opération de fichier :
   • Vérifier les paramètres d'autorisation des fichiers
   • S'assurer que le chemin de destination est accessible en écriture
3. Problèmes d'analyse des réponses :
   • Vérifier que le format d'entrée est correct
   • Essayez de redémarrer la session