DeepSeek Engineer: um assistente de codificação experimental baseado na API do DeepSeek, com palavras-chave

Introdução geral

DeepSeek O Engineer é uma poderosa ferramenta de assistente de programação desenvolvida com base na API do DeepSeek, capaz de interagir com o usuário por meio de uma interface de linha de comando intuitiva para auxiliar em uma variedade de tarefas de desenvolvimento de software. A ferramenta combina o poder de um grande modelo de linguagem com a manipulação prática do sistema de arquivos e recursos inteligentes de manipulação de código, permitindo não apenas diálogos regulares de código, mas também suporte à leitura, criação e modificação em tempo real de arquivos locais. Por meio de um mecanismo de resposta JSON estruturado, o DeepSeek Engineer é capaz de entender com precisão a intenção do usuário e fornecer suporte de desenvolvimento diversificado, como geração de código e edição de arquivos. Ele oferece suporte para saída de resposta de streaming de várias linhas e pode importar rapidamente e editar com precisão o conteúdo de arquivos com comandos simples, o que o torna um assistente poderoso para que os desenvolvedores melhorem a eficiência da programação.

Lista de funções

• Integração do cliente da API DeepSeek com suporte para conclusão de diálogo de transmissão no estilo GPT
• Sistema operacional de arquivos com segurança de tipo baseado em Pydantic
• O sistema inteligente solicita que todas as respostas sigam rigorosamente o formato de saída JSON
• Funções de leitura de arquivos locais e análise de conteúdo
• Suporte a operações de criação e atualização de arquivos
• Visualização das diferenças de código
• Funcionalidade de modificação de arquivos em nível de fragmento
• O comando "/add" importa rapidamente o conteúdo de um arquivo.
• Rastreamento contínuo do histórico de diálogos
• Suporte a sessões de terminal interativo
• Mecanismo de confirmação de modificação de documentos em tempo real

Extração de palavras-chave da programação principal

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.

Usando a Ajuda

1. preparação ambiental

Em primeiro lugar, você precisa preparar o seguinte:

1. Obter a chave da API do DeepSeek
2. estabelecer.enve configurar a chave de API:

DEEPSEEK_API_KEY=your_api_key_here

2. etapas de instalação

O DeepSeek Engineer oferece duas opções de instalação:

Instalação usando o pip (modo tradicional)

pip install -r requirements.txt
python3 main.py

Instalação usando uv (alternativa mais rápida)

uv venv
uv run main.py

3. orientação sobre o uso de funções essenciais

Função Fluxo de operação

1. Início de uma sessão interativaExecute o script (por exemplo:python3 main.py) para iniciar um loop interativo no terminal. Digite sua solicitação ou pergunta de código.
2. Adicionar conteúdo do arquivo: Entrada /add path/to/file para adicionar o conteúdo do arquivo à caixa de diálogo. Você também pode digitar /add path/to/folder para adicionar todos os arquivos no diretório (excluindo binários e arquivos ocultos).
3. Confirmação de alterações em documentosQuando o assistente sugere arquivos novos ou editados, você pode confirmar as alterações diretamente no seu ambiente local.
4. fim da sessão: Entrada exit talvez quit para encerrar a sessão.

Funções principais

• Configuração do cliente DeepSeekConfiguração automática do cliente da API para usar uma DEEPSEEK_API_KEY válida e conectar-se ao ponto de extremidade do DeepSeek especificado na variável de ambiente para transmitir a conclusão da classe GPT.
• modelo de dadosProcessamento de operações de arquivo com segurança de tipo com Pydantic, incluindo FileToCreate, que descreve um arquivo a ser criado ou atualizado, FileToEdit, que descreve a substituição de segmentos de código específicos em um arquivo existente, e AssistantResponse, que estrutura respostas de bate-papo e possíveis operações de arquivo.
• alerta do sistemaUm system_PROMPT abrangente orienta o diálogo, garantindo que todas as respostas sigam estritamente a saída JSON, com a opção de criar ou editar arquivos.
• função auxiliarInclui read_local_file para ler o conteúdo de um arquivo local, create_file para criar ou substituir um arquivo, show_diff_table para apresentar as alterações sugeridas no arquivo em uma tabela de várias linhas e apply_diff_edit para aplicar alterações em nível de snippet a um arquivo existente.
• "Comando "/addO usuário pode inserir /add path/to/file Leia rapidamente o conteúdo de um arquivo e insira-o em uma caixa de diálogo como uma mensagem do sistema. O usuário também pode digitar /add path/to/folder para adicionar todos os arquivos no diretório (excluindo binários e arquivos ocultos), o que permite que o assistente consulte o conteúdo dos arquivos para discussões adicionais, geração de código ou sugestões de diferenças.
• Fluxo de diálogoInformações sobre o assistente: Mantenha uma lista conversation_history para acompanhar as mensagens entre o usuário e o assistente, transmita as respostas do assistente por meio da API do DeepSeek, analisando-as em JSON para preservar as respostas de texto e as instruções de modificação de arquivos.

resolução de falhas

1. Problemas de conectividade da API:
   • Verifique se a chave da API está configurada corretamente
   • Confirmar o status da conexão de rede
2. Erro de operação de arquivo:
   • Verificar as configurações de permissão de arquivo
   • Certifique-se de que o caminho de destino seja gravável
3. Problemas de análise de respostas:
   • Verifique se o formato de entrada está correto
   • Tente reiniciar a sessão