@zoraxylia/dsh-codex-adapter 0.1.0 → 0.1.2
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.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/README.de.md +32 -32
- package/README.es.md +32 -32
- package/README.fr.md +32 -32
- package/README.hi.md +32 -32
- package/README.id.md +32 -32
- package/README.ja.md +32 -32
- package/README.ko.md +32 -32
- package/README.md +33 -33
- package/README.pt.md +32 -32
- package/README.ru.md +32 -32
- package/README.th.md +32 -32
- package/README.tr.md +32 -32
- package/README.vi.md +32 -32
- package/README.zh-TW.md +32 -32
- package/README.zh.md +33 -33
- package/agy/agents/ds-flash.md +1 -1
- package/agy/agents/ds-pro.md +1 -1
- package/agy/skills/dsh-playbook/SKILL.md +1 -1
- package/codex/agents/ds-flash.toml +2 -2
- package/codex/agents/ds-pro.toml +2 -2
- package/codex/prompts/dsh-playbook.md +1 -1
- package/commands/off.md +1 -1
- package/commands/playbook.md +1 -1
- package/cordis.patch.yml +2 -2
- package/grok/agents/ds-flash.md +1 -1
- package/grok/agents/ds-pro.md +1 -1
- package/grok/commands/dsh-config.md +1 -1
- package/grok/commands/dsh-playbook.md +2 -2
- package/grok/commands/dsh-status.md +1 -1
- package/lib/client.js +37 -27
- package/lib/server.mjs +22 -22
- package/package.json +6 -5
- package/scripts/bump-version.mjs +79 -0
- package/scripts/fake-agy.sh +3 -3
- package/scripts/release-local.mjs +2 -2
- package/scripts/smoke-bundle.mjs +2 -2
- package/scripts/smoke-pack.mjs +4 -4
- package/scripts/smoke.mjs +3 -3
- package/scripts/verify-wpc10-client.mjs +2 -2
- package/scripts/verify-wpc14-proc-endpoints.mjs +6 -6
- package/scripts/verify-wpc9-guardrails.mjs +10 -10
- package/src/cli-workers.mjs +1 -1
- package/src/client/index.tsx +34 -32
- package/src/cwd-lock.mjs +1 -1
- package/src/hub/index.mjs +31 -10
- package/src/hub-client.mjs +4 -4
- package/src/install/install.mjs +35 -32
- package/src/jobs.mjs +2 -2
- package/src/multimodal.mjs +18 -18
- package/src/origin-guard.mjs +8 -8
- package/src/plugin-env.mjs +2 -2
- package/src/proc-kill.mjs +5 -5
- package/src/provider-probe.mjs +3 -3
- package/src/server.mjs +4 -4
- package/src/status-shard.mjs +2 -2
- package/src/vision-route.mjs +3 -3
- package/statusline/statusline.sh +1 -1
- package/statusline/worker-segment.sh +3 -3
- package/worker.cordis.yml +1 -1
- /package/docs/images/{dsh-crew-host.png → dsh-adapter-host.png} +0 -0
- /package/docs/images/{dsh-crew-jobs.png → dsh-adapter-jobs.png} +0 -0
- /package/docs/images/{dsh-crew-logo.png → dsh-adapter-logo.png} +0 -0
- /package/docs/images/{dsh-crew-overview.png → dsh-adapter-overview.png} +0 -0
package/README.fr.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="./docs/images/dsh-
|
|
2
|
+
<img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">DSH
|
|
5
|
+
<h1 align="center">DSH Adapter</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
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 />
|
|
@@ -24,13 +24,13 @@
|
|
|
24
24
|
<br />
|
|
25
25
|
|
|
26
26
|
<p align="center">
|
|
27
|
-
<img src="./docs/images/dsh-
|
|
27
|
+
<img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
|
|
28
28
|
</p>
|
|
29
|
-
<p align="center"><sub>La page de paramètres de DSH
|
|
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
30
|
|
|
31
|
-
## Pourquoi DSH
|
|
31
|
+
## Pourquoi DSH Adapter
|
|
32
32
|
|
|
33
|
-
DSH
|
|
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
34
|
|
|
35
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
36
|
|
|
@@ -79,7 +79,7 @@ Chaque envoi est vérifié avant que quoi que ce soit ne soit lancé. L'imbricat
|
|
|
79
79
|
|
|
80
80
|
### 📋 Tableau des jobs
|
|
81
81
|
|
|
82
|
-
Le panneau DSH
|
|
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
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
|
118
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
119
|
|
|
120
120
|
<p align="center">
|
|
121
|
-
<img src="./docs/images/dsh-
|
|
121
|
+
<img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
|
|
122
122
|
</p>
|
|
123
|
-
<p align="center"><sub>Dans Claude Code, les workers dsh-
|
|
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
124
|
|
|
125
125
|
<p align="center">
|
|
126
|
-
<img src="./docs/images/dsh-
|
|
126
|
+
<img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
|
|
127
127
|
</p>
|
|
128
|
-
<p align="center"><sub>Le panneau DSH
|
|
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
129
|
|
|
130
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
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
Ou, pour le développement local depuis les sources :
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
dsh plugin --profile web add link:/path/to/dsh-
|
|
144
|
+
dsh plugin --profile web add link:/path/to/dsh-adapter
|
|
145
145
|
dsh web
|
|
146
146
|
```
|
|
147
147
|
|
|
@@ -151,7 +151,7 @@ Le protocole `link:` crée un lien symbolique vers ce dépôt, donc chaque rebui
|
|
|
151
151
|
|
|
152
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
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-
|
|
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
155
|
|
|
156
156
|
```
|
|
157
157
|
DEEPSEEK_API_KEY=sk-...
|
|
@@ -165,7 +165,7 @@ node scripts/smoke.mjs
|
|
|
165
165
|
|
|
166
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
167
|
|
|
168
|
-
Ouvrez ensuite Réglages → DSH
|
|
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
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
Installation en un clic (choisissez une option) :
|
|
194
194
|
|
|
195
|
-
- **Page de paramètres DSH** (quand le mode hub est installé) : Paramètres → DSH
|
|
195
|
+
- **Page de paramètres DSH** (quand le mode hub est installé) : Paramètres → DSH Adapter → « Install to Claude Code »
|
|
196
196
|
- **Ligne de commande** : `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
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.**
|
|
@@ -204,7 +204,7 @@ Les deux font la même chose : enregistrer le marketplace local (le répertoire
|
|
|
204
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
205
|
- Pour le développement local, `statusline/statusline.sh` ou `statusline/worker-segment.sh` peuvent être intégrés indépendamment
|
|
206
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-
|
|
207
|
+
- **Développement local et débogage** : `claude --plugin-dir /path/to/dsh-adapter` pour charger temporairement
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### Commandes de session
|
|
@@ -213,11 +213,11 @@ Elles ne remplacent les valeurs globales que pour la session courante, et sont a
|
|
|
213
213
|
|
|
214
214
|
| Commande | Effet |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
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
217
|
|
|
218
|
-
| `/dsh-
|
|
219
|
-
| `/dsh-
|
|
220
|
-
| `/dsh-
|
|
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
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Trois prompts sont installés pour Codex :
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
Enregistre le serveur MCP dsh-
|
|
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
272
|
|
|
273
273
|
### Utilisation
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ Désinstallation : `node src/install/cli.mjs uninstall-agy`
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
Écrit la section `[mcp_servers.dsh-
|
|
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
301
|
|
|
302
302
|
### Utilisation
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ Désinstallation : `node src/install/cli.mjs uninstall-grok`
|
|
|
329
329
|
| `dsh_worker_cancel` | Annule le job spécifié et termine son processus runtime |
|
|
330
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
331
|
|
|
332
|
-
La progression est simultanément répliquée dans `~/.config/dsh-
|
|
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
333
|
|
|
334
334
|
## Garde-fous d'envoi
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ Chaque envoi est vérifié avant que quoi que ce soit ne soit lancé — les ref
|
|
|
340
340
|
|
|
341
341
|
## Playbook d'envoi
|
|
342
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-
|
|
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
344
|
|
|
345
345
|
## Backends CLI explicites
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ Comment *bien* envoyer — flash ou pro, des briefs autonomes, un parallélisme
|
|
|
350
350
|
|
|
351
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
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-
|
|
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
354
|
|
|
355
355
|
| Outil | Description |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ Comment *bien* envoyer — flash ou pro, des briefs autonomes, un parallélisme
|
|
|
361
361
|
|
|
362
362
|
### Configuration
|
|
363
363
|
|
|
364
|
-
Dans **la page de paramètres DSH → DSH
|
|
364
|
+
Dans **la page de paramètres DSH → DSH Adapter → Multimodal** (ou modifiez directement `~/.config/dsh-adapter/config.json`) :
|
|
365
365
|
|
|
366
366
|
**Fournisseur de vision** (visualisation d'images) :
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ Deux méthodes d'intégration :
|
|
|
405
405
|
|
|
406
406
|
## Mode hub
|
|
407
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-
|
|
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
409
|
|
|
410
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
411
|
- **Organisation par répertoire de travail** : gérez les sessions worker par cwd dans la Web UI
|
|
412
412
|
- **API loopback** :
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **Détection automatique** : le shim MCP des hôtes détecte automatiquement le hub (variable d'environnement `
|
|
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
417
|
- DSH Web actif → les jobs passent en mode hub (`mode: "hub"`)
|
|
418
418
|
- Non actif → repli sur le runtime standalone
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ Ce package est aussi un bundle DSH valide (`dsh.bundle` + `cordis.patch.yml`). A
|
|
|
437
437
|
|
|
438
438
|
### DSH Web en cours d'exécution → mode hub activé automatiquement
|
|
439
439
|
|
|
440
|
-
- **État actuel** : si `dsh plugin add dsh-
|
|
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
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
442
|
|
|
443
443
|
### Points connus
|
package/README.hi.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="./docs/images/dsh-
|
|
2
|
+
<img src="./docs/images/dsh-adapter-logo.png" alt="DSH Adapter" width="120" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">DSH
|
|
5
|
+
<h1 align="center">DSH Adapter</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>एक <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> प्लगइन: Claude Code / Codex / Antigravity / Grok से DSH एजेंटों में काम भेजें, बिना होस्ट के नेटिव सबएजेंट UI को छोड़े।</strong><br />
|
|
@@ -24,13 +24,13 @@
|
|
|
24
24
|
<br />
|
|
25
25
|
|
|
26
26
|
<p align="center">
|
|
27
|
-
<img src="./docs/images/dsh-
|
|
27
|
+
<img src="./docs/images/dsh-adapter-overview.png" alt="DSH Adapter — settings page" width="100%" />
|
|
28
28
|
</p>
|
|
29
|
-
<p align="center"><sub>DSH
|
|
29
|
+
<p align="center"><sub>DSH Adapter सेटिंग्स पेज - होस्ट इंटीग्रेशन, डिस्पैच पॉलिसी, निष्पादन और मल्टीमोडल ब्रिज</sub></p>
|
|
30
30
|
|
|
31
|
-
## DSH
|
|
31
|
+
## DSH Adapter क्यों
|
|
32
32
|
|
|
33
|
-
DSH
|
|
33
|
+
DSH Adapter एक प्लगइन है [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) के लिए - एक ओपन-सोर्स एजेंट हार्नेस। यह DSH एजेंटों को Claude Code, Codex, Antigravity और Grok से डिस्पैच करने योग्य बनाता है: ऑर्केस्ट्रेटर अपना मॉडल रखता है, काम एक वास्तविक DSH एजेंट पर चलता है जिसके पास उस हार्नेस के टूल, सैंडबॉक्स, प्रीसेट और सेशन हिस्ट्री होती है, और होस्ट अभी भी इसे एक नेटिव सबएजेंट के रूप में दिखाता है जिसमें लाइव प्रगति होती है।
|
|
34
34
|
|
|
35
35
|
काम को क्या चलाता है वह एक DSH एजेंट है, न कि एक बेयर मॉडल कॉल। टियर (`flash` / `pro`) चुनते हैं कि एजेंट को हार्नेस की कॉन्फ़िगर्ड रोस्टर से कितनी क्षमता मिलेगी - आज DeepSeek V4 Flash और V4 Pro - तो DSH में मॉडल का परिवर्तन यहां कोई परिवर्तन नहीं चाहिए।
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ DSH के मॉडल केवल पाठ हैं। `describe_image` अ
|
|
|
79
79
|
|
|
80
80
|
### 📋 जॉब्स बोर्ड
|
|
81
81
|
|
|
82
|
-
DSH
|
|
82
|
+
DSH Adapter पैनल एक जॉब्स बोर्ड के रूप में भी काम करता है: हर worker job — चल रहा या समाप्त — tier, effort, लाइव प्रगति और tokens के साथ सूचीबद्ध है, रखे गए workspaces अपने धारक दिखाते हैं, और एक job जो बीच उड़ान में गायब हो जाता है (जैसे hub रीस्टार्ट) चुपचाप गायब होने के बजाय एक अनाथ ghost के रूप में सामने आता है।
|
|
83
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
|
118
118
|
डिस्पैच चौड़ाई में फैलता है। नीचे अठारह worker इस README का समानांतर अनुवाद कर रहे हैं: होस्ट उन्हें अपने subagent गिनता है, जबकि harness उन्हें असली session के रूप में चलाता है।
|
|
119
119
|
|
|
120
120
|
<p align="center">
|
|
121
|
-
<img src="./docs/images/dsh-
|
|
121
|
+
<img src="./docs/images/dsh-adapter-host.png" alt="Claude Code" width="100%" />
|
|
122
122
|
</p>
|
|
123
|
-
<p align="center"><sub>Claude Code में dsh-
|
|
123
|
+
<p align="center"><sub>Claude Code में dsh-adapter के worker नेटिव subagent दिखते हैं; statusline सेगमेंट चल रहे tier, बीता समय और token दिखाता है।</sub></p>
|
|
124
124
|
|
|
125
125
|
<p align="center">
|
|
126
|
-
<img src="./docs/images/dsh-
|
|
126
|
+
<img src="./docs/images/dsh-adapter-jobs.png" alt="DSH Adapter" width="100%" />
|
|
127
127
|
</p>
|
|
128
|
-
<p align="center"><sub>DSH
|
|
128
|
+
<p align="center"><sub>DSH Adapter पैनल वही रन harness की तरफ़ से दिखाता है: कौन-सा होस्ट किस job को भेजा, उसका tier और effort, लाइव प्रगति और token खपत।</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>पैनल जॉब्स बोर्ड भी है: चल रहे और समाप्त jobs tier, प्रगति और tokens के साथ सूचीबद्ध रहते हैं, रखे गए workspaces अपने धारक का नाम बताते हैं, और एक job जो बीच उड़ान में गायब हो जाता है (hub रीस्टार्ट) चुपचाप गायब होने के बजाय अनाथ ghost के रूप में सामने आता है।</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
या, सोर्स ट्री से लोकल डेवलपमेंट के लिए:
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
dsh plugin --profile web add link:/path/to/dsh-
|
|
144
|
+
dsh plugin --profile web add link:/path/to/dsh-adapter
|
|
145
145
|
dsh web
|
|
146
146
|
```
|
|
147
147
|
|
|
@@ -151,7 +151,7 @@ dsh web
|
|
|
151
151
|
|
|
152
152
|
hub mode में — ऊपर दिया गया इंस्टॉलेशन — worker DSH इंस्टेंस के अंदर चलते हैं और उन्हीं DeepSeek क्रेडेंशियल का उपयोग करते हैं जो DSH इंस्टेंस में पहले से कॉन्फ़िगर हैं। कुछ और सेट करने की आवश्यकता नहीं है।
|
|
153
153
|
|
|
154
|
-
केवल standalone fallback को अपनी key की आवश्यकता है: किसी host से DSH इंस्टेंस चलाए बिना डिस्पैच करने से एक अलग प्रक्रिया के रूप में worker runtime लॉन्च होता है। [platform.deepseek.com](https://platform.deepseek.com) से API key प्राप्त करें और इसे `~/.config/dsh-
|
|
154
|
+
केवल standalone fallback को अपनी key की आवश्यकता है: किसी host से DSH इंस्टेंस चलाए बिना डिस्पैच करने से एक अलग प्रक्रिया के रूप में worker runtime लॉन्च होता है। [platform.deepseek.com](https://platform.deepseek.com) से API key प्राप्त करें और इसे `~/.config/dsh-adapter/.env` में लिखें:
|
|
155
155
|
|
|
156
156
|
```
|
|
157
157
|
DEEPSEEK_API_KEY=sk-...
|
|
@@ -165,7 +165,7 @@ node scripts/smoke.mjs
|
|
|
165
165
|
|
|
166
166
|
smoke test उपलब्ध किसी भी पथ के माध्यम से एक सस्ता job dispatch करता है — जब DSH instance चल रहा हो तो hub, अन्यथा standalone — और उपयोग किए गए पथ को प्रिंट करता है। लगभग दस सेकंड में आपको `smoke test passed — configuration OK` दिखना चाहिए। विफलता पर कारण प्रिंट होता है, जो परीक्षित पथ तक सीमित होता है।
|
|
167
167
|
|
|
168
|
-
फिर Settings → DSH
|
|
168
|
+
फिर Settings → DSH Adapter खोलकर host इंटीग्रेशन — Claude Code, Codex, Antigravity, Grok — एक क्लिक में इंस्टॉल करें, या उसी इंस्टॉलर को कमांड लाइन से चलाएं:
|
|
169
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # Claude Code plugin: marketplace + permissions + HUD segment
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
वन-क्लिक स्थापना (एक चुनें):
|
|
194
194
|
|
|
195
|
-
- **DSH सेटिंग्स पेज** (जब hub मोड स्थापित हो): सेटिंग्स → DSH
|
|
195
|
+
- **DSH सेटिंग्स पेज** (जब hub मोड स्थापित हो): सेटिंग्स → DSH Adapter → "Claude Code में स्थापित करें"
|
|
196
196
|
- **कमांड लाइन**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
दोनों एक ही काम करते हैं: स्थानीय मार्केटप्लेस पंजीकृत करें (माता-पिता की निर्देशिका `dsh-plugins/` को मार्केटप्लेस रूट के रूप में) + `claude plugin install` + MCP टूल अनुमति allowlist + claude-hud कार्यकर्ता स्थिति सेगमेंट कॉन्फ़िगरेशन (परिवर्तनों से पहले settings.json को ऑटो-बैकअप करें, idempotent)। **परिवर्तनों को प्रभावी होने के लिए स्थापना के बाद सेशन पुनः प्रारंभ करें।**
|
|
@@ -204,7 +204,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
204
204
|
- **HUD स्टेटसलाइन सेगमेंट**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (वर्तमान टियर / बीता हुआ समय / टोकन उपयोग / पूर्णता काउंट)
|
|
205
205
|
- स्थानीय विकास के लिए, `statusline/statusline.sh` या `statusline/worker-segment.sh` को स्वतंत्र रूप से एकीकृत किया जा सकता है
|
|
206
206
|
- **लंबे समय चलने वाले कार्य**: CC के पास MCP कॉल पर समय सीमा है (`MCP_TOOL_TIMEOUT` समायोज्य), लंबे कार्य ऑर्केस्ट्रेटर को `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)` पोलिंग का उपयोग कर सकते हैं
|
|
207
|
-
- **स्थानीय विकास और डिबगिंग**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **स्थानीय विकास और डिबगिंग**: `claude --plugin-dir /path/to/dsh-adapter` अस्थायी रूप से लोड करने के लिए
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### सेशन कमांड
|
|
@@ -213,11 +213,11 @@ node src/install/cli.mjs uninstall-claude
|
|
|
213
213
|
|
|
214
214
|
| कमांड | क्या करता है |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter:config` | इस सेशन के डिफ़ॉल्ट देखें या सेट करें: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<सेकंड>`, `policy=auto\|flash-only\|pro-only`, `escalate=true\|false`, `origin_depth_limit=<1-32>`, `preset_flash/preset_pro=<preset id|default>`, `reset` |
|
|
217
217
|
|
|
218
|
-
| `/dsh-
|
|
219
|
-
| `/dsh-
|
|
220
|
-
| `/dsh-
|
|
218
|
+
| `/dsh-adapter:on` · `/dsh-adapter:off` | इस सेशन में डिस्पैच चालू या बंद करें (बंद एक हार्ड स्विच है: टूल मना कर देता है) |
|
|
219
|
+
| `/dsh-adapter:status` | worker jobs की लाइव स्थिति: tier, प्रगति, tokens, मौजूदा टूल |
|
|
220
|
+
| `/dsh-adapter:playbook` | डिस्पैच सर्वोत्तम अभ्यास: flash बनाम pro चुनना, आत्मनिर्भर ब्रीफ, समानांतरता, परिणाम सत्यापन, गार्डरेल |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Codex के लिए तीन prompts इंस्टॉल होते ह
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
dsh-
|
|
271
|
+
dsh-adapter MCP server को `~/.gemini/config/mcp_config.json` में पंजीकृत करता है और `ds-flash` / `ds-pro` agents तथा `dsh-config`, `dsh-status` और `dsh-playbook` skills को `~/.gemini/config/` में इंस्टॉल करता है (सभी फाइलें पहले बैकअप होती हैं)। इंस्टॉलेशन के बाद सेशन पुनः प्रारंभ करें।
|
|
272
272
|
|
|
273
273
|
### उपयोग
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ dsh-crew MCP server को `~/.gemini/config/mcp_config.json` में पं
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
`[mcp_servers.dsh-
|
|
300
|
+
`[mcp_servers.dsh-adapter]` सेक्शन को `~/.grok/config.toml` में लिखता है और `ds-flash` / `ds-pro` agents तथा `/dsh-config`, `/dsh-status` और `/dsh-playbook` commands को `~/.grok/` में इंस्टॉल करता है (सभी फाइलें पहले बैकअप होती हैं)।
|
|
301
301
|
|
|
302
302
|
### उपयोग
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ node src/install/cli.mjs grok
|
|
|
329
329
|
| `dsh_worker_cancel` | निर्दिष्ट job को रद्द करें, इसकी रनटाइम प्रक्रिया समाप्त करें |
|
|
330
330
|
| `dsh_worker_config` | सेशन डिफ़ॉल्ट पढ़ें/सेट करें (tier, effort, mode, timeout, policy, escalation) और `worker_profiles` सूचीबद्ध करें |
|
|
331
331
|
|
|
332
|
-
प्रगति एक साथ `~/.config/dsh-
|
|
332
|
+
प्रगति एक साथ `~/.config/dsh-adapter/status.d/` में मिरर की जाती है (प्रति लेखक एक शार्ड फाइल, statusline / बाहरी निगरानी द्वारा पढ़ी जा सकती है)।
|
|
333
333
|
|
|
334
334
|
## डिस्पैच गार्डरेल
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ node src/install/cli.mjs grok
|
|
|
340
340
|
|
|
341
341
|
## डिस्पैच प्लेबुक
|
|
342
342
|
|
|
343
|
-
*अच्छी तरह* डिस्पैच कैसे करें — flash बनाम pro, आत्मनिर्भर ब्रीफ, सुरक्षित समानांतरता, परिणाम सत्यापन, और ऊपर के गार्डरेल — प्रति host एक प्लेबुक के रूप में बंडल है: `/dsh-
|
|
343
|
+
*अच्छी तरह* डिस्पैच कैसे करें — flash बनाम pro, आत्मनिर्भर ब्रीफ, सुरक्षित समानांतरता, परिणाम सत्यापन, और ऊपर के गार्डरेल — प्रति host एक प्लेबुक के रूप में बंडल है: `/dsh-adapter:playbook` (Claude Code skill), `/dsh-playbook` (Codex prompt, Antigravity skill, Grok command)।
|
|
344
344
|
|
|
345
345
|
## स्पष्ट CLI बैकएंड
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ node src/install/cli.mjs grok
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek एक टेक्स्ट-ओनली मॉडल है** और इमेज इनपुट या जनरेशन का समर्थन नहीं करता है। यह प्लगइन ये क्षमताएं MCP उपकरणों के माध्यम से बाहरी रूप से प्राप्त करता है:
|
|
352
352
|
|
|
353
|
-
**नेटिव विजन पहले**: जब विजन प्रदाता एक अंतर्निहित CLI है (या स्पष्ट रूप से `native`), तो `describe_image` पहले DeepSeek के अपने VL मॉडल `deepseek-v4-flash-vision-exp` को आज़माता है (सीधा API कॉल; key `DEEPSEEK_API_KEY` या `~/.config/dsh-
|
|
353
|
+
**नेटिव विजन पहले**: जब विजन प्रदाता एक अंतर्निहित CLI है (या स्पष्ट रूप से `native`), तो `describe_image` पहले DeepSeek के अपने VL मॉडल `deepseek-v4-flash-vision-exp` को आज़माता है (सीधा API कॉल; key `DEEPSEEK_API_KEY` या `~/.config/dsh-adapter/.env` से)। कोई भी विफलता नीचे दी गई CLI प्रदाता श्रृंखला पर सहजता से गिरती है, जो fallback के रूप में बनी रहती है। इमेज जनरेशन अछूता है — नेटिव मॉडल केवल चित्र देखता है।
|
|
354
354
|
|
|
355
355
|
| उपकरण | विवरण |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ node src/install/cli.mjs grok
|
|
|
361
361
|
|
|
362
362
|
### कॉन्फ़िगरेशन
|
|
363
363
|
|
|
364
|
-
**DSH सेटिंग्स पेज → DSH
|
|
364
|
+
**DSH सेटिंग्स पेज → DSH Adapter → Multimodal** में (या सीधे `~/.config/dsh-adapter/config.json` संपादित करें):
|
|
365
365
|
|
|
366
366
|
**विजन प्रदाता** (इमेज देखना):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ node src/install/cli.mjs grok
|
|
|
405
405
|
|
|
406
406
|
## Hub मोड
|
|
407
407
|
|
|
408
|
-
यह पैकेज एक वैध DSH बंडल भी है (`dsh.bundle` + `cordis.patch.yml`)। `dsh plugin add dsh-
|
|
408
|
+
यह पैकेज एक वैध DSH बंडल भी है (`dsh.bundle` + `cordis.patch.yml`)। `dsh plugin add dsh-adapter` के साथ DSH Web प्रोफाइल में स्थापित करने के बाद:
|
|
409
409
|
|
|
410
410
|
- **कार्यकर्ता सेशन फर्स्ट-क्लास नागरिक बन जाते हैं**: DSH होस्ट में फर्स्ट-क्लास सेशन के रूप में चलें (`agents.create` + per-session मॉडल/effort वॉटरफॉल + डिफ़ॉल्ट प्रीसेट), Web UI सेशन सूची में दिखाई दें, किसी भी समय खोल सकते हैं पूर्ण निष्पादन देखने के लिए
|
|
411
411
|
- **कार्य निर्देशिका द्वारा आयोजित करें**: Web UI में cwd द्वारा कार्यकर्ता सेशन का प्रबंधन करें
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **ऑटो-डिटेक्शन**: hosts का MCP shim ऑटो-डिटेक्ट hub करता है (`
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: कार्य भेजें, सूची, लंबे-पोल परिणाम, रद्द करें
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: स्वास्थ्य जांच (MCP shim यह निर्धारित करने के लिए उपयोग करता है कि hub चल रहा है या नहीं)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: host इंटीग्रेशन की वन-क्लिक इंस्टॉल — Claude Code / Codex / Antigravity / Grok (`src/install/` का बैकएंड)
|
|
416
|
+
- **ऑटो-डिटेक्शन**: hosts का MCP shim ऑटो-डिटेक्ट hub करता है (`DSHPLUGIN_ADAPTER_HUB` env var, डिफ़ॉल्ट `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web चल रहा है → job hub मोड में प्रवेश करते हैं (`mode: "hub"`)
|
|
418
418
|
- चल नहीं रहा है → स्टैंडअलोन रनटाइम पर वापस आएं
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ node src/install/cli.mjs grok
|
|
|
437
437
|
|
|
438
438
|
### DSH Web चल रहा है → hub मोड ऑटो-सक्षम
|
|
439
439
|
|
|
440
|
-
- **वर्तमान स्थिति**: यदि `dsh plugin add dsh-
|
|
440
|
+
- **वर्तमान स्थिति**: यदि `dsh plugin add dsh-adapter` DSH Web प्रोफाइल में स्थापित है, तो job होस्ट में फर्स्ट-क्लास सेशन के रूप में चलते हैं, Web UI सेशन सूची में दिखाई देते हैं
|
|
441
441
|
- **अनुशंसा**: स्थानीय विकास पुनरावृत्ति के दौरान, hub मोड सक्षम करने की अनुशंसा करते हैं; कार्यकर्ता प्रगति पूरी तरह से Web UI में देखी जा सकती है; क्रॉस-मशीन सहयोग या Web UI के बिना वातावरण के लिए, डिस्पैच करने वाले host के शेल दृष्टिकोण का उपयोग करें
|
|
442
442
|
|
|
443
443
|
### ज्ञात आइटम
|