Notas

Notas são registros externos pesquisáveis para conhecimento do projeto. Cada Nota tem título e corpo e também pode conter tags e referências de assets.

Escolher Compartilhado ou Privado

Escopo	Armazenamento	Comportamento do controle de código-fonte
Compartilhado	`<Project>/ProjectNotes/`	Usa o provedor ativo de controle de código-fonte do Unreal quando disponível
Privado	`<Project>/Saved/Locus/PrivateNotes/`	Nunca consulta ou altera o provedor

O escopo é determinado pela raiz de armazenamento. O Locus não converte uma Nota existente entre Compartilhado e Privado.

Criar e organizar Notas

Use Nova Nota ou Ctrl+N e escolha um escopo. O Locus cria um título padrão exclusivo, salva a Nota e inicia a edição do título. Use Nova pasta ou Ctrl+Shift+N para organizar a árvore.

Pastas são uma camada lógica de organização dentro de um escopo. Excluir uma pasta exige confirmação e move suas Notas e pastas filhas para a pasta pai, em vez de excluir as Notas. Arraste Notas ou pastas para reorganizá-las no mesmo escopo. Isso altera a atribuição de pasta da Nota, não o arquivo armazenado; portanto, a organização normal de Notas não exige uma movimentação de arquivo no controle de código-fonte. Pressione F2 para renomear um item selecionado e Ctrl+D para duplicar uma Nota selecionada.

Locus filtra Notas para Privado na primeira vez que abre para um projeto. Um clique normal seleciona uma linha; Ctrl/Shift-click estende a seleção. A barra de ferramentas do Nota permanece em uma linha, movendo Inserir Referência, escopo e ações de criação progressivamente para o menu de reticências em larguras estreitas.

Espaço de trabalho Notas do Locus com hierarquia de pastas, contexto Compartilhado e uma Nota ativa — Notas organizam o conhecimento do projeto por pasta e escopo enquanto a Nota selecionada permanece visível para edição.

Editar e salvar

Selecione uma Nota para editar seu título, corpo, tags e referências de assets. O Locus salva após um pequeno atraso de edição. Pressione Ctrl+S para gravar imediatamente as alterações pendentes ou tentar novamente um salvamento que falhou.

A apresentação padrão Legível exibe referências de assets como rótulos. A apresentação Fonte mostra a forma dos tokens escritos. Altere o padrão, o tamanho da fonte e a quebra de linha em Configurações.

Encontrar Notas

A pesquisa de texto corresponde a títulos, corpos, tags, rótulos de assets e caminhos de objetos de assets. Combine-a com filtros de escopo, tag ou asset selecionado. Várias tags selecionadas usam correspondência AND e a correspondência de tags não diferencia maiúsculas de minúsculas.

Use a ação de contexto do Content Browser Mostrar Notas de Projeto Relacionadas para filtrar pelo asset selecionado. Criar Nota de Projeto cria uma Nota Compartilhada ou Privada associada ao contexto do Content Browser.

Referências ricas

Use Inserir Referência para procurar um Ativo, Pin, Nota ou Documento. Você também pode digitar @ onde houver suporte ou arrastar um item Locus compatível ou ativo Content Browser para um texto editável. Os ativos são localizados ou abertos no Editor, os Notas são selecionados na área de trabalho dos Notas, os Documentos são abertos em uma guia do Editor Documento e os Pins usam a navegação normal.

Para criar uma referência Actor, arraste exatamente um Actor elegível carregado do World Outliner para um Nota editável. A identidade usa o mundo raiz salvo e o GUID Actor, não seu rótulo. Actors não são oferecidos por Inserir Referência ou @; referências ausentes ou malformadas permanecem visíveis para diagnóstico.

Notas compartilhados não podem fazer referência recentemente a Notas privados ou Pins privados. Notas privados podem fazer referência a conteúdo compartilhado ou privado.

Recuperação e alterações externas

Snapshots de recuperação são armazenados separadamente da Nota autoritativa:

recuperação Compartilhada: <Project>/Saved/ProjectNotes/Recovery/
recuperação Privada: <Project>/Saved/Locus/Recovery/PrivateNotes/

Quando houver uma recuperação disponível, revise-a antes de escolher Restaurar, Restaurar como Nova Nota ou Descartar. Se um arquivo mudar fora do Locus enquanto você tiver edições não salvas, o Locus bloqueia a substituição silenciosa e oferece ações seguras, como recarregar do disco, salvar o texto local como uma nova Nota, copiar o texto local ou comparar as duas versões. Uma Nota sem alterações locais que mudou externamente é atualizada do disco.

Excluir Notas

Excluir Notas selecionadas exige confirmação e remove permanentemente seus arquivos externos; o sistema de desfazer do Unreal não consegue restaurá-los. Quando o controle de código-fonte está ativo, o Locus recusa estados de exclusão inseguros, como checkout de outro usuário, arquivo desatualizado ou estado que não pode verificar.

Controle de código-fonte e Modo Local

Notas Privadas permanecem sempre neutras em relação ao provedor. Selecionar, abrir ou ler uma Nota Compartilhada limpa e controlada não faz checkout. Ela permanece somente leitura até você usar Check Out; um checkout bem-sucedido permite a edição, enquanto uma falha mantém a Nota protegida sem um bypass para torná-la gravável.

Uma nova Nota Compartilhada é gravada primeiro localmente e depois solicita Marcar para Adição; se a operação do provedor falhar, o arquivo local válido permanece e a ação pode ser tentada novamente.

Sem um provedor ativo, Notas Compartilhadas novas ou não rastreadas continuam editáveis no Modo Local. Uma Nota já controlada pelo depot permanece protegida até que o provedor seja restaurado e ela receba Check Out explicitamente. O Locus não envia, sincroniza, gerencia changelists nem altera typemaps do repositório. Consulte Controle de Código-Fonte e Solução de problemas.

Sem nenhum provedor configurado, Notas não mostra nenhum status de controle de origem, dica de ferramenta, orientação ou ação. Com um provedor configurado, o Mostrar Status do Controle de Código-Fonte controla apenas indicadores de linha compactos sem alterar o feedback de segurança necessário ou a elegibilidade de ação.

Limitações atuais

A organização da Nota permanece no escopo Compartilhado ou Privado existente.
Referências de assets não carregam assets apenas para listar ou pesquisar Notas.
O suporte ao controle de código-fonte é limitado pelo provedor ativo do Unreal e pelo estado do arquivo informado por ele.

A criação de Actor é limitada a um World Outliner Actor carregado elegível colocado em um Nota editável. Listar ou pesquisar referências não carrega ativos, níveis ou Actors.