Notes

Les Notes sont des enregistrements externes consultables pour les connaissances du projet. Chaque Note possède un titre et un corps, et peut également contenir des tags et des références d’assets.

Choisir Partagé ou Privé

Scope	Stockage	Comportement du contrôle de source
Partagé	`<Project>/ProjectNotes/`	Utilise le fournisseur Unreal actif lorsqu’il est disponible
Privé	`<Project>/Saved/Locus/PrivateNotes/`	Ne consulte ni ne modifie jamais le fournisseur

Le scope est déterminé par la racine de stockage. Locus ne convertit pas une Note existante entre Partagé et Privé.

Créer et organiser des Notes

Utilisez Nouvelle note ou Ctrl+N et choisissez un scope. Locus crée un titre par défaut unique, enregistre la Note et commence l’édition du titre. Utilisez Nouveau dossier ou Ctrl+Shift+N pour organiser l’arborescence.

Les dossiers sont une couche d’organisation logique dans un scope. Supprimer un dossier demande confirmation et déplace ses Notes et ses sous-dossiers vers le parent au lieu de supprimer les Notes. Faites glisser des Notes ou des dossiers pour les réorganiser dans le même scope. Cela change l’affectation du dossier de la Note plutôt que son fichier stocké ; l’organisation normale des Notes ne nécessite donc pas de déplacement de fichier dans le contrôle de source. Appuyez sur F2 pour renommer un élément sélectionné et sur Ctrl+D pour dupliquer une Note sélectionnée.

Locus filtre les Note en Privé lors de sa première ouverture pour un projet. Un clic normal sélectionne une ligne ; Ctrl/Shift-click étend la sélection. La barre d’outils Notes reste sur une ligne, déplaçant progressivement les actions Insérer la référence, la portée, puis la création dans le menu points de suspension sur des largeurs étroites.

Espace de travail Notes Locus avec hiérarchie de dossiers, contexte de scope Partagé et Note active — Les Notes organisent les connaissances du projet par dossier et par scope tandis que la Note sélectionnée reste visible pour l’édition.

Modifier et enregistrer

Sélectionnez une Note pour modifier son titre, son corps, ses tags et ses références d’assets. Locus enregistre après un court délai d’édition. Appuyez sur Ctrl+S pour écrire immédiatement les changements en attente ou réessayer un enregistrement qui a échoué.

La présentation Lisible par défaut affiche les références d’assets comme des libellés. La présentation Source expose la forme des tokens écrits. Modifiez la valeur par défaut, la taille de police et le retour à la ligne dans Paramètres.

Rechercher des Notes

La recherche textuelle correspond aux titres, corps, tags, libellés d’assets et chemins d’objets d’assets. Combinez-la avec des filtres de scope, de tag ou d’asset sélectionné. Plusieurs tags sélectionnés utilisent une correspondance AND et la correspondance des tags ne tient pas compte de la casse.

Utilisez l’action contextuelle du Content Browser Afficher les Notes de projet associées pour filtrer l’asset sélectionné. Créer une Note de projet crée une Note Partagée ou Privée associée au contexte du Content Browser.

De riches références

Utilisez Insérer la référence pour rechercher un actif, repère, Note ou Document. Vous pouvez également saisir @ lorsque cela est pris en charge ou faire glisser un élément Locus ou un actif Content Browser pris en charge dans un texte modifiable. Les ressources sont localisées ou ouvertes dans l’éditeur, les Note sont sélectionnés dans l’espace de travail Note, les Document s’ouvrent dans un onglet de l’éditeur Document et les repère utilisent la navigation normale.

Pour créer une référence Actor, faites glisser exactement un Actor chargé éligible du World Outliner vers un Note modifiable. L’identité utilise le monde racine enregistré et le GUID Actor, et non son étiquette. Les Actor ne sont pas proposés par Insérer la référence ou @ ; les références manquantes ou malformées restent visibles pour le diagnostic.

Les Note partagés ne peuvent pas faire référence à nouveau aux Note privés ou aux repère privés. Les Note privés peuvent faire référence à du contenu partagé ou privé.

Récupération et changements externes

Les instantanés de récupération sont stockés séparément de la Note faisant autorité :

récupération Partagée : <Project>/Saved/ProjectNotes/Recovery/
récupération Privée : <Project>/Saved/Locus/Recovery/PrivateNotes/

Lorsqu’une récupération est disponible, examinez-la avant de choisir Restaurer, Restaurer comme nouvelle Note ou Abandonner. Si un fichier change en dehors de Locus alors que vous avez des modifications non enregistrées, Locus bloque le remplacement silencieux et propose des actions sûres comme recharger le disque, enregistrer le texte local comme nouvelle Note, copier le texte local ou comparer les deux versions. Une Note propre modifiée à l’extérieur est actualisée depuis le disque.

Supprimer des Notes

Supprimer les Notes sélectionnées demande confirmation et supprime définitivement leurs fichiers externes ; le système d’annulation d’Unreal ne peut pas les restaurer. Lorsque le contrôle de source est actif, Locus refuse les états de suppression dangereux, comme le checkout d’un autre utilisateur, un fichier pas à jour ou un état impossible à vérifier.

Contrôle de source et Mode local

Les Notes privées restent toujours neutres vis-à-vis du fournisseur. Sélectionner, ouvrir ou lire une Note Partagée propre et contrôlée ne l’extrait pas. Elle reste en lecture seule jusqu’à l’action Extraire ; une extraction réussie active l’édition, tandis qu’un échec laisse la Note protégée sans contournement Rendre inscriptible.

Une nouvelle Note Partagée est d’abord écrite localement puis marquée pour ajout ; si l’opération du fournisseur échoue, le fichier local valide reste disponible et l’action peut être réessayée.

Sans fournisseur actif, les Notes Partagées nouvelles ou non suivies restent modifiables en Mode local. Une Note déjà contrôlée par le dépôt reste protégée jusqu’au retour du fournisseur et à son extraction explicite. Locus ne soumet pas, ne synchronise pas, ne gère pas les changelists et ne modifie pas les typemaps du dépôt. Voir Contrôle de source et Résolution des problèmes.

Sans fournisseur configuré, Notes n’affiche aucun état de contrôle de source, aucune info-bulle, aucune instruction ou action. Avec un fournisseur configuré, Afficher le statut du Contrôle de source contrôle uniquement les indicateurs de rangée compacts sans modifier le retour de sécurité requis ou l’éligibilité à l’action.

Limitations actuelles

L’organisation d’une Note reste dans son scope Partagé ou Privé existant.
Les références d’assets ne chargent pas les assets uniquement pour lister ou rechercher des Notes.
La prise en charge du contrôle de source est limitée par le fournisseur Unreal actif et l’état de fichier qu’il signale.

La création de Actor est limitée à un World Outliner Actor chargé éligible déposé dans un Note modifiable. La liste ou la recherche de références ne charge pas les ressources, les niveaux ou les Actor.