No está documentado oficialmente, pero las discusiones de la comunidad (#1772/#49/#897) confirman que en Linux el módulo nativo node-pty debe compilarse en local: en Debian hace falta build-essential, en Arch base-devel, y g++ debe admitir gnu++20 (GCC 10+)
status_warning
DeepSeek Harness is currently in _developer preview_ and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES. (texto original del README)
Ejecución directa con npx (opción preferida en el README oficial)
En la Web UI, entrar a Settings → Models, ingresar la API key (obtenida en https://platform.deepseek.com/ ) en la tarjeta de DeepSeek y guardar; texto oficial: "The model route becomes usable immediately without restarting the server" (surte efecto al guardar, sin reiniciar)
api · key_storage
Texto original de providers.md: "Keys are write-only. The page receives a redacted descriptor after saving, never the literal secret. The key is stored in `$DSH_HOME/.credentials.yaml`"; las definiciones de modelos se guardan en $DSH_HOME/settings.yaml
api · catalog_providers
Anthropic
api · catalog_providers
OpenAI
api · catalog_providers
Bedrock
api · catalog_providers
Vertex
api · catalog_providers
Azure
api · catalog_providers
Codex
api · catalog_config
Add provider → elegir el proveedor → ingresar la API key → guardar; Bedrock/Vertex/Azure/Codex usan, respectivamente, credenciales de AWS + region, ADC project, api-version y OAuth
api · env_var
Las credenciales se pueden inyectar por variables de entorno (el campo apiKeyEnv de los ejemplos de configuración, por ejemplo GATEWAY_API_KEY)
Add a custom provider: ingresar Provider ID (en minúsculas y permanente), nombre visible, base URL, protocolo de API, credenciales y al menos un modelo; admite Fetch available models, que llama al GET /models compatible con OpenAI para traer la lista de modelos automáticamente, y en los endpoints no compatibles hay que escribir el nombre del modelo a mano
local · ollama
ollama launch dsh: un solo comando para ejecutarlo todo en local, con el plugin Ollama web search preinstalado (según la versión oficial de Ollama)
① Settings → Models: ingresar la API key de DeepSeek → ② Choose workspace: elegir el directorio de trabajo (texto oficial: "The session composer remains unavailable until a workspace is selected") → ③ abrir una sesión y enviar la tarea
dsh --profile headless "job" — descripción oficial: "Run one fresh persisted session, print the final answer, and exit"
terminal · profile
dsh --profile <name> — "Boot the named profile under $DSH_HOME/profiles/<name>"; los profiles web y headless se inicializan automáticamente desde una plantilla en su primer uso, y los demás profiles deben crearse con dsh plugin
terminal · plugin_mgmt
dsh plugin --profile <name> <pnpm args> — reenvía los argumentos de pnpm al directorio del profile para gestionar sus plugins
Agent de programación con funcionalidad completa: admite edición de archivos, Shell, búsqueda de archivos y en la web, Skills, planes, objetivos, subagentes y flujos de trabajo.
modes · list · name_zh
Modo PTC
modes · list · name_en
Code
modes · list · dir
code
modes · list · official_desc_zh
Tiene todas las capacidades del modo estándar y además expone las herramientas a través del Code Mode SDK, para que el modelo combine operaciones de varios pasos en un solo programa de TypeScript.
modes · list · name_zh
Modo minimalista
modes · list · name_en
Minimal
modes · list · dir
minimal
modes · list · official_desc_zh
Agent de programación de solo dos herramientas: bash persistente y str_replace_editor.
modes · list · name_zh
Modo creación
modes · list · name_en
Creator
modes · list · dir
cordis
modes · list · official_desc_zh
Sirve para crear presets de Agent personalizados: tiene todas las capacidades del modo estándar y añade inspección en tiempo de ejecución, experimentación con plugins y guía para crear presets.
modes · definition_location
Cuatro directorios dentro de apps/cli/config/agent-presets/ (code/cordis/minimal/standard); los archivos de definición de los presets están escritos por el equipo oficial directamente en chino
Ni el README, ni apps/cli/README.md, ni la guía de usuario de docs incluyen comandos de actualización o desinstalación (verificado uno por uno: ABSENT); en las discusiones de la comunidad aparece la práctica de limpiar la caché de npx (rm -rf ~/.npm/_npx, ver #49/#897), que es una técnica de diagnóstico y no un procedimiento oficial de actualización
Respuesta del propio autor del hilo (2026-08-16): en Debian, no tener instalado build-essential hacía fallar la compilación del módulo nativo node-pty; tras instalar build-essential con apt, la instalación funcionó
Soluciones más votadas: ① instalar las herramientas de compilación con pacman -Syu base-devel; ② cambiar a Bun: bun add --global @deepseek-ai/dsh (node-pty está en la lista blanca de Bun); ③ si se insiste con npm, limpiar la caché y permitir los scripts de compilación: rm -rf ~/.npm/_npx && npx --allow-scripts=node-pty @deepseek-ai/dsh@0.1.0-rc.6 web; otra alternativa: npm config set allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs --location=user
Diagnóstico de la comunidad: el g++ 9.4.0 que trae el sistema no admite -std=gnu++20 (hace falta GCC 10+); solución: limpiar primero la caché de npx y luego CC=gcc-11 CXX=g++-11 npm install -g @deepseek-ai/dsh, seguido de dsh web
Causa raíz: node-pty v1.1.0 no trae binarios precompilados para Linux x64 (Node 24/ABI 137) y el script de instalación de npm falla en silencio; solución manual: entrar al directorio de node-pty y ejecutar npx node-gyp rebuild para generar el pty.node faltante; el hilo no tiene respuesta oficial (0 respuestas)
No se obtuvieron los detalles de la solución (1 comentario, sin verificación a fondo); el síntoma se relaciona con la política de seguridad de pnpm que ignora por defecto los scripts de compilación de las dependencias, y puede cruzarse con la solución allow-scripts de #49; esta solución queda pendiente de completar
DSH Wiki · El radar de DSH · Un proyecto de ai798 Lab
