dshx — Pont machine-friendly pour DeepSeek Harness

dshx

Utilisez dshx comme frontière machine autour de l'exécution amont dsh --profile headless. Gardez la tâche bornée et rendez l'espace de travail explicite.

Vérification de disponibilité

Exécutez :

dshx doctor --json

Exigez que node_supported, dsh_available et api_key_present soient true avant de déléguer un travail payant / utilisant un modèle. N'affichez jamais les valeurs des identifiants.

Si dshx est manquant, expliquez la commande d'installation épinglée et exécutez-la uniquement avec l'autorisation de l'utilisateur :

npm install -g @hfshfg/[email protected]

Déléguer une tâche

Privilégiez l'entrée standard pour que le texte de la tâche ne dépende pas du quoting du shell :

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

Passez la tâche par tube ou redirection dans stdin. Pour des instructions de plus de 24 000 caractères, écrivez le matériau source dans l'espace de travail autorisé et envoyez une tâche courte qui référence ce fichier.

Choisissez un délai d'attente proportionnel à la tâche. Gardez la valeur par défaut de 30 minutes pour un travail de codage normal ; utilisez une limite plus courte pour un diagnostic. Ne fixez pas de délai d'attente illimité sauf si l'utilisateur demande explicitement une exécution persistante.

Interpréter les résultats

• ok: true, reason: completed : retournez ou résumez text et rapportez duration_ms.
• reason: failed : rapportez le code de sortie amont et des diagnostics concis.
• reason: timeout : expliquez que l'arbre de processus a été terminé à la limite déclarée ; ne prétendez pas que la tâche est terminée.
• reason: output_limit : réduisez la tâche ou demandez à DSH d'écrire un fichier de résultat dans l'espace de travail.
• Le code de sortie 2 signifie une erreur locale de paramètre / d'entrée ; corrigez l'invocation avant de réessayer.

Traitez stdout comme le canal de résultat et stderr comme les diagnostics. N'analysez pas la sortie ANSI ou les spinners ; dshx les supprime des résultats machine.

Limites

• Déléguez uniquement du travail à l'intérieur de l'espace de travail autorisé par l'utilisateur.
• N'incluez pas de clés API ou d'autres secrets dans le texte de la tâche, argv ou résumés de sortie.
• N'utilisez pas dsh web pour la délégation agent-à-agent ; c'est l'interface utilisateur navigateur humaine.
• Examinez les modifications DSH et les preuves de test avant de les présenter comme complètes.
• N'oubliez pas que DeepSeek Harness est en aperçu développeur et que dshx 0.2.1 épingle @deepseek-ai/dsh 0.1.0-rc.6.