Cursor É uma coisa boa, mas coisas boas podem dar errado de todas as formas. Se uma conversa (seja no Chat ou no Composer) der errado, muitas vezes isso pode ser resolvido abrindo outra estação de acoplamento, mas o contexto é perdido. Podemos tentar corrigir isso introduzindo a preparação de conteúdo externo como um segundo cérebro para o Cursor. Saiba como usar um notebook para compartilhar o contexto entre o editor e o chat.
Blocos de notas no Cursor
O cursor tem uma função padrão que não é ativada pelos blocos de notas; podemos ativá-la da seguinte forma
Ao abri-lo, você verá a barra de menu do NOTEPADS no lado esquerdo.
Visão geral (laptop atualmente em versão beta)
O bloco de notas é uma ferramenta avançada de compartilhamento de contexto no Cursor que preenche a lacuna entre as interações do editor e do bate-papo. Pense nela como uma ferramenta que vai além do .cursorrules Documentação de referência aprimorada para recursos que o ajudam a criar contexto reutilizável para seu fluxo de trabalho de desenvolvimento.
Os notebooks podem ser usados como uma coleção de ideias, regras e documentos com os seguintes recursos:
- Pode ser compartilhado entre diferentes partes do ambiente de desenvolvimento
- fazer uso de
@citação gramatical - Suporte para anexos de arquivos
- Modelos dinâmicos para vários cenários de desenvolvimento
Primeiros passos
- Clique no botão "+" na seção Notebook.
- Dê um nome significativo ao seu laptop
- Adicione conteúdo, contexto, arquivos e outras informações relevantes da mesma forma que faria em um editor ou bate-papo
- Use no editor ou no bate-papo
@Cite-o.
função-chave
- compartilhamento de contextoCompartilhamento contínuo de contexto entre o editor e o bate-papo
- Anexo ao documentoDocumentação e referências adicionais (
.cursorrules(não realizável) - referência dinâmica: Uso
@Mencione links para outros recursos - Conteúdo flexívelEscrever e organizar informações de forma a atender às suas necessidades
Cenários de uso comuns
- Geração de modelos dinâmicos
- Criar modelos para padrões de código comuns
- Armazenar regras de estrutura específicas do projeto
- Estrutura de código consistente em toda a equipe
- Documentação de arquitetura
- Especificação de front-end
- padrões de design de back-end
- Documentação do modelo de dados
- Guia de arquitetura do sistema
- Guia de desenvolvimento
- padrão de codificação
- Regras específicas do projeto
- melhores práticas
- Acordos de equipe
problemas comuns
O que devo escrever em meu caderno?
Os laptops são perfeitos para isso:
- Decisões sobre a arquitetura do projeto
- Diretrizes e padrões de desenvolvimento
- Modelos de código reutilizáveis
- Documentos que precisam ser consultados com frequência
- Convenções e regras específicas da equipe
O que não é apropriado escrever em um caderno?
Evite fazer anotações em seu caderno:
- Notas ou rascunhos provisórios
- Informações que fazem parte do controle de versão (por exemplo, git)
- Dados ou comprovantes confidenciais
- Informações altamente dinâmicas que mudam com frequência
Preciso seguir um formato ou uma estrutura específica?
Embora o laptop seja muito flexível, recomendamos:
- Use títulos e parágrafos claros
- Inclua exemplos quando for relevante
- Manter o conteúdo focado e organizado
- Use a formatação Markdown para melhorar a legibilidade
- Anexação de documentos relevantes, se necessário
Exemplo de caderno de anotações
A seguir, um exemplo de um notebook para um projeto típico de aplicativo da Web:
Exemplo de notebook
Guia de desenvolvimento da API do #
Estrutura da interface ##
- Usando convenções RESTful
- URL base: `/api/v1
- Nomeação de recursos na forma plural
Autenticação do ##
- Autenticação baseada em JWT
Autenticação baseada em JWT Token Formato: Portador {token}
- Necessidade de atualizar o mecanismo de token
## Formato da resposta.
{
"status": "sucesso|erro",
"message": "Optional Message" (Mensagem opcional)
}
## Referência do anexo
@api-specs.yaml
@auth-flow.md
