Plandex: um assistente de codificação de IA de código aberto com suporte para contextos ultralongos

Introdução geral

O Plandex é um assistente de codificação de IA de código aberto de ponta a ponta, projetado para projetos de software grandes e complexos. Ele pode planejar e executar tarefas de várias etapas e lidar com até dois milhões de token O Plandex oferece um ambiente de sandbox para isolar as alterações de código geradas por IA que os desenvolvedores podem revisar antes de aplicar para garantir a segurança do projeto. Ele é compatível com OpenAI, Anthropic, Google e muitos outros modelos, permitindo que os usuários alternem com flexibilidade para otimizar o desempenho e o custo. O Plandex oferece modos totalmente automatizados e controle refinado, adequados para desenvolvedores iniciantes e profissionais. É fácil de instalar, oferece suporte à integração e ao controle de versão do Git e é adequado para o desenvolvimento individual e em equipe. O Plandex oferece hospedagem na nuvem e opções de implementação local para atender a diferentes necessidades.

Lista de funções

• Gerenciamento de projetos em larga escalaSuporte a 2 milhões de contextos de tokens e diretórios indexados de até 20 milhões de tokens, adequados para bases de código muito grandes.
• Suporte a vários modelosIntegração de modelos da OpenAI, Anthropic, Google, etc., permitindo a troca para otimizar o desempenho e o custo.
• Análise do SandboxAlterações de código geradas por IA são armazenadas em uma área restrita onde os desenvolvedores podem analisá-las arquivo por arquivo antes de aplicá-las, evitando modificações diretas no projeto.
• depuração de automaçãoDetecta e corrige automaticamente erros de comando do terminal, oferece suporte a compilação, teste e implantação e é compatível com a depuração de aplicativos do navegador (requer o Chrome).
• Geração do mapa do projetoGeração rápida de mapas de projetos com suporte a tree-sitter em mais de 30 idiomas e verificação da precisão sintática.
• controle de versãoSuporte para gerenciamento de ramificações, exploração de vários caminhos de implementação e integração com o Git para geração automática de mensagens de confirmação.
• Flexibilidade e autonomiaModo totalmente automático ou controle passo a passo está disponível para acomodar diferentes complexidades de tarefas e preferências do desenvolvedor.
• gerenciamento de contexto (computação)Carregamento de arquivos ou diretórios com precisão por meio do terminal, atualizando automaticamente o contexto e garantindo que o modelo receba o código mais recente.
• Modelo de interação REPLSuporte para interação de linha de comando com preenchimento automático difuso para carregamento rápido de arquivos e execução de tarefas.
• Implementação localizadaSuporte à implantação do Docker de servidores locais, protege a privacidade dos dados e é adequado para necessidades de auto-hospedagem.
• Modo de bate-papoChat: um recurso de bate-papo com reconhecimento de projeto adequado para discutir códigos, aprender sobre tecnologia ou planejar tarefas.

Usando a Ajuda

Processo de instalação

O Plandex oferece um método de instalação simples e é compatível com Mac, Linux, FreeBSD e Windows (via WSL). Veja a seguir as etapas detalhadas:

1. Instalação da CLI::
   • Execute o comando de instalação com um clique sem dependências adicionais:

     curl -sL https://plandex.ai/install.sh | bash
     

   • Após a instalação, oplandex talvez pdx está disponível.
   • Verificar a instalação: Executar plandex --versionVerifique o número da versão.
2. Servidor de implantação local (opcional)::
   • O Git, o Docker e o Docker Compose precisam ser instalados.
   • Clone o repositório e inicie o servidor:

     git clone https://github.com/plandex-ai/plandex.git
     cd plandex/app
     ./start_local.sh
     

   • Executando em um novo terminal plandex sign-inSe estiver usando a opção "Local mode host", selecione "Local mode host" (padrão). http://localhost:8099).
   • Defina a chave da API:

     export OPENROUTER_API_KEY=<your-openrouter-api-key>
     export OPENAI_API_KEY=<your-openai-api-key>
     

3. Usuário do Windows::
   • Só é compatível com o ambiente WSL; você precisa executar comandos no terminal WSL; o Windows CMD ou o PowerShell não são compatíveis.
4. Opções de hospedagem na nuvem::
   • Plandex Cloud (modelo integrado)Não é necessária uma chave de API, é compatível com vários dispositivos, inclui um crédito mensal de US$ 20 e é excelente para começar a usar rapidamente.
   • Plandex Cloud (vem com uma chave de API)Usando OpenAI e OpenRouter para usuários com contas existentes.
   • Acesse https://app.plandex.ai/start para se registrar e começar.

Uso

O Plandex opera por meio de comandos de terminal e as funções principais incluem planejamento de tarefas, geração de código, revisão e depuração. Veja abaixo o processo detalhado:

Projeto de inicialização

• Vá para o catálogo de projetos:

  cd your-project-dir
  

• (Opcional) Inicialize seu repositório Git:

  git init
  

• Inicie o REPL do Plandex:

  plandex
  

  ou usar um comando curto:

  pdx
  

Modo de bate-papo

• Padrão para o modo de bate-papo, adequado para discutir projetos ou aprender sobre a base de código:

  \chat 探索现有代码库中的认证逻辑
  

• O Plandex analisa o contexto e responde a perguntas, e os desenvolvedores podem esclarecer as tarefas passo a passo.

Criar um plano

• Mude para o modo contar para criar um plano:

  \tell 添加用户认证功能，包括登录和注册
  

• O Plandex gera um plano detalhado, listando as etapas e os documentos necessários, solicitando ao usuário a confirmação ou o ajuste.

Carregando o contexto

• Adiciona um arquivo ou diretório ao contexto:

  plandex load path/to/file
  plandex load path/to/directory
  

• O Plandex atualiza automaticamente o contexto para garantir que o modelo esteja usando o código mais recente.

Revisão das mudanças

• Visualizar as alterações de código geradas pela IA:

  plandex changes
  

• A visualização de diferenças na interface do usuário do terminal oferece suporte à revisão de documento por documento. Aceita alterações:

  plandex apply
  

• Ele pode ser modificado manualmente e recarregado após a rejeição.

depuração de automação

• Executar comandos de terminal (como construir ou testar):

  plandex run npm test
  

• Se o comando falhar, o Plandex analisará o erro e gerará uma recomendação de correção. O Chrome é necessário para a depuração do navegador:

  plandex run --browser
  

controle de versão

• Crie ramificações para experimentar diferentes implementações:

  plandex branch feature-auth
  

• Retornar a um estado anterior:

  plandex rewind
  

• Confirmar as alterações no Git:

  plandex commit
  

• O Plandex gera automaticamente as informações de envio.

Modelos de comutação

• Altere o modelo para otimizar o desempenho ou o custo:

  plandex --model gemini-exp
  

• ou no modo REPL:

  \set-model deepseek-v3
  

Operação da função em destaque

1. Suporte a projetos em larga escala::
   • O Plandex usa o tree-sitter para analisar a estrutura do código e gerar um mapa do projeto. Executar plandex Indexa automaticamente os projetos e oferece suporte a mais de 30 linguagens, como Python, JavaScript, Go e outras.
   • Exemplo: o Plandex carrega arquivos sob demanda para reduzir o consumo de tokens ao processar uma base de código de 2 milhões de tokens.
2. Análise do Sandbox::
   • As alterações são armazenadas na área restrita, execute plandex changes Visualizar discrepâncias. Oferece suporte à revisão linha por linha para evitar que códigos errôneos entrem no projeto.
   • Exemplo: depois de gerar 50 alterações de arquivo, você pode verificar cada uma delas na interface do usuário para garantir que a lógica e a sintaxe estejam corretas.
3. depuração de automação::
   • Ao executar comandos de teste, o Plandex captura os erros e gera sugestões para corrigi-los. Por exemplo:

     plandex run pytest
     

   • Suporte à depuração do navegador para que o Chrome analise automaticamente os erros de front-end.
4. Otimização de vários modelos::
   • Trocar modelos de baixo custo (por exemplo, DeepSeek):

     \set-model deepseek-v3
     

   • A troca de modelos sem perda de contexto é adequada para tarefas de longo prazo.
5. Modo de bate-papo::
   • Para explorar uma base de código ou aprender técnicas. Exemplo:

     \chat 解释项目中的 OAuth 实现
     

   • O Plandex fornece respostas detalhadas com exemplos de código.

advertência

• Chave da APIOpenAI e OpenRouter precisam ser configurados para o modo de nuvem (com chave própria) ou implantação local.
• gerenciamento de custosAtivar o cache de contexto (OpenAI e Anthropic são compatíveis por padrão), selecionar modelos de baixo custo e carregar o contexto exatamente para reduzir os custos.
• Suporte à comunidadeEntre no Discord (https://discord.gg/plandex-ai) ou no GitHub Discussions (https://github.com/plandex-ai/plandex/discussions) para obter ajuda.

cenário do aplicativo

1. Manutenção de uma grande base de código
   Como os desenvolvedores mantêm uma base de código de mais de 2 milhões de tokens, o Plandex indexa rapidamente os projetos e gera mapas de projetos. Os usuários podem carregar módulos, gerar novos recursos ou corrigir bugs, e as revisões de sandbox garantem a segurança do código.
2. Prototipagem rápida de novos projetos
   Quando as equipes de startups desenvolvem aplicativos, o Plandex planeja APIs REST, modelos de banco de dados e outros recursos. O modo totalmente automatizado acelera a criação de protótipos e o gerenciamento de ramificações oferece suporte a várias tentativas de arquitetura.
3. Aprendizado em toda a pilha de tecnologia
   Quando os desenvolvedores estão aprendendo uma nova linguagem, como o Rust, o modo de bate-papo do Plandex responde a perguntas e gera exemplos de código para ajudar a começar rapidamente.
4. Geração automatizada de testes
   Ao adicionar testes a um projeto, o Plandex analisa o código e gera testes unitários. As revisões de sandbox garantem a cobertura e a depuração automatizada corrige casos de uso com falhas.

QA

1. Quais linguagens de programação são compatíveis com o Plandex?
   O Plandex usa o suporte de "tree-sitter" para mais de 30 linguagens, incluindo Python, JavaScript, Go, Java, C++ e outras, e a geração de mapas de projetos para garantir a precisão sintática.
2. Como posso reduzir o custo de uso?
   Ative o cache de contexto, escolha um modelo de baixo custo (por exemplo, DeepSeek) e carregue os arquivos de contexto com precisão para reduzir o consumo de tokens.
3. É possível executar o Plandex localmente?
   Sim, o Docker é compatível com a implantação de servidores locais, usando chaves OpenAI e OpenRouter, e os dados não são carregados na nuvem para proteger a privacidade.
4. Qual é a diferença entre o Plandex e outras ferramentas de codificação de IA?
   O Plandex é especializado em projetos de grande porte, suporta 2 milhões de contextos de token, oferece revisão em área restrita e depuração automatizada e supera as ferramentas que fornecem apenas o recurso de autocompletar código.