Memórias de Cursor: fornece memória de contexto persistente para Cursores.

O Cursor Memories é um projeto de código aberto hospedado no GitHub que tem como objetivo fornecer memória de contexto persistente para o editor de código de IA Cursor. Ele ajuda os assistentes de IA a reter informações do projeto em todas as sessões por meio de documentos estruturados, resolvendo o problema de a IA esquecer o contexto após cada sessão. Os usuários podem gerenciar o histórico do projeto, os detalhes técnicos e o progresso por meio de arquivos Markdown simples, permitindo que a IA recupere rapidamente o contexto e melhore a eficiência do desenvolvimento. O projeto é mantido pelo desenvolvedor da comunidade carlxrosales e é adequado para desenvolvedores que precisam de gerenciamento de projetos de longo prazo.

Lista de funções

• memória de contexto persistenteArmazenamento de informações do projeto em arquivos Markdown: o armazenamento de informações do projeto em arquivos Markdown garante que a IA leia e restaure o contexto no início de cada sessão.
• Gerenciamento de documentos estruturadosSuporte a uma ampla variedade de tipos de documentos, como resumos de projetos, contextos técnicos e notas de progresso, de forma claramente organizada.
• Suporte ao modo personalizadoCombinado com o esquema personalizável do Cursor, ele fornece fluxos de trabalho para as fases de planejamento, implementação e reflexão.
• Otimização eficiente de tokensAdoção de uma regra de carregamento hierárquico que carrega apenas os documentos necessários para reduzir o consumo de tokens para o processamento de IA.
• Colaboração entre sessõesMelhorar a colaboração de IA mantendo a consistência entre as fases de desenvolvimento com os arquivos do Banco de Memória.
• Suporte à comunidade de código abertoO código do projeto está disponível publicamente, permitindo que os usuários contribuam e personalizem os recursos.

Usando a Ajuda

Processo de instalação

1. armazém de clones
   Execute o seguinte comando no terminal para clonar o projeto Cursor Memories localmente:

   git clone https://github.com/carlxrosales/cursor-memories.git
   

   Quando a clonagem estiver concluída, vá para o diretório do projeto:

   cd cursor-memories
   

2. Cópia de arquivos de configuração
   O projeto contém .cursor responder cantando custom_modes pasta. Copie-a para o diretório raiz de seu projeto Cursor:

   cp -r .cursor /path/to/your/project
   cp -r custom_modes /path/to/your/project
   

   Observação: Outros documentos (por exemplo, arquivos de descrição) podem, opcionalmente, ser copiados para o arquivo memory_bank_documents para referência, mas não é obrigatório.

3. Configuração de modos personalizados
   Crie modos personalizados manualmente no Cursor Editor:
   • Abra o Cursor e clique no Seletor de modo no painel de bate-papo.
   • Crie o seguinte padrão (é recomendável usar o emoji correspondente para aumentar o reconhecimento):
     • 🔍 VAN (análise da visão)
     • 📋 PLAN (planejamento)
     • 🎨 CRIATIVO
     • ⚒️ IMPLEMENT (implementação)
     • 📝 REFLECT (Refletir)
     • 🗄️ ARCHIVE
   • Em cada modo, cole custom_modes O conteúdo das instruções para o arquivo correspondente na pasta. Por exemplo, para definir o van_instructions.md para a caixa de entrada do comando personalizado no modo VAN.
   • Selecione um dos ícones fornecidos pelo Cursor para salvar as configurações.
4. Inicialização do banco de memória
   Execute o seguinte comando no diretório raiz do projeto para inicializar o banco de memória:

   npx cursor-bank init
   

   Isso criará o memory_bank contendo os arquivos Markdown necessários, como projectbrief.mdetechContext.md responder cantando progress.md.

Uso

Operação da função principal

• Ler banco de memória
  No painel de bate-papo do cursor, digite os comandos:

  follow your custom instructions
  

  O Cursor lê automaticamente o memory_bank Arquivo Markdown na pasta para restaurar o contexto do projeto. Recomenda-se executar esse comando no início de cada nova sessão.

• Atualizar banco de memória
  Inserido após a conclusão de uma fase importante de desenvolvimento ou atualização do projeto:

  update memory bank
  

  O cursor irá revisar e atualizar memory_bank Arquivos na pasta, por exemplo, atualização progress.md Últimos desenvolvimentos ou modificações na implementação da Convenção techContext.md Informações sobre a pilha de tecnologia no

• Modelo de planejamento (PLAN)
  Entre no modo de planejamento:

  /plan
  

  O Cursor analisa o código existente e os arquivos do Memory Bank e faz de 4 a 6 perguntas de esclarecimento. Por exemplo, "Qual é a prioridade que você deseja que a nova funcionalidade tenha?" ou "Você precisa ajustar a estrutura da API existente? ou "Você precisa ajustar a estrutura da API existente?". Após a resposta do usuário, o Cursor cria um plano detalhado a ser implementado assim que o usuário confirmar.

• Modalidades de implementação (IMPLEMENT)
  Após a confirmação do planejamento, ele entra no modo de implementação, no qual o Cursor gera código ou modifica arquivos de acordo com o plano. Após a conclusão, ele informa o status da conclusão e lista as próximas etapas.

Procedimento de operação detalhado

1. Lançamento de novos projetos
   • estar em movimento npx cursor-bank init Cria a estrutura do banco de memória.
   • compilador projectbrief.mdInsira os objetivos e o contexto do projeto. Exemplo:

     # Project Brief
     项目名称：在线任务管理工具
     目标：开发一个支持多人协作的任务管理 Web 应用
     技术栈：React, Node.js, MongoDB
     

   • existir techContext.md Documentar detalhes técnicos, como a estrutura da API ou a versão da estrutura, no
2. Desenvolvimento diário
   • No início de cada sessão, digite follow your custom instructions.
   • Selecione o modo de acordo com a fase de desenvolvimento. Por exemplo, use o modo CREATIVE para gerar um rascunho do design da interface do usuário ou o modo IMPLEMENT para escrever o código de back-end.
   • atualização regular progress.mdSe o usuário for membro da API de autenticação de usuário, você poderá registrar o marco de conclusão, como "Conclusão da API de autenticação de usuário".
3. Otimizar o gerenciamento de contexto
   • Use o recurso Hierarchical Rule Loading para carregar apenas os documentos relevantes para a tarefa atual. Por exemplo, o modo PLAN carrega apenas projectbrief.md responder cantando techContext.md.
   • Em projetos complexos, adicionar activeContext.md Registre o status do trabalho atual, por exemplo, "Módulo de pagamento em desenvolvimento".

Operação da função em destaque

• Gráficos de fluxos de trabalho
  O Cursor Memories oferece suporte a fluxos de trabalho gráficos, em que os esquemas são conectados em uma ordem lógica (VAN → PLAN → CREATIVE → IMPLEMENT). O usuário pode criar um fluxo de trabalho diagramático no progress.md O modo de gravação é ativado. Exemplo:

  # Progress
  2025-07-20: 完成 PLAN 阶段，进入 CREATIVE 模式设计 UI。
  

  No Cursor, digite follow your custom instructionsA IA ajusta seu comportamento de acordo com os registros.

• Compartilhamento de memórias entre modalidades
  Os arquivos do banco de memória são compartilhados entre os modos. Por exemplo, os requisitos registrados no modo PLAN influenciam automaticamente as sugestões de código no modo IMPLEMENT. O usuário não precisa inserir o contexto novamente.
• Função de controle de qualidade
  Em qualquer modo, chame a função QA integrada para verificar o código. Exemplo:

  Run QA on auth module
  

  O cursor verifica a consistência do código e relata possíveis problemas.

advertência

• seguro memory_bank Os arquivos Markdown na pasta são claros e precisos, e a eficácia da IA depende da qualidade do documento.
• Faça backup dos arquivos do Memory Bank regularmente para evitar perdas acidentais.
• Se o projeto for complexo, recomenda-se que ele seja dividido techContext.md para vários arquivos, como apiContext.md responder cantando uiContext.md.

cenário do aplicativo

1. Desenvolvimento de projetos de longo prazo
   Os desenvolvedores usam as Cursor Memories para manter o contexto da IA consistente em grandes projetos que abrangem várias sessões. Por exemplo, ao desenvolver um aplicativo da Web, a IA se lembra da pilha de tecnologia e do design da API para evitar a duplicação de instruções.
2. Trabalho em equipe
   Os membros da equipe compartilham arquivos do Memory Bank para garantir que a IA tenha uma compreensão consistente do contexto do projeto. Um Memory Bank documentado também serve como um registro do projeto, facilitando a rápida atualização dos novos membros da equipe.
3. Prototipagem rápida
   No modo CREATIVE, os designers ou desenvolvedores geram rapidamente rascunhos de UI ou protótipos funcionais, e o Memory Bank registra as decisões de design para o modo IMPLEMENT subsequente.

QA

1. A pasta Memory Bank precisa ser criada manualmente?
   Não é necessário. Executar npx cursor-bank init criará automaticamente memory_bank e os arquivos necessários. Se for criado manualmente, verifique se a estrutura do arquivo é consistente com o modelo do projeto.
2. Como você lida com a perda de contexto?
   No início de cada sessão, digite follow your custom instructionsSe o arquivo do banco de memória estiver faltando, certifique-se de que o Cursor leia o arquivo do banco de memória. Se ele ainda estiver faltando, verifique o .cursor/rules O caminho de configuração no
3. Há suporte para outras ferramentas de IA?
   Sim, o Memory Bank é um método de gerenciamento de documentos de uso geral que funciona com qualquer assistente de IA compatível com a leitura de arquivos Markdown, sujeito ao ajuste do formato do comando.
4. Como otimizar o consumo de tokens?
   Use o recurso de carregamento em camadas para carregar apenas os arquivos relevantes para a tarefa atual. Evite carregar arquivos na seção activeContext.md Armazene informações confidenciais ou longas no