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 sept é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 — ce qui est livré d'usine, les trois voies d'installation, la désinstallation.
• 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.

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.

Note : la build Windows ARM64 reste expérimentale. Le programme principal est natif ARM64, mais une partie des charges du paquet (runtimes Python / Node / Office intégrés, certains modules natifs) reste en x64 et n'a pas été entièrement vérifiée sur machine ARM ; pour un usage courant, préférez la version x64.

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 sept étapes ; vous pouvez à tout moment « ignorer la configuration » et compléter plus tard dans la page des réglages.

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

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 :

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 :

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 est vide (seulement les composants officiels de base) : il faut réinstaller les plugins — c'est précisément ce qui le rend propre.
• Supprimer un profil supprime aussi sa configuration locale et ses fichiers de plugins, sans retour possible.

9. Plugins : état d'usine et méthode d'installation

9.1 Ce qui est livré d'usine

L'installeur ne préinstalle aucun plugin tiers. Le profil par défaut créé au premier lancement ne charge que deux composants officiels de base :

• @deepseek-ai/dsh-base — le cœur du Host : sessions, outils, accès aux fichiers, connexion aux modèles.
• @deepseek-ai/dsh-web-app — l'interface web que vous voyez.

Autrement dit, juste après l'installation vous obtenez une application de bureau propre, capable de dialoguer, de lire et écrire des fichiers et d'exécuter des commandes ; le marché des plugins, les équipes d'experts, la saisie vocale, le tableau des tâches, le graphe de code, etc., c'est à vous de les installer. C'est un choix assumé : vous décidez de ce qui est installé, et en cas de problème il est facile de remonter au « dernier installé ».

9.2 Trois voies d'installation

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 npm, Miroir de Chine continentale, ou Adresse personnalisée (registre npm interne).
• 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.

Certains plugins sont livrés avec DSH : ils affichent « Ce plugin est livré avec DSH · Activez-le sans télécharger une autre copie », et l'activation suffit ; lorsqu'ils sont plus anciens que la version de DSH en cours, une « Mise à jour » apparaît. Entrent dans cette catégorie les équipes d'experts, la saisie vocale, le marché des plugins, la revue automatique, le terminal, la recherche de sessions, les titres de session, les compétences-badges, Ralph, la traduction de chaîne de pensée, Inspector, LiveShare, Forge, les outils de worktree et les recommandations personnalisées. Ceux qui sont volumineux ou lourds en dépendances et ne sont pas installés par défaut (sous-agent Claude Code, sous-agent Codex, contrôle du bureau Computer Use) s'activent de la même façon, à la demande, depuis la page des plugins.

Les composants de base intégrés à DSH (comme dsh-base et dsh-web-app) n'apparaissent pas dans la liste gérable de la page des plugins ; leur état d'exécution se consulte dans Paramètres → « Plugins intégrés ».

Le marché des plugins compte actuellement deux options : dsh-community-market (le marché ouvert intégré, qui accepte des sources de données personnalisées) et dsh-market (le marché des projets populaires de la communauté, alimenté par awesome-dsh-plugin). Un seul peut être actif à la fois.

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

9.3 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…).
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.4 Désactiver et désinstaller

• 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 « Désinstaller "…" ? » — ce qu'il fournit disparaît une fois désinstallé. Dans l'assistant de récupération, la même action porte le libellé « Désactiver ».
• Les composants dont la gestion des plugins a besoin (Host, service web, accès aux fichiers, etc.) portent la mention « La gestion des plugins en a besoin ; il ne peut pas être éteint ou désinstallé » — c'est ce qui empêche de réduire l'application à l'état de brique. 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 ».
• Un profil issu d'une mise à niveau garde le marché des plugins désactivé par défaut, jusqu'à ce que vous fassiez un choix explicite dans les réglages. Ce n'est pas une panne.

9.5 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.

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, Agents-Anywhere, 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 (« Redémarrer en mode de récupération ») ou depuis Paramètres → Version et mises à jour → « Redémarrer en mode 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 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 Paramètres → Version et mises à jour → « Vérifier les mises à jour ».
• Redémarrage : Paramètres → 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 : du canal de test vers la version stable, « Installer la version stable… » dans le plateau ; pour revenir au dernier état qui démarrait, « Retour en arrière » de l'assistant de récupération.

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.

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 informations sur les auteurs des plugins tiers accompagnent chaque plugin et se consultent dans la page des plugins ou dans les détails du marché ; ce manuel ne les énumère plus version par version, car cela relève de vos choix d'installation et non de l'état d'usine du produit.

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