# dsh-mobile-upgrade

[English](../../README.md) | [简体中文](../zh-Hans/README.md) | [繁體中文](../zh-Hant/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md) | [Español](../es/README.md) | Français | [Deutsch](../de/README.md) | [Русский](../ru/README.md)

Améliorations mobiles pour le profil web de [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`), livrées sous forme d'un plugin unique. Tout est rendu via les slots et signaux d'état de l'hôte lui-même — ni takeover de la mise en page, ni widgets flottants, ni interrogation du DOM de la conversation.

## Ce que vous obtenez

- **Ligne de redémarrage** — une entrée « Redémarrer le service » dans Paramètres → Général. Demande d'abord confirmation, redémarre le processus `dsh`, puis recharge la page automatiquement dès que le service répond à nouveau.
- **Commutateurs de modalité d'entrée** — cases à cocher text/image/video sur chaque ligne de modèle de l'éditeur de fournisseur natif, écrivant le tableau `input` du modèle dans `settings.yaml` (avec sauvegarde à côté du fichier). Les modèles de catalogue sans route personnalisée affichent les commutateurs en lecture seule.
- **Tiroir pour écrans étroits** — en dessous de 1024px, la barre latérale se réduit en une petite pastille d'angle qui conserve le bouton de l'hôte ; dépliée, la barre complète flotte en tiroir au-dessus du contenu pleine largeur, et choisir une session la referme. La pastille et le tiroir permutent de façon atomique (aucune animation de géométrie susceptible de se figer lorsque le thread principal est occupé), et un appui qui ferme le tiroir le replie dans cette même frame au lieu d'attendre le nouveau rendu de l'hôte — de sorte qu'un téléphone faisant tourner de nombreuses sessions ne peut pas laisser le tiroir coincé à moitié déplié, et la pastille fermée ne reste jamais blanche au-dessus d'un rail que l'hôte a déjà vidé.
- **Onglets de paramètres sur écran étroit** — en dessous de 700px, la navigation latérale du dialogue de paramètres devient une rangée d'onglets à défilement horizontal.
- **Menu de modèles pleine largeur** — en dessous de 700px, le menu de modèles du composer se ré-ancre exactement à la largeur du téléphone (marges de 12px) au lieu de sortir de l'écran ; le placement vertical au-dessus du déclencheur reste géré par l'hôte.
- **Carte de question défilable** — en dessous de 1024px, une question en attente ne peut plus enterrer ses propres choix : la question est plafonnée en hauteur dans sa propre zone de défilement, de sorte qu'une question longue défile sur place tandis que la liste d'options en dessous conserve la place qui reste et que les options, la rangée d'envoi et les boutons de réduction et de fermeture restent à l'écran et accessibles. Une question courte reste intacte, et la carte épouse toujours son contenu.
- **Contournement du panneau de détails** — le panneau d'outils plein écran dont le bouton de fermeture est inerte dans l'hôte actuel n'est pas rendu sur les écrans étroits, il ne peut donc pas bloquer la conversation.
- **Réactivité à l'épreuve des rafales** — les observateurs du tiroir/menu et le sondeur des paramètres réagissent à une rafale de messages en streaming à un débit plafonné et passent en repli tant que l'hôte est injoignable ; un remontage du rail pendant une reconnexion conserve l'état du tiroir au lieu de le faire clignoter, et les appuis fermant le tiroir sont retentés à travers un remontage au lieu de tomber sur un bouton périmé : de nombreuses sessions en streaming simultané ne figent plus la saisie et ne font plus tressaillir la barre latérale jusqu'à la rendre incliquable, ouverte ou fermée.
- **Garde du catalogue de sous-agents** — l'hôte sert le catalogue de sous-agents en énumérant tout le corpus de sessions à chaque requête (~1s sur un long historique), et son client demande à chaque sélection, survol de pastille et événement d'appartenance. Le plugin enveloppe ce rafraîchissement : un parent sans enfants dans la liste de sessions vivante n'est jamais interrogé, un parent est réinterrogé au plus une fois toutes les 2,5s, et les départs de rafraîchissement sont espacés — une distribution en sous-agents n'affame plus l'hôte avec des balayages complets du corpus.
- **Pastilles de lignée ouvrables au clic** — sur ordinateur, les pastilles de sous-agents (« N subagents » et le sélecteur de titre de sous-agents) ne s'ouvrent au survol que dans l'hôte actuel ; un clic ne fait rien. Le plugin traduit un clic sur une pastille en la paire d'événements de survol que l'hôte comprend déjà, de sorte que cliquer ouvre et ferme l'arbre (les fils d'Ariane des ancêtres gardent leur navigation au clic).
- **Collecteur d'en-tête sur écran étroit** — en dessous de 1024px, les pastilles de l'en-tête de session (lignée, tâches, préréglage) sont plus larges que le téléphone et uniquement au survol. Elles se replient en une seule pilule (`≡ titre · N agents · M jobs`) ; la toucher ouvre une feuille pleine largeur avec la lignée de la session (chaque ancêtre touchable, chacun avec son nombre de descendants), l'arbre de sous-agents enraciné à la racine de la famille — les lignes sont rendues depuis la liste de sessions vivante, les branches récupèrent leur catalogue à la demande via le rafraîchissement gardé — et les tâches en arrière-plan de cette session. Sur ordinateur, rien ne change.
- **Auto-mise à jour** — le bundle client est servi immuable par révision, donc un onglet de téléphone peut tourner des jours sur une build plus ancienne. La page compare la révision avec laquelle elle a démarré à celle que le serveur publie maintenant et se recharge elle-même une fois la page inactive (jamais pendant la saisie d'un brouillon), ou propose une bannière tactile.
- **Lissage du rendu de la liste des sessions** — l'hôte pousse un frame à valeur complète pour chaque changement de projection de chaque session attachée, et la vue de minutage d'un sous-agent en cours change à chaque événement validé : une flotte occupée en arrière-plan diffuse donc 50-150 frames/s dans la page. Chaque frame redessinait toute la liste des sessions (chaque reconstruction parcourt tous les résumés plus un balayage de cache en O(n²) — mesuré comme la majorité du temps du thread principal, gelant la page jusqu'au rechargement). Le plugin regroupe ces redessins sur un intervalle final adaptatif tandis que les valeurs continuent d'alimenter les stores par session sans changement — le streaming en arrière-plan ne gèle plus la page, sur n'importe quelle session, neuve ou ancienne.
- **Commutateurs par fonction** — le plugin installe une section `dsh-mobile-upgrade` dans Paramètres → Plugins avec un interrupteur par fonction.

## Captures d'écran

La pastille flottante et le tiroir de sessions (annotés) :

| | |
|---|---|
| ![Pastille flottante](../../res/shot-floating-chip.png) | ![Tiroir de sessions](../../res/shot-drawer.png) |

## Installation

```sh
dsh plugin --profile web add dsh-mobile-upgrade
```

Redémarrez `dsh web`, puis ouvrez le profil web sur votre téléphone : la ligne de redémarrage se trouve dans Paramètres → Général et les interrupteurs dans Paramètres → Plugins → dsh-mobile-upgrade. Les pièces jointes viennent du système d'attachement natif du composer de l'hôte.

Nécessite `dsh` 0.1.5-rc.1 ou plus récent (le système d'attachement intégré de l'hôte remplace la fonction d'envoi de ce plugin).

## Configuration

La carte de paramètres du plugin accepte :

| Clé | Par défaut | Signification |
|---|---|---|
| `restartEnabled` | `true` | Proposer la ligne de redémarrage et sa route |

## Commutateurs par fonction

Chaque fonction ci-dessus peut être activée ou désactivée dans Paramètres → Plugins → dsh-mobile-upgrade (effectif au prochain chargement de la page), ou remplacée par appareil avec une clé `localStorage` — `mfx-restart`, `mfx-settle`, `mfx-drawer`, `mfx-settings`, `mfx-modality`, `mfx-menus`, `mfx-net`, `mfx-questions`, `mfx-selfupdate`, `mfx-agents`, `mfx-header`, `mfx-listthrottle` — dont la valeur `"0"` désactive la fonction.

## Limitations connues

- Le client s'accroche à des éléments précis de l'interface de l'hôte via leurs noms de classes CSS hachées (menu, bouton du tiroir, éditeur de fournisseur, pastilles de l'en-tête de session). Si une build de l'hôte les renomme, les fonctions concernées se dégradent jusqu'à ce que ce plugin suive ; tout le reste continue de fonctionner. La région de la carte de question est en revanche repérée via le point d'accroche `data-question-key` propre à la carte, de sorte qu'une build de l'hôte qui se contente de recalculer le hachage de ses modules CSS la maintient fonctionnelle.
- Le collecteur d'en-tête et le shim de clic de lignée s'appuient sur les données propres de l'hôte (la liste de sessions vivante et ses catalogues de sous-agents) ; ils n'ajoutent aucune requête au-delà des récupérations de branches gardées, et un appui sur une ligne dont le mode est encore en chargement se complète de lui-même dès que ce catalogue arrive.
- Les commutateurs de modalité d'entrée ne peuvent modifier que les routes de fournisseurs que vous avez personnalisées ; les routes de catalogue seul sont en lecture seule par conception, car fabriquer une section de catalogue fait s'effondrer le répertoire de modèles.

## Notes de sécurité

Les routes HTTP du plugin (redémarrage, édition des paramètres) n'effectuent aucune authentification propre — elles font confiance à la surface web de `dsh` dans laquelle elles sont chargées. Avant toute exposition au-delà de localhost, placez le déploiement derrière la même barrière que le reste de l'interface (authentification par proxy inverse, écoute en loopback).

## Liens communautaires

- [Linux.Do](https://linux.do) — Une communauté pour partager et discuter de technologie.

## Licence

Distribué sous la [Synthetic Source License (SySL), version 1.0](LICENSE).

> AVIS : Ce logiciel comprend du code généré par une intelligence artificielle. Consultez le fichier LICENSE pour les termes de la Synthetic Source License, y compris les exigences de divulgation des modèles.