@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
@@ -0,0 +1,15 @@
1
+ {
2
+ "name": "dsh-adapter",
3
+ "owner": {
4
+ "name": "ZSeven-W"
5
+ },
6
+ "description": "Dispatch subtasks to DeepSeek Harness (DSH) agents as native subagents with live progress",
7
+ "plugins": [
8
+ {
9
+ "name": "dsh-adapter",
10
+ "source": "./",
11
+ "description": "Dispatch subtasks to DeepSeek Harness (DSH) agents as native subagents with live progress",
12
+ "category": "productivity"
13
+ }
14
+ ]
15
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "dsh-adapter",
3
+ "version": "0.1.1",
4
+ "description": "Dispatch subtasks to DeepSeek Harness (DSH) agents as native subagents with live progress",
5
+ "author": {
6
+ "name": "zx-yk"
7
+ }
8
+ }
package/.mcp.json ADDED
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "dsh-adapter": {
4
+ "command": "node",
5
+ "args": ["${CLAUDE_PLUGIN_ROOT}/lib/server.mjs"]
6
+ }
7
+ }
8
+ }
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ZSeven-W
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.de.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>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 />
9
+ <sub>Native Fortschritts-UI &bull; Tier-Richtlinie &amp; Eskalation &bull; Dispatch-Leitplanken &bull; Jobs-Board &bull; DSH-Sitzungen im Host &bull; Vision &amp; Bildgenerierung (Native-First) &bull; Ein-Klick-Installation</sub>
10
+ </p>
11
+
12
+ <p align="center">
13
+ <sub>npm: <code>@zoraxylia/dsh-codex-adapter</code> &middot; Aktuelles Plugin-Release: <code>0.1.0-rc.11</code> &middot; Getestet mit DSH <code>0.1.1-rc.1</code></sub>
14
+ </p>
15
+
16
+ <p align="center">
17
+ <a href="./README.md">English</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">Français</a> &middot; <a href="./README.es.md">Español</a> &middot; <a href="./README.de.md"><b>Deutsch</b></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 — Einstellungsseite" width="100%" />
28
+ </p>
29
+ <p align="center"><sub>Die Einstellungsseite von DSH Adapter — Host-Integrationen, Dispatch-Richtlinie, Ausführung und die multimodale Brücke</sub></p>
30
+
31
+ ## Warum DSH Adapter
32
+
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
+
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
+
37
+ <table>
38
+ <tr>
39
+ <td width="50%">
40
+
41
+ ### 🧵 Native Fortschritts-UI
42
+
43
+ Worker erscheinen als normale Subagenten in Claude Code / Codex / Antigravity / Grok — Dispatch-Anzahl, laufender Schritt, Tool-Aufrufe und Token-Verbrauch werden alle im eigenen Task-Panel des Hosts angezeigt, plus ein claude-hud-Statusline-Segment: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3`.
44
+
45
+ </td>
46
+ <td width="50%">
47
+
48
+ ### 🎚️ Tier-Richtlinie und Eskalation
49
+
50
+ `flash` für mechanische Arbeit, `pro` für Reasoning, `effort` von `off` bis `max`. `tier_policy` kann jeden Dispatch auf Tool-Ebene auf einen Tier begrenzen, und `escalate_on_failure` wiederholt einen fehlgeschlagenen flash-Lauf einmal auf pro — evidenzbasiert, statt die Schwierigkeit im Voraus zu erraten.
51
+
52
+ </td>
53
+ </tr>
54
+ <tr>
55
+ <td width="50%">
56
+
57
+ ### 🏛️ DSH-Sitzungen im Host
58
+
59
+ Ist das Bundle in einem DSH-Profil installiert, ist jeder Worker eine First-Class-DSH-Sitzung: sichtbar in der Web-UI, nach Arbeitsverzeichnis gruppiert, mit dem pro Tier gewählten Agent-Preset gemountet. Läuft DSH nicht, fällt der Dispatch auf eine Standalone-DSH-Runtime zurück, sodass CI- und Headless-Umgebungen weiterhin funktionieren.
60
+
61
+ </td>
62
+ <td width="50%">
63
+
64
+ ### 👁️ Vision und Bildgenerierung
65
+
66
+ Die Modelle von DSH sind reine Textmodelle. `describe_image` bevorzugt jetzt DeepSeeks eigenes VL-Modell (`deepseek-v4-flash-vision-exp`), sobald ein Key verfügbar ist, und fällt dann auf die CLIs zurück, die Sie bereits haben — Claude, Codex, Grok, Antigravity — oder auf eine beliebige von Ihnen konfigurierte OpenAI-kompatible API. `generate_image` leiht sich den Pinsel derselben CLIs. Eingefügte Bilder bleiben in der Konversation sichtbar und erreichen das Modell als Text.
67
+
68
+ </td>
69
+ </tr>
70
+ <tr>
71
+ <td width="50%">
72
+
73
+ ### 🛡️ Dispatch-Leitplanken
74
+
75
+ Jeder Dispatch wird geprüft, bevor irgendetwas gestartet wird. Worker→Worker-Verschachtelung ist auf Origin-Chain-Tiefe 3 begrenzt und Zyklen werden abgelehnt; ein zweiter Worker auf einem Workspace, den bereits ein anderer Job hält, wird mit den Halter-Informationen abgelehnt — niemals stillschweigend in die Warteschlange gestellt. Ablehnungen sind lesbare Fehler: warten oder neu zuschneiden, nicht umgehen.
76
+
77
+ </td>
78
+ <td width="50%">
79
+
80
+ ### 📋 Jobs-Board
81
+
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
+
84
+ </td>
85
+ </tr>
86
+ <tr>
87
+ <td width="50%">
88
+
89
+ ### 🔌 Benutzerdefinierte Provider
90
+
91
+ Bringen Sie Ihren eigenen Endpoint (Base URL + API-Schlüssel + Modelle) oder eine lokale Befehlsvorlage mit. Jeder Provider hat einen Konnektivitätstest, der Erreichbarkeit und Auth prüft und dann einen echten Vision-Aufruf macht — so erfahren Sie es sofort statt mitten in der Aufgabe.
92
+
93
+ </td>
94
+ <td width="50%">
95
+
96
+ ### 📦 Ein-Klick-Installation
97
+
98
+ Die Einstellungsseite installiert und aktualisiert das Claude-Code-Plugin, die Codex-Rollendateien und die Antigravity-/Grok-Agenten, -Skills und -Befehle für Sie — Marketplace-Registrierung, Berechtigungs-Allowlist, HUD-Anbindung, für diese Maschine gerenderte absolute Pfade — und stellt sie genauso einfach wieder her. Jede Einstellungsdatei wird zuvor gesichert.
99
+
100
+ </td>
101
+ </tr>
102
+ </table>
103
+
104
+ ## Funktionsweise
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
+ ## Ein Lauf, zwei Ansichten
117
+
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
+
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>Claude Code sieht dsh-adapter-Worker als native Subagenten; das Statusline-Segment zeigt laufende Tiers, verstrichene Zeit und 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>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
+
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
+
132
+ ## Installation
133
+
134
+ Aus npm in ein DSH-Profil installieren:
135
+
136
+ ```bash
137
+ dsh plugin --profile web add @zoraxylia/dsh-codex-adapter@latest
138
+ dsh web
139
+ ```
140
+
141
+ Oder für lokale Entwicklung direkt aus dem Quellbaum:
142
+
143
+ ```bash
144
+ dsh plugin --profile web add link:/path/to/dsh-adapter
145
+ dsh web
146
+ ```
147
+
148
+ Das `link:`-Protokoll verlinkt die Profilabhängigkeit auf dieses Repository, sodass Rebuilds sofort sichtbar sind.
149
+
150
+ ### DeepSeek-Zugangsdaten konfigurieren (nur standalone)
151
+
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
+
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
+
156
+ ```
157
+ DEEPSEEK_API_KEY=sk-...
158
+ ```
159
+
160
+ ### Prüfen
161
+
162
+ ```bash
163
+ node scripts/smoke.mjs
164
+ ```
165
+
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
+
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
+
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
+ ## Hintergrund und Begriffe
181
+
182
+ - **DSH** (DeepSeek Harness): DeepSeeks Open-Source-Agent-Harness, ein Code-Agent in Web-UI-Form, ähnlich wie Claude Code, aber mit DeepSeek-Modellen.
183
+ - **MCP** (Model Context Protocol): Das KI-Tool-Integrationsprotokoll von Anthropic; ermöglicht es LLMs, externe Tools und Datenquellen sicher aufzurufen.
184
+ - **Cordis-Bundle**: Das Plugin-Format von DSH; dieses Projekt kann standalone als MCP-Dienst laufen oder als Hub-Modus in DSH Web installiert werden.
185
+ - **tier**: Fähigkeitsstufe — welcher Slot aus DSHs konfiguriertem Modell-Roster einem Worker zugewiesen wird. `flash` ist schnell und günstig (einfache Aufgaben), `pro` denkt intensiver nach (komplexe Probleme). Derzeit sind sie DeepSeek V4 Flash und V4 Pro zugeordnet; Modelle in DSH austauschen, und hier ändert sich nichts.
186
+ - **worker**: Der DSH-Agent, der die Arbeit erledigt — eine vollständige Sitzung mit eigenen Tools, eigener Sandbox und eigenem Preset, kein bloßer Modellaufruf.
187
+ - **effort**: Reasoning-Stärke, `off` = kein Reasoning, `high` = hoher Reasoning-Einsatz, `max` = maximaler Reasoning-Einsatz.
188
+
189
+ ## Claude Code
190
+
191
+ ### Installation
192
+
193
+ Ein-Klick-Installation (eine Option wählen):
194
+
195
+ - **DSH-Einstellungsseite** (wenn der Hub-Modus installiert ist): Settings → DSH Adapter → „Install to Claude Code"
196
+ - **Kommandozeile**: `node src/install/cli.mjs all`
197
+
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.**
199
+
200
+ ### Verwendung
201
+
202
+ - Sagen Sie direkt in der Konversation „dispatch X to ds-flash" oder „dispatch X to ds-pro", und der Subagent führt die Aufgabe aus
203
+ - Dispatch-Anzahl und Echtzeit-Fortschritt werden in der Task-UI von Claude Code angezeigt
204
+ - **HUD-Statuszeilen-Segment**: `⚙dsh 1▶pro 2m14s 21.7k/606 ✓3` (aktueller Tier / verstrichene Zeit / Token-Verbrauch / Abschlusszähler)
205
+ - Für die lokale Entwicklung können `statusline/statusline.sh` oder `statusline/worker-segment.sh` unabhängig integriert werden
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-adapter` zum temporären Laden
208
+
209
+
210
+ ### Sitzungsbefehle
211
+
212
+ Sie überschreiben die globalen Vorgaben nur für die aktuelle Sitzung und werden auf Tool-Ebene durchgesetzt, nicht per Prompt:
213
+
214
+ | Befehl | Wirkung |
215
+ |---|---|
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
+
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
+
222
+ ## Codex
223
+
224
+ ### Installation
225
+
226
+ Empfohlen wird die Verwendung des Installers (rendert Pfade für diese Maschine automatisch, kopiert die Prompts `/dsh-config`, `/dsh-status` und `/dsh-playbook`):
227
+
228
+ ```bash
229
+ node src/install/cli.mjs codex
230
+ ```
231
+
232
+ Oder manuell kopieren (erfordert nach dem Kopieren eine manuelle Pfadanpassung):
233
+
234
+ ```bash
235
+ cp codex/agents/*.toml ~/.codex/agents/ # global or project-level .codex/agents/
236
+ ```
237
+
238
+ Die Rollendateien sind vorkonfiguriert mit:
239
+
240
+ - MCP-Server-Mounting-Konfiguration
241
+ - `default_tools_approval_mode = "approve"` (**erforderlich**, andernfalls werden Tool-Aufrufe im Exec-Modus automatisch abgebrochen)
242
+ - `tool_timeout_sec = 3600`
243
+
244
+ **Hinweis**: Beim manuellen Kopieren müssen die absoluten Pfade im Feld `args` an den tatsächlichen Installationsort angepasst werden; der Installer übernimmt dies automatisch.
245
+
246
+ ### Verwendung
247
+
248
+ - Wählen Sie in der interaktiven TUI „spawn ds-pro to ...", um Aufgaben zu verteilen; die Active/Done-Panels zeigen den Fortschritt
249
+ - Der `codex exec`-Modus kann `dsh_run_worker` auch direkt aufrufen
250
+
251
+
252
+ ### Sitzungsbefehle
253
+
254
+ Für Codex werden drei Prompts installiert:
255
+
256
+ | Befehl | Wirkung |
257
+ |---|---|
258
+ | `/dsh-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` |
259
+
260
+ | `/dsh-status` | Live-Status der Worker-Jobs: Tier, Fortschritt, Tokens, aktuelles Tool |
261
+ | `/dsh-playbook` | Dispatch-Best-Practices: die Wahl zwischen flash und pro, eigenständige Briefings, Parallelität, Verifizieren von Ergebnissen, Leitplanken |
262
+
263
+ ## Antigravity (agy)
264
+
265
+ ### Installation
266
+
267
+ ```bash
268
+ node src/install/cli.mjs agy
269
+ ```
270
+
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
+
273
+ ### Verwendung
274
+
275
+ - Wählen Sie `ds-flash` oder `ds-pro` als Agenten, um Aufgaben zu verteilen
276
+ - `dsh_worker_config` liest die Sitzungsvorgaben oder überschreibt sie
277
+
278
+ ### Sitzungs-Skills
279
+
280
+ | Skill | Wirkung |
281
+ |---|---|
282
+ | `/dsh-config` | Vorgaben der Sitzung anzeigen oder setzen (Tier / Effort / Modus / Timeout / Richtlinie / Eskalation / Reset) |
283
+ | `/dsh-status` | Live-Status der Worker-Jobs: Tier, Fortschritt, Tokens, aktuelles Tool |
284
+ | `/dsh-playbook` | Dispatch-Best-Practices: die Wahl zwischen flash und pro, eigenständige Briefings, Parallelität, Verifizieren von Ergebnissen, Leitplanken |
285
+
286
+ ### Einschränkungen
287
+
288
+ - agy führt Worker mit **voller Freigabe** aus (`--dangerously-skip-permissions` + accept-edits): agy 1.1.16 hat keinen Workspace-bezogenen Berechtigungsmodus, daher muss ein headless Worker Tool-Anfragen automatisch genehmigen.
289
+
290
+ Deinstallation: `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
+ 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
+
302
+ ### Verwendung
303
+
304
+ - Wählen Sie `ds-flash` oder `ds-pro` als Agenten, um Aufgaben zu verteilen
305
+
306
+ ### Sitzungsbefehle
307
+
308
+ | Befehl | Wirkung |
309
+ |---|---|
310
+ | `/dsh-config` | Vorgaben der Sitzung anzeigen oder setzen (Tier / Effort / Modus / Timeout / Richtlinie / Eskalation / Reset) |
311
+ | `/dsh-status` | Live-Status der Worker-Jobs: Tier, Fortschritt, Tokens, aktuelles Tool |
312
+ | `/dsh-playbook` | Dispatch-Best-Practices: die Wahl zwischen flash und pro, eigenständige Briefings, Parallelität, Verifizieren von Ergebnissen, Leitplanken |
313
+
314
+ ### Einschränkungen
315
+
316
+ - Aus Sicherheitsgründen startet grok keine MCP-Server auf Repo-Ebene in nicht vertrauenswürdigen Projektverzeichnissen (`grok mcp doctor` meldet „folder untrusted“); eine globale Installation ist nicht betroffen — Verzeichnis wechseln oder `--trust` übergeben.
317
+ - grok-Worker laufen mit `bypassPermissions` (always-approve, wie die grok-Dokumentation für headless Automatisierung empfiehlt); Deny-Regeln und Hooks gelten weiterhin.
318
+
319
+ Deinstallation: `node src/install/cli.mjs uninstall-grok`
320
+
321
+ ## MCP-Tools
322
+
323
+ | Tool | Beschreibung |
324
+ |---|---|
325
+ | `dsh_run_worker` | Blockierender Task-Dispatch (`tier`: flash/pro, `effort`: off/high/max, `cwd`, `worker`), wartet auf das Ergebnis |
326
+ | `dsh_spawn_worker` | Asynchroner Task-Dispatch, gibt die Job-ID zurück (für paralleles Fan-out); Ergebnisse mit `dsh_worker_result` einsammeln |
327
+ | `dsh_worker_status` | Echtzeit-Fortschritt aller Jobs (Turn/Schritt/aktuelles Tool/Token) + cwd-Advisory-Locks |
328
+ | `dsh_worker_result` | Holt das Ergebnis, kann mit `wait_seconds` warten |
329
+ | `dsh_worker_cancel` | Bricht den angegebenen Job ab und beendet seinen Runtime-Prozess |
330
+ | `dsh_worker_config` | Sitzungsvorgaben lesen/setzen (Tier, Effort, Modus, Timeout, Richtlinie, Eskalation) und `worker_profiles` auflisten |
331
+
332
+ Der Fortschritt wird gleichzeitig nach `~/.config/dsh-adapter/status.d/` gespiegelt (eine Shard-Datei pro Writer, lesbar für Statusline / externes Monitoring).
333
+
334
+ ## Dispatch-Leitplanken
335
+
336
+ Jeder Dispatch wird geprüft, bevor irgendetwas gestartet wird — Ablehnungen sind lesbare Fehler, niemals stille Warteschlangen:
337
+
338
+ - **Origin Chain**: Jeder Dispatch hängt einen Hop an die Worker→Worker-Origin-Chain an. Verschachtelung tiefer als die Obergrenze (`origin_depth_limit`, Standard 3) wird abgelehnt, ebenso jeder Zyklus (dasselbe Backend + cwd erscheint zweimal) — der Schutz, der rekursive Worker-Selbstverstärkung stoppt.
339
+ - **cwd-Advisory-Lock**: ein laufender Worker pro Workspace. Ein zweiter Dispatch in einen gehaltenen Workspace wird mit der Job-ID, dem Backend und der Startzeit des Halters abgelehnt — warten Sie, bis er sich erledigt hat, brechen Sie ihn mit `dsh_worker_cancel` ab, oder übergeben Sie `allow_concurrent_cwd: true` (nur reine Leseaufgaben).
340
+
341
+ ## Dispatch-Playbook
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-adapter:playbook` (Claude-Code-Skill), `/dsh-playbook` (Codex-Prompt, Antigravity-Skill, Grok-Befehl).
344
+
345
+ ## Explizite CLI-Backends
346
+
347
+ `worker="agy"` / `worker="grok"` pinnt einen Dispatch auf diese externe CLI (Backend × Modell × Effort) statt auf die DSH-Tier-Logik. Das ist explizites Opt-in — es gibt keinen Standard, setzen Sie es also nur, wenn der Nutzer diese CLI verlangt. Einschränkungen: grok verweigert das Starten repo-lokaler MCP-Server in nicht vertrauenswürdigen Ordnern, und agy führt Worker mit voller Freigabe aus (kein Workspace-bezogener Berechtigungsmodus).
348
+
349
+ ## Multimodal: Vision und Bildgenerierung
350
+
351
+ **DeepSeek ist ein reines Textmodell** und unterstützt weder Bildeingabe noch -generierung. Dieses Plugin bezieht diese Fähigkeiten extern über MCP-Tools:
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-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
+
355
+ | Tool | Beschreibung |
356
+ |---|---|
357
+ | `describe_image` | Beantwortet Fragen durch das Betrachten von Bildern (Screenshots, Designs, Diagramme usw.), Ergebnisse werden nach Provider + Modell + Bild + Frage zwischengespeichert |
358
+ | `generate_image` | Erzeugt ein Bild aus einer Textbeschreibung und speichert es unter einem angegebenen absoluten Pfad; die Ausgabe ist eine flache Bitmap (Ebenenbearbeitung erfordert OpenPencil) |
359
+
360
+ **Bildeinfügen in Sitzungen**: Wechseln Sie in DSH das Modell auf `DeepSeek (vision) ◉`, um Bilder direkt einzufügen. Bilder bleiben in der Sitzung und werden normal angezeigt; das Plugin hängt transkribierten Text dahinter an und entfernt die Bilder vor dem Senden — Sie sehen das Bild, das Modell liest den Text. Die Transkription folgt derselben Native-First-Leiter: DeepSeeks VL-Modell, wenn ein Key verfügbar ist, danach Ihr konfigurierter CLI-Provider.
361
+
362
+ ### Konfiguration
363
+
364
+ In der **DSH-Einstellungsseite → DSH Adapter → Multimodal** (oder bearbeiten Sie direkt `~/.config/dsh-adapter/config.json`):
365
+
366
+ **Vision-Provider** (Bildbetrachtung):
367
+
368
+ - `native` / `deepseek-native` (DeepSeeks eigenes VL-Modell — wird bei jedem eingebauten Provider automatisch zuerst versucht, sobald ein Key verfügbar ist)
369
+ - `claude-code` (Standard, verwendet Haiku, kostengünstig)
370
+ - `codex` (verwendet GPT, konkretes Modell wählbar)
371
+ - `grok` (verwendet Grok)
372
+ - `agy` (Antigravity)
373
+ - `custom` (OpenAI-kompatible API oder lokaler Befehl)
374
+ - `off` (deaktiviert)
375
+
376
+ **Bildgenerierungs-Provider** (Bildgenerierung):
377
+
378
+ - `codex` (`$imagegen`, gpt-image-2)
379
+ - `agy` (Nano Banana)
380
+ - `grok` (Imagine)
381
+ - `custom` (OpenAI-kompatible API oder lokaler Befehl)
382
+ - `off` (deaktiviert)
383
+
384
+ ### Benutzerdefinierter Provider
385
+
386
+ Zwei Integrationsmethoden:
387
+
388
+ **API**: Jeder OpenAI-kompatible Endpoint
389
+ - Base URL, API-Schlüssel und Modellliste ausfüllen
390
+ - Vision verwendet `/chat/completions` mit inline eingebetteten Base64-Bildern
391
+ - Bildgenerierung verwendet `/images/generations`
392
+ - **Das „Bildgenerierungsmodell" muss angegeben werden, um Generierungsfähigkeit zu erhalten**, andernfalls erscheint der Provider nur in der Vision-Auswahl
393
+
394
+ **CLI**: Lokale Befehlsvorlage, Platzhalter werden durch sichere Referenzen ersetzt
395
+ - Vision: `{image} {question} {model}` → stdout als Antwort
396
+ - Bildgenerierung: `{prompt} {output} {size}` → der Befehl muss die Datei nach `{output}` schreiben
397
+ - Mindestens einen Befehl ausfüllen; je nachdem, welcher ausgefüllt ist, ergibt sich die Fähigkeit
398
+
399
+ **Konnektivitätstest**: Jeder benutzerdefinierte Provider hat eine Test-Schaltfläche
400
+ - API: Erreichbarkeit des Endpoints und Auth prüfen, echte Vision-Anfrage zur Verifizierung senden
401
+ - CLI: Ausführbare Datei prüfen, echten Befehl zur Verifizierung ausführen
402
+ - Bildgenerierung: Nur die Konfiguration validieren, keine tatsächliche Bildausgabe
403
+
404
+ **Entliehene Abo-CLIs** (claude / codex / grok / agy) erfordern eine lokale Anmeldung; das Plugin umgeht deren Berechtigungen nicht für Sie.
405
+
406
+ ## Hub-Modus
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-adapter`:
409
+
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
+ - **Nach Arbeitsverzeichnis organisieren**: Worker-Sitzungen nach cwd in der Web-UI verwalten
412
+ - **Loopback-API**:
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
+ - DSH Web läuft → Jobs wechseln in den Hub-Modus (`mode: "hub"`)
418
+ - Läuft nicht → Fallback auf die Standalone-Runtime
419
+
420
+ **Windows-Prozessabfrage:** Die Erkennung des Aufrufers und das geprüfte Beenden eines einzelnen Prozesses verwenden PowerShell/CIM. Die API für verwaiste Prozesse verweigert das Beenden von Prozessgruppen mit `unsupported-platform` und sendet kein Signal.
421
+
422
+ ## Lösungsauswahl und Einschränkungen
423
+
424
+ ### Reguläre Abonnenten → Shell-Subagent-Ansatz (empfohlen)
425
+
426
+ - **Aktueller Stand**: Die Subagent-Shell von Claude Code verwendet Haiku als Vermittler; jeder Dispatch fügt Hunderte bis Tausende Token hinzu
427
+ - **Kompromiss**: Eine kleine Menge Anthropic-Token im Austausch für native Task-UI, Echtzeit-Fortschrittsanzeige und keine zusätzliche Konfiguration
428
+ - **Empfehlung**: Wenn Sie bereits Claude Pro abonniert haben oder Claude Code verwenden, nutzen Sie diesen Ansatz — bequem und transparent
429
+
430
+ ### Pay-as-you-go- / CI-Umgebungen → direkter Router-Ansatz
431
+
432
+ - **Aktueller Stand**: Das Subagent-Frontmatter von Claude Code unterstützt keine direkte Verbindung zu Drittanbieter-Modellen; das Router-Experiment dieses Repos im Scratchpad erfordert API-Key-Credentials für Claude Code, aber Abo-OAuth wird upstream von Anthropic mit 403 blockiert
433
+ - **Empfehlung**:
434
+ - Wer API-Key-Credentials (kein OAuth) verwendet und Anthropic-Token sparen möchte, kann einen lokalen Router für eine direkte DeepSeek-Verbindung betreiben
435
+ - CI-Umgebungen verwenden typischerweise ebenfalls API-Schlüssel; dieser Ansatz ist wirtschaftlicher (ausschließlich DeepSeek-Token)
436
+ - Erfordert eigene Tests der Router-Integration (nicht offiziell unterstützt)
437
+
438
+ ### DSH Web läuft → Hub-Modus automatisch aktiviert
439
+
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
+ - **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
+
443
+ ### Bekannte Punkte
444
+
445
+ - Die Codex-Rolle kann theoretisch `model_provider` direkt auf DeepSeek zeigen lassen (unverifiziert); diese Brücke hängt nicht davon ab
446
+ - Die Ausgabe der Bildgenerierung ist eine flache Bitmap; Ebenenbearbeitung erfordert OpenPencil
447
+ - **Runtime-Abhängigkeiten**: Nur `@modelcontextprotocol/sdk` und `zod`; `@deepseek-ai/*` sind Host-Runtime (vom DSH-Host bereitgestellt; eine normale npm-Installation zieht sie nie)
448
+ - **Codex muss konfigurieren**: `default_tools_approval_mode = "approve"`, andernfalls werden Tool-Aufrufe automatisch abgebrochen
449
+
450
+ ## Entwicklung
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
+ Runtime-Abhängigkeiten sind nur `@modelcontextprotocol/sdk` und `zod`; jedes `@deepseek-ai/*`-Paket ist eine Peer-Abhängigkeit, die vom DSH-Host bereitgestellt wird, wodurch das Plugin im einzigen Modul-Realm des Hosts bleibt.
461
+
462
+ ## Ökosystem
463
+
464
+ - [DSH Android](https://github.com/ZSeven-W/dsh-android) — ein Live-Android-Emulator oder USB-Gerät in der Konversation, vollständig über adb gesteuert
465
+ - [DSH iOS](https://github.com/ZSeven-W/dsh-ios) — ein lebender iOS-Simulator — und ein iPhone per USB — in der Konversation
466
+ - [DSH Noema](https://github.com/ZSeven-W/dsh-noema) — Langzeitgedächtnis für DSH
467
+ - [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — `.op`-Designdokumente innerhalb einer Konversation inspizieren und bearbeiten
468
+
469
+ ## Lizenz
470
+
471
+ MIT
472
+
473
+
474
+ ### `dsh_worker_probe` / `needs_input`
475
+
476
+ `dsh_worker_probe` sendet eine zeitlich begrenzte, wirkungslose Werkzeuganfrage an eine konfigurierte DSH-Route, ohne Worker zu starten oder Bindungen zu ändern. Dabei können Tokens anfallen. Unbeantwortete Fragen stoppen den Worker mit `needs_input`; erst nach der Nutzerantwort erneut beauftragen. Host-Berechtigungen werden übernommen, kein neuer OS-Sandbox zugesichert.
477
+
478
+ ```js
479
+ dsh_worker_probe({ tier: "flash" })
480
+ ```