Allgemeine Einführung
DeepSeek Engineer ist ein leistungsstarker Programmierassistent, der auf der Grundlage der DeepSeek-API entwickelt wurde und über eine intuitive Befehlszeilenschnittstelle mit dem Benutzer interagieren kann, um ihn bei einer Vielzahl von Softwareentwicklungsaufgaben zu unterstützen. Das Tool kombiniert die Leistungsfähigkeit eines umfangreichen Sprachmodells mit praktischer Dateisystemmanipulation und intelligenten Code-Handling-Funktionen, die nicht nur reguläre Code-Dialoge ermöglichen, sondern auch das Lesen, Erstellen und Ändern von lokalen Dateien in Echtzeit unterstützen. Durch einen strukturierten JSON-Antwortmechanismus ist DeepSeek Engineer in der Lage, die Absicht des Benutzers genau zu verstehen und vielfältige Entwicklungsunterstützung wie Codegenerierung und Dateibearbeitung zu bieten. DeepSeek Engineer unterstützt die Ausgabe von mehrzeiligen Streaming-Antworten und kann Dateiinhalte mit einfachen Befehlen schnell importieren und präzise bearbeiten, was es zu einem leistungsstarken Assistenten für Entwickler macht, der die Effizienz der Programmierung verbessert.
Funktionsliste
- DeepSeek-API-Client-Integration mit Unterstützung für Streaming-Dialogvervollständigung im GPT-Stil
- Pydantisches, typsicheres Dateibetriebssystem
- Intelligente Systemaufforderungen, die sicherstellen, dass alle Antworten strikt dem JSON-Ausgabeformat entsprechen
- Funktionen zum Lesen lokaler Dateien und zur Inhaltsanalyse
- Unterstützung bei der Erstellung und Aktualisierung von Dateien
- Visualisierung von Code-Unterschieden
- Funktionalität zur Änderung von Dateien auf Fragmentebene
- Der Befehl "/add" importiert schnell den Inhalt einer Datei.
- Laufende Verfolgung des Dialogverlaufs
- Unterstützung interaktiver Terminalsitzungen
- Mechanismus zur Bestätigung von Dokumentenänderungen in Echtzeit
Extrahieren von Schlüsselwörtern der Programmierung
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.
Hilfe verwenden
1. die Vorbereitung der Umwelt
Zunächst einmal müssen Sie Folgendes vorbereiten:
- DeepSeek API-Schlüssel erhalten
- einrichten.
.env
Datei und konfigurieren Sie den API-Schlüssel:
DEEPSEEK_API_KEY=your_api_key_here
2. die Installationsschritte
DeepSeek Engineer bietet zwei Installationsoptionen:
Installation mit pip (traditioneller Weg)
pip install -r requirements.txt
python3 main.py
Installation mit uv (schnellere Alternative)
uv venv
uv run main.py
3. eine Anleitung für die Nutzung der Kernfunktionen
Funktion Betriebsablauf
- Starten einer interaktiven Sitzung: Führen Sie das Skript aus (zum Beispiel:
python3 main.py
), um eine interaktive Schleife im Terminal zu starten. Geben Sie Ihre Anfrage oder Codefrage ein. - Dateiinhalt hinzufügen: Eingabe
/add path/to/file
um den Inhalt der Datei in den Dialog aufzunehmen. Sie können auch Folgendes eingeben/add path/to/folder
um alle Dateien im Verzeichnis hinzuzufügen (mit Ausnahme von Binärdateien und versteckten Dateien). - Bestätigung von DokumentenänderungenWenn der Assistent neue oder bearbeitete Dateien vorschlägt, können Sie die Änderungen direkt in Ihrer lokalen Umgebung bestätigen.
- Ende der Sitzung: Eingabe
exit
vielleichtquit
um die Sitzung zu beenden.
Hauptfunktionen
- DeepSeek-Client-KonfigurationAPI-Client automatisch so konfigurieren, dass er einen gültigen DEEPSEEK_API_KEY verwendet und sich mit dem in der Umgebungsvariablen angegebenen DeepSeek-Endpunkt verbindet, um die GPT-Klassenvervollständigung zu streamen.
- DatenmodellPydantic: Typsichere Verarbeitung von Dateioperationen mit Pydantic, einschließlich FileToCreate zur Beschreibung einer zu erstellenden oder zu aktualisierenden Datei, FileToEdit zur Beschreibung der Ersetzung bestimmter Codesegmente in einer bestehenden Datei und AssistantResponse zur Strukturierung von Chat-Antworten und möglichen Dateioperationen.
- SystemwarnungEin umfassender system_PROMPT leitet den Dialog und stellt sicher, dass alle Antworten strikt der JSON-Ausgabe folgen, mit der Option, Dateien zu erstellen oder zu bearbeiten.
- HelferfunktionEnthält read_local_file zum Lesen des Inhalts einer lokalen Datei, create_file zum Erstellen oder Überschreiben einer Datei, show_diff_table zur Darstellung der vorgeschlagenen Dateiänderungen in einer mehrzeiligen Tabelle und apply_diff_edit zur Anwendung von Änderungen auf Snippet-Ebene auf eine bestehende Datei.
- "/add" Befehl: Der Benutzer kann eingeben
/add path/to/file
Lesen Sie schnell den Inhalt einer Datei und fügen Sie ihn als Systemnachricht in einen Dialog ein. Der Benutzer kann auch Folgendes eingeben/add path/to/folder
um alle Dateien im Verzeichnis hinzuzufügen (mit Ausnahme von Binärdateien und versteckten Dateien), was es dem Assistenten ermöglicht, den Inhalt der Dateien für weitere Diskussionen, Codegenerierung oder Diff-Vorschläge heranzuziehen. - Ablauf des DialogsConversation_history: Führt eine conversation_history-Liste, um die Nachrichten zwischen dem Benutzer und dem Assistenten zu verfolgen, streamt die Antworten des Assistenten über die DeepSeek-API und parst sie in JSON, um Textantworten und Anweisungen zur Dateiänderung zu erhalten.
Fehlerbehebung
- Probleme mit der API-Konnektivität:
- Prüfen Sie, ob der API-Schlüssel richtig konfiguriert ist
- Bestätigen Sie den Status der Netzwerkverbindung
- Dateioperationsfehler:
- Überprüfen der Dateiberechtigungseinstellungen
- Sicherstellen, dass der Zielpfad beschreibbar ist
- Probleme beim Parsen von Antworten:
- Prüfen Sie, ob das Eingabeformat korrekt ist
- Versuchen Sie, die Sitzung neu zu starten