CodeNomad/docs/help/fr/desktop.md
Pascal André 89bc69cf3b
Some checks are pending
Publish help / build (push) Waiting to run
Publish help / deploy (push) Blocked by required conditions
feat: add a Support CodeNomad page and entry points for sponsorship (#1194)
## Summary

- New **Support CodeNomad** help page (10 languages): what sponsorship
pays for, the funding policy (a contribution, not a purchase; never
required to download, use or update) and one button per funding channel
naming who receives the money.
- **Download page** ends with a short *Support development* section with
the same buttons; the help **header** gains a *Sponsor* link; the former
support page is retitled **Bug reports and source builds** (ids
unchanged) so the two are not confused.
- **App**: *Support CodeNomad* in Settings → Info (secondary button
between Updates and Diagnostics), in the Help menu after *CodeNomad
Help* (Electron and Tauri, English help-page fallback) and as a palette
command without a default shortcut. All open the localized help page.
- **Repository**: `.github/FUNDING.yml` lists the maintainer's GitHub
Sponsors profile and the Support page (the Sponsor button needs
*Settings → General → Features → Sponsorships*).

Channels live in `docs/help/funding.json` and render through a
`{{funding}}` directive allowed only on the download and sponsor pages,
so adding a channel needs no retranslation. Entries are validated (exact
keys, unique ids, `https://github.com/sponsors/<login>` only) and
escaped; a page using `{{funding}}` with no channel fails the build. CSP
unchanged.

Agreed with the co-maintainer before publishing.

## Validation

- `npm run test:help`: 31/31 (27 pages × 10 locales, funding validation
and placement).
- `node scripts/test-help-browser.mjs`: 47/47 (header overflow at 390 px
in en/he/ne/ja/zh-Hans, button geometry).
- `npm run typecheck`; unit tests help-url, hotkey-bindings,
menu-labels; browser tests help-command, server-info, view-menu-electron
(22/22); `cargo test` for the Tauri crate (291/291, including the
English sponsor fallback).
- Independent review: zero findings.
2026-10-29 18:57:45 +01:00

9.5 KiB
Raw Permalink Blame History

Fenêtres de bureau et données

Fenêtres, onglets et service partagé

  1. Utilisez Nouvelle instance pour ouvrir un autre onglet projet/accueil dans la fenêtre actuelle.
  2. Utilisez le menu natif Fenêtre → Nouvelle fenêtre (Ctrl+Shift+N ou Cmd+Shift+N) pour une fenêtre d’application séparée.
  3. Dans Paramètres → Avancé, activez Focaliser la fenêtre existante au second lancement si un autre lancement doit focaliser la dernière fenêtre utilisée au lieu d’en ouvrir une nouvelle.

Les onglets de projet, conversations sélectionnées et dispositions appartiennent à une fenêtre. Les sessions/messages OpenCode appartiennent au service natif OpenCode partagé : une autre fenêtre peut voir la même conversation. Fermer un onglet de projet ferme ce projet dans CodeNomad, pas ses sessions OpenCode ; rouvrez-le pour les retrouver. Une autre fenêtre qui affiche la même connexion de projet ferme aussi son onglet et affiche une notification ; les onglets ouverts séparément sur le même dossier ne sont pas concernés. Fermer une fenêtre entière, quitter ou recharger conserve les connexions de projet pour la restauration ; voir Projets. Ne considérez pas la fermeture des fenêtres comme une preuve qu’un agent ou une Mission planifiée s’est arrêté.

Les menus natifs de l’application utilisent la langue de l’interface de CodeNomad dès qu’une fenêtre est chargée ; ils restent en anglais jusque-là. Aide → À propos de CodeNomad (aussi dans le menu de l’application sur macOS) ouvre Paramètres → Info avec la version, les mises à jour et les diagnostics. Aide → Soutenir CodeNomad ouvre la page Soutenir CodeNomad dans votre navigateur.

Préférences et restauration au démarrage

  1. Ouvrez les paramètres depuis la fenêtre à configurer. Les points d’entrée du bureau local focalisent l’unique fenêtre native Preferences avec le projet/la Location de cette fenêtre d’origine.
  2. Dans Général, activez ou désactivez Restaurer l’état précédent.
  3. Pour oublier la disposition enregistrée de cette fenêtre, utilisez Effacer l’état de démarrage enregistré. L’action s’applique immédiatement, sans confirmation.

La restauration peut rouvrir onglets d’espace de travail/SideCar et sessions actives, texte non envoyé, positions de défilement, panneaux, placement et zoom de fenêtre. C’est un état client par fenêtre, pas une copie de la base de conversations natives. L’effacer retire onglets, brouillons et disposition enregistrés ; cela ne supprime ni configuration CodeNomad ni conversations OpenCode. Enregistrez d’abord ailleurs tout brouillon non envoyé important.

La fenêtre Preferences ne possède pas d’état de restauration séparé : ces commandes ciblent la fenêtre qui l’a ouverte. Si cette fenêtre est fermée, ou inconnue parce que Preferences a été rouvert au lancement, elles suivent la dernière fenêtre utilisée ; une modification préparée pour une autre fenêtre n’est jamais appliquée, les commandes affichent d’abord la valeur de la nouvelle fenêtre. Pour régler une fenêtre précise, ouvrez Preferences depuis celle-ci. Les paramètres propres au projet utilisent aussi la Location d’origine ; ils restent indisponibles sans elle. Quand Preferences se rouvre au lancement, ils se reconnectent une fois ce projet ouvert ; tant que le dossier démarre encore, ou s’il est ouvert dans plusieurs onglets, ils restent indisponibles jusqu’à ce que vous ouvriez Preferences depuis la fenêtre voulue.

Les paramètres navigateur et distants sont intégrés, plutôt qu’un second propriétaire natif de Preferences. Une erreur d’ouverture des préférences natives est signalée ; elle ne permet pas de supposer qu’un écran intégré caché s’est ouvert à la place.

Profils de données de bureau

  1. Dans les paramètres natifs Paramètres → Général, sous Restaurer l’état précédent, dépliez Profil de données. Il liste tous les profils de cet ordinateur avec leur taille, leur date de création et leur dernière utilisation, le profil ouvert en premier.
  2. Sélectionnez le profil qu’ouvrira le prochain lancement, ou choisissez Nouveau profil et saisissez un nom de 1 à 64 lettres minuscules, chiffres, points, tirets ou tirets bas, commençant par une lettre ou un chiffre.
  3. Choisissez Redémarrer dans pour basculer tout de suite ; sinon le profil choisi s’ouvre au prochain lancement. Sélectionner de nouveau le profil ouvert annule le changement.

Les profils d’une autre configuration sont listés mais ne peuvent pas être choisis ici. Sans choix mémorisé, un lancement empaqueté examine les profils par défaut, dev et dev-v2 pour du travail restaurable et ouvre le plus récemment utilisé, ou le profil par défaut si aucun n’en contient. Choisir un profil ne déplace, ne fusionne ni ne supprime les données de profil.

CODENOMAD_PROFILE défini avant de lancer l’exécutable prime sur ce choix ; Profil de données affiche alors les profils sans permettre d’en choisir un. default ou stable sélectionne le profil par défaut, et un nom invalide empêche le lancement au lieu de sélectionner un autre profil. Par exemple, dans PowerShell, avant de lancer l’exécutable de bureau voulu :

$env:CODENOMAD_PROFILE = "review"

Pour une configuration serveur indépendante, définissez aussi CLI_CONFIG vers un fichier de configuration distinct avant le lancement. La valeur par défaut est ~/.config/codenomad/config.yaml. Un nom de profil seul ne change ni ce fichier ni le service OpenCode partagé.

Isolé par un profil de données de bureau Non isolé automatiquement
État de restauration fenêtres/onglets, brouillons non envoyés et portée singleton/backend du bureau Sessions, messages, identifiants fournisseurs et exécution OpenCode
Stockage natif Chromium/WebView associé au profil, sous les limites de plateforme Configuration/préférences CodeNomad, clés vocales, SideCars et activation d’extensions si la configuration est partagée
Stockage d’aperçu natif dans son hôte/profil Fichiers des projets ouverts ; données des serveurs distants

Sur Tauri macOS, les profils délimités partagent le stockage WebKit système, les connexions et le cache ; n’utilisez pas les noms de profil comme isolation de sécurité des comptes. Electron stocke les données web dans son profil. La version installée et Flux de mises à jour ne sélectionnent jamais un autre profil. Les lancements de développement non empaquetés utilisent dev sauf sélection explicite.

Supprimer un profil enregistré

  1. Dépliez Profil de données comme ci-dessus et actualisez la liste au besoin.
  2. Choisissez le bouton de suppression du profil à retirer. Le profil ouvert n’en a pas.
  3. Confirmez seulement après préservation des brouillons/connexions nécessaires. Inspectez tout rapport de suppression incomplète avant de réessayer.

La suppression retire onglets, brouillons, disposition et stockage web/cache/connexions détenus de ce profil, y compris un profil listé depuis une autre configuration. Elle préserve le profil ouvert, les conversations OpenCode et les fichiers de projet. Un profil ouvert ou dans un état inconnu ne peut pas être supprimé ; fermez les fenêtres CodeNomad concernées, actualisez la liste et réessayez. Le contenu non reconnu est conservé et signalé plutôt que supprimé largement.

Le stockage WebKit partagé de Tauri macOS est conservé, car le supprimer affecterait les autres profils. Ce nettoyage n’est pas annulable : une conversation native survivante ne restaure pas un brouillon non envoyé supprimé. Effacer l’état de démarrage enregistré est l’action plus limitée pour seulement réinitialiser la fenêtre actuelle.

Zoom et géométrie des panneaux

  1. Utilisez les commandes natives Affichage → Zoom avant, Zoom arrière ou Taille réelle ; clavier/molette suivent aussi la prise en charge de l’hôte.
  2. Utilisez Volet gauche et Volet droit aux coins fixes extérieurs de l’en-tête pour basculer les panneaux. Épinglez/désépinglez les tiroirs si la disposition le permet.
  3. Si les commandes ne tiennent plus, réduisez le zoom ou élargissez la fenêtre ; les dispositions étroites déplacent les commandes dans les menus et ferment les panneaux qui ne tiennent plus.

Les fenêtres principales locales et distantes réservent au moins 390 × 600 pixels CSS, mis à l’échelle par le zoom et bornés par la zone de travail du moniteur. Augmenter le zoom peut agrandir une fenêtre trop petite ; le diminuer ne réduit pas une fenêtre déjà plus grande. Preferences et les enfants d’aperçu navigateur ont leurs propres règles de taille.

Les panneaux laissent une largeur minimale de conversation. Un panneau ancré qui ne tient plus se ferme, le panneau droit en premier, puis revient quand la fenêtre a de nouveau la place, sauf si vous l’avez fermé pendant qu’il était ancré ; un panneau que vous ouvrez sans place flotte au-dessus de la conversation. Sous 420 pixels CSS de largeur de conversation, la chronologie se masque et les actions d’en-tête utilisent leur menu de débordement ; la préférence de chronologie est conservée. Ces changements géométriques ne modifient ni le brouillon ni la session native. Voir Paramètres et disposition et Aperçus navigateur et SideCars.