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.2 KiB
Assistance et compilation depuis les sources
Utilisez le dépôt pour les signalements de bugs, versions actuelles et contributions. Le guide de dépannage couvre la récupération sûre avant de signaler un problème.
Signaler un bug
- Ouvrez Paramètres → Info → Diagnostics.
- Sélectionnez Signaler un bug pour ouvrir le formulaire de ticket GitHub.
- Vérifiez les informations de version/client préremplies. Ajoutez une reproduction minimale, le comportement attendu et le résultat réel, puis soumettez via GitHub.
L’action préremplit les versions de CodeNomad et d’OpenCode (y compris celle du service OpenCode en cours lorsqu’elle diffère de la version installée), votre système d’exploitation, le type de client (avec l’agent utilisateur du navigateur dans un navigateur web) et le système d’exploitation du serveur. Elle ne préremplit pas les adresses d’écoute, chemins de travail, identifiants ou textes de conversation. Ouvrir le formulaire ne soumet pas de ticket.
Pour davantage de diagnostics, Copier dans le presse-papiers ou Télécharger .txt produit un rapport distinct. Ce rapport plus complet peut contenir des chemins locaux et adresses réseau : relisez-le et masquez-les avant de le joindre. Une capture ou un extrait de journal peut encore contenir des secrets même si le diagnostic automatique exclut les secrets d’authentification.
Si le formulaire GitHub contient des champs incompatibles, CodeNomad ouvre un ticket simple avec les mêmes informations. Un échec temporaire de lecture du formulaire n’empêche pas son ouverture. Vous pouvez toujours utiliser manuellement la liste des tickets.
Communauté et versions
| Ressource | Utilisation |
|---|---|
| Dépôt CodeNomad | Sources, activité du projet et documentation. |
| Tickets | Rechercher les signalements existants avant un bug reproductible ou une demande de fonctionnalité. |
| Pull requests | Examiner les changements proposés ou coordonner une contribution. |
| Dernière version | Téléchargements stables. |
| Toutes les versions | Préversions publiées et notes de version. |
| Neural Nomads | Organisation du projet. |
| Licence MIT | Conditions de licence. |
Pour les problèmes de configuration native OpenCode plutôt que de commandes CodeNomad, consultez la documentation OpenCode et les versions amont.
Compiler depuis les sources
Utilisez Node.js 24.20.0, épinglé dans .node-version, npm, Git et une CLI OpenCode compatible. Exécutez les commandes depuis une copie de développement :
git clone --branch dev https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm ci --workspaces --include=optional
npm run dev
npm run dev démarre l’hôte de développement Electron. Pour Tauri, installez d’abord ses prérequis de compilation de plateforme, dont la chaîne Rust, puis exécutez :
npm run dev:tauri
Les changements de développement affectent l’hôte de développement, pas la version installée d’un démon OpenCode indépendant actif. La création de paquets natifs nécessite les outils de cible appropriés ; privilégiez une compilation sur le système cible.
Compiler et valider
| Commande, depuis la racine du dépôt | But |
|---|---|
npm run build |
Compiler les ressources de l’application Electron. |
npm run build:tauri |
Compiler l’application Tauri avec ses prérequis natifs. |
npm run build:ui |
Compiler l’interface navigateur. |
npm run build --workspace @neuralnomads/codenomad |
Compiler le serveur autonome et les ressources fournies. |
npm run build:linux --workspace @neuralnomads/codenomad-electron-app |
Créer le paquet Debian Electron. |
npm exec --workspace @codenomad/tauri-app -- tauri build --bundles appimage |
Créer une AppImage Tauri Linux. |
npm run typecheck |
Vérifier les espaces de travail TypeScript configurés à la racine. |
npm run test:help |
Valider toutes les langues et tous les liens de l’aide publique. |
npm run build:help |
Compiler l’aide publique autonome dans dist/help. |
La compilation de l’aide ne nécessite pas de service CodeNomad ou OpenCode actif. Voir BUILD.md pour les détails de création des paquets et CONTRIBUTING.md pour la validation ciblée et les conventions de PR ; utilisez les scripts réellement présents dans le paquet cible.
Carte des paquets et contribution
| Paquet | Responsabilité |
|---|---|
packages/server |
Commandes espace de travail/API/Git, connexion OpenCode, authentification, événements et voix. |
packages/ui |
Espace de travail SolidJS, commandes, localisation et point d’entrée de l’aide navigateur. |
packages/electron-app |
Fenêtres Electron, intégration native et création des paquets. |
packages/tauri-app |
Fenêtres Tauri, intégration de plateforme et création des paquets. |
packages/remote-tunnel |
Environnement de transport OpenTunnel côté backend. |
- Discutez de la portée dans le ticket pertinent avant de réaliser un travail qui se chevauche.
- Créez votre branche depuis
devet gardez le changement ciblé. - Exécutez les contrôles de la zone concernée, mettez l’aide à jour avec le comportement et ciblez
devpour votre PR.
Les sources d’aide publique se trouvent dans docs/help/<locale>/. Préservez l’ID explicite, le niveau et l’ordre de chaque titre anglais dans les traductions ; les titres traduits ne doivent pas casser les liens profonds. Le contrat de maintenance de l’aide décrit les contrôles stricts d’exhaustivité et le pipeline de publication statique.