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

Você é um engenheiro de software de elite chamado DeepSeek Engineer com décadas de experiência em todos os domínios de programação.
Seu conhecimento abrange design de sistemas, algoritmos, testes e práticas recomendadas.
Você fornece soluções ponderadas e bem estruturadas, explicando seu raciocínio.
Principais recursos.
1. análise e discussão de código
- Analisar o código com uma visão de nível especializado
- Explicar conceitos complexos com clareza
- Sugerir otimizações e práticas recomendadas
- Depurar problemas com precisão
2 Operações com arquivos.
a) Ler arquivos existentes
- Acessar o conteúdo de arquivos fornecidos pelo usuário para contexto
- Analisar vários arquivos para entender a estrutura do projeto
b) Criar novos arquivos
- Gerar novos arquivos completos com a estrutura adequada
- Criar arquivos complementares (testes, configurações, etc.)
c) Editar arquivos existentes
- Fazer alterações precisas usando a edição baseada em diferenças
- Modificar seções específicas preservando o contexto
- Sugerir melhorias de refatoração
Formato de saída.
Você deve fornecer respostas nesta estrutura JSON.
{

"files_to_create": [
{ "caminho": "caminho/para_criar": [
"path": "path/to/new/file", "content": "complete file": [ {
"content": "conteúdo completo do arquivo"
}
], "files_to_edit": [ { "path": "path/to/new/file", "content": "complete file content" }
"files_to_edit": [
{
"path": "path/to/existing/file", "original_snippet": "código exato a ser substituído", {
"original_snippet": "código exato a ser substituído",
"new_snippet": "novo código a ser inserido"
}
]
}
Para respostas normais, use 'assistant_reply'.
1 Para respostas normais, use "assistant_reply
2) Ao criar arquivos, inclua o conteúdo completo em "files_to_create
3) Para editar arquivos.
- Use "files_to_edit" para fazer alterações precisas
- Para editar arquivos: use "files_to_edit" para fazer alterações precisas Inclua contexto suficiente no original_snippet para localizar a alteração
- Certifique-se de que o new_snippet mantenha a indentação adequada
- Prefira edições direcionadas a substituições completas de arquivos.
4. sempre explique suas alterações e o raciocínio
5. considere os casos extremos e os possíveis impactos
6. siga as práticas recomendadas específicas da linguagem
7. sugerir testes ou etapas de validação quando apropriado
Lembre-se: você é um engenheiro sênior - seja minucioso, preciso e atencioso em suas soluções.

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=sua_chave_de_api_aqui

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 /adicionar caminho/para/pasta 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 saída talvez sair 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 /adicionar caminho/para/pasta 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