$DSH_HOME/settings.yaml, cuyo valor predeterminado es ~/.dsh/settings.yaml.
Las configuraciones de esta página se verificaron con @deepseek-ai/dsh@0.1.0-rc.8. Cada ruta completó un turno de texto de Streaming y un bucle de herramientas de lectura de archivos con un modelo representativo. Este alcance no significa que todos los modelos de CometAPI acepten todos los formatos de API.
Referencias oficiales:
- Repositorio de DeepSeek Harness
- Código fuente de DeepSeek Harness 0.1.0-rc.8
- CLI de DeepSeek Harness
- Guía de proveedores de DeepSeek Harness
Requisitos previos
- Node.js y npm
- Una cuenta de CometAPI con una clave de API activa del panel de control
- Un ID de modelo de la página de modelos de CometAPI para cada formato de API que planee utilizar
Comprender las rutas de los proveedores
El valor deapi selecciona el formato de protocolo. baseURL termina antes de la ruta de operación que Harness agrega.
Reemplace cada valor de
your-model-id de forma independiente. Elija un modelo que acepte el formato de API de la entrada de su proveedor.Configure los proveedores
1
Confirme la versión de Harness probada
Confirme la versión fijada del paquete antes de configurar Harness:El comando debería mostrar
0.1.0-rc.8.2
Configure su clave de API de CometAPI
Guarde su clave en Configure la variable en cada sesión de shell que inicie Harness. No confirme claves de API en el control de versiones.
COMETAPI_KEY antes de iniciar Harness:3
Agregue los proveedores de CometAPI
Cree El ejemplo selecciona el proveedor Responses de forma predeterminada. Cambie La dirección local predeterminada es
$DSH_HOME/settings.yaml. Si el archivo ya tiene una sección llm-pi-ai, fusione estas entradas de proveedores en su mapa providers existente:agent-default-model.provider y agent-default-model.model para seleccionar otra entrada configurada.Si prefiere la interfaz web, iníciela después de exportar COMETAPI_KEY y, a continuación, use la configuración de modelos para agregar o editar entradas de proveedores y seleccionar el modelo predeterminado:http://127.0.0.1:3080. YAML sigue siendo la vía directa para hacer coincidir los nombres de ruta y las URL base de esta guía.4
Verifique una interacción de texto
Ejecute una tarea sin interfaz de una sola ejecución desde el directorio del proyecto que desea que use Harness:Una ejecución correcta muestra
COMETAPI_DSH_OK. Para comprobar otro proveedor, actualice agent-default-model y ejecute el comando de nuevo.5
Verifique el uso de herramientas de archivos
Cree un archivo centinela temporal y luego pida a Harness que lo lea con una herramienta de archivos:Confirme que la respuesta final sea
COMETAPI_DSH_TOOL_OK. Ejecute Harness únicamente en un espacio de trabajo donde acepte su acceso a archivos, procesos y red.Ruta opcional
Harness tiene una ruta de proveedor integrada llamadagoogle. La configuración siguiente dirige esa ruta a CometAPI, por lo que reemplaza el endpoint nativo de Google de la ruta en lugar de agregar una segunda ruta de Google.
Fusione esta entrada en llm-pi-ai.providers y, a continuación, selecciónela en agent-default-model:
api a esta entrada. La ruta integrada google conserva su protocolo nativo de Google y envía solicitudes de Streaming a /v1beta/models/{model}:streamGenerateContent?alt=sse con autenticación x-goog-api-key.
Solución de problemas
Harness informa que falta la clave de API
Harness informa que falta la clave de API
Confirma que
COMETAPI_KEY esté definida en el mismo shell desde el que se inicia Harness. Reinicia Harness después de cambiar la variable de entorno.Harness no muestra el modelo configurado
Harness no muestra el modelo configurado
Confirma que
$DSH_HOME/settings.yaml sea YAML válido, que el proveedor esté en llm-pi-ai.providers y que el modelo figure en models de ese proveedor. El valor predeterminado de DSH_HOME es ~/.dsh.Chat Completions o Responses usan la ruta incorrecta
Chat Completions o Responses usan la ruta incorrecta
Usa
https://api.cometapi.com/v1 como baseURL. No añadas /chat/completions ni /responses; Harness añade la ruta de la operación.Anthropic Messages devuelve un error de ruta
Anthropic Messages devuelve un error de ruta
Usa
https://api.cometapi.com sin /v1 como baseURL de Messages. El adaptador de Anthropic añade /v1/messages.Google genera una ruta v1beta duplicada
Google genera una ruta v1beta duplicada
Usa
https://api.cometapi.com/v1beta exactamente. No añadas una ruta de modelo ni un campo api a la ruta google integrada.Un modelo funciona con un proveedor, pero no con otro
Un modelo funciona con un proveedor, pero no con otro
La disponibilidad de los modelos y los formatos de API aceptados pueden variar. Elige un modelo para cada entrada de proveedor en lugar de suponer que un mismo modelo funciona con los cuatro formatos.
La configuración deja de funcionar tras una actualización
La configuración deja de funcionar tras una actualización
DeepSeek Harness está en vista previa para desarrolladores. Vuelve a
@deepseek-ai/dsh@0.1.0-rc.8 y revisa los cambios upstream antes de adaptar la configuración a otra versión.