CommunitySchreiben & Editierengithub.com

dshx

Maschinenlesbarer DeepSeek Harness Adapter mit cwd, stdin, Timeout, stabilem JSON – CLI + Codex/Agent Plugins

Was ist dshx?

Diese Fähigkeit stellt `dshx` als zuverlässige, maschinenfreundliche Kommandozeilenschnittstelle für den `dsh --profile headless` Laufzeit bereit. Sie eignet sich besonders für den Einsatz in KI-Agenten, CI/CD-Pipelines und Codex-Umgebungen, da sie strukturierte JSON-Ausgaben, standardmäßige Ein-/Ausgabe (stdin/stdout) und klare Timeout-Mechanismen bietet. `dshx` unterstützt die Plattformen DeepSeek Harness (Developer Preview) und wird auf Node.js ausgeführt. Die Verwendung erfolgt über die CLI, wobei die Befehle `dshx doctor`, `dshx run` und explizite Timeout- und Arbeitsverzeichnis-Parameter die Ausführung kontrollieren. Das Tool fängt Fehler klar ab (z.B. Exit-Code 2 bei Parameterfehlern) und grenzt Aufgaben sowie Diagnose- und Ergebnisdaten strikt voneinander ab, sodass Agenten Ergebnisse zuverlässig parsen können. Es schützt außerdem API-Schlüssel und sensible Daten vor der Weitergabe an den Upstream.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add dongsheng123132/dshx

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht dshx?

Verwenden Sie dshx als maschinelle Grenze um die übergeordnete dsh --profile headless Laufzeit. Halten Sie die Aufgabe begrenzt und machen Sie das Arbeitsverzeichnis explizit.

Bereitschaft

Führen Sie aus:

dshx doctor --json

Fordern Sie node_supported, dsh_available und api_key_present als true, bevor Sie bezahlte/Modell-Arbeit delegieren. Geben Sie niemals Anmeldeinformationen aus.

Wenn dshx fehlt, erklären Sie den festgelegten Installationsbefehl und führen Sie ihn nur mit Benutzerautorisierung aus:

npm install -g @hfshfg/[email protected]

Eine Aufgabe delegieren

Bevorzugen Sie stdin, damit der Aufgabentext nicht von Shell-Anführungszeichen abhängt:

dshx run --stdin --cwd ./workspace --timeout 1800000 --json

Leiten Sie die Aufgabe in stdin um oder leiten Sie sie um. Für Anweisungen mit mehr als 24.000 Zeichen schreiben Sie das Quellmaterial in das autorisierte Arbeitsverzeichnis und senden Sie eine kurze Aufgabe, die auf diese Datei verweist.

Wählen Sie eine zum Aufgabentyp proportionale Zeitüberschreitung. Behalten Sie den Standard von 30 Minuten für normale Programmierarbeit; verwenden Sie eine kürzere Grenze für Diagnosen. Setzen Sie keine unbegrenzte Zeitüberschreitung, es sei denn, der Benutzer verlangt explizit eine dauerhafte Ausführung.

Ergebnisse interpretieren

  • ok: true, reason: completed: Geben Sie text zurück oder fassen Sie es zusammen und melden Sie duration_ms.
  • reason: failed: Melden Sie den upstream Exit-Code und prägnante Diagnosen.
  • reason: timeout: Erklären Sie, dass der Prozessbaum an der deklarierten Grenze beendet wurde; behaupten Sie nicht, dass die Aufgabe abgeschlossen ist.
  • reason: output_limit: Verengen Sie die Aufgabe oder bitten Sie DSH, eine Ergebnisdatei im Arbeitsverzeichnis zu schreiben.
  • Exit-Code 2 bedeutet lokalen Parameter-/Eingabefehler; korrigieren Sie den Aufruf, bevor Sie es erneut versuchen.

Behandeln Sie stdout als Ergebniskanal und stderr als Diagnose. Parsen Sie keine ANSI- oder Spinner-Ausgabe; dshx entfernt sie von Maschinenergebnissen.

Grenzen

  • Delegieren Sie nur Arbeit innerhalb des vom Benutzer autorisierten Arbeitsverzeichnisses.
  • Fügen Sie keine API-Schlüssel oder anderen Geheimnisse in Aufgabentext, argv oder Ausgabezusammenfassungen ein.
  • Verwenden Sie dsh web nicht für Agent-zu-Agent Delegierung; es ist die menschliche Browser-Benutzeroberfläche.
  • Überprüfen Sie DSH-Änderungen und Testnachweise, bevor Sie sie als abgeschlossen präsentieren.
  • Denken Sie daran, dass DeepSeek Harness eine Entwicklervorschau ist und dshx 0.2.1 @deepseek-ai/dsh 0.1.0-rc.6 festlegt.

Verwandte Skills