DeepSeek Harness · Prévia para desenvolvedores

DeepSeek Harness Tudo é plugin · Runtime Agent

O modelo é a alma do Agent; o Harness faz o Agent entender o ambiente, usar ferramentas e trabalhar de forma contínua em cenários reais. O DeepSeek Harness (dsh) já é código aberto: abra primeiro o chat web DeepSeek, valide a tarefa conversando com o DeepSeek-V4 e, se precisar, combine localmente um Agent completo com plugins.

MIT

Licença de código aberto

DeepSeek Harness amigável para uso comercial

Plugin

Tudo é plugin

Do modelo à UI, tudo pode ser substituído

4

Modos de execução

Padrão / PTC / Mínimo / Criação

V4

DeepSeek-V4

Validar primeiro no chat web e depois executar localmente

Agent = Model + Harness

O Harness faz o Agent DeepSeek trabalhar de forma contínua em cenários reais

O DeepSeek-V4 oferece raciocínio e conversa; o DeepSeek Harness oferece ambiente, ferramentas e execução rastreável. Só os dois juntos formam um Agent que dá para colocar em prática.

Núcleo Cordis

O Cordis só cuida de carregar, descarregar e resolver dependências de plugins — não das capacidades concretas do Agent. O DeepSeek Harness entrega por completo o «o que ele pode fazer» aos plugins.

DeepSeek Harness Cordis

Os plugins fornecem as capacidades

Modelo, ferramentas, skills, sessão, sandbox, armazenamento, loop, agendamento e UI: todas as capacidades do Agent vêm de plugins e colaboram por serviços e eventos do Cordis.

DeepSeek tudo é plugin

Combinação livre na camada de configuração

Sem alterar o código-fonte do DeepSeek Harness, você pode escolher, substituir ou estender qualquer capacidade na camada de configuração e testar rapidamente combinações de ferramentas adequadas ao DeepSeek-V4.

DeepSeek Harness combinável
Capacidades centrais do DeepSeek Harness

Seis capacidades que definem um runtime Agent de código aberto

Uma prévia para desenvolvedores de Harness: código aberto, substituível e rastreável. Combina com um fluxo «validar na conversa + executar localmente» junto ao chat web DeepSeek e ao DeepSeek-V4.

Tudo é plugin

O DeepSeek Harness se baseia no sistema de plugins Cordis. Adaptação de modelo, registro de ferramentas, logs de sessão, loop do Agent e até a UI são plugins e podem ser substituídos livremente na configuração.

DeepSeek Harness plugins

Cada execução deixa rastro

Tudo o que o modelo vê é gravado em um log de sessão apenas de acréscimo: prompt de sistema, cadeia de pensamento, chamadas de ferramentas e resultados, agendamento de subagentes e injeção de contexto. A vista Trajectory reproduz por origem.

DeepSeek Trajectory

Quatro modos de execução

O modo padrão oferece o conjunto completo de ferramentas; o modo PTC (Code Mode) orquestra chamadas de vários passos com código gerado; o modo mínimo serve para benchmarks; o modo criação serve para experimentar plugins e criar novos presets.

DeepSeek Harness modos

Complementar ao DeepSeek-V4

O chat web DeepSeek serve para esclarecer primeiro a tarefa e comparar Pro / Flash; o Harness serve para executar a mesma tarefa de forma contínua em um Agent local com sandbox e ferramentas.

DeepSeek-V4 Agent

Web UI com um comando

Depois de instalar o Node.js, execute npx @deepseek-ai/dsh web; por padrão abre a Web UI local (127.0.0.1:3080). Na instalação a partir do código-fonte, faça o build com pnpm e execute o mesmo comando.

DeepSeek dsh web

Ecossistema de plugins aberto

Adicione o topic do GitHub «dsh-plugin» ao repositório do plugin para facilitar a descoberta. Plugins centrais e APIs ainda iteram; o aviso oficial deixa claro que haverá mudanças incompatíveis.

ecossistema dsh-plugin
Visão rápida do DeepSeek Harness

Prévia para desenvolvedores: fatos que vale lembrar

As informações vêm da página oficial de apresentação da DeepSeek e do README do GitHub, para pesquisar questões relacionadas a DeepSeek Harness / dsh.

dsh

Nome da CLI

Pista da CLI e do nome do pacote do DeepSeek Harness: npx @deepseek-ai/dsh web

Cordis

Núcleo de plugins

Só gerencia carga / descarga / dependências; todas as capacidades do Agent vêm de plugins

MIT

Licença de código aberto

O repositório oficial deepseek-ai/deepseek-harness é código aberto sob MIT

4

Modos embutidos

Padrão, PTC (Code), Mínimo, Criação — do Agent de código ao benchmark

3080

Porta web padrão

Após o npx, a Web UI local escuta por padrão em 127.0.0.1:3080

Prévia

Prévia para desenvolvedores

Para testes de desenvolvedores Harness no mundo; plugins centrais e APIs em iteração contínua

Plugin

O modelo também pode ser substituído

Inclui adaptador de modelo e UI

Log

Sessão apenas de acréscimo

Retomar / ramificar / reproduzir da mesma origem

V4

DeepSeek-V4

Validar primeiro a intenção no chat web

Código aberto

Sincronizado com o GitHub

Feedback em Discussions

O DeepSeek Harness ainda está em prévia para desenvolvedores; o aviso oficial enfatiza que haverá mudanças que quebram compatibilidade. Não fixe cegamente a versão em sistemas de produção; conversa e validação de solução podem começar no chat web DeepSeek deste site.

Esclareça primeiro a tarefa no chat web DeepSeek

O DeepSeek Harness serve para execução Agent local; intenção, prompts e efeito do DeepSeek-V4 convém validar primeiro no chat web.

Modos de execução do DeepSeek Harness

Quatro modos, do benchmark ao Agent personalizado

Troque de modo sem alterar o código-fonte. Comparação detalhada e casos de uso na subpágina «Modos de execução».

Modo padrão

Um Agent de código com recursos completos: edição de arquivos, Shell, busca de arquivos e web, Skills, planejamento, objetivos, subagentes e fluxos de trabalho. Adequado a tarefas de desenvolvimento do dia a dia.

DeepSeek Harness modo padrão

Modo PTC / Code

Tem todas as capacidades do modo padrão e apresenta as ferramentas pelo Code Mode SDK, para o modelo combinar operações de vários passos em um programa TypeScript e reduzir idas e voltas de chamadas de ferramentas.

DeepSeek PTC Code Mode

Modo mínimo

Um Agent de código com apenas duas ferramentas — bash persistente e str_replace_editor — para benchmarks de modelos em ambiente mínimo (incluindo cenários de avaliação relacionados ao DeepSeek-V4).

DeepSeek Harness modo mínimo

Modo criação

Para criar presets de Agent personalizados: capacidades do modo padrão, mais inspeção de runtime, experimentos em memória com plugins Cordis e orientação para criar presets.

DeepSeek Harness modo criação

Modos de execução

Ideia de design

Tudo é plugin; cada execução deixa rastro

Esta é a formulação central oficial da DeepSeek sobre o Harness — e os três pontos que vale lembrar ao pesquisar «o que é DeepSeek Harness».

01

Tudo é plugin

O DeepSeek Harness é construído sobre o sistema de plugins Cordis. Modelo, ferramentas, skills, sessão, sandbox, armazenamento, loop, agendamento e UI vêm de plugins e colaboram por serviços e eventos. Desenvolvedores não precisam fazer fork do código-fonte para recompor capacidades na camada de configuração.

02

Cada execução deixa rastro

Prompt de sistema, cadeia de pensamento, chamadas de ferramentas e resultados, agendamento de subagentes e cada injeção de contexto são gravados em um log de sessão apenas de acréscimo. Retomar, ramificar, buscar e reproduzir compartilham o mesmo fluxo de eventos; a vista Trajectory inspeciona por origem.

03

Vários modos de execução

O modo padrão dá a combinação completa de ferramentas; o modo PTC encadeia várias rodadas de ferramentas com código gerado pelo modelo; o modo mínimo deixa só shell e edição de arquivos para avaliação; o modo criação inspeciona o runtime, experimenta plugins e combina novos modos.

Experimentar rápido

Subir a Web UI localmente ou instalar a partir do código-fonte

Os comandos abaixo vêm da documentação oficial, para conferência. Se quiser primeiro confirmar a formulação da tarefa e o efeito do DeepSeek-V4, comece a conversa no chat web DeepSeek deste site.

Experimentar rápido

Depois de instalar o Node.js, você pode iniciar a Web UI com npx.

npx @deepseek-ai/dsh web

Instalação a partir do código-fonte

Obtenha o código-fonte completo do projeto e siga as instruções do repositório.

git clone https://github.com/deepseek-ai/deepseek-harness
FAQ do DeepSeek Harness

Perguntas frequentes sobre o DeepSeek Harness

Qual a relação com o chat web DeepSeek e o DeepSeek-V4? Dá para usar em produção? Abaixo, segundo a linha oficial.

01 O que é o DeepSeek Harness?

O DeepSeek Harness (comando dsh) é o runtime Agent (agent harness) de código aberto da DeepSeek AI. Ele faz o modelo entender o ambiente, chamar ferramentas e trabalhar de forma contínua em cenários reais. O lema de arquitetura é «tudo é plugin» e o núcleo é o Cordis.

02 Em que o Harness difere do chat web DeepSeek e do DeepSeek-V4?

O chat web DeepSeek e o DeepSeek-V4 cobrem «conversa, raciocínio e contexto longo»; o Harness cobre «ferramentas, sandbox, log de sessão e runtime substituível». Caminho recomendado: esclareça primeiro a tarefa no chat web e, se precisar, execute localmente com dsh um Agent com ferramentas.

03 Já dá para usar em produção?

O posicionamento oficial é uma prévia para desenvolvedores, com aviso explícito de mudanças incompatíveis. Serve para experimentar plugins, avaliar e aprender a arquitetura — não para cravar sistemas de produção críticos na versão atual.

04 Como experimentar o DeepSeek Harness o mais rápido possível?

Depois do Node.js, execute npx @deepseek-ai/dsh web; por padrão abre http://127.0.0.1:3080. Você também pode fazer git clone do repositório oficial e instalar e construir com pnpm conforme o README. Para validar primeiro na conversa, use «Experimentar» neste site para entrar no chat web DeepSeek.

05 O que é o Cordis?

O Cordis é o núcleo de plugins usado pelo DeepSeek Harness: carga, descarga e dependências. Capacidades concretas do Agent (modelo, ferramentas, UI etc.) não estão no núcleo, e sim nos plugins, que colaboram por serviços e eventos.

06 O modo PTC e o Code Mode são a mesma coisa?

A página oficial em chinês fala em modo PTC e a inglesa em Code mode: ambos se referem a um trecho de código gerado pelo modelo (via Code Mode SDK) que combina várias rodadas de chamadas de ferramentas, mantendo as capacidades do modo padrão.

07 Para que serve o modo mínimo?

O modo mínimo só conserva bash persistente e str_replace_editor para benchmarks de modelos em ambiente mínimo. Nas notas públicas de avaliação, parte das pontuações de Code Agent do DeepSeek-V4-Flash se relaciona ao quadro do modo mínimo.

08 Como publicar um plugin da comunidade?

Adicione o topic do GitHub «dsh-plugin» ao repositório do plugin para facilitar a descoberta. Feedback e defeitos pelas GitHub Discussions oficiais. Plugins centrais e APIs básicas continuarão iterando.

09 Dá para reproduzir uma sessão?

Sim. Prompts, cadeia de pensamento, resultados de ferramentas e agendamento de subagentes que o modelo vê são gravados em um log apenas de acréscimo. Retomar, ramificar, buscar e reproduzir compartilham o mesmo fluxo de eventos e podem ser vistos por origem na vista Trajectory.

10 É preciso alterar o código-fonte para trocar modelo ou ferramentas?

Não. O aviso oficial enfatiza que desenvolvedores não precisam mexer no código-fonte do DeepSeek Harness para escolher, substituir ou estender qualquer capacidade na camada de configuração, incluindo adaptador de modelo e UI.

11 Qual é a licença de código aberto?

O repositório oficial é código aberto sob MIT; dependências de terceiros estão em THIRD_PARTY_NOTICES no repositório. Antes de uso comercial, leia você mesmo a licença e o aviso da prévia.

12 Como usar o DeepSeek se eu não quiser instalar o ambiente local?

Abra primeiro o chat web DeepSeek deste site, converse diretamente com o DeepSeek-V4 e confirme prompts e decomposição da tarefa; quando precisar de ferramentas locais e sandbox, instale o Node.js e execute o dsh. Os dois caminhos se complementam e não se substituem.

DeepSeek-V4 + Harness: da conversa ao Agent executável

Valide a ideia no chat web; combine plugins e ferramentas no Harness. Comece com um clique para o chat web DeepSeek neste site.