dshx

O que dshx faz?

Use o dshx como limite de máquina em torno do runtime dsh --profile headless upstream. Mantenha a tarefa delimitada e torne o workspace explícito.

Prontidão

Execute:

dshx doctor --json

Exija que node_supported, dsh_available e api_key_present sejam verdadeiros antes de delegar trabalho pago/modelo. Nunca imprima valores de credenciais.

Se o dshx estiver faltando, explique o comando de instalação fixado e execute-o apenas com autorização do usuário:

npm install -g @hfshfg/[email protected]

Delegar uma tarefa

Prefira stdin para que o texto da tarefa não dependa de escapamento de shell:

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

Direcione ou redirecione a tarefa para stdin. Para instruções com mais de 24.000 caracteres, escreva o material de origem dentro do workspace autorizado e envie uma tarefa curta que referencie esse arquivo.

Escolha um timeout proporcional à tarefa. Mantenha o padrão de 30 minutos para trabalho normal de codificação; use um limite mais curto para diagnóstico. Não defina um timeout ilimitado a menos que o usuário solicite explicitamente execução persistente.

Interpretar resultados

• ok: true, reason: completed: retorne ou resuma text e relate duration_ms.
• reason: failed: relate o código de saída upstream e diagnósticos concisos.
• reason: timeout: explique que a árvore de processos foi encerrada no limite declarado; não afirme que a tarefa foi concluída.
• reason: output_limit: restrinja a tarefa ou peça ao DSH para escrever um arquivo de resultado no workspace.
• Código de saída 2 significa erro local de parâmetro/entrada; corrija a invocação antes de tentar novamente.

Trate stdout como o canal de resultado e stderr como diagnósticos. Não analise saída ANSI ou spinner; o dshx a remove dos resultados de máquina.

Limites

• Delegue apenas trabalho dentro do workspace autorizado pelo usuário.
• Não inclua chaves de API ou outros segredos no texto da tarefa, argv ou resumos de saída.
• Não use dsh web para delegação agente-para-agente; é a interface de navegador voltada para humanos.
• Revise as alterações do DSH e evidências de teste antes de apresentá-las como completas.
• Lembre-se de que o DeepSeek Harness está em Desenvolvedor (Developer Preview) e o dshx 0.2.1 fixa o @deepseek-ai/dsh 0.1.0-rc.6.