Guías de DeepSeek Harness

La instalación falla en un Node antiguo

Respuesta primero: DeepSeek Harness necesita Node.js ^22.19.0 o >=24.0.0. Los runtimes viejos fallan en npx, a veces con node-domexception.

1. Ejecutar node -v y confirma el rango.
2. Instala un build 22.19+ o 24+ del distribuidor de Node que ya usas.
3. Abre una terminal nueva para que se actualice PATH.
4. Reintentar npx @deepseek-ai/[email protected] web.

0.1.2-rc.1 también corrige arranque y HMR en Node 24.0-24.11.1. Los pines están en la página de descarga.

dsh web falla con EACCES en el puerto 3080

Respuesta primero: en Windows suele ser Hyper-V, WSL2 o Docker reservando el puerto, no un permiso de archivo.

1. Lee el reserved-range del host. Si 3080 está ahí, no hagas chmod.
2. Para el consumidor (switch Hyper-V, WSL2, Docker) o elige otro puerto con el flag actual de dsh.
3. Confirma que la URL impresa sigue en loopback. No enlaces la UI a una interfaz pública.
4. Si la página carga pero las APIs dan 403, estás fuera de la lista Host de confianza. Quédate en 127.0.0.1.

Corrección ACL del sandbox de Windows

Respuesta primero: @deepseek-ai/dsh-sandbox-windows-acl puede bloquear al creador fuera de un TEMP bajo C:\Windows\Temp, o fallar SetNamedSecurityInfoW error 5 en un workspace de BUILTIN\Administrators.

1. Comprueba si TMP/TEMP de máquina es C:\Windows\Temp y si tu override de usuario está vacío.
2. Pon HKCU TMP y TEMP en una carpeta tuya, por ejemplo bajo tu perfil. Reinicia la terminal.
3. Crea un workspace cuyo dueño seas tú, no Administrators. Evita raíces de unidad como D:\.
4. Reintenta una llamada pwsh en sandbox. Si solo funciona danger-full-access, sigue siendo ACL, no el modelo.

Vaciar Windows Temp tras un grant puede romper workspace-write hasta recrear la política temp. Ver política de sandbox and límites del sandbox.

workspace-invalid-path en nombres de carpeta chinos

Respuesta primero: el selector Win32 puede truncar rutas con caracteres como 开 o 一, y dsh ve ENOENT.

1. 0.1.2-rc.1 incluye un fix de ese truncado. Fíjalo si aún estás en 0.1.1-rc.2.
2. Si aún no puedes actualizar, elige una ruta de workspace con nombres ASCII.
3. No elijas la raíz de una unidad. session.create falla con EPERM y New Session queda en blanco.

ERR_MODULE_NOT_FOUND tras un pnpm install

Respuesta primero: instalar la CLI publicada con pnpm suele romper el loader entry ui-plan y falta @deepseek-ai/cordis-plugin-group.

1. Usa npx o npm para el paquete publicado.
2. Usa pnpm solo dentro de un checkout de código después de pnpm install and pnpm run build.
3. Si un plugin add trajo latest 0.0.1-rc.1 con CLI 0.1.1-rc.2, fija el plugin a la línea del CLI.

SEC_E_NO_CREDENTIALS dentro del sandbox de Windows

Respuesta primero: el sandbox puede romper HTTPS de Schannel (curl, PowerShell, .NET) mientras HTTP plano y clientes OpenSSL siguen.

1. Reprodúcelo fuera del sandbox. Si HTTPS funciona ahí, el almacén de certificados del host está bien.
2. Prefiere clientes sin Schannel en el paso sandboxed, o haz ese fetch fuera de workspace-write tras una aprobación explícita.
3. No lo tomes como prueba de que la política de archivos está apagada. La red está fuera de SandboxMode.

El upgrade oculta títulos de sesión o bloquea el arranque

Respuesta primero: 0.1.2-alpha.5 y 0.1.2-rc.1 corrigen una regresión al actualizar desde 0.1.1-rc.2 o 0.1.2-alpha.3.

1. Fija 0.1.2-rc.1 si necesitas la línea 0.1.2.
2. Si debes exportar sesiones SQLite, hazlo en un build anterior a 0.1.2-alpha.3. Se quitó el backend; no se borraron archivos.
3. Mantén DSH_HOME desechable mientras pruebas un upgrade.

Avisos del antivirus

Respuesta primero: dsh es un paquete npm firmado que arranca Node y puede lanzar shells. Los escáneres heurísticos marcan ese patrón.

1. Confirma que lanzaste @deepseek-ai/dsh, no un nombre parecido.
2. Compara el shasum del tarball instalado con los valores en Notas de SHA y firmas.
3. Restaura Node o carpetas temp en cuarentena solo después de esa comprobación.

Buenas prácticas para el primer arranque

1. Empieza en un directorio vacío desechable, no en tu home ni en un monorepo de cliente.
2. Quédate en workspace-write y ask. No empieces con danger-full-access.
3. Fija la versión. npx sin pin sigue latest, que sigue siendo 0.1.1-rc.2.
4. Revisa plugins, servidores MCP, Skills y Hooks antes de que se ejecuten.
5. Saca las credenciales del workspace si no aceptas que un proceso del mismo usuario las lea. El sandbox de archivos limita escrituras, no lecturas.

Descargar DeepSeek Harness