@zoraxylia/dsh-codex-adapter 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/.claude-plugin/marketplace.json +15 -0
  2. package/.claude-plugin/plugin.json +8 -0
  3. package/.mcp.json +8 -0
  4. package/LICENSE +21 -0
  5. package/README.de.md +480 -0
  6. package/README.es.md +480 -0
  7. package/README.fr.md +480 -0
  8. package/README.hi.md +480 -0
  9. package/README.id.md +480 -0
  10. package/README.ja.md +478 -0
  11. package/README.ko.md +480 -0
  12. package/README.md +483 -2
  13. package/README.pt.md +480 -0
  14. package/README.ru.md +480 -0
  15. package/README.th.md +480 -0
  16. package/README.tr.md +480 -0
  17. package/README.vi.md +480 -0
  18. package/README.zh-TW.md +478 -0
  19. package/README.zh.md +482 -0
  20. package/agents/ds-flash.md +17 -0
  21. package/agents/ds-pro.md +17 -0
  22. package/agy/agents/ds-flash.md +18 -0
  23. package/agy/agents/ds-pro.md +18 -0
  24. package/agy/skills/dsh-config/SKILL.md +6 -0
  25. package/agy/skills/dsh-playbook/SKILL.md +65 -0
  26. package/agy/skills/dsh-status/SKILL.md +6 -0
  27. package/codex/agents/ds-flash.toml +23 -0
  28. package/codex/agents/ds-pro.toml +23 -0
  29. package/codex/prompts/dsh-config.md +3 -0
  30. package/codex/prompts/dsh-playbook.md +60 -0
  31. package/codex/prompts/dsh-status.md +1 -0
  32. package/commands/config.md +9 -0
  33. package/commands/off.md +5 -0
  34. package/commands/on.md +5 -0
  35. package/commands/playbook.md +64 -0
  36. package/commands/status.md +5 -0
  37. package/cordis.patch.yml +4 -0
  38. package/docs/images/dsh-adapter-host.png +0 -0
  39. package/docs/images/dsh-adapter-jobs.png +0 -0
  40. package/docs/images/dsh-adapter-logo.png +0 -0
  41. package/docs/images/dsh-adapter-overview.png +0 -0
  42. package/grok/agents/ds-flash.md +19 -0
  43. package/grok/agents/ds-pro.md +19 -0
  44. package/grok/commands/dsh-config.md +9 -0
  45. package/grok/commands/dsh-playbook.md +66 -0
  46. package/grok/commands/dsh-status.md +5 -0
  47. package/lib/client.js +2694 -0
  48. package/lib/server.mjs +15417 -0
  49. package/package.json +138 -4
  50. package/scripts/build-client.mjs +23 -0
  51. package/scripts/build-mcp.mjs +43 -0
  52. package/scripts/bump-version.mjs +79 -0
  53. package/scripts/fake-agy.sh +23 -0
  54. package/scripts/release-local.mjs +87 -0
  55. package/scripts/smoke-bundle.mjs +166 -0
  56. package/scripts/smoke-cwd.mjs +41 -0
  57. package/scripts/smoke-pack.mjs +285 -0
  58. package/scripts/smoke.mjs +79 -0
  59. package/scripts/verify-cli-workers.mjs +133 -0
  60. package/scripts/verify-wpc10-client.mjs +237 -0
  61. package/scripts/verify-wpc14-proc-endpoints.mjs +356 -0
  62. package/scripts/verify-wpc9-guardrails.mjs +432 -0
  63. package/src/cli-workers.mjs +396 -0
  64. package/src/client/index.tsx +1135 -0
  65. package/src/client/jobs-view.ts +374 -0
  66. package/src/cwd-lock.mjs +91 -0
  67. package/src/hub/index.mjs +643 -0
  68. package/src/hub-client.mjs +72 -0
  69. package/src/i18n.mjs +19 -0
  70. package/src/install/cli.mjs +34 -0
  71. package/src/install/install.mjs +580 -0
  72. package/src/jobs.mjs +289 -0
  73. package/src/multimodal.mjs +744 -0
  74. package/src/origin-guard.mjs +133 -0
  75. package/src/paths.mjs +43 -0
  76. package/src/plugin-env.mjs +65 -0
  77. package/src/proc-kill.mjs +208 -0
  78. package/src/process-info.mjs +60 -0
  79. package/src/provider-probe.mjs +35 -0
  80. package/src/server.mjs +438 -0
  81. package/src/status-shard.mjs +95 -0
  82. package/src/tier-binding.mjs +63 -0
  83. package/src/vision-route.mjs +139 -0
  84. package/src/worker-profiles.mjs +95 -0
  85. package/src/worker-question.mjs +22 -0
  86. package/statusline/statusline.sh +14 -0
  87. package/statusline/worker-segment.sh +35 -0
  88. package/worker.cordis.yml +77 -0
package/README.fr.md ADDED
@@ -0,0 +1,480 @@
1
+ <p align="center">
2
+ <img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
3
+ </p>
4
+
5
+ <h1 align="center">DSH Adapter</h1>
6
+
7
+ <p align="center">
8
+ <strong>Un plugin <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> : envoyer du travail à des agents DSH depuis Claude Code / Codex / Antigravity / Grok, sans renoncer à l'interface native de subagents de l'hôte.</strong><br />
9
+ <sub>Interface de progression native &bull; Politique de tier et escalade &bull; Garde-fous d'envoi &bull; Tableau des jobs &bull; Sessions DSH dans l'hôte &bull; Vision et génération d'images (natif d'abord) &bull; Installation en un clic</sub>
10
+ </p>
11
+
12
+ <p align="center">
13
+ <sub>npm: <code>@zoraxylia/dsh-codex-adapter</code> &middot; Version actuelle du plugin : <code>0.1.0-rc.11</code> &middot; Testé avec DSH <code>0.1.1-rc.1</code></sub>
14
+ </p>
15
+
16
+ <p align="center">
17
+ <a href="./README.md"><b>English</b></a> &middot; <a href="./README.zh.md">简体中文</a> &middot; <a href="./README.zh-TW.md">繁體中文</a> &middot; <a href="./README.ja.md">日本語</a> &middot; <a href="./README.ko.md">한국어</a> &middot; <a href="./README.fr.md"><b>Français</b></a> &middot; <a href="./README.es.md">Español</a> &middot; <a href="./README.de.md">Deutsch</a> &middot; <a href="./README.pt.md">Português</a> &middot; <a href="./README.ru.md">Русский</a> &middot; <a href="./README.hi.md">हिन्दी</a> &middot; <a href="./README.tr.md">Türkçe</a> &middot; <a href="./README.th.md">ไทย</a> &middot; <a href="./README.vi.md">Tiếng Việt</a> &middot; <a href="./README.id.md">Bahasa Indonesia</a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="https://github.com/ZSeven-W/dsh-crew/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ZSeven-W/dsh-crew?color=64748b" alt="License" /></a>
22
+ </p>
23
+
24
+ <br />
25
+
26
+ <p align="center">
27
+ <img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
28
+ </p>
29
+ <p align="center"><sub>La page de paramètres de DSH Adapter — intégrations hôte, politique d'envoi, exécution et pont multimodal</sub></p>
30
+
31
+ ## Pourquoi DSH Adapter
32
+
33
+ DSH Adapter est un plugin pour [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — un harness open-source pour agents. Il permet d'envoyer des agents DSH depuis Claude Code, Codex, Antigravity et Grok : l'orchestrateur conserve son propre modèle, le travail s'exécute sur un véritable agent DSH avec les outils, le sandbox, les presets et l'historique de session de ce harness, et l'hôte l'affiche toujours comme un subagent natif avec une progression en direct.
34
+
35
+ Ce qui exécute le travail est un agent DSH, pas un simple appel de modèle. Les tiers (`flash` / `pro`) sélectionnent le niveau de capacité que cet agent reçoit depuis le roster configuré du harness — DeepSeek V4 Flash et V4 Pro aujourd'hui — donc un changement de modèle dans DSH ne nécessite aucun changement ici.
36
+
37
+ <table>
38
+ <tr>
39
+ <td width="50%">
40
+
41
+ ### 🧵 Interface de progression native
42
+
43
+ Les workers apparaissent comme des subagents normaux dans Claude Code / Codex / Antigravity / Grok — le nombre d'envois, l'étape en cours, les appels d'outils et l'utilisation de tokens s'affichent dans le panneau de tâches de l'hôte, plus un segment statusline claude-hud : `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3`.
44
+
45
+ </td>
46
+ <td width="50%">
47
+
48
+ ### 🎚️ Politique de tier et escalade
49
+
50
+ `flash` pour le travail mécanique, `pro` pour le raisonnement, `effort` de `off` à `max`. `tier_policy` peut verrouiller chaque envoi sur un seul tier au niveau de la couche d'outils, et `escalate_on_failure` relance une fois sur pro une exécution flash ayant échoué — sur la base de preuves, pas en devinant la difficulté à l'avance.
51
+
52
+ </td>
53
+ </tr>
54
+ <tr>
55
+ <td width="50%">
56
+
57
+ ### 🏛️ Sessions DSH dans l'hôte
58
+
59
+ Avec le bundle installé dans un profil DSH, chaque worker est une session DSH de première classe : visible dans la Web UI, regroupée par répertoire de travail, montée avec le preset Agent que vous choisissez par tier. Sans DSH en cours d'exécution, l'envoi retombe sur un runtime DSH standalone, donc les environnements CI et headless fonctionnent toujours.
60
+
61
+ </td>
62
+ <td width="50%">
63
+
64
+ ### 👁️ Vision et génération d'images
65
+
66
+ Les modèles de DSH sont uniquement textuels. `describe_image` préfère désormais le propre modèle VL de DeepSeek (`deepseek-v4-flash-vision-exp`) dès qu'une clé est disponible, puis retombe sur les CLI que vous avez déjà — Claude, Codex, Grok, Antigravity — ou sur toute API compatible OpenAI que vous configurez. `generate_image` emprunte le pinceau de ces mêmes CLI. Les images collées restent visibles dans la conversation et arrivent au modèle sous forme de texte.
67
+
68
+ </td>
69
+ </tr>
70
+ <tr>
71
+ <td width="50%">
72
+
73
+ ### 🛡️ Garde-fous d'envoi
74
+
75
+ Chaque envoi est vérifié avant que quoi que ce soit ne soit lancé. L'imbrication worker→worker est plafonnée à une profondeur de chaîne d'origine de 3 et les cycles sont refusés ; un second worker sur un espace de travail qu'un autre job détient déjà est refusé avec les informations du détenteur — jamais mis en file silencieusement. Les refus sont des erreurs lisibles : attendez ou recadrez, ne contournez pas.
76
+
77
+ </td>
78
+ <td width="50%">
79
+
80
+ ### 📋 Tableau des jobs
81
+
82
+ Le panneau DSH Adapter fait aussi office de tableau des jobs : chaque job worker — en cours ou terminé — est listé avec son tier, son effort, sa progression en direct et ses tokens, les espaces de travail détenus indiquent leurs détenteurs, et un job qui disparaît en plein vol (par ex. un redémarrage du hub) apparaît comme un fantôme orphelin au lieu de disparaître silencieusement.
83
+
84
+ </td>
85
+ </tr>
86
+ <tr>
87
+ <td width="50%">
88
+
89
+ ### 🔌 Fournisseurs personnalisés
90
+
91
+ Apportez votre propre endpoint (Base URL + clé API + modèles) ou un modèle de commande local. Chaque fournisseur dispose d'un test de connectivité qui vérifie l'accessibilité et l'authentification, puis effectue un véritable appel vision pour que vous le sachiez maintenant, pas en pleine tâche.
92
+
93
+ </td>
94
+ <td width="50%">
95
+
96
+ ### 📦 Installation en un clic
97
+
98
+ La page de paramètres installe et met à jour le plugin Claude Code, les fichiers de rôle Codex et les agents, skills et commandes Antigravity / Grok pour vous — enregistrement marketplace, liste blanche de permissions, câblage HUD, chemins absolus rendus pour cette machine — et les restaure tout aussi facilement. Chaque fichier de paramètres est d'abord sauvegardé.
99
+
100
+ </td>
101
+ </tr>
102
+ </table>
103
+
104
+ ## Comment ça marche
105
+
106
+ ```
107
+ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
108
+ └─ ds-flash / ds-pro ← native subagent shell (progress shows in the host's task UI)
109
+ └─ MCP: dsh_run_worker(tier, effort, cwd, worker=)
110
+ ├─ worker="agy"/"grok" → that external CLI runs the task (explicit opt-in)
111
+ ├─ hub reachable → session inside DSH (visible in the Web UI, grouped by cwd)
112
+ └─ otherwise → dsh-jsonrpc-agent runtime (worker.cordis.yml)
113
+ └─ DeepSeek V4 Flash / Pro (DSH SDK, event stream → progress and token stats)
114
+ ```
115
+
116
+ ## Une exécution, deux points de vue
117
+
118
+ La répartition s'étale. Ci-dessous, dix-huit workers traduisent ce README en parallèle : l'hôte les compte comme ses propres subagents, tandis que le harness les exécute comme de vraies sessions.
119
+
120
+ <p align="center">
121
+ <img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
122
+ </p>
123
+ <p align="center"><sub>Dans Claude Code, les workers dsh-adapter sont des subagents natifs ; le segment de statusline suit les tiers en cours, le temps écoulé et les tokens.</sub></p>
124
+
125
+ <p align="center">
126
+ <img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
127
+ </p>
128
+ <p align="center"><sub>Le panneau DSH Adapter montre la même exécution côté harness : quel hôte a lancé chaque tâche, son tier et son effort, sa progression et ses tokens.</sub></p>
129
+
130
+ <p align="center"><sub>Le panneau est aussi le tableau des jobs : les jobs en cours et terminés restent listés avec tier, progression et tokens, les espaces de travail détenus indiquent leurs détenteurs, et un job qui disparaît en plein vol (un redémarrage du hub) apparaît comme un fantôme orphelin au lieu de disparaître silencieusement.</sub></p>
131
+
132
+ ## Installation
133
+
134
+ Installer depuis npm dans un profil DSH :
135
+
136
+ ```bash
137
+ dsh plugin --profile web add @zoraxylia/dsh-codex-adapter@latest
138
+ dsh web
139
+ ```
140
+
141
+ Ou, pour le développement local depuis les sources :
142
+
143
+ ```bash
144
+ dsh plugin --profile web add link:/path/to/dsh-adapter
145
+ dsh web
146
+ ```
147
+
148
+ Le protocole `link:` crée un lien symbolique vers ce dépôt, donc chaque rebuild est visible immédiatement.
149
+
150
+ ### Configurer les identifiants DeepSeek (standalone uniquement)
151
+
152
+ En mode hub — l'installation ci-dessus — les workers s'exécutent dans l'instance DSH et utilisent les identifiants DeepSeek avec lesquels elle est déjà configurée. Rien d'autre à configurer.
153
+
154
+ Seul le fallback standalone a besoin d'une clé propre : envoyer du travail depuis un hôte sans instance DSH en cours d'exécution lance un worker runtime comme processus séparé. Récupérez une clé API sur [platform.deepseek.com](https://platform.deepseek.com) et écrivez-la dans `~/.config/dsh-adapter/.env` :
155
+
156
+ ```
157
+ DEEPSEEK_API_KEY=sk-...
158
+ ```
159
+
160
+ ### Vérifier
161
+
162
+ ```bash
163
+ node scripts/smoke.mjs
164
+ ```
165
+
166
+ Le smoke test envoie une tâche peu coûteuse par le chemin disponible — le hub si une instance DSH tourne, sinon standalone — et affiche lequel a été utilisé. En une dizaine de secondes, `smoke test passed — configuration OK` doit s'afficher. En cas d'échec, la raison est imprimée et limitée au chemin qui a été testé.
167
+
168
+ Ouvrez ensuite Réglages → DSH Adapter pour installer les intégrations hôte — Claude Code, Codex, Antigravity, Grok — en un clic, ou pilotez le même installeur depuis la ligne de commande :
169
+
170
+ ```bash
171
+ node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
172
+ node src/install/cli.mjs codex # Codex agents + prompts
173
+ node src/install/cli.mjs agy # Antigravity MCP config + agents + skills
174
+ node src/install/cli.mjs grok # Grok MCP config + agents + commands
175
+ node src/install/cli.mjs all # all four hosts at once
176
+ # uninstall symmetrically (uninstall-claude | uninstall-codex | uninstall-agy | uninstall-grok):
177
+ node src/install/cli.mjs uninstall-claude
178
+ ```
179
+
180
+ ## Contexte et terminologie
181
+
182
+ - **DSH** (DeepSeek Harness) : le harness open-source pour agents de DeepSeek, un agent code sous forme de Web UI, similaire à Claude Code mais pilotant les modèles DeepSeek.
183
+ - **MCP** (Model Context Protocol) : le protocole d'intégration d'outils IA d'Anthropic, qui permet aux LLM d'appeler en toute sécurité des outils externes et des sources de données.
184
+ - **Cordis bundle** : le format de plugin de DSH ; ce projet peut s'exécuter en standalone comme service MCP ou s'installer dans DSH Web en mode hub.
185
+ - **tier** : niveau de capacité — quel emplacement du roster de modèles configuré de DSH un worker reçoit. `flash` est rapide et peu coûteux (tâches simples), `pro` raisonne plus en profondeur (problèmes complexes). Aujourd'hui, ils correspondent à DeepSeek V4 Flash et V4 Pro ; changez les modèles dans DSH et rien ne change ici.
186
+ - **worker** : l'agent DSH qui effectue le travail — une session complète avec ses propres outils, sandbox et preset, pas un simple appel de modèle.
187
+ - **effort** : intensité de raisonnement, `off` = aucun raisonnement, `high` = investissement de raisonnement élevé, `max` = investissement de raisonnement maximal.
188
+
189
+ ## Claude Code
190
+
191
+ ### Installation
192
+
193
+ Installation en un clic (choisissez une option) :
194
+
195
+ - **Page de paramètres DSH** (quand le mode hub est installé) : Paramètres → DSH Adapter → « Install to Claude Code »
196
+ - **Ligne de commande** : `node src/install/cli.mjs all`
197
+
198
+ Les deux font la même chose : enregistrer le marketplace local (le répertoire parent `dsh-plugins/` comme racine marketplace) + `claude plugin install` + liste blanche de permissions des outils MCP + configuration du segment de statut worker claude-hud (sauvegarde automatique de settings.json avant modification, idempotent). **Redémarrez la session après l'installation pour que les changements prennent effet.**
199
+
200
+ ### Utilisation
201
+
202
+ - Directement en conversation, dites « dispatch X to ds-flash » ou « dispatch X to ds-pro » et le subagent exécute la tâche
203
+ - Le nombre d'envois et la progression en temps réel s'affichent dans l'interface de tâches de Claude Code
204
+ - **Segment de ligne de statut HUD** : `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier actuel / temps écoulé / utilisation de tokens / nombre de tâches terminées)
205
+ - Pour le développement local, `statusline/statusline.sh` ou `statusline/worker-segment.sh` peuvent être intégrés indépendamment
206
+ - **Tâches longues** : CC a des limites de timeout sur les appels MCP (`MCP_TOOL_TIMEOUT` ajustable) ; pour les tâches longues, l'orchestrateur peut utiliser `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` en polling
207
+ - **Développement local et débogage** : `claude --plugin-dir /path/to/dsh-adapter` pour charger temporairement
208
+
209
+
210
+ ### Commandes de session
211
+
212
+ Elles ne remplacent les valeurs globales que pour la session courante, et sont appliquées au niveau de l'outil plutôt que par le prompt :
213
+
214
+ | Commande | Effet |
215
+ |---|---|
216
+ | `/dsh-adapter:config` | Afficher ou définir les valeurs par défaut de la session : `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<secondes>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
217
+
218
+ | `/dsh-adapter:on` · `/dsh-adapter:off` | Activer ou désactiver la répartition pour cette session (désactivé = interrupteur strict, l'outil refuse) |
219
+ | `/dsh-adapter:status` | État en direct des jobs worker : tier, progression, tokens, outil courant |
220
+ | `/dsh-adapter:playbook` | Bonnes pratiques d'envoi : choisir flash ou pro, briefs autonomes, parallélisme, vérification des résultats, garde-fous |
221
+
222
+ ## Codex
223
+
224
+ ### Installation
225
+
226
+ Il est recommandé d'utiliser l'installeur (génère automatiquement les chemins pour cette machine, copie les prompts `/dsh-config`, `/dsh-status` et `/dsh-playbook`) :
227
+
228
+ ```bash
229
+ node src/install/cli.mjs codex
230
+ ```
231
+
232
+ Ou copie manuelle (nécessite une modification manuelle des chemins après copie) :
233
+
234
+ ```bash
235
+ cp codex/agents/*.toml ~/.codex/agents/ # global or project-level .codex/agents/
236
+ ```
237
+
238
+ Les fichiers de rôle sont préconfigurés avec :
239
+
240
+ - Configuration de montage du serveur MCP
241
+ - `default_tools_approval_mode = "approve"` (**requis**, sinon les appels d'outils sont automatiquement annulés en mode exec)
242
+ - `tool_timeout_sec = 3600`
243
+
244
+ **Remarque** : en cas de copie manuelle, les chemins absolus dans le champ `args` doivent être mis à jour pour correspondre à l'emplacement réel d'installation ; l'installeur s'en charge automatiquement.
245
+
246
+ ### Utilisation
247
+
248
+ - Dans la TUI interactive, sélectionnez « spawn ds-pro to ... » pour envoyer des tâches ; les panneaux Active/Done affichent la progression
249
+ - Le mode `codex exec` peut aussi appeler directement `dsh_run_worker`
250
+
251
+
252
+ ### Commandes de session
253
+
254
+ Trois prompts sont installés pour Codex :
255
+
256
+ | Commande | Effet |
257
+ |---|---|
258
+ | `/dsh-config` | Afficher ou définir les valeurs par défaut de la session : `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<secondes>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
259
+
260
+ | `/dsh-status` | État en direct des jobs worker : tier, progression, tokens, outil courant |
261
+ | `/dsh-playbook` | Bonnes pratiques d'envoi : choisir flash ou pro, briefs autonomes, parallélisme, vérification des résultats, garde-fous |
262
+
263
+ ## Antigravity (agy)
264
+
265
+ ### Installation
266
+
267
+ ```bash
268
+ node src/install/cli.mjs agy
269
+ ```
270
+
271
+ Enregistre le serveur MCP dsh-adapter dans `~/.gemini/config/mcp_config.json` et installe les agents `ds-flash` / `ds-pro` ainsi que les skills `dsh-config`, `dsh-status` et `dsh-playbook` dans `~/.gemini/config/` (tous les fichiers sont d'abord sauvegardés). Redémarrez la session après l'installation.
272
+
273
+ ### Utilisation
274
+
275
+ - Choisissez `ds-flash` ou `ds-pro` comme agent pour envoyer des tâches
276
+ - `dsh_worker_config` lit ou remplace les valeurs par défaut de la session
277
+
278
+ ### Skills de session
279
+
280
+ | Skill | Effet |
281
+ |---|---|
282
+ | `/dsh-config` | Afficher ou définir les valeurs par défaut de la session (tier / effort / mode / timeout / policy / escalation / reset) |
283
+ | `/dsh-status` | État en direct des jobs worker : tier, progression, tokens, outil courant |
284
+ | `/dsh-playbook` | Bonnes pratiques d'envoi : choisir flash ou pro, briefs autonomes, parallélisme, vérification des résultats, garde-fous |
285
+
286
+ ### Mises en garde
287
+
288
+ - agy exécute les workers avec **approbation totale** (`--dangerously-skip-permissions` + accept-edits) : agy 1.1.16 n'a pas de mode de permission limité à l'espace de travail, un worker headless doit donc auto-approuver les demandes d'outils.
289
+
290
+ Désinstallation : `node src/install/cli.mjs uninstall-agy`
291
+
292
+ ## Grok
293
+
294
+ ### Installation
295
+
296
+ ```bash
297
+ node src/install/cli.mjs grok
298
+ ```
299
+
300
+ Écrit la section `[mcp_servers.dsh-adapter]` dans `~/.grok/config.toml` et installe les agents `ds-flash` / `ds-pro` ainsi que les commandes `/dsh-config`, `/dsh-status` et `/dsh-playbook` dans `~/.grok/` (tous les fichiers sont d'abord sauvegardés).
301
+
302
+ ### Utilisation
303
+
304
+ - Choisissez `ds-flash` ou `ds-pro` comme agent pour envoyer des tâches
305
+
306
+ ### Commandes de session
307
+
308
+ | Commande | Effet |
309
+ |---|---|
310
+ | `/dsh-config` | Afficher ou définir les valeurs par défaut de la session (tier / effort / mode / timeout / policy / escalation / reset) |
311
+ | `/dsh-status` | État en direct des jobs worker : tier, progression, tokens, outil courant |
312
+ | `/dsh-playbook` | Bonnes pratiques d'envoi : choisir flash ou pro, briefs autonomes, parallélisme, vérification des résultats, garde-fous |
313
+
314
+ ### Mises en garde
315
+
316
+ - Par conception de sécurité, grok ne démarre pas les serveurs MCP au niveau du dépôt dans les répertoires de projet non fiables (`grok mcp doctor` signale « folder untrusted ») ; une installation globale n'est pas affectée — changez de répertoire ou passez `--trust`.
317
+ - Les workers grok s'exécutent avec `bypassPermissions` (toujours approuver, comme le recommandent les docs grok pour l'automatisation headless) ; les règles de refus et les hooks s'appliquent toujours.
318
+
319
+ Désinstallation : `node src/install/cli.mjs uninstall-grok`
320
+
321
+ ## Outils MCP
322
+
323
+ | Outil | Description |
324
+ |---|---|
325
+ | `dsh_run_worker` | Envoi de tâche bloquant (`tier` : flash/pro, `effort` : off/high/max, `cwd`, `worker`), attend le résultat |
326
+ | `dsh_spawn_worker` | Envoi asynchrone, renvoie un identifiant de job (pour le fan-out parallèle) ; récupérez les résultats avec `dsh_worker_result` |
327
+ | `dsh_worker_status` | Progression en temps réel de tous les jobs (turn/step/outil actuel/token) + verrous consultatifs cwd |
328
+ | `dsh_worker_result` | Récupère le résultat, peut spécifier `wait_seconds` pour attendre |
329
+ | `dsh_worker_cancel` | Annule le job spécifié et termine son processus runtime |
330
+ | `dsh_worker_config` | Lit/définit les valeurs par défaut de la session (tier, effort, mode, timeout, policy, escalation) et liste les `worker_profiles` |
331
+
332
+ La progression est simultanément répliquée dans `~/.config/dsh-adapter/status.d/` (un fichier shard par écrivain, lisible par statusline / surveillance externe).
333
+
334
+ ## Garde-fous d'envoi
335
+
336
+ Chaque envoi est vérifié avant que quoi que ce soit ne soit lancé — les refus sont des erreurs lisibles, jamais des files d'attente silencieuses :
337
+
338
+ - **Chaîne d'origine** : chaque envoi ajoute un saut à la chaîne d'origine worker→worker. Une imbrication plus profonde que la limite (`origin_depth_limit`, 3 par défaut) est refusée, tout comme tout cycle (le même backend + cwd apparaissant deux fois) — le garde-fou qui arrête l'auto-amplification récursive des workers.
339
+ - **Verrou consultatif cwd** : un seul worker en cours par espace de travail. Un second envoi dans un espace de travail détenu est refusé avec l'identifiant de job du détenteur, son backend et son heure de démarrage — attendez qu'il se termine, annulez-le avec `dsh_worker_cancel`, ou passez `allow_concurrent_cwd: true` (tâches en lecture seule uniquement).
340
+
341
+ ## Playbook d'envoi
342
+
343
+ Comment *bien* envoyer — flash ou pro, des briefs autonomes, un parallélisme sûr, la vérification des résultats et les garde-fous ci-dessus — est fourni sous forme de playbook par hôte : `/dsh-adapter:playbook` (skill Claude Code), `/dsh-playbook` (prompt Codex, skill Antigravity, commande Grok).
344
+
345
+ ## Backends CLI explicites
346
+
347
+ `worker="agy"` / `worker="grok"` épingle un envoi à cette CLI externe (backend × modèle × effort) au lieu de la logique de tier DSH. C'est un opt-in explicite — il n'y a pas de valeur par défaut, ne le définissez donc que lorsque l'utilisateur demande cette CLI. Mises en garde : grok refuse de démarrer des serveurs MCP locaux au dépôt dans des dossiers non fiables, et agy exécute les workers avec une approbation totale (pas de mode de permission limité à l'espace de travail).
348
+
349
+ ## Multimodal : vision et génération d'images
350
+
351
+ **DeepSeek est un modèle uniquement textuel** et ne prend pas en charge la saisie ou la génération d'images. Ce plugin obtient ces capacités en externe via des outils MCP :
352
+
353
+ **La vision native d'abord** : lorsque le fournisseur de vision est une CLI intégrée (ou explicitement `native`), `describe_image` essaie d'abord le propre modèle VL de DeepSeek `deepseek-v4-flash-vision-exp` (appel API direct ; clé depuis `DEEPSEEK_API_KEY` ou `~/.config/dsh-adapter/.env`). Tout échec se replie gracieusement sur la chaîne de fournisseurs CLI ci-dessous, conservée comme fallback. La génération d'images n'est pas touchée — le modèle natif ne fait que regarder des images.
354
+
355
+ | Outil | Description |
356
+ |---|---|
357
+ | `describe_image` | Répond aux questions en visualisant des images (captures d'écran, maquettes, graphiques, etc.) ; résultats mis en cache par fournisseur + modèle + image + question |
358
+ | `generate_image` | Génère une image à partir d'une description textuelle, l'enregistre dans le chemin absolu spécifié ; la sortie est un bitmap plat (nécessite OpenPencil pour l'édition en couches) |
359
+
360
+ **Collage d'images en session** : dans DSH, passez le modèle sur `DeepSeek (vision) ◉` pour coller directement des images. Les images restent dans la session et s'affichent normalement ; le plugin ajoute le texte transcrit après elles et retire les images avant l'envoi — vous voyez l'image, le modèle lit le texte. La transcription suit la même échelle « natif d'abord » : le modèle VL de DeepSeek lorsqu'une clé est disponible, puis votre fournisseur CLI configuré.
361
+
362
+ ### Configuration
363
+
364
+ Dans **la page de paramètres DSH → DSH Adapter → Multimodal** (ou modifiez directement `~/.config/dsh-adapter/config.json`) :
365
+
366
+ **Fournisseur de vision** (visualisation d'images) :
367
+
368
+ - `native` / `deepseek-native` (le propre modèle VL de DeepSeek — essayé en premier automatiquement pour chaque fournisseur intégré dès qu'une clé est disponible)
369
+ - `claude-code` (par défaut, utilise haiku, peu coûteux)
370
+ - `codex` (utilise GPT, peut spécifier un modèle particulier)
371
+ - `grok` (utilise Grok)
372
+ - `agy` (Antigravity)
373
+ - `custom` (API compatible OpenAI ou commande locale)
374
+ - `off` (désactivé)
375
+
376
+ **Fournisseur de génération d'images** (génération d'images) :
377
+
378
+ - `codex` (`$imagegen`, gpt-image-2)
379
+ - `agy` (Nano Banana)
380
+ - `grok` (Imagine)
381
+ - `custom` (API compatible OpenAI ou commande locale)
382
+ - `off` (désactivé)
383
+
384
+ ### Fournisseur personnalisé
385
+
386
+ Deux méthodes d'intégration :
387
+
388
+ **API** : tout endpoint compatible OpenAI
389
+ - Renseignez Base URL, la clé API et la liste de modèles
390
+ - La vision utilise `/chat/completions` avec des images base64 en ligne
391
+ - La génération d'images utilise `/images/generations`
392
+ - **Vous devez spécifier le « modèle de génération d'images » pour disposer de la capacité de génération**, sinon le fournisseur n'apparaît que dans la sélection de vision
393
+
394
+ **CLI** : modèle de commande locale, avec des espaces réservés remplacés par des références sûres
395
+ - Vision : `{image} {question} {model}` → stdout comme réponse
396
+ - Génération d'images : `{prompt} {output} {size}` → la commande doit écrire le fichier dans `{output}`
397
+ - Renseignez au moins une commande ; celle qui est remplie détermine la capacité
398
+
399
+ **Test de connectivité** : chaque fournisseur personnalisé dispose d'un bouton de test
400
+ - API : vérifier l'accessibilité de l'endpoint, l'authentification, envoyer une vraie requête vision pour valider
401
+ - CLI : vérifier le fichier exécutable, exécuter une vraie commande pour valider
402
+ - Génération d'images : valider uniquement la configuration, sans sortie d'image réelle
403
+
404
+ **CLI d'abonnement empruntées** (claude / codex / grok / agy) exigent que vous soyez connecté localement ; le plugin ne contournera pas leurs permissions à votre place.
405
+
406
+ ## Mode hub
407
+
408
+ Ce package est aussi un bundle DSH valide (`dsh.bundle` + `cordis.patch.yml`). Après installation dans un profil DSH Web avec `dsh plugin add dsh-adapter` :
409
+
410
+ - **Les sessions worker deviennent des citoyens de première classe** : elles s'exécutent comme des sessions de première classe dans l'hôte DSH (`agents.create` + cascade modèle/effort par session + preset par défaut), apparaissent dans la liste des sessions de la Web UI et peuvent être ouvertes à tout moment pour voir l'exécution complète
411
+ - **Organisation par répertoire de travail** : gérez les sessions worker par cwd dans la Web UI
412
+ - **API loopback** :
413
+ - `POST/GET /_dsh/dsh-adapter/jobs` : lancer des tâches, lister, long-poll des résultats, annuler
414
+ - `GET /_dsh/dsh-adapter/ping` : health check (le shim MCP l'utilise pour détecter si le hub fonctionne)
415
+ - `POST /_dsh/dsh-adapter/install` : installation en un clic des intégrations hôte — Claude Code / Codex / Antigravity / Grok (backend de `src/install/`)
416
+ - **Détection automatique** : le shim MCP des hôtes détecte automatiquement le hub (variable d'environnement `DSHPLUGIN_ADAPTER_HUB`, défaut `http://127.0.0.1:3080`)
417
+ - DSH Web actif → les jobs passent en mode hub (`mode: "hub"`)
418
+ - Non actif → repli sur le runtime standalone
419
+
420
+ **Inspection des processus Windows :** la détection de la source et l’arrêt vérifié d’un processus utilisent PowerShell/CIM. L’API des processus orphelins refuse l’arrêt d’un groupe avec `unsupported-platform`, sans envoyer de signal.
421
+
422
+ ## Choix de solution et limitations
423
+
424
+ ### Abonnés réguliers → approche par subagent shell (recommandé)
425
+
426
+ - **État actuel** : le shell subagent de Claude Code utilise haiku comme intermédiaire ; chaque envoi ajoute des centaines à des milliers de tokens
427
+ - **Compromis** : utiliser une petite quantité de tokens Anthropic en échange de l'interface de tâches native, de l'affichage de progression en temps réel et d'aucune configuration supplémentaire
428
+ - **Recommandation** : si vous êtes déjà abonné à Claude Pro ou utilisez Claude Code, utilisez cette approche — pratique et transparente
429
+
430
+ ### Paiement à l'usage / environnements CI → approche routeur direct
431
+
432
+ - **État actuel** : le frontmatter de subagent de Claude Code ne prend pas en charge la connexion directe à un modèle tiers ; l'expérience de routeur de ce dépôt dans scratchpad nécessite des identifiants de type clé API pour Claude Code, mais l'OAuth par abonnement est bloqué en amont par Anthropic avec une 403
433
+ - **Recommandation** :
434
+ - Si vous utilisez des identifiants par clé API (pas OAuth) et souhaitez économiser les tokens Anthropic, vous pouvez exécuter un routeur local pour une connexion directe à DeepSeek
435
+ - Les environnements CI utilisent généralement aussi des clés API ; cette approche est plus économique (uniquement des tokens DeepSeek)
436
+ - Nécessite de tester soi-même l'intégration du routeur (non officiellement prise en charge)
437
+
438
+ ### DSH Web en cours d'exécution → mode hub activé automatiquement
439
+
440
+ - **État actuel** : si `dsh plugin add dsh-adapter` est installé dans un profil DSH Web, les jobs s'exécutent comme des sessions de première classe dans l'hôte et apparaissent dans la liste des sessions de la Web UI
441
+ - **Recommandation** : lors des itérations de développement local, il est recommandé d'activer le mode hub ; la progression des workers peut être entièrement observée dans la Web UI ; pour la collaboration entre machines ou les environnements sans Web UI, utilisez l'approche shell de l'hôte d'envoi
442
+
443
+ ### Points connus
444
+
445
+ - Le rôle Codex peut théoriquement essayer `model_provider` pointant directement vers DeepSeek (non vérifié) ; ce pont n'en dépend pas
446
+ - La sortie de génération d'images est un bitmap plat ; l'édition en couches nécessite OpenPencil
447
+ - **Dépendances runtime** : uniquement `@modelcontextprotocol/sdk` et `zod` ; `@deepseek-ai/*` sont le runtime de l'hôte (fourni par l'hôte DSH ; une simple installation npm ne les installe jamais)
448
+ - **Codex doit configurer** : `default_tools_approval_mode = "approve"`, sinon les appels d'outils sont automatiquement annulés
449
+
450
+ ## Développement
451
+
452
+ ```bash
453
+ pnpm install
454
+ node_modules/.bin/tsdown src/client/index.tsx --format cjs --platform browser \
455
+ --target es2022 --tsconfig tsconfig.client.json --out-dir .client-build --clean
456
+ node scripts/build-client.mjs # wraps the bundle for the DSH module loader
457
+ node scripts/smoke.mjs # dispatches one real flash task end to end
458
+ ```
459
+
460
+ Les dépendances runtime sont uniquement `@modelcontextprotocol/sdk` et `zod` ; chaque package `@deepseek-ai/*` est un runtime d'hôte fourni par l'hôte DSH (documenté dans le champ dshHostRuntime du package, et non dans peerDependencies, si bien qu'une simple installation npm ne les installe jamais), ce qui maintient le plugin dans le realm de module unique de l'hôte.
461
+
462
+ ## Écosystème
463
+
464
+ - [DSH Android](https://github.com/ZSeven-W/dsh-android) — un émulateur Android ou un appareil USB, en direct dans la conversation, piloté entièrement via adb
465
+ - [DSH iOS](https://github.com/ZSeven-W/dsh-ios) — un simulateur iOS — et un iPhone en USB — vivants dans la conversation
466
+ - [DSH Noema](https://github.com/ZSeven-W/dsh-noema) — mémoire à long terme pour DSH
467
+ - [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — inspecter et modifier les documents de conception `.op` dans une conversation
468
+
469
+ ## Licence
470
+
471
+ MIT
472
+
473
+
474
+ ### `dsh_worker_probe` / `needs_input`
475
+
476
+ `dsh_worker_probe` envoie une requête d’outil sans effet, limitée dans le temps, à une route DSH configurée, sans créer de worker ni modifier les liaisons. Elle peut consommer des tokens. Une question sans réponse arrête le worker avec `needs_input` : obtenez la réponse humaine avant de relancer. Les permissions de l’hôte sont héritées, sans nouveau sandbox OS.
477
+
478
+ ```js
479
+ dsh_worker_probe({ tier: "flash" })
480
+ ```