$DSH_HOME/settings.yaml, cujo padrão é ~/.dsh/settings.yaml.
As configurações nesta página foram verificadas com @deepseek-ai/dsh@0.1.0-rc.8. Cada rota concluiu uma interação de texto com streaming e um loop de ferramenta de leitura de arquivos com um modelo representativo. Esse escopo não significa que todos os modelos da CometAPI aceitem todos os formatos de API.
Referências oficiais:
- Repositório do DeepSeek Harness
- Código-fonte do DeepSeek Harness 0.1.0-rc.8
- CLI do DeepSeek Harness
- Guia de provedores do DeepSeek Harness
Pré-requisitos
- Node.js e npm
- Uma conta CometAPI com uma chave de API ativa do painel
- Um ID de modelo da página de modelos da CometAPI para cada formato de API que você pretende usar
Entenda as rotas do provedor
O valor deapi seleciona o formato de comunicação. O baseURL termina antes do caminho da operação que o Harness acrescenta.
Substitua cada valor de
your-model-id de forma independente. Escolha um modelo que aceite o formato de API da respectiva entrada de provedor.Configure os provedores
1
Confirme a versão testada do Harness
Confirme a versão fixada do pacote antes de configurar o Harness:O comando deve exibir
0.1.0-rc.8.2
Defina sua chave de API do CometAPI
Armazene sua chave em Defina a variável em cada sessão de shell que iniciar o Harness. Não envie chaves de API ao controle de versão.
COMETAPI_KEY antes de iniciar o Harness:3
Adicione os provedores do CometAPI
Crie O exemplo seleciona o provedor Responses por padrão. Altere O endereço local padrão é
$DSH_HOME/settings.yaml. Se o arquivo já tiver uma seção llm-pi-ai, mescle estas entradas de provedor ao mapa providers existente:agent-default-model.provider e agent-default-model.model para selecionar outra entrada configurada.Se preferir a interface Web, inicie-a após exportar COMETAPI_KEY e use as configurações de modelo para adicionar ou editar entradas de provedor e selecionar o modelo padrão:http://127.0.0.1:3080. O YAML continua sendo o caminho direto para corresponder aos nomes das rotas e às URLs base deste guia.4
Verifique uma interação de texto
Execute uma tarefa pontual sem interface no diretório do projeto que ցանկանում usar com o Harness:Uma execução bem-sucedida exibe
COMETAPI_DSH_OK. Para verificar outro provedor, atualize agent-default-model e execute o comando novamente.5
Verifique o uso da ferramenta de arquivos
Crie um arquivo sentinela temporário e peça ao Harness para lê-lo com uma ferramenta de arquivos:Confirme que a resposta final é
COMETAPI_DSH_TOOL_OK. Execute o Harness somente em um espaço de trabalho no qual você aceite seu acesso a arquivos, processos e rede.Rota opcional
O Harness tem uma rota de provedor integrada chamadagoogle. A configuração abaixo aponta essa rota para o CometAPI, substituindo o endpoint nativo do Google da rota em vez de adicionar uma segunda rota do Google.
Mescle esta entrada em llm-pi-ai.providers e selecione-a em agent-default-model:
api a esta entrada. A rota integrada google mantém seu protocolo nativo do Google e envia solicitações de Streaming para /v1beta/models/{model}:streamGenerateContent?alt=sse com autenticação x-goog-api-key.
Solução de problemas
O Harness informa que a chave de API está ausente
O Harness informa que a chave de API está ausente
Confirme que
COMETAPI_KEY está definido no mesmo shell que inicia o Harness. Reinicie o Harness após alterar a variável de ambiente.O Harness não mostra o modelo configurado
O Harness não mostra o modelo configurado
Confirme que
$DSH_HOME/settings.yaml é um YAML válido, que o provedor está em llm-pi-ai.providers e que o modelo está listado em models desse provedor. O DSH_HOME padrão é ~/.dsh.Chat Completions ou Responses usa o caminho incorreto
Chat Completions ou Responses usa o caminho incorreto
Use
https://api.cometapi.com/v1 como baseURL. Não acrescente /chat/completions nem /responses; o Harness acrescenta o caminho da operação.Anthropic Messages retorna um erro de caminho
Anthropic Messages retorna um erro de caminho
Use
https://api.cometapi.com sem /v1 como o baseURL de Messages. O adaptador Anthropic acrescenta /v1/messages.O Google gera um caminho v1beta duplicado
O Google gera um caminho v1beta duplicado
Use
https://api.cometapi.com/v1beta exatamente como está. Não acrescente um caminho de modelo e não adicione um campo api à rota integrada google.Um modelo funciona em um provedor, mas não em outro
Um modelo funciona em um provedor, mas não em outro
A disponibilidade de modelos e os formatos de API aceitos podem ser diferentes. Escolha um modelo para cada entrada de provedor em vez de presumir que um modelo funciona em todos os quatro formatos.
A configuração deixa de funcionar após uma atualização
A configuração deixa de funcionar após uma atualização
O DeepSeek Harness está em prévia para desenvolvedores. Volte para
@deepseek-ai/dsh@0.1.0-rc.8 e revise as alterações upstream antes de adaptar a configuração para outra versão.