mirror of
https://github.com/NeuralNomadsAI/CodeNomad.git
synced 2026-11-18 22:44:40 +00:00
I keep one live web preview per session while duplicate tabs retain independent chat/preview choices. Switching tabs preserves the document, URL, history, viewport and token; closing one tab keeps the survivor’s browser alive, and saved pages load only on explicit reopening. I preserve imported URLs/history/templates until the shared layout write is accepted, give another occurrence its own restoration fence, and hide/deactivate the retained guest beneath floating drawers without detaching it. I cover the full 64-entry layout, stale-token cleanup, surviving toolbar opening, iframe/real Electron drawer hit-testing, Tauri visibility IPC, menus and dialogs, and correct restoration help in all ten locales. The production package delta against `origin/dev` is +257/−219 (net +38), excluding tests and Rust regression files. I verified that all three new unit cases and all four browser regressions fail against the original relevant code and pass after the fixes. Typecheck, the exact unconditioned CI UI step (760 tests), full UI units (2,345), Electron controller tests (24), and help (31 checks; 28 pages in ten locales) pass. Windows passed 261/262 broad browser checks, then all 54 session/persistence checks and three focused repeats of the one Electron timeout, with assertions unchanged. Linux under Node 24.22.2/Xvfb passed 260/262, including all preview regressions and all 54 session/persistence checks; two untouched history-navigation prompt-menu cases still time out on repeat. The current GitHub UI steps pass; failures in untouched pruning-presence, Windows legacy-probe cleanup and Missions native-baseline checks remain outside this preview fix.
89 lines
10 KiB
Markdown
89 lines
10 KiB
Markdown
# Projets et worktrees
|
||
|
||
Un onglet de projet relie CodeNomad à un dossier sur l’ordinateur du backend. Ouvrir un onglet, parcourir une copie de travail et déplacer une famille de conversations sont des opérations distinctes.
|
||
|
||
## Ouvrir un projet {#open-project}
|
||
|
||
1. Cliquez sur **Nouvelle instance** (`+`) pour ouvrir l’accueil.
|
||
2. Choisissez **Parcourir les dossiers**, sélectionnez le dossier du backend et ouvrez-le ; ou choisissez une entrée sous **Dossiers récents**.
|
||
3. Pour une copie de dépôt, choisissez **Cloner un dépôt Git**, saisissez **URL du dépôt** et **Dossier de destination**, puis **Cloner**. **Dossier de destination** est prérempli avec le nom du dépôt, dans le dossier qui contient votre dernier clone, sinon à côté de votre projet le plus récent. **Parcourir** choisit le dossier qui contiendra le clone ; vous pouvez aussi modifier le chemin, y compris le nom du dossier du clone.
|
||
|
||
Parcourir un serveur distant signifie parcourir son système de fichiers, pas votre téléphone ou ordinateur portable. Ouvrir un projet ne crée pas un démon OpenCode distinct par onglet. Les conversations sont des sessions natives OpenCode ; leur durée de vie n’est pas celle de l’onglet.
|
||
|
||
Le clonage écrit un dépôt dans la destination. **Supprimer d'abord le dossier de destination s'il existe déjà.** est destructeur : n’activez cette option que si tout ce qui s’y trouve peut être supprimé. Dans le doute, utilisez une nouvelle destination.
|
||
|
||
Les entrées récentes sont des raccourcis. **Renommer l'espace de travail** change son nom affiché ; **Retirer des récents** retire le raccourci, pas ses fichiers ni ses conversations. Cliquer sur un projet récent déjà ouvert ouvre un nouvel onglet ; son bouton **Ouvert** (**Basculer vers le projet ouvert**) sélectionne plutôt l’onglet existant.
|
||
|
||
Ouvrez deux fois le même dossier et sélectionnez la même conversation dans les deux onglets pour garder le chat dans l’un et un aperçu web, un fichier ou un rapport de Mission dans l’autre. Chaque onglet conserve sa propre vue, la position de défilement de la conversation, la sélection du panneau droit et le mode Fichiers ; les messages, l’exécution et les données du projet restent partagés.
|
||
|
||
## Utiliser le lanceur de nouvelle instance {#new-instance-launcher}
|
||
|
||
1. Appuyez longuement ou faites un clic droit sur `+` ; lorsque ce bouton a le focus clavier, utilisez **Alt+Down**, **Shift+F10** ou la touche Menu.
|
||
2. Recherchez les projets récents ou sélectionnez **Parcourir…**, **Temporaire** ou **Cloner…**.
|
||
|
||
Un clic normal ouvre toujours l’accueil complet. Le lanceur est un raccourci, pas l’interface de gestion : renommez/retirez les projets récents et gérez les serveurs enregistrés depuis l’accueil. Échap ferme le lanceur et rend le focus à `+`.
|
||
|
||
## Fermer un onglet de projet {#close-stop}
|
||
|
||
1. Utilisez le bouton de fermeture de l’onglet ou **Fermer l'onglet** dans la palette de commandes (`Ctrl/Cmd+W` dans le moteur de rendu).
|
||
2. Fermer l’onglet ferme ce projet dans CodeNomad : il cesse de suivre ses événements et ses demandes. Les sessions continuent de s’exécuter dans OpenCode.
|
||
3. Rouvrez le dossier via Parcourir ou les dossiers récents pour retrouver ces conversations.
|
||
|
||
| Action | Portée et effet | Ce qu’elle ne fait pas |
|
||
| --- | --- | --- |
|
||
| Fermer l’onglet | Retire la connexion de projet CodeNomad de cet onglet ; un autre onglet ouvert séparément sur le même dossier n’est pas affecté | Ne supprime ni les fichiers du projet ni l’historique natif, n’arrête pas les sessions et ne décharge pas la Location d’OpenCode |
|
||
| Arrêter la session | Exécution de la conversation sélectionnée | Ne ferme pas le projet et ne supprime pas son historique |
|
||
|
||
Si une autre fenêtre affiche la même connexion de projet, son onglet se ferme aussi et cette fenêtre affiche une notification. Les brouillons et pièces jointes non envoyés de l’onglet fermé reviennent quand vous rouvrez le même dossier dans cette fenêtre ; elle les garde pour ses 16 derniers projets fermés, jusqu’à son rechargement ou sa fermeture. Ils ne font pas partie de la restauration au démarrage.
|
||
|
||
Fermer une fenêtre entière, quitter ou recharger ne ferme pas ses connexions de projet ; la restauration normale au démarrage s’applique toujours. Arrêtez explicitement les exécutions concernées si vous devez vérifier qu’elles sont terminées. CodeNomad ne décharge jamais les Locations natives ; la maintenance du service partagé est décrite dans [Configuration d’OpenCode](opencode.md).
|
||
|
||
Lorsque la restauration au démarrage est activée, chaque onglet restant retrouve ses propres choix de panneaux, sa sélection et son lecteur de Mission ainsi que son choix entre le chat et l’aperçu web. Les URL et l’historique du navigateur sont partagés par session ; les pages enregistrées se chargent uniquement lorsque l’aperçu web est explicitement rouvert. Fermer une occurrence retire uniquement sa vue enregistrée ; rouvrir le dossier crée une nouvelle occurrence.
|
||
|
||
## Espaces de travail temporaires {#temporary-workspaces}
|
||
|
||
1. Choisissez **Temporaire** dans le lanceur ou **Nouvelle instance temporaire** sur l’accueil.
|
||
2. Travaillez dans le dossier vide géré par CodeNomad ; Git n’est pas initialisé automatiquement.
|
||
3. À la fermeture de l’onglet, choisissez **Garder**, **Jeter** ou **Annuler**. Le menu de l’onglet propose aussi **Garder comme projet**.
|
||
|
||
| Choix | Effet | Récupération |
|
||
| --- | --- | --- |
|
||
| Garder | Ferme le projet dans CodeNomad, conserve le dossier et les conversations, retire son statut temporaire et ajoute un projet récent | Rouvrir depuis les dossiers récents ; le dossier n’est pas déplacé |
|
||
| Jeter | Supprime les conversations, fichiers et brouillons non envoyés de l’espace de travail temporaire | Aucune annulation ; enregistrez d’abord ailleurs ce dont vous avez besoin |
|
||
| Annuler | Laisse l’espace de travail temporaire ouvert | Continuer à travailler ou décider plus tard |
|
||
|
||
Un onglet temporaire intact, sans conversation, fichier ni brouillon non envoyé, est supprimé discrètement à la fermeture. Les onglets temporaires ouverts participent à la restauration normale au démarrage, mais l’accueil n’a pas de liste séparée pour reprendre les dossiers temporaires fermés.
|
||
|
||
La suppression est refusée si une conversation est active ou si le dossier est ouvert dans un autre onglet/une autre fenêtre. Arrêtez l’exécution et fermez d’abord les autres vues. En cas d’échec, l’espace reste temporaire : résolvez le problème signalé et réessayez plutôt que de supprimer manuellement un répertoire parent.
|
||
|
||
## Sélectionner ou créer un worktree {#select-create-worktree}
|
||
|
||
1. Ouvrez une conversation parente et utilisez le sélecteur de worktree de sa zone de saisie. Sur les dispositions étroites, il se réduit à une flèche.
|
||
2. Sélectionnez un worktree découvert existant ou choisissez **+ Créer un worktree**.
|
||
3. Pour une création, saisissez **Nom** et choisissez **Créer et utiliser le worktree**.
|
||
|
||
Quand le projet est un dossier situé dans un dépôt, seuls les worktrees qui contiennent ce dossier sont proposés. Pour créer un worktree depuis un tel dossier, Git doit le suivre. Un nouveau nom de branche part du HEAD de la copie sélectionnée. Un nom de branche existant utilise sa révision actuelle ; Git peut refuser une branche déjà extraite ailleurs. Les worktrees utilisent l’emplacement par défaut `.codenomad/worktrees`. Les modifications non validées restent dans la copie d’origine ; la création ne les copie pas dans le nouveau worktree.
|
||
|
||
Le sélecteur de la zone de saisie déplace la conversation parente et ses descendants récursifs en tant que famille vérifiée. Une sous-session ne peut pas modifier ce sélecteur indépendamment. Les sessions actives bloquent l’opération : laissez la famille terminer ou arrêtez d’abord son exécution. Attendez qu’un déplacement soit réglé avant d’en demander un autre ; en cas d’erreur, vérifiez l’état actualisé de la conversation/du worktree avant de réessayer.
|
||
|
||
À l’inverse, **Worktree à consulter** dans [Fichiers](files.md) change seulement la copie lue par le panneau. Cela ne déplace pas une conversation, ne change pas de branche et ne change pas le lieu d’exécution de sa prochaine commande shell.
|
||
|
||
## Supprimer un worktree {#remove-worktree}
|
||
|
||
1. Dans la liste des worktrees de la zone de saisie, utilisez **Supprimer le worktree** pour un worktree de branche supprimable.
|
||
2. Vérifiez le dossier cible. Laissez **Forcer la suppression (jeter les modifications locales)** désactivé sauf si les modifications locales peuvent être perdues.
|
||
3. Confirmez la suppression et vérifiez l’inventaire résultant.
|
||
|
||
La suppression retire le dossier local du worktree. La copie principale de Git n’est pas une cible supprimable. CodeNomad ramène les familles de conversations concernées vers la copie racine et vérifie leur emplacement avant de retirer le worktree ; des sessions actives peuvent bloquer la suppression. La suppression n’est ni une archive ni une sauvegarde des fichiers non validés.
|
||
|
||
Si Git refuse des fichiers modifiés/non suivis, préservez ou nettoyez ces fichiers avant de réessayer. La suppression forcée les détruit explicitement. Pour un répertoire verrouillé, fermez les terminaux, éditeurs, observateurs et processus en arrière-plan qui l’utilisent. La boîte d’erreur propose **Copier la version nettoyée** pour partager un diagnostic ; relisez même le texte nettoyé.
|
||
|
||
## Initialiser Git ou travailler sans lui {#initialize-git}
|
||
|
||
1. Pour un dossier ordinaire avec Git disponible, ouvrez **Fichiers → Changements** ou **Commits**.
|
||
2. Choisissez **Initialiser Git**. L’action est immédiate, sans confirmation supplémentaire.
|
||
3. Attendez l’actualisation des métadonnées du projet et des conversations ; utilisez **Actualiser** si Git a été initialisé hors de CodeNomad.
|
||
|
||
L’initialisation crée le dépôt dans le dossier explicitement ouvert, pas dans son parent. Elle ne crée pas de commit.
|
||
|
||
Si le backend ne peut pas exécuter Git, les conversations et la navigation bornée dans les fichiers restent disponibles pour le dossier explicitement ouvert, en mode répertoire seul. Les opérations de worktree et l’initialisation Git nécessitent Git sur ce backend. Consultez [Installation](install.md) et [Fichiers](files.md).
|