Sommaire de ce manuel

Les treize sections suivent l'ordre « installer → utiliser → résoudre un problème ». Pour traiter un problème précis, allez directement à la section 12.

• 1 · Qu'est-ce que c'est — une structure en trois couches ; au quotidien, seule la plus haute est sollicitée.
• 2 · Installation — quel paquet pour quelle plateforme, et comment installer.
• 3 · Première ouverture — l'assistant en six étapes, et « fermer ne veut pas dire quitter ».
• 4 · Panorama de l'interface — ce que gère chacune des quatre zones.
• 5 · Première conversation — comment formuler clairement la demande.
• 6 · Menu du plateau — toutes les entrées au niveau système sont ici.
• 7 · Page des réglages — ce que l'on change dans chaque section.
• 8 · Profils — comment basculer entre plusieurs configurations et revenir en arrière en cas d'échec.
• 9 · Plugins préinstallés — 35 plugins présentés un par un en sept catégories, et comment les gérer puis les réinstaller.
• 10 · Mode sans échec et mode de récupération — comment s'en sortir quand l'application ne démarre plus.
• 11 · Mise à jour — cinq phases et quatre opérations réutilisables.
• 12 · En cas de problème — tableau des symptômes fréquents et export de diagnostic.
• 13 · Données et aide — emplacements des fichiers et accès aux autres documents.

1. Qu'est-ce que c'est

En une phrase : elle installe les capacités d'agent de DeepSeek Harness dans une application de bureau ; double-cliquez sur l'icône pour lancer une conversation, lui faire lire ou écrire des fichiers, exécuter des commandes, appeler des outils.

Le produit se compose de trois couches ; vous n'avez affaire qu'à la troisième, les deux premières fonctionnent automatiquement en arrière-plan.

Cette version (édition Essentials) présente une autre différence avec la version générale du dépôt logiciel : ce n'est pas une application vide « avec une coque, en attendant que vous installiez des plugins » ; elle réunit dans l'installeur 35 plugins déjà sélectionnés et capables de fonctionner ensemble. À la première ouverture après l'installation, ces capacités sont déjà là dans la page des plugins, sans que vous ayez à les chercher un par un sur npm.

2. Installation

Prenez sur la page de téléchargement du produit l'installeur correspondant à votre plateforme, puis double-cliquez dessus. L'installeur intègre déjà Electron, Node.js, pnpm et une version figée du runtime DSH ; aucune installation d'environnement supplémentaire n'est nécessaire. Cette version embarque Electron 44.0.0, Node.js 24.21.0, pnpm 11.8.0, Python 3.12.14 et le runtime DSH 0.2.2-rc.1.

Une mise à niveau ne demande pas de fermer l'ancienne version à la main. L'installeur demande d'abord à l'instance en cours de quitter, la force à s'arrêter si elle ne répond pas, puis remplace les fichiers ; s'il n'y arrive vraiment pas, l'installation s'arrête sur une erreur explicite, au lieu de laisser une application qui ne s'ouvre plus. Avant une mise à niveau, pensez tout de même à enregistrer votre travail. La désinstallation commence elle aussi par confirmer et fermer les programmes en cours, pour éviter que des fichiers occupés bloquent l'opération à mi-chemin.

Note : la page de téléchargement propose actuellement trois paquets — Windows x64, macOS universel et Linux x64. Le produit Linux arm64 est construit sur le canal de test et n'est pas encore accessible par le lien de téléchargement stable ; sur une machine ARM, en cas de problème avec les modules natifs, utilisez la version x64 de la plateforme correspondante ou la build du canal de test.

3. Première ouverture

Au premier lancement, une configuration par défaut (un profil nommé desktop) est préparée automatiquement et le service d'interface démarre sur la machine locale. Un assistant s'affiche d'abord, en six étapes ; vous pouvez à tout moment « ignorer la configuration » et compléter plus tard dans la page des réglages :

La dernière page commence par une vue d'ensemble par grandes catégories : mémoire et contexte, interface et espaces de travail, agents et compétences, documents et médias, code et ingénierie, robotique et simulation, connexion et automatisation ; chaque catégorie indique « ce qu'elle peut vous apporter » et le nombre de plugins. Ce n'est qu'après le clic sur « Terminer et commencer » que l'assistant installe les plugins un par un, en présentant pour chacun son nom, sa version, sa catégorie, sa description complète, et une phrase remerciant son auteur. L'installation ne demande aucune intervention : laissez simplement la progression aller au bout — 35 paquets installés l'un après l'autre, le premier démarrage prend donc un peu plus de temps que d'habitude.

Une fois l'assistant terminé, l'interface principale apparaît. Fermer la fenêtre ne veut pas dire quitter l'application : par défaut, la fermeture ne fait que replier la fenêtre dans le plateau système, tandis que le service d'arrière-plan et les tâches en cours continuent de tourner ; pour quitter réellement, utilisez « Quitter » dans le menu du plateau.

4. Panorama de l'interface principale

Une fois les plugins préinstallés en place, la barre latérale et le champ de saisie affichent quelques entrées supplémentaires : centre de compétences, tableau des tâches, tableau des coûts, historique de saisie, équipes d'experts, etc. Toutes viennent des plugins de la section 9 ; désactiver le plugin correspondant les fait disparaître.

5. Première conversation

1. Ouvrez une nouvelle session et choisissez le répertoire de travail.
2. En une phrase, dites « quoi faire + où + à quoi doit ressembler le résultat ». Par exemple : « Lis le README de ce répertoire, trouve les liens de téléchargement obsolètes et présente-les sous forme de tableau ».
3. Une fois qu'elle travaille, surveillez les appels d'outils et les fichiers modifiés ; pour changer de direction, interrompez et énoncez la nouvelle demande.
4. Si le résultat ne convient pas, dites précisément ce qui cloche : elle corrige avec le contexte, sans qu'il faille rouvrir une session.

Trois points pour formuler une demande claire :

• Périmètre : quel répertoire, quels fichiers — ne la laissez pas improviser.
• Critère d'acceptation : à quoi ressemble un résultat terminé (ça démarre, les tests passent, aucune cellule vide dans le tableau).
• Contraintes : ce qu'il ne faut pas toucher, les formats à conserver, l'accès réseau autorisé ou non.

6. Menu du plateau

Une fois la fenêtre fermée, l'icône du plateau est le point d'entrée de l'application. Un clic droit dessus affiche :

Le « mode : Renforcé / Compatible / Étendu » mentionné dans la version précédente du manuel a été supprimé : depuis la 2.2.9, le mode de fenêtre est fixe et seuls les réglages conservent l'option « Apparence de la fenêtre (matériau) ».

7. La page des réglages

L'accès aux réglages se trouve en bas de la barre latérale (Paramètres → Réglages du bureau). Les sections sont les suivantes :

En mode sans échec, cette page est en lecture seule, et les éléments accès par navigateur, réseau local, contrôle à distance, notifications sont eux aussi désactivés — c'est voulu, ce n'est pas une panne.

8. Profils : plusieurs configurations

Un profil est un environnement de configuration indépendant : sessions, plugins et réglages appartiennent chacun au leur, sans interférence. L'usage typique : un profil « travail » et un « personnel », ou un « quotidien » et un « essai de nouveaux plugins ».

Trois règles pratiques :

• Si un profil est cassé, passer à un autre suffit pour continuer à travailler, sans devoir d'abord réparer le premier.
• Un profil neuf ne contient que les composants officiels de base ; les 35 plugins préinstallés n'ont été installés que dans celui qui a terminé l'assistant. Si vous changez de profil et voulez continuer à les utiliser, vérifiez la liste réelle dans la page des plugins et installez ceux qui manquent.
• Supprimer un profil le déplace vers le répertoire de sauvegarde de récupération (il n'est pas effacé immédiatement) ; les sessions et réglages partagés sont conservés. Il n'est toutefois plus utilisable, à vérifier avant d'agir.

9. Plugins : les 35 plugins préinstallés

Cette section est le point central de cette version du manuel. L'installeur de la 2.2.9 embarque 35 plugins, répartis en sept grandes catégories, installés automatiquement dans le profil courant à la fin du premier assistant. Nous verrons d'abord « ce qui est installé et comment », puis chaque plugin catégorie par catégorie, et enfin comment les gérer et les réinstaller.

9.1 Ce qui est préinstallé d'usine

L'installeur distribue les 35 plugins sous forme d'archives (répertoire plugins/), installées une par une dans le profil à la fin du premier assistant. Ce ne sont pas des « téléchargements optionnels » : ils sont là dès l'installation — ouvrez la page des plugins et les 35 figurent dans « Plugins installés », activés par défaut.

9.2 Comment se déroule la préinstallation

Quelques détails utiles à connaître :

• L'installation se fait plugin par plugin ; à chaque installation, l'assistant affiche son nom, sa version, sa catégorie, sa description et son auteur. Ne fermez pas la fenêtre avant la fin.
• Le critère de réussite est la présence du nom du paquet dans les dépendances du package.json du profil, et non l'absence d'erreur de la commande ; une fois installé, le nom est aussi ajouté à profile.bundles, faute de quoi on obtient « installé mais non activé ».
• L'échec d'un seul plugin ne bloque pas le démarrage : en cas d'échecs, une boîte récapitulative liste les noms et les causes, et l'information est écrite dans le journal du bureau (bundled plugin not installed: <nom>: <cause>) ; l'assistant se termine normalement. Vous pourrez vérifier ensuite dans la page des plugins lesquels figurent réellement dans la liste.
• Seul le profil qui a terminé l'assistant est concerné. Les profils créés ensuite sont propres : relancez l'assistant ou complétez depuis la page des plugins si nécessaire.

9.3 Liste détaillée par catégorie

Voici les 35 plugins, par grandes catégories. Le v qui suit le nom indique la version livrée ; la mention « Recommandé pour » est un conseil de choix, non une limitation de fonctionnalité.

9.4 Désactiver, désinstaller et réinstaller

• Désactiver d'abord, désinstaller ensuite : la désactivation empêche seulement le chargement au prochain démarrage, les fichiers d'installation et la configuration restent, et l'on peut réactiver à tout moment ; la désinstallation passe par dsh plugin remove et supprime le package, l'interface demandant alors « Après la désinstallation, les fonctionnalités qu'il fournit disparaîtront ».
• Désinstaller un plugin préinstallé ne libère pas beaucoup d'espace : les .tgz d'origine restent dans plugins/ du répertoire du programme ; ce qui est supprimé est la copie installée dans le profil. Pour vraiment maigrir, il faut un installeur sans ces paquets, plutôt que de désinstaller un par un.
• Réinstaller : Réglages → Outils du bureau → « Assistant de configuration », refaire un passage jusqu'à la page 6 et cliquer sur « Terminer et commencer » ; les paquets manquants du profil sont alors réinstallés. On peut aussi installer à la main par les voies du 9.5.
• Les composants protégés sont intouchables : les composants dont le gestionnaire de plugins a besoin (Host, service web, accès aux fichiers, etc.) portent la mention « Nécessaire à la gestion des plugins ; ne peut pas être désactivé ni désinstallé » ; les composants de base comme dsh-base et dsh-web-app n'entrent pas dans la liste gérable, leur état se consulte uniquement dans « Paramètres → Plugins intégrés ».

9.5 Installer soi-même un plugin : trois voies

La page des plugins (« Plugins » dans la barre latérale, sous-titrée « Installer, activer et configurer les plugins ») recouvre deux choses :

• Installer un nouveau plugin : cliquez sur « Ajouter un plugin », choisissez « Installer un plugin tiers » et saisissez un nom de package npm (par exemple dsh-xxx ou @auteur/nom-du-plugin), une adresse de dépôt GitHub ou un répertoire local. À l'installation, vous pouvez choisir le registre : Registre par défaut, Registre officiel, Miroir de Chine continentale, ou registre npm interne personnalisé.
• Gérer ce qui est installé : dans « Plugins installés », activer, désactiver, désinstaller, vérifier les mises à jour, et consulter pour chaque plugin sa version, sa source et son état d'exécution.

Deux marchés de plugins sont proposés : dsh-community-market (le marché ouvert intégré, qui accepte des sources de données personnalisées, Beta) et dsh-market (le marché des projets populaires de la communauté, alimenté par awesome-dsh-plugin, dont le nom du paquet livré est dshmarket). Un seul peut être actif à la fois ; le marché est lui-même un plugin, on peut donc aussi l'activer ou le désactiver depuis la page des plugins.

Les trois commandes du terminal (sans --profile, elles s'appliquent au profil actif) :

9.6 Redémarrer après l'installation, vérifier après l'installation

Un plugin installé n'est chargé qu'après redémarrage de l'application — à la fin de l'installation, l'interface affiche « Installé ; redémarrez DSH pour le charger. » Pour vérifier qu'il est bien là :

1. Ouvrez la page des plugins et regardez s'il figure dans « Plugins installés » et s'il est activé.
2. Regardez si son entrée est apparue dans la barre latérale (marché, tableau des tâches, équipes d'experts, coûts…).
3. En cas de doute, ouvrez « Paramètres → Journal », augmentez le niveau de journalisation et redémarrez une fois : un échec de chargement laisse en général une erreur explicite.

9.7 Que faire si un plugin casse l'application

Pas besoin de réinstaller le système ni de supprimer le répertoire de données. Passez par l'assistant de récupération de la section 10 : désactivez d'abord, dans « Gestion des plugins », celui que vous venez d'installer, puis démarrez ; en dernier recours, « Retour en arrière » ramène au dernier point de contrôle qui démarrait. Cela vaut aussi pour les plugins préinstallés — ils ne diffèrent en rien de ceux installés plus tard.

10. Mode sans échec et mode de récupération

Ces deux fonctions répondent à la même situation : l'application ne démarre plus après une installation. La différence : le mode sans échec sert à « entrer proprement et travailler », le mode de récupération à « rester dehors et réparer ».

10.1 Mode sans échec

Le mode sans échec démarre avec un répertoire de données temporaire et indépendant : il ne lit ni vos plugins, ni vos réglages, ni vos sessions, ni vos espaces de travail, et ne peut donc pas être bloqué par eux. Vos données d'origine ne sont pas modifiées d'un octet.

Comment y entrer : plateau → « Entrer en mode sans échec… » ; ou, sur la page d'accueil de l'assistant de récupération, « Mode sans échec ».

Ce que l'on peut y faire :

• Vérifier « est-ce bien un problème de plugin » — si tout fonctionne en mode sans échec, le problème vient très probablement d'un plugin ou de la configuration.
• Dialoguer normalement dans l'interface web, lire et écrire des fichiers, bref traiter l'urgent.
• Consulter les journaux et exporter les informations de diagnostic (l'assistant de récupération sait aussi les exporter).

Limites (c'est voulu) :

• La page des réglages du bureau est en lecture seule, impossible à modifier.
• Les éléments qui dépendent d'une configuration persistante — accès par navigateur, accès réseau local, contrôle à distance, notifications de bureau — sont indisponibles.
• Un bandeau « Mode sans échec » reste affiché en haut de l'interface, pour rappeler que vous travaillez dans un environnement temporaire.

Pour en sortir : plateau → « Quitter le mode sans échec et redémarrer… ». L'environnement temporaire est nettoyé automatiquement au démarrage normal suivant et n'occupe pas d'espace sur le disque.

10.2 L'assistant de récupération (mode de récupération)

Quand y arrive-t-on :

• Vous l'ouvrez volontairement depuis le plateau, via « Assistant de récupération… ».
• Les démarrages échouent à répétition et l'application s'y replie d'elle-même.
• Quand l'interface refuse vraiment de démarrer, une boîte de dialogue « Récupérer Nonead DSH Desktop » s'ouvre séparément : on peut retenter la récupération sans redémarrer le service d'arrière-plan.

L'assistant de récupération indique trois choses : pourquoi vous êtes là (en entrée manuelle, il écrit « Vous êtes entré manuellement en mode de récupération »), quel profil et quel répertoire sont utilisés, et à quelle étape le démarrage s'est arrêté (initialisation Electron → préparation de l'environnement Shell → préparation du runtime de bureau → choix du profil → composition de la configuration des plugins → démarrage du service des plugins → démarrage de l'interface de bureau → confirmation du démarrage). L'étape où ça bloque circonscrit le problème.

Comment fonctionne le retour en arrière : après chaque démarrage réussi, l'application enregistre un « point de contrôle de démarrage » — la configuration qui fonctionnait à cet instant. Le retour en arrière ramène ensemble le profil, settings.yaml et l'état d'activation des plugins à ce moment-là. Chaque point de contrôle affiche l'un de trois états : « récupérable », « illisible », « aucun point de contrôle » ; « illisible » signifie que le point de contrôle lui-même est corrompu — prenez-en un plus ancien.

Rétablir la configuration d'usine : le répertoire de données actuel est déplacé en bloc vers la corbeille (la corbeille de Windows sous Windows), et un profil par défaut est recréé au redémarrage. Les fichiers de projet situés hors du répertoire de données ne sont pas supprimés — seuls la configuration et les sessions de l'application sont effacés. Vérifiez avant d'exécuter que vous n'avez plus besoin des anciennes sessions.

10.3 Sortie

Une fois réparé, aucun nettoyage manuel : quittez simplement l'assistant de récupération et démarrez l'application. Si vous avez cliqué sur « Redémarrer » depuis le mode de récupération, l'application refait un démarrage normal ; en cas de nouvel échec, vous revenez à l'assistant, sans boucle infinie.

11. Mise à jour

Cinq phases : vérifier → télécharger → installer → redémarrer → confirmer la version. Quatre opérations réutilisables :

• Vérification manuelle : plateau → « Vérifier les mises à jour… », ou Réglages → Version et mises à jour → « Vérifier les mises à jour ».
• Redémarrage : Réglages → Version et mises à jour → « Redémarrer » ; un clic sur l'annonce de mise à jour dans la barre de titre fonctionne aussi.
• Nettoyer les restes d'installation : un échec de mise à jour vient souvent d'une ancienne instance qui occupe les fichiers. Quittez l'application depuis le plateau et relancez l'installeur ; inutile de supprimer des répertoires à la main.
• Revenir en arrière : pour retrouver le dernier état qui démarrait, « Retour en arrière » de l'assistant de récupération. Pour passer à l'installeur du canal stable, prenez simplement la version correspondante sur la page de téléchargement et installez par-dessus : profils et plugins sont conservés.

12. En cas de problème

Exporter les informations de diagnostic

Plateau → « Exporter les informations de diagnostic… », ou la même entrée en bas de la page des réglages. Le paquet contient des chemins locaux, les journaux, les informations système et, en cas de plantage, des extraits de mémoire. Relisez-le avant de le partager : chemins et extraits de sessions peuvent contenir des données privées.

13. Où sont les données, où trouver de l'aide

Plus de documentation

• README.md / README.zh.md : installation, build, environnement de développement.
• docs/ : architecture, processus de publication, guide de développement de plugins.
• Dans le même répertoire, Nonead-DSH-Desktop-User-Manual.en.md et les versions HTML en huit langues : contenu correspondant, pratique pour comparer.
• CHANGELOG.md : les changements de chaque version ; l'entrée 2.2.9 contient une « Liste des plugins intégrés (35) » cohérente avec ce manuel.

Remerciements

Ce produit repose sur DeepSeek Harness en amont et sur la communauté open source : Electron, Node.js, pnpm, Python, ainsi que le système de plugins Cordis et l'écosystème des bundles officiels. Merci aux mainteneurs en amont et à toutes les personnes qui y contribuent.

Les 35 plugins distribués avec l'installeur viennent des auteurs et équipes suivants (classés par nom ; un même auteur peut en avoir plusieurs) :

La version, l'auteur et la description complète de chaque plugin sont livrés dans plugins/manifest.json, et visibles dans les détails de la page des plugins.

Le manuel suit les versions. Si vous constatez un écart avec la version actuelle, ouvrez une issue sur GitHub / GitCode.