@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
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"name": "dsh-
|
|
2
|
+
"name": "dsh-adapter",
|
|
3
3
|
"owner": {
|
|
4
4
|
"name": "ZSeven-W"
|
|
5
5
|
},
|
|
6
6
|
"description": "Dispatch subtasks to DeepSeek Harness (DSH) agents as native subagents with live progress",
|
|
7
7
|
"plugins": [
|
|
8
8
|
{
|
|
9
|
-
"name": "dsh-
|
|
9
|
+
"name": "dsh-adapter",
|
|
10
10
|
"source": "./",
|
|
11
11
|
"description": "Dispatch subtasks to DeepSeek Harness (DSH) agents as native subagents with live progress",
|
|
12
12
|
"category": "productivity"
|
package/.mcp.json
CHANGED
package/README.de.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>Ein <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>-Plugin: Verteilen Sie Arbeit von Claude Code / Codex / Antigravity / Grok aus an DSH-Agenten, ohne auf die native Subagent-UI des Hosts zu verzichten.</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 — Einstellungsseite" width="100%" />
|
|
28
28
|
</p>
|
|
29
|
-
<p align="center"><sub>Die Einstellungsseite von DSH
|
|
29
|
+
<p align="center"><sub>Die Einstellungsseite von DSH Adapter — Host-Integrationen, Dispatch-Richtlinie, Ausführung und die multimodale Brücke</sub></p>
|
|
30
30
|
|
|
31
|
-
## Warum DSH
|
|
31
|
+
## Warum DSH Adapter
|
|
32
32
|
|
|
33
|
-
DSH
|
|
33
|
+
DSH Adapter ist ein Plugin für [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — ein Open-Source-Agent-Harness. Es macht DSH-Agenten aus Claude Code, Codex, Antigravity und Grok heraus dispatchbar: Der Orchestrator behält sein eigenes Modell, die Arbeit läuft auf einem echten DSH-Agenten mit den Tools, der Sandbox, den Presets und dem Sitzungsverlauf dieses Harness, und der Host zeigt diesen weiterhin als nativen Subagenten mit Live-Fortschritt an.
|
|
34
34
|
|
|
35
35
|
Was die Arbeit ausführt, ist ein DSH-Agent, kein bloßer Modellaufruf. Tiers (`flash` / `pro`) bestimmen, wie viel Fähigkeit dieser Agent aus dem konfigurierten Roster des Harness erhält — derzeit DeepSeek V4 Flash und V4 Pro —, sodass ein Modellwechsel in DSH hier keine Änderung erfordert.
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ Jeder Dispatch wird geprüft, bevor irgendetwas gestartet wird. Worker→Worker-
|
|
|
79
79
|
|
|
80
80
|
### 📋 Jobs-Board
|
|
81
81
|
|
|
82
|
-
Das DSH-
|
|
82
|
+
Das DSH-Adapter-Panel dient zugleich als Jobs-Board: Jeder Worker-Job — laufend oder abgeschlossen — wird mit Tier, Effort, Live-Fortschritt und Tokens aufgelistet, gehaltene Workspaces zeigen ihre Halter, und ein Job, der mitten im Flug verschwindet (z. B. ein Hub-Neustart), erscheint als verwaister Geist, statt stillschweigend zu verschwinden.
|
|
83
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, keeps its own model)
|
|
|
118
118
|
Dispatch lässt sich breit auffächern. Unten übersetzen achtzehn Worker dieses README parallel: Der Host zählt sie als eigene Subagenten, während das Harness sie als echte Sessions ausführt.
|
|
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 sieht dsh-
|
|
123
|
+
<p align="center"><sub>Claude Code sieht dsh-adapter-Worker als native Subagenten; das Statusline-Segment zeigt laufende Tiers, verstrichene Zeit und 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>Das DSH-
|
|
128
|
+
<p align="center"><sub>Das DSH-Adapter-Panel zeigt denselben Lauf von der Harness-Seite: welcher Host welchen Job gestartet hat, Tier und Effort, Fortschritt und Tokenverbrauch.</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>Das Panel ist zugleich das Jobs-Board: laufende und abgeschlossene Jobs bleiben mit Tier, Fortschritt und Tokens aufgelistet, gehaltene Workspaces nennen ihre Halter, und ein Job, der mitten im Flug verschwindet (ein Hub-Neustart), erscheint als verwaister Geist, statt stillschweigend zu verschwinden.</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
Oder für lokale Entwicklung direkt aus dem Quellbaum:
|
|
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 @@ Das `link:`-Protokoll verlinkt die Profilabhängigkeit auf dieses Repository, so
|
|
|
151
151
|
|
|
152
152
|
Im Hub-Modus — die Installation oben — laufen Worker innerhalb der DSH-Instanz und nutzen die DeepSeek-Zugangsdaten, mit denen sie bereits konfiguriert ist. Mehr ist nicht zu konfigurieren.
|
|
153
153
|
|
|
154
|
-
Nur das Standalone-Fallback braucht einen eigenen Key: Dispatch von einem Host ohne laufende DSH-Instanz startet eine Worker-Runtime als separaten Prozess. Hole einen API-Key auf [platform.deepseek.com](https://platform.deepseek.com) und schreibe ihn in `~/.config/dsh-
|
|
154
|
+
Nur das Standalone-Fallback braucht einen eigenen Key: Dispatch von einem Host ohne laufende DSH-Instanz startet eine Worker-Runtime als separaten Prozess. Hole einen API-Key auf [platform.deepseek.com](https://platform.deepseek.com) und schreibe ihn in `~/.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
|
Der Smoke Test schickt einen günstigen Job über den verfügbaren Pfad — den Hub, wenn eine DSH-Instanz läuft, sonst standalone — und gibt aus, welcher davon verwendet wurde. Nach etwa zehn Sekunden sollte `smoke test passed — configuration OK` erscheinen. Bei einem Fehler wird der Grund ausgegeben, bezogen auf den getesteten Pfad.
|
|
167
167
|
|
|
168
|
-
Öffne danach Einstellungen → DSH
|
|
168
|
+
Öffne danach Einstellungen → DSH Adapter und installiere die Host-Integrationen — Claude Code, Codex, Antigravity, Grok — mit einem Klick, oder steuere denselben Installer über die Kommandozeile:
|
|
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
|
Ein-Klick-Installation (eine Option wählen):
|
|
194
194
|
|
|
195
|
-
- **DSH-Einstellungsseite** (wenn der Hub-Modus installiert ist): Settings → DSH
|
|
195
|
+
- **DSH-Einstellungsseite** (wenn der Hub-Modus installiert ist): Settings → DSH Adapter → „Install to Claude Code"
|
|
196
196
|
- **Kommandozeile**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
Beide bewirken dasselbe: lokalen Marketplace registrieren (übergeordnetes Verzeichnis `dsh-plugins/` als Marketplace-Root) + `claude plugin install` + MCP-Tool-Berechtigungs-Allowlist + Konfiguration des claude-hud-Worker-Status-Segments (automatisches Backup von settings.json vor Änderungen, idempotent). **Starten Sie die Sitzung nach der Installation neu, damit die Änderungen wirksam werden.**
|
|
@@ -204,7 +204,7 @@ Beide bewirken dasselbe: lokalen Marketplace registrieren (übergeordnetes Verze
|
|
|
204
204
|
- **HUD-Statuszeilen-Segment**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (aktueller Tier / verstrichene Zeit / Token-Verbrauch / Abschlusszähler)
|
|
205
205
|
- Für die lokale Entwicklung können `statusline/statusline.sh` oder `statusline/worker-segment.sh` unabhängig integriert werden
|
|
206
206
|
- **Langlaufende Aufgaben**: CC hat Timeout-Limits für MCP-Aufrufe (`MCP_TOOL_TIMEOUT` anpassbar); bei langen Aufgaben kann der Orchestrator `dsh_spawn_worker` + `dsh_worker_result(wait_seconds)`-Polling verwenden
|
|
207
|
-
- **Lokale Entwicklung und Debugging**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **Lokale Entwicklung und Debugging**: `claude --plugin-dir /path/to/dsh-adapter` zum temporären Laden
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### Sitzungsbefehle
|
|
@@ -213,11 +213,11 @@ Sie überschreiben die globalen Vorgaben nur für die aktuelle Sitzung und werde
|
|
|
213
213
|
|
|
214
214
|
| Befehl | Wirkung |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter:config` | Vorgaben der Sitzung anzeigen oder setzen: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<Sekunden>`, `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` | Dispatch für diese Sitzung ein- oder ausschalten (aus ist ein harter Schalter: das Tool verweigert) |
|
|
219
|
+
| `/dsh-adapter:status` | Live-Status der Worker-Jobs: Tier, Fortschritt, Tokens, aktuelles Tool |
|
|
220
|
+
| `/dsh-adapter:playbook` | Dispatch-Best-Practices: die Wahl zwischen flash und pro, eigenständige Briefings, Parallelität, Verifizieren von Ergebnissen, Leitplanken |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Für Codex werden drei Prompts installiert:
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
Registriert den dsh-
|
|
271
|
+
Registriert den dsh-adapter-MCP-Server in `~/.gemini/config/mcp_config.json` und installiert die `ds-flash`- / `ds-pro`-Agenten sowie die Skills `dsh-config`, `dsh-status` und `dsh-playbook` nach `~/.gemini/config/` (alle Dateien werden zuvor gesichert). Starten Sie die Sitzung nach der Installation neu.
|
|
272
272
|
|
|
273
273
|
### Verwendung
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ Deinstallation: `node src/install/cli.mjs uninstall-agy`
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
Schreibt den Abschnitt `[mcp_servers.dsh-
|
|
300
|
+
Schreibt den Abschnitt `[mcp_servers.dsh-adapter]` in `~/.grok/config.toml` und installiert die `ds-flash`- / `ds-pro`-Agenten sowie die Befehle `/dsh-config`, `/dsh-status` und `/dsh-playbook` nach `~/.grok/` (alle Dateien werden zuvor gesichert).
|
|
301
301
|
|
|
302
302
|
### Verwendung
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ Deinstallation: `node src/install/cli.mjs uninstall-grok`
|
|
|
329
329
|
| `dsh_worker_cancel` | Bricht den angegebenen Job ab und beendet seinen Runtime-Prozess |
|
|
330
330
|
| `dsh_worker_config` | Sitzungsvorgaben lesen/setzen (Tier, Effort, Modus, Timeout, Richtlinie, Eskalation) und `worker_profiles` auflisten |
|
|
331
331
|
|
|
332
|
-
Der Fortschritt wird gleichzeitig nach `~/.config/dsh-
|
|
332
|
+
Der Fortschritt wird gleichzeitig nach `~/.config/dsh-adapter/status.d/` gespiegelt (eine Shard-Datei pro Writer, lesbar für Statusline / externes Monitoring).
|
|
333
333
|
|
|
334
334
|
## Dispatch-Leitplanken
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ Jeder Dispatch wird geprüft, bevor irgendetwas gestartet wird — Ablehnungen s
|
|
|
340
340
|
|
|
341
341
|
## Dispatch-Playbook
|
|
342
342
|
|
|
343
|
-
Wie man *gut* dispatcht — flash vs. pro, eigenständige Briefings, sichere Parallelität, Verifizieren von Ergebnissen und die Leitplanken oben — ist als Playbook pro Host gebündelt: `/dsh-
|
|
343
|
+
Wie man *gut* dispatcht — flash vs. pro, eigenständige Briefings, sichere Parallelität, Verifizieren von Ergebnissen und die Leitplanken oben — ist als Playbook pro Host gebündelt: `/dsh-adapter:playbook` (Claude-Code-Skill), `/dsh-playbook` (Codex-Prompt, Antigravity-Skill, Grok-Befehl).
|
|
344
344
|
|
|
345
345
|
## Explizite CLI-Backends
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ Wie man *gut* dispatcht — flash vs. pro, eigenständige Briefings, sichere Par
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek ist ein reines Textmodell** und unterstützt weder Bildeingabe noch -generierung. Dieses Plugin bezieht diese Fähigkeiten extern über MCP-Tools:
|
|
352
352
|
|
|
353
|
-
**Native Vision zuerst**: Wenn der Vision-Provider eine eingebaute CLI ist (oder explizit `native`), versucht `describe_image` zuerst DeepSeeks eigenes VL-Modell `deepseek-v4-flash-vision-exp` (direkter API-Aufruf; Key aus `DEEPSEEK_API_KEY` oder `~/.config/dsh-
|
|
353
|
+
**Native Vision zuerst**: Wenn der Vision-Provider eine eingebaute CLI ist (oder explizit `native`), versucht `describe_image` zuerst DeepSeeks eigenes VL-Modell `deepseek-v4-flash-vision-exp` (direkter API-Aufruf; Key aus `DEEPSEEK_API_KEY` oder `~/.config/dsh-adapter/.env`). Jeder Fehler fällt sauber auf die CLI-Provider-Kette unten zurück, die als Fallback erhalten bleibt. Die Bildgenerierung bleibt unberührt — das native Modell schaut sich Bilder immer nur an.
|
|
354
354
|
|
|
355
355
|
| Tool | Beschreibung |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ Wie man *gut* dispatcht — flash vs. pro, eigenständige Briefings, sichere Par
|
|
|
361
361
|
|
|
362
362
|
### Konfiguration
|
|
363
363
|
|
|
364
|
-
In der **DSH-Einstellungsseite → DSH
|
|
364
|
+
In der **DSH-Einstellungsseite → DSH Adapter → Multimodal** (oder bearbeiten Sie direkt `~/.config/dsh-adapter/config.json`):
|
|
365
365
|
|
|
366
366
|
**Vision-Provider** (Bildbetrachtung):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ Zwei Integrationsmethoden:
|
|
|
405
405
|
|
|
406
406
|
## Hub-Modus
|
|
407
407
|
|
|
408
|
-
Dieses Paket ist auch ein gültiges DSH-Bundle (`dsh.bundle` + `cordis.patch.yml`). Nach der Installation in ein DSH-Web-Profil mit `dsh plugin add dsh-
|
|
408
|
+
Dieses Paket ist auch ein gültiges DSH-Bundle (`dsh.bundle` + `cordis.patch.yml`). Nach der Installation in ein DSH-Web-Profil mit `dsh plugin add dsh-adapter`:
|
|
409
409
|
|
|
410
410
|
- **Worker-Sitzungen werden First-Class-Bürger**: laufen als First-Class-Sitzungen im DSH-Host (`agents.create` + Modell-/Effort-Wasserfall pro Sitzung + Standard-Preset), erscheinen in der Sitzungsliste der Web-UI und können jederzeit geöffnet werden, um die vollständige Ausführung einzusehen
|
|
411
411
|
- **Nach Arbeitsverzeichnis organisieren**: Worker-Sitzungen nach cwd in der Web-UI verwalten
|
|
412
412
|
- **Loopback-API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **Auto-Erkennung**: Der MCP-Shim der Hosts erkennt den Hub automatisch (Env-Var `
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: Tasks starten, auflisten, Ergebnisse per Long-Poll abrufen, abbrechen
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: Health-Check (der MCP-Shim nutzt dies, um zu erkennen, ob der Hub läuft)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: Ein-Klick-Installation der Host-Integrationen — Claude Code / Codex / Antigravity / Grok (Backend von `src/install/`)
|
|
416
|
+
- **Auto-Erkennung**: Der MCP-Shim der Hosts erkennt den Hub automatisch (Env-Var `DSHPLUGIN_ADAPTER_HUB`, Standard `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web läuft → Jobs wechseln in den Hub-Modus (`mode: "hub"`)
|
|
418
418
|
- Läuft nicht → Fallback auf die Standalone-Runtime
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ Dieses Paket ist auch ein gültiges DSH-Bundle (`dsh.bundle` + `cordis.patch.yml
|
|
|
437
437
|
|
|
438
438
|
### DSH Web läuft → Hub-Modus automatisch aktiviert
|
|
439
439
|
|
|
440
|
-
- **Aktueller Stand**: Ist `dsh plugin add dsh-
|
|
440
|
+
- **Aktueller Stand**: Ist `dsh plugin add dsh-adapter` in ein DSH-Web-Profil installiert, laufen Jobs als First-Class-Sitzungen im Host und erscheinen in der Sitzungsliste der Web-UI
|
|
441
441
|
- **Empfehlung**: Bei lokalen Entwicklungsiterationen wird empfohlen, den Hub-Modus zu aktivieren; der Worker-Fortschritt lässt sich vollständig in der Web-UI beobachten; für maschinenübergreifende Zusammenarbeit oder Umgebungen ohne Web-UI den Shell-Ansatz des dispatchierenden Hosts verwenden
|
|
442
442
|
|
|
443
443
|
### Bekannte Punkte
|
package/README.es.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 de <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>: despachar trabajo a agentes DSH desde Claude Code / Codex / Antigravity / Grok, sin renunciar a la interfaz nativa de subagents del host.</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 página de ajustes de DSH
|
|
29
|
+
<p align="center"><sub>La página de ajustes de DSH Adapter — integraciones con el host, política de despacho, ejecución y el puente multimodal</sub></p>
|
|
30
30
|
|
|
31
|
-
## Por qué DSH
|
|
31
|
+
## Por qué DSH Adapter
|
|
32
32
|
|
|
33
|
-
DSH
|
|
33
|
+
DSH Adapter es un plugin para [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH), un harness de agentes de código abierto. Permite despachar agentes DSH desde Claude Code, Codex, Antigravity y Grok: el orchestrator conserva su propio modelo, el trabajo se ejecuta en un agente DSH real con las herramientas, el sandbox, los presets y el historial de sesión de ese harness, y el host lo sigue mostrando como un subagent nativo con progreso en vivo.
|
|
34
34
|
|
|
35
35
|
Lo que ejecuta el trabajo es un agente DSH, no una simple llamada a un modelo. Los tiers (`flash` / `pro`) seleccionan cuánta capacidad recibe ese agente del roster configurado del harness — hoy, DeepSeek V4 Flash y V4 Pro —, de modo que un cambio de modelo en DSH no requiere ningún cambio aquí.
|
|
36
36
|
|
|
@@ -79,7 +79,7 @@ Cada despacho se comprueba antes de que nada se lance. El anidamiento worker→w
|
|
|
79
79
|
|
|
80
80
|
### 📋 Tablón de trabajos
|
|
81
81
|
|
|
82
|
-
El panel de DSH
|
|
82
|
+
El panel de DSH Adapter hace las veces de tablón de trabajos: cada job worker — en ejecución o terminado — aparece listado con tier, effort, progreso en vivo y tokens; los workspaces retenidos muestran a sus titulares, y un job que desaparece a mitad de vuelo (p. ej., un reinicio del hub) aparece como un fantasma huérfano en lugar de desaparecer en silencio.
|
|
83
83
|
|
|
84
84
|
</td>
|
|
85
85
|
</tr>
|
|
@@ -118,14 +118,14 @@ Claude Code / Codex / Antigravity / Grok (orchestrator, conserva su propio model
|
|
|
118
118
|
El despacho se reparte. Abajo, dieciocho workers traducen este README en paralelo: el host los cuenta como sus propios subagents, mientras el harness los ejecuta como sesiones reales.
|
|
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>En Claude Code, los workers de dsh-
|
|
123
|
+
<p align="center"><sub>En Claude Code, los workers de dsh-adapter son subagents nativos; el segmento de statusline muestra los tiers en ejecución, el tiempo transcurrido y los 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>El panel de DSH
|
|
128
|
+
<p align="center"><sub>El panel de DSH Adapter muestra la misma ejecución desde el harness: qué host despachó cada trabajo, su tier y effort, el progreso en vivo y el uso de tokens.</sub></p>
|
|
129
129
|
|
|
130
130
|
<p align="center"><sub>El panel es también el tablón de trabajos: los jobs en ejecución y terminados permanecen listados con tier, progreso y tokens; los workspaces retenidos nombran a sus titulares, y un job que desaparece a mitad de vuelo (un reinicio del hub) aparece como un fantasma huérfano en lugar de desaparecer en silencio.</sub></p>
|
|
131
131
|
|
|
@@ -141,7 +141,7 @@ dsh web
|
|
|
141
141
|
O, para desarrollo local desde el código fuente:
|
|
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 @@ El protocolo `link:` enlaza la dependencia del perfil a este repositorio, así c
|
|
|
151
151
|
|
|
152
152
|
En modo hub — la instalación anterior — los workers se ejecutan dentro de la instancia de DSH y utilizan las credenciales de DeepSeek con las que ya está configurada. Nada más que configurar.
|
|
153
153
|
|
|
154
|
-
Solo el fallback standalone necesita su propia key: despachar desde un host sin ninguna instancia de DSH en ejecución inicia un worker runtime como proceso separado. Obtén una API key en [platform.deepseek.com](https://platform.deepseek.com) y escríbela en `~/.config/dsh-
|
|
154
|
+
Solo el fallback standalone necesita su propia key: despachar desde un host sin ninguna instancia de DSH en ejecución inicia un worker runtime como proceso separado. Obtén una API key en [platform.deepseek.com](https://platform.deepseek.com) y escríbela en `~/.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
|
El smoke test despacha una tarea económica por el camino disponible — el hub si una instancia de DSH está en ejecución, en caso contrario standalone — e imprime cuál se utilizó. En unos diez segundos deberías ver `smoke test passed — configuration OK`. Si falla, se imprime el motivo, limitado al camino que fue probado.
|
|
167
167
|
|
|
168
|
-
Luego abre Ajustes → DSH
|
|
168
|
+
Luego abre Ajustes → DSH Adapter e instala las integraciones del host — Claude Code, Codex, Antigravity, Grok — con un clic, o usa el mismo instalador desde la línea de comandos:
|
|
169
169
|
|
|
170
170
|
```bash
|
|
171
171
|
node src/install/cli.mjs claude # Plugin de Claude Code: marketplace + permisos + segmento HUD
|
|
@@ -192,7 +192,7 @@ node src/install/cli.mjs uninstall-claude
|
|
|
192
192
|
|
|
193
193
|
Instalación con un clic (elige una opción):
|
|
194
194
|
|
|
195
|
-
- **Página de ajustes de DSH** (cuando el modo hub está instalado): Ajustes → DSH
|
|
195
|
+
- **Página de ajustes de DSH** (cuando el modo hub está instalado): Ajustes → DSH Adapter → "Instalar en Claude Code"
|
|
196
196
|
- **Línea de comandos**: `node src/install/cli.mjs all`
|
|
197
197
|
|
|
198
198
|
Ambas hacen lo mismo: registrar el marketplace local (el directorio padre `dsh-plugins/` como raíz del marketplace) + `claude plugin install` + lista blanca de permisos de las herramientas MCP + configuración del segmento de estado del worker en claude-hud (copia de seguridad automática de settings.json antes de los cambios, idempotente). **Reinicia la sesión tras la instalación para que los cambios surtan efecto.**
|
|
@@ -204,7 +204,7 @@ Ambas hacen lo mismo: registrar el marketplace local (el directorio padre `dsh-p
|
|
|
204
204
|
- **Segmento de la línea de estado del HUD**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (tier actual / tiempo transcurrido / uso de tokens / tareas completadas)
|
|
205
205
|
- Para desarrollo local, `statusline/statusline.sh` o `statusline/worker-segment.sh` se pueden integrar de forma independiente
|
|
206
206
|
- **Tareas de larga duración**: CC impone límites de timeout a las llamadas MCP (`MCP_TOOL_TIMEOUT` ajustable); en tareas largas, el orchestrator puede usar `dsh_spawn_worker` + polling con `dsh_worker_result(wait_seconds)`
|
|
207
|
-
- **Desarrollo local y depuración**: `claude --plugin-dir /path/to/dsh-
|
|
207
|
+
- **Desarrollo local y depuración**: `claude --plugin-dir /path/to/dsh-adapter` para cargar temporalmente
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
### Comandos de sesión
|
|
@@ -213,11 +213,11 @@ Solo anulan los valores globales de la sesión actual y se aplican en la capa de
|
|
|
213
213
|
|
|
214
214
|
| Comando | Qué hace |
|
|
215
215
|
|---|---|
|
|
216
|
-
| `/dsh-
|
|
216
|
+
| `/dsh-adapter:config` | Mostrar o fijar los valores por defecto de la sesión: `tier=flash\|pro`, `effort=off\|high\|max`, `mode=auto\|hub\|standalone`, `timeout=<segundos>`, `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` | Activar o desactivar el despacho en esta sesión (desactivado es un interruptor duro: la herramienta rechaza) |
|
|
219
|
+
| `/dsh-adapter:status` | Estado en vivo de los jobs worker: tier, progreso, tokens, herramienta actual |
|
|
220
|
+
| `/dsh-adapter:playbook` | Buenas prácticas de despacho: elegir entre flash y pro, briefs autocontenidos, paralelismo, verificar resultados, barreras |
|
|
221
221
|
|
|
222
222
|
## Codex
|
|
223
223
|
|
|
@@ -268,7 +268,7 @@ Para Codex se instalan tres prompts:
|
|
|
268
268
|
node src/install/cli.mjs agy
|
|
269
269
|
```
|
|
270
270
|
|
|
271
|
-
Registra el servidor MCP dsh-
|
|
271
|
+
Registra el servidor MCP dsh-adapter en `~/.gemini/config/mcp_config.json` e instala los agents `ds-flash` / `ds-pro` además de los skills `dsh-config`, `dsh-status` y `dsh-playbook` en `~/.gemini/config/` (antes se hace copia de seguridad de todos los archivos). Reinicia la sesión después de la instalación.
|
|
272
272
|
|
|
273
273
|
### Uso
|
|
274
274
|
|
|
@@ -297,7 +297,7 @@ Desinstalar: `node src/install/cli.mjs uninstall-agy`
|
|
|
297
297
|
node src/install/cli.mjs grok
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
Escribe la sección `[mcp_servers.dsh-
|
|
300
|
+
Escribe la sección `[mcp_servers.dsh-adapter]` en `~/.grok/config.toml` e instala los agents `ds-flash` / `ds-pro` además de los comandos `/dsh-config`, `/dsh-status` y `/dsh-playbook` en `~/.grok/` (antes se hace copia de seguridad de todos los archivos).
|
|
301
301
|
|
|
302
302
|
### Uso
|
|
303
303
|
|
|
@@ -329,7 +329,7 @@ Desinstalar: `node src/install/cli.mjs uninstall-grok`
|
|
|
329
329
|
| `dsh_worker_cancel` | Cancela el job indicado y termina su proceso runtime |
|
|
330
330
|
| `dsh_worker_config` | Lee/fija los valores por defecto de la sesión (tier, effort, mode, timeout, policy, escalation) y lista los `worker_profiles` |
|
|
331
331
|
|
|
332
|
-
El progreso se refleja a la vez en `~/.config/dsh-
|
|
332
|
+
El progreso se refleja a la vez en `~/.config/dsh-adapter/status.d/` (un archivo shard por escritor; lo pueden leer el statusline o la monitorización externa).
|
|
333
333
|
|
|
334
334
|
## Barreras de despacho
|
|
335
335
|
|
|
@@ -340,7 +340,7 @@ Cada despacho se comprueba antes de que nada se lance — los rechazos son error
|
|
|
340
340
|
|
|
341
341
|
## Playbook de despacho
|
|
342
342
|
|
|
343
|
-
Cómo despachar *bien* — flash vs pro, briefs autocontenidos, paralelismo seguro, verificar resultados y las barreras anteriores — viene empaquetado como un playbook por host: `/dsh-
|
|
343
|
+
Cómo despachar *bien* — flash vs pro, briefs autocontenidos, paralelismo seguro, verificar resultados y las barreras anteriores — viene empaquetado como un playbook por host: `/dsh-adapter:playbook` (skill de Claude Code), `/dsh-playbook` (prompt de Codex, skill de Antigravity, comando de Grok).
|
|
344
344
|
|
|
345
345
|
## Backends explícitos de CLI
|
|
346
346
|
|
|
@@ -350,7 +350,7 @@ Cómo despachar *bien* — flash vs pro, briefs autocontenidos, paralelismo segu
|
|
|
350
350
|
|
|
351
351
|
**DeepSeek es un modelo solo de texto** y no admite entrada ni generación de imágenes. Este plugin obtiene esas capacidades de forma externa mediante herramientas MCP:
|
|
352
352
|
|
|
353
|
-
**Primero la visión nativa**: cuando el proveedor de visión es una CLI integrada (o explícitamente `native`), `describe_image` prueba primero el propio modelo VL de DeepSeek `deepseek-v4-flash-vision-exp` (llamada directa a la API; key de `DEEPSEEK_API_KEY` o `~/.config/dsh-
|
|
353
|
+
**Primero la visión nativa**: cuando el proveedor de visión es una CLI integrada (o explícitamente `native`), `describe_image` prueba primero el propio modelo VL de DeepSeek `deepseek-v4-flash-vision-exp` (llamada directa a la API; key de `DEEPSEEK_API_KEY` o `~/.config/dsh-adapter/.env`). Cualquier fallo degrada de forma elegante a la cadena de proveedores CLI de abajo, que se mantiene como fallback. La generación de imágenes no cambia — el modelo nativo solo mira imágenes.
|
|
354
354
|
|
|
355
355
|
| Herramienta | Descripción |
|
|
356
356
|
|---|---|
|
|
@@ -361,7 +361,7 @@ Cómo despachar *bien* — flash vs pro, briefs autocontenidos, paralelismo segu
|
|
|
361
361
|
|
|
362
362
|
### Configuración
|
|
363
363
|
|
|
364
|
-
En **la página de ajustes de DSH → DSH
|
|
364
|
+
En **la página de ajustes de DSH → DSH Adapter → Multimodal** (o edita directamente `~/.config/dsh-adapter/config.json`):
|
|
365
365
|
|
|
366
366
|
**Proveedor de visión** (ver imágenes):
|
|
367
367
|
|
|
@@ -405,15 +405,15 @@ Dos métodos de integración:
|
|
|
405
405
|
|
|
406
406
|
## Modo hub
|
|
407
407
|
|
|
408
|
-
Este paquete también es un bundle DSH válido (`dsh.bundle` + `cordis.patch.yml`). Tras instalarlo en un perfil de DSH Web con `dsh plugin add dsh-
|
|
408
|
+
Este paquete también es un bundle DSH válido (`dsh.bundle` + `cordis.patch.yml`). Tras instalarlo en un perfil de DSH Web con `dsh plugin add dsh-adapter`:
|
|
409
409
|
|
|
410
410
|
- **Las sesiones de los workers se convierten en ciudadanos de primera clase**: se ejecutan como sesiones de primera clase en el host DSH (`agents.create` + cascada de modelo/effort por sesión + preset por defecto), aparecen en la lista de sesiones de la Web UI y se pueden abrir en cualquier momento para ver la ejecución completa
|
|
411
411
|
- **Organización por directorio de trabajo**: gestiona las sesiones de los workers por cwd en la Web UI
|
|
412
412
|
- **Loopback API**:
|
|
413
|
-
- `POST/GET /_dsh/dsh-
|
|
414
|
-
- `GET /_dsh/dsh-
|
|
415
|
-
- `POST /_dsh/dsh-
|
|
416
|
-
- **Detección automática**: el shim MCP de los hosts detecta automáticamente el hub (variable de entorno `
|
|
413
|
+
- `POST/GET /_dsh/dsh-adapter/jobs`: lanza tareas, lista, long-poll de resultados, cancela
|
|
414
|
+
- `GET /_dsh/dsh-adapter/ping`: health check (el shim MCP lo usa para detectar si el hub está en marcha)
|
|
415
|
+
- `POST /_dsh/dsh-adapter/install`: instalación con un clic de las integraciones del host — Claude Code / Codex / Antigravity / Grok (backend de `src/install/`)
|
|
416
|
+
- **Detección automática**: el shim MCP de los hosts detecta automáticamente el hub (variable de entorno `DSHPLUGIN_ADAPTER_HUB`, por defecto `http://127.0.0.1:3080`)
|
|
417
417
|
- DSH Web en marcha → los jobs entran en modo hub (`mode: "hub"`)
|
|
418
418
|
- No está en marcha → se recurre al runtime standalone
|
|
419
419
|
|
|
@@ -437,7 +437,7 @@ Este paquete también es un bundle DSH válido (`dsh.bundle` + `cordis.patch.yml
|
|
|
437
437
|
|
|
438
438
|
### DSH Web en ejecución → modo hub activado automáticamente
|
|
439
439
|
|
|
440
|
-
- **Estado actual**: si `dsh plugin add dsh-
|
|
440
|
+
- **Estado actual**: si `dsh plugin add dsh-adapter` está instalado en un perfil de DSH Web, los jobs se ejecutan como sesiones de primera clase en el host y aparecen en la lista de sesiones de la Web UI
|
|
441
441
|
- **Recomendación**: durante la iteración del desarrollo local, se recomienda activar el modo hub; el progreso de los workers se puede observar por completo en la Web UI; para la colaboración entre máquinas o entornos sin Web UI, usa el enfoque de shell del host que despacha
|
|
442
442
|
|
|
443
443
|
### Puntos conocidos
|