1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
6 KiB
Mobile et PWA
Utilisez l’interface navigateur sur téléphone ou tablette pour poursuivre le travail sur l’hôte du backend. Installer la PWA change la manière d’ouvrir l’interface, pas le lieu des projets, identifiants ou de l’exécution des agents.
Se connecter depuis un téléphone ou une tablette
- Sur l’hôte, ouvrez Paramètres → Accès distant → Contrôle à distance, puis choisissez Démarrer le contrôle à distance.
- Scannez le QR code d’appairage avec votre appareil mobile et ouvrez le lien dans le navigateur que vous comptez garder.
- Sinon, configurez l’accès direct, ouvrez l’URL HTTPS accessible et de confiance de l’hôte, puis connectez-vous avec son mot de passe serveur.
Le Contrôle à distance exige un appairage ; les connexions directes nécessitent routage, écoute accessible et authentification. N’utilisez pas localhost sur le téléphone pour atteindre votre poste. Perdre les données de site ou changer de profil navigateur peut nécessiter une nouvelle connexion ou un appairage ; voir Contrôle à distance.
Installer la PWA
- Ouvrez l’URL CodeNomad fonctionnelle en HTTPS de confiance dans un navigateur acceptant l’installation.
- Dans Chrome/Edge et les navigateurs similaires, utilisez l’action d’installation de la barre d’adresse ou l’action Install CodeNomad du navigateur si proposée. Sur Safari iPhone/iPad, utilisez Share → Add to Home Screen ; le libellé exact dépend du système/navigateur.
- Ouvrez le nouveau lanceur et effectuez la connexion ou l’appairage si son stockage navigateur est séparé.
L’installation est propre à chaque appareil/navigateur et origine. Elle n’installe pas Node, Git ou OpenCode sur le téléphone, ne démarre pas de backend et n’accorde pas d’intégrations natives de bureau. Supprimer le lanceur ne supprime pas les conversations de l’hôte ; révoquez séparément un appareil appairé pour retirer l’accès.
Contexte sécurisé et certificats
L’installation PWA distante et l’accès microphone nécessitent un contexte sécurisé reconnu par le navigateur. Utilisez un certificat HTTPS de confiance correspondant exactement au nom d’hôte/à l’IP. Un certificat local généré doit être explicitement approuvé par l’appareil/navigateur client ; une page d’avertissement ou son contournement n’est pas une configuration d’installation fiable. Les exceptions localhost des navigateurs s’appliquent à cet appareil, pas à une adresse HTTP LAN d’un autre hôte.
Si l’installation manque, confirmez d’abord la confiance HTTPS et la prise en charge du navigateur, puis rouvrez la page dans le navigateur complet plutôt qu’un navigateur QR/intégré. Pour les échecs de microphone, vérifiez les permissions de site navigateur/système et Voix. Ne désactivez pas l’authentification ou la vérification TLS pour réparer l’installation.
Travailler avec les dispositions tactiles
Utilisez les commandes Volet gauche et Volet droit pour ouvrir navigation et outils. Sur les dispositions étroites, les panneaux recouvrent la conversation au lieu d’imposer une largeur de bureau ; ouvrir un panneau flottant ferme l’autre. Les actions d’en-tête passent dans leur menu de débordement si l’espace manque.
La zone de saisie garde Agent, Modèle et Réflexion dans son pied. Le champ se redimensionne avec la conversation visible, y compris le clavier à l’écran ; les longs brouillons restent défilables. Sur les appareils uniquement tactiles, l’envoi ne rouvre pas le clavier à l’écran, pour que vous puissiez lire la réponse ; touchez la zone de saisie pour continuer. Pendant qu’une session travaille, le menu Plus d'actions de la zone de saisie propose Mettre le message en file d'attente ou Injecter maintenant, selon ce que votre envoi normal ne fait pas, sans nécessiter de raccourci de clavier physique. Ouvrir une interruption compacte temporairement la zone de saisie sans changer sa hauteur enregistrée ni son brouillon. Répondez aux autorisations/questions dans le dock au-dessus, en gardant son pied d’actions accessible. Voir Conversations et Autorisations.
Limites de capacité et connectivité
| Fonctionnalité | Navigateur mobile / PWA |
|---|---|
| Projets, conversations, fichiers et autorisations | Opèrent sur l’hôte backend connecté, sous ses contrôles d’accès. Les pièces jointes d’appareil sont transférées depuis le téléphone ; les références de projet sont résolues sur l’hôte. |
| Fenêtres natives de bureau, menus système et automatisation native de l’hôte | Non fournis par l’installation de la PWA. |
| Aperçu navigateur | N’acquiert pas de capacités natives de navigateur invité ; le rendu de repli reste limité par le navigateur. |
| Contenu SideCar et WebSockets | Dépendent du chemin de connexion ; le Contrôle à distance bloque le proxy de contenu SideCar, le contenu d’aperçu et les mises à niveau WebSocket. Voir ses restrictions exactes. |
| Microphone, presse-papiers, notifications et proposition d’installation | Dépendent de la prise en charge navigateur/système, du contexte sécurisé et des permissions utilisateur. |
| Travail hors ligne | Aucun backend hors ligne ni historique API en cache. Les ressources d’interface statiques peuvent être en cache, mais les documents et réponses API ne constituent pas un espace de travail hors ligne. |
Gardez le backend accessible. La suspension par le système mobile ou un changement de réseau peut déconnecter le flux d’événements ; au retour, le client reconnecte et relit l’état actuel, sans rejeu d’événements garanti. Vérifiez si une action s’est terminée avant de réessayer. Fermer la PWA n’arrête pas un backend autonome ; quitter l’application de bureau hôte et son backend rend le Contrôle à distance indisponible jusqu’au prochain lancement.