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 de 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.
{
"assistant_reply": "Sua principal explicação ou resposta", "files_to_create": [
"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"
}
]
}

Diretrizes.
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 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

3.1 Diálogo básico

• Depois de iniciar o programa, você pode inserir perguntas ou solicitações relacionadas à programação diretamente no terminal
• O sistema o processará por meio da API do DeepSeek e retornará uma resposta estruturada
• Suporta saída de streaming de várias linhas para uma interação mais suave

3.2 Operações de documentos

1. Importar o conteúdo do arquivo:
   • fazer uso de/add path/to/fileadiciona o conteúdo do arquivo à caixa de diálogo
   • Exemplo:/add src/main.pyimportará o conteúdo do main.py para o contexto de diálogo
2. Criação e edição de arquivos:
   • Quando o assistente sugere a criação de um novo arquivo ou a edição de um arquivo existente, são exibidas sugestões de alteração detalhadas
   • O sistema exibe uma tabela de diferenças em rich text que mostra claramente as alterações propostas
   • Você pode optar por confirmar ou rejeitar essas alterações

3.3 Gerenciamento de diálogo

• O sistema mantém automaticamente o histórico da conversa para garantir a coerência contextual
• Encerre a sessão com o comando "exit" ou "quit".

4. recomendações de melhores práticas

1. Operações de arquivo:
   • Verifique se o caminho do arquivo está correto antes de importar o arquivo
   • Recomenda-se fazer backups antes de modificar arquivos importantes
2. Otimização do diálogo:
   • Mantenha as perguntas claras e específicas
   • Use o comando /add para complementar as informações contextuais quando apropriado
   • Analise cuidadosamente as alterações antes de confirmar as alterações no documento
3. Ganhos de eficiência:
   • Aproveite o recurso de saída estruturada JSON do sistema
   • Faça bom uso da função de exibição de diferenças de arquivos
   • Mantenha as conversas simples, limpando seu histórico de diálogos quando apropriado

5 Solução de problemas

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