Guía de lectura

Manual de usuario de Nonead DSH Desktop

Este es un manual pensado para quien usa el producto, no para quien programa. No hace falta saber escribir código ni tener instalados Node.js, pnpm o cualquier otra herramienta de desarrollo: el instalador ya trae todo el entorno necesario, así que funciona nada más instalarlo.

Versión cubierta: 2.2.8 (tiempo de ejecución de DSH 0.2.2-rc.1) · noviembre de 2026
Para quién: quien se acerca al producto por primera vez; léelo en orden o salta directamente a la sección que necesites

Índice de esta guía

Las trece secciones siguen el orden «instalar → usar → resolver». Si solo quieres resolver un problema concreto, salta directamente a la sección 12.

1. Qué es esto

En una frase: mete las capacidades de agente de DeepSeek Harness en una aplicación de escritorio; con doble clic en el icono ya puedes conversar, dejar que lea y escriba archivos, ejecute comandos y use herramientas.

El producto tiene tres capas. Solo tratas con la tercera; las dos primeras funcionan solas en segundo plano.

Capa de escritorio Ventana · bandeja · actualización · terminal · perfiles Host (servicio en segundo plano) Carga complementos, ejecuta herramientas, gestiona sesiones y archivos Interfaz web (lo que ves en la ventana) Conversación · cuadro de entrada · barra lateral · ajustes
Fig. 1 El producto se compone de tres capas; la operación diaria ocurre solo en la superior.
¿En qué se diferencia de la versión web? La versión web solo conversa. La de escritorio pone el equipo entero a su disposición: lee tus archivos, ejecuta comandos, instala complementos y trabaja sobre tus directorios. Todo ocurre en tu máquina y los datos no salen de ella.

2. Instalación

Descarga el instalador de tu plataforma desde la página del producto y haz doble clic: no hay nada más que preparar. El instalador ya incluye Electron, Node.js, pnpm y una versión fija del tiempo de ejecución de DSH, así que no necesitas instalar ningún entorno aparte. Esta versión trae Electron 44.0.0, Node.js 24.21.0, pnpm 11.8.0, Python 3.12.14 y el tiempo de ejecución de DSH 0.2.2-rc.1.

PlataformaQué se descargaCómo se instala
Windows x64Instalador .exeDoble clic y sigue el asistente hasta el final
macOS (Intel y Apple Silicon)Imagen de disco .dmgÁbrela y arrastra el icono a «Aplicaciones»
Linux x64.AppImagePrimero chmod +x para dar permiso de ejecución; luego doble clic o ejecútalo desde la terminal
Tabla 1 Instalación en las tres plataformas. En Linux, si avisa que falta FUSE, se puede ejecutar con --appimage-extract-and-run.

Para actualizar no hace falta cerrar a mano la versión anterior. El instalador pide primero que la instancia en marcha se cierre, y si no responde la termina a la fuerza antes de sobrescribir los archivos; si aun así no consigue cerrarla, la instalación se detiene con un error explícito en lugar de dejarte una aplicación que luego no abre. Aun así, guarda tu trabajo antes de actualizar.

Nota: en Windows ARM64 la compilación es experimental por ahora. El programa principal es ARM64 nativo, pero parte de la carga incluida (Python / Node / tiempos de ejecución de Office y algunos módulos nativos) sigue siendo x64 y no se ha validado por completo en equipos ARM; para uso normal se recomienda la versión x64.

3. Primera apertura

El primer arranque prepara por su cuenta una configuración por defecto (un Profile llamado desktop) y levanta el servicio de interfaz en este equipo. Antes de nada verás un asistente de siete pasos; puedes omitirlo cuando quieras y completarlo después en Configuración.

PasoQué preguntaQué conviene elegir
1 BienvenidaExplica qué se va a configurarPulsa «Comenzar la configuración»
2 Modo de ventanaCompatible / extendido / mejorado: decide la disposición de la ventana y cómo responde el escritorioSi dudas, «Modo de compatibilidad», que es el más compatible; el extendido y el mejorado no admiten Linux
3 Material de la ventanaFondo sólido o fondo de cristalCon tarjetas gráficas antiguas o escritorio remoto, el fondo sólido es más estable
4 Mercado de pluginsDesactivado / dsh-market / dsh-community-market; solo uno puede estar activoPuedes dejarlo desactivado y activarlo cuando lo necesites
5 Conexión con el teléfonoSi quieres llegar a este equipo desde el móvil o el navegador con Agents-Anywhere (Beta)Si no lo tienes claro, déjalo desactivado; si lo activas, completa el emparejamiento en «Conexión con el teléfono» de la barra lateral
6 Notificaciones de escritorioSi quieres avisos del sistema cuando terminan o fallan las tareas del turno, las de segundo plano y las de automatizaciónRecomendado activarlas todas: así no hay que vigilar las tareas largas
7 Acceso desde el navegadorSi permites abrir el Profile actual en el navegador y si solo en este equipo o en toda la LANPara uso propio, «solo este equipo»; la LAN necesita un certificado HTTPS
Tabla 2 Los siete pasos del asistente de primera apertura.

Al terminar el asistente entras en la interfaz principal. Cerrar la ventana no es salir de la aplicación: por defecto solo se recoge en la bandeja, mientras el servicio en segundo plano y las tareas en curso siguen funcionando. Para salir de verdad, usa «Salir» en el menú de la bandeja.

4. La interfaz principal, de un vistazo

ZonaDóndeQué gestiona
Barra lateralIzquierdaLista de sesiones, crear sesión, entradas de complementos y habilidades, conexión con el teléfono y acceso a Configuración; se puede plegar
Zona de conversaciónCentroLos mensajes entre tú y el agente, la ejecución de herramientas, los cambios en archivos y la salida de comandos
Cuadro de entradaAbajoEscribe lo que necesitas; adjunta archivos, cambia de modelo y elige el directorio de trabajo; puedes interrumpir en cualquier momento
Barra de control del escritorioParte superior de la ventanaLa aporta el shell de escritorio: atrás/adelante, recargar y controles de ventana; su forma cambia según el modo de ventana
Tabla 3 Las cuatro zonas de la interfaz principal.
El directorio de trabajo es clave. Por defecto solo puede leer y escribir en el directorio que elijas para cada sesión. Confirmar ese directorio al abrir una sesión cuesta un segundo y ahorra mucho más que descubrir después que se cambió lo que no tocaba.

5. La primera conversación

  1. Abre una sesión nueva y elige el directorio de trabajo.
  2. Di en una frase «qué hacer + dónde + cómo debe quedar el resultado». Por ejemplo: «lee el README de este directorio y sácame en una tabla los enlaces de descarga que ya no funcionan».
  3. Mientras trabaja, sigue las llamadas a herramientas y los archivos que toca; si quieres que cambie de rumbo, interrúmpelo y dilo.
  4. Si el resultado no te vale, explica qué está mal: corrige con el contexto que ya tiene, no hace falta abrir otra sesión.

Tres puntos para pedir las cosas con claridad:

6. El menú de la bandeja

Con la ventana cerrada, el icono de la bandeja es la puerta principal a la aplicación. Al hacer clic derecho verás:

EntradaQué hace
Abrir Nonead DSH DesktopVuelve a traer la ventana al frente
Nuevo perfil…Crea un conjunto de configuración independiente
Perfil: <nombre>El Profile en uso; desde aquí se cambia
Modo: mejorado / compatible / extendidoCambia el modo de ventana al vuelo (requiere reinicio)
Buscar actualizaciones…Comprueba a mano si hay una versión nueva
Instalar la versión estable…Vuelve del canal de pruebas a la versión estable
Entrar en modo seguro…Arranca en un entorno temporal para aislar problemas de complementos (ver sección 10)
Salir del modo seguro y reiniciar…Exclusivo del modo seguro: vuelve al arranque normal
Abrir la terminal de DSHAbre la terminal integrada, donde se puede usar el comando dsh
Exportar diagnósticos…Empaqueta registros e información del sistema para reportar un problema
Recargar la interfazEquivale a refrescar la página; no reinicia el servicio en segundo plano
Reiniciar en modo de recuperaciónAbre primero el Asistente de recuperación y no carga el Profile ni los complementos actuales
SalirCierra la aplicación de verdad y con ella el servicio en segundo plano
Tabla 4 El menú de la bandeja.

7. Configuración

La entrada a la configuración está al final de la barra lateral (Configuración → Configuración de escritorio). Las secciones son estas:

SecciónQué se puede cambiarCuándo se aplica
PerfilElegir el Profile del arranque, crear uno nuevo o borrarlo (al borrarlo se van también su configuración y los archivos de complementos)Al reiniciar
Modo de ventanaCompatible / extendido / mejorado y el material de la ventana (fondo sólido / cristal)Reinicia solo al guardar
Mercado de pluginsDesactivado / dsh-market / dsh-community-market; solo uno puede estar activoAl reiniciar; tras actualizar desde una versión anterior queda desactivado hasta que elijas uno explícitamente
Navegador y red localPermitir abrir en el navegador (solo en modo de compatibilidad), solo este equipo o la LAN, y la huella y descarga del certificado CA localInmediato o al reiniciar
Agents-Anywhere (Beta)Interruptor de la conexión con el teléfono; al activarlo, el emparejamiento se completa en «Conexión con el teléfono» de la barra lateralInmediato
Notificaciones de escritorioFin o fallo del turno, de las tareas en segundo plano y de las tareas de automatizaciónInmediato
RegistroRegistro para desarrolladores y nivel de registro; los registros salen con el paquete de diagnósticoInmediato
Versión y actualizacionesVersión actual, buscar actualizaciones, reiniciar y reiniciar en modo de recuperaciónInmediato
Opciones para desarrolladoresRecargar la interfaz y mostrar u ocultar las herramientas de desarrolloInmediato
Acciones del pieExportar diagnósticos y abrir la terminal de DSH—
Tabla 5 Las secciones de la página de Configuración de escritorio.
En el modo seguro esta página es de solo lectura, y el acceso desde el navegador, la LAN, Agents-Anywhere y las notificaciones también quedan desactivados. Es así por diseño, no es un fallo.

8. Profile: varias configuraciones

Un Profile es un entorno de configuración independiente: sesiones, complementos y ajustes propios, sin mezclarse con los demás. Lo típico es tener uno para «trabajo» y otro para «personal», o uno para el día a día y otro para probar complementos nuevos.

Iniciar DSH Elegir perfil Cargar complementos y ajustes Entrar en la interfaz Fallo de inicio asistente de recuperación Punto de control o cambiar de perfil sí no
Fig. 2 El Profile decide qué complementos y ajustes se cargan; si el arranque falla, se cae al asistente de recuperación.

Tres reglas prácticas:

9. Complementos: qué viene de fábrica y cómo se instala

9.1 Qué trae de fábrica

El instalador no incluye ningún complemento de terceros. El Profile por defecto que se crea en el primer arranque solo carga dos componentes base oficiales:

Dicho de otro modo: recién instalado tienes una aplicación de escritorio limpia, capaz de conversar, leer y escribir archivos y ejecutar comandos; el mercado de plugins, los equipos de agentes, la entrada de voz, el tablero de tareas, el grafo de código y todo lo demás lo instalas tú. Es una decisión deliberada: tú decides qué entra, y cuando algo falla es fácil acotarlo a «lo último que instalé».

Una versión anterior de este manual incluía una lista de «35 complementos instalados en este equipo». Era la medición de una máquina concreta, no el estado de fábrica, y se ha retirado. Para ver qué tienes instalado, usa el método que sigue.

9.2 Tres vías de instalación

VíaPara qué sirveCómo se usa
Página de ComplementosComplementos oficiales y de terceros«Complementos» a la izquierda → «Agregar complemento» → «Instalar un complemento de terceros», e indica el nombre del paquete npm, la dirección del repositorio Git o un directorio local
Mercado de pluginsComplementos de la comunidadPrimero elige un mercado en Configuración → «Mercado de plugins» y reinicia; después busca e instala desde el mercado
Terminal de DSHComplementos de terceros con nombre de paquete conocido y operaciones por lotesBandeja → «Abrir la terminal de DSH» y ejecuta dsh plugin add <nombre-del-paquete>
Tabla 6 Las tres vías de instalación.

La página de Complementos (a la izquierda, «Complementos», con el subtítulo «Instalar, habilitar y configurar complementos») sirve para dos cosas:

Algunos complementos se envían con DSH: en su ficha aparece «Este complemento se envía con DSH», con lo que se explica que no hay que descargar nada aparte y basta con habilitarlo; si es más antiguo que la versión de DSH en uso, aparece «Actualizar». En este grupo están los equipos de agentes, la entrada de voz, el mercado de complementos, la revisión automática, la terminal, la búsqueda de sesiones, los títulos de sesión, las habilidades de insignia, Ralph, la traducción de la cadena de pensamiento, Inspector, LiveShare, Forge, las herramientas de worktree y las recomendaciones personalizadas. Los que pesan más o arrastran dependencias y no vienen activados (los subagentes de Claude Code y de Codex, el control de escritorio Computer Use) se habilitan también desde la página de Complementos cuando hagan falta.

Los componentes base que van dentro de DSH (cosas como dsh-base y dsh-web-app) no aparecen en la lista gestionable de Complementos; su estado se consulta en Configuración → «Complementos integrados».

Mercados de plugins: ahora mismo hay dos disponibles, dsh-community-market (el mercado abierto integrado, que admite fuentes de datos propias) y dsh-market (el mercado de la comunidad, con datos de awesome-dsh-plugin). Solo uno puede estar activo a la vez.

Los tres comandos de la terminal (sin --profile actúan sobre el Profile activo):

ComandoQué hace
dsh plugin add <nombre-del-paquete>Instalar
dsh plugin remove <nombre-del-paquete>Desinstalar
dsh plugin updateActualizar los complementos instalados

9.3 Tras instalar hay que reiniciar, y hay que confirmar

Un complemento no se carga hasta que reinicias la aplicación: al terminar la instalación, la interfaz avisa de que hay que reiniciar DSH para cargarlo. Para confirmar que quedó bien instalado:

  1. Abre la página de Complementos y comprueba que aparece en «Instalado» y que está habilitado.
  2. Mira si en la barra lateral ha aparecido su entrada (el mercado, el tablero, los equipos de agentes y páginas similares).
  3. Si sigues sin verlo claro, abre «Configuración → Registro», sube el nivel de registro y reinicia una vez: cuando la carga falla, casi siempre queda un error explícito.

9.4 Desactivar y desinstalar

9.5 Qué hacer si un complemento rompe la aplicación

No hay que reinstalar el sistema ni borrar el directorio de datos. Se pasa por el Asistente de recuperación de la sección 10: primero deshabilita en «Gestión de complementos» el último que instalaste y arranca; si con eso no basta, «Revertir» te devuelve al último punto de control que arrancaba.

10. Modo seguro y modo de recuperación

Las dos funciones resuelven el mismo tipo de problema: instalé algo y ya no arranca. La diferencia es que el modo seguro sirve para «entrar limpio y seguir trabajando» y el modo de recuperación para «quedarse fuera y reparar».

10.1 Modo seguro

El modo seguro arranca con un directorio de datos temporal e independiente: no lee tus complementos, ajustes, sesiones ni registros de espacios de trabajo, así que tampoco puede quedar atrapado por ellos. Tus datos originales no se tocan ni un byte.

Cómo se entra: bandeja → «Entrar en modo seguro…»; o desde la portada del Asistente de recuperación, «Modo seguro».

Qué se puede hacer dentro:

Limitaciones (por diseño):

Cómo se sale: bandeja → «Salir del modo seguro y reiniciar…». Al salir, el entorno temporal se limpia solo en el siguiente arranque normal y no se queda ocupando espacio en el disco.

10.2 Asistente de recuperación (modo de recuperación)

Cuándo se entra:

El asistente te dice tres cosas: por qué has entrado (si entraste a mano, lo indica expresamente), qué Profile y qué directorio se están usando y en qué paso se detuvo el arranque (inicio de Electron → preparación del entorno del shell → preparación del entorno de escritorio → selección de Profile → combinación de la configuración de complementos → inicio del servicio de complementos → inicio de la interfaz de escritorio → confirmación del resultado del arranque). El paso en el que se queda acota el problema.

PestañaPara qué sirveCuándo usarla
Recuperación rápidaLa puerta de entrada a todo: modo seguro, gestionar complementos, ver los puntos de control, cambiar de Profile, gestionar los datos y ver el diagnósticoCuando no sabes qué pulsar, empieza aquí
Gestión de complementosLista los complementos instalados directamente y permite «deshabilitar» (se conserva la instalación, pero no se carga) o «desinstalar»; los integrados y los protegidos son de solo lecturaCuando sospechas del último que instalaste
RevertirRestaura un punto de control de arranque: devuelve a la vez el Profile, el settings.yaml compartido y los parches del directorio de datos (incluido el estado de los complementos)Cuando recuerdas que «ayer todavía iba»
Cambiar de perfilLista los Profile disponibles y permite cambiar o crear uno; el Profile actual se conservaCuando uno está roto y prefieres usar otro
Restablecer y datosVer o cambiar el directorio de datos, volver al directorio por defecto y restablecer la configuración de fábricaCuando ya no hay forma de rescatarlo
DiagnósticoVer o editar settings.yaml, los parches del Profile y la lista de complementos, abrir el directorio del Profile y exportar el paquete de diagnósticoCuando hay que buscar la causa o abrir un informe
Tabla 7 Las seis pestañas del Asistente de recuperación.

Cómo funciona «Revertir»: después de cada arranque correcto, la aplicación guarda un «punto de control de arranque», es decir, la configuración que en ese momento funcionaba. Revertir es devolver el Profile, el settings.yaml y el estado de los complementos a ese instante. Cada punto de control muestra uno de tres estados («restaurable», «ilegible», «sin puntos de control»); «ilegible» significa que ese punto de control está dañado, así que hay que probar con uno anterior.

Restablecer la configuración de fábrica: mueve el directorio de datos actual entero a la papelera (en Windows, a la Papelera de reciclaje) y, al reiniciar, crea un Profile por defecto nuevo. Los archivos de tus proyectos, que están fuera del directorio de datos, no se borran: solo se limpian su configuración y sus sesiones. Antes de hacerlo, asegúrate de que de verdad no necesitas las sesiones antiguas.

10.3 Cómo se sale

Una vez reparado no hay que limpiar nada a mano: cierra el Asistente de recuperación con normalidad y arranca la aplicación. Si pulsas «Reiniciar» desde el modo de recuperación, la aplicación vuelve a hacer el arranque normal completo; si vuelve a fallar, regresa al Asistente de recuperación y no entra en un bucle infinito.

11. Actualización

Buscar actualizaciones ¿Versión nueva? Descargar el instalador Instalar y reiniciar La versión antigua se cierra sola Arranca la nueva perfil y plugins Ya está al día no sí
Fig. 3 El flujo de actualización.

Cinco fases: comprobar → descargar → instalar → reiniciar → confirmar la versión. Y cuatro operaciones que conviene tener a mano:

Actualizar no toca tus Profile, complementos ni sesiones: todo eso vive en el directorio de datos y el instalador solo reemplaza el programa.

12. Cuando algo falla

SíntomaQué probar primeroSi no basta
Doble clic en el icono y no pasa nada / pantalla en blancoSal del todo desde la bandeja y vuelve a abrir; comprueba si ya había una instancia en marchaReinicia en modo de recuperación y mira en qué paso se detuvo
El arranque se queda colgado o reinicia en bucleAsistente de recuperación → «Cambiar de perfil» y usa otro que funcioneAsistente de recuperación → «Gestión de complementos» → deshabilita el último que instalaste
Tras instalar un complemento la interfaz da error o el panel devuelve 4xxDesactiva ese complemento en la página de Complementos y reiniciaDesinstálalo y busca una alternativa
El complemento está instalado pero no hace nadaConfirma en la página de Complementos que está habilitado y luego sal del todo y vuelve a abrirMira el error de carga en «Configuración → Registro»
Cierro la ventana y no encuentro la aplicaciónMira el icono de la bandeja: por defecto la aplicación no se cierraBandeja → «Abrir Nonead DSH Desktop»
Una tarea se queda a medias sin avanzarComprueba si se detuvo por seguridad o espera una confirmación; revisa el nivel de registroExporta los diagnósticos y cuéntalo indicando la hora
El navegador no abre la interfazConfirma que el modo de ventana es «Modo de compatibilidad»Vuelve a activar «Permitir abrir en el navegador» en Configuración
Un dispositivo de la LAN no se conectaConfirma que el acceso a la LAN está activo y que el dispositivo confía en el certificadoRevisa el cortafuegos y si la IP del equipo ha cambiado
La actualización no se instalaSal del todo desde la bandeja y vuelve a ejecutar el instaladorExporta los diagnósticos y adjunta una captura del error del instalador
La página de Configuración sale en gris y no se puede editarLo más probable es que estés en el modo seguro: mira el aviso de la parte superiorSal del modo seguro y reinicia
Tabla 8 Síntomas habituales y cómo resolverlos.

Exportar información de diagnóstico

Bandeja → «Exportar diagnósticos…», o la misma acción al pie de la página de Configuración. El paquete incluye rutas locales, registros, información del sistema y fragmentos de memoria del momento del fallo. Échale un vistazo antes de compartirlo: las rutas y los fragmentos de sesión pueden contener información privada.

13. Dónde están los datos y la ayuda

ContenidoDónde
Datos de la aplicación (Profile, configuración, sesiones, complementos)Windows: %APPDATA%\Nonead DSH Desktop; macOS: ~/Library/Application Support/Nonead DSH Desktop; Linux: ~/.config/Nonead DSH Desktop
El programa en síEn Windows, por defecto D:\Software\Nonead DSH Desktop (se puede cambiar al instalar); en macOS, «Aplicaciones»; en Linux, donde esté el AppImage
Registro de escritorioSe activa en Configuración → Registro; sale con el paquete de diagnóstico
Archivos de sesiónEl almacén de sesiones dentro del directorio de datos; en «Diagnóstico» del Asistente de recuperación se puede abrir directamente el directorio del Profile
Los archivos de tus proyectosEl directorio de trabajo que asignas a cada sesión; no está en los datos de la aplicación y desinstalar no lo borra
Tabla 9 Dónde viven los datos. Si instalaste por separado o cambiaste el directorio de instalación, manda la ruta real.

Más documentación

Agradecimientos

Este producto se apoya en el DeepSeek Harness de origen y en la comunidad de código abierto: Electron, Node.js, pnpm, Python y el sistema de complementos Cordis con su ecosistema de bundles oficiales. Gracias a los responsables del proyecto original y a todas las personas que contribuyen.

Los datos de autoría de los complementos de terceros viajan con cada complemento y se consultan en la página de Complementos o en la ficha de cada uno en el mercado; este manual ya no enumera versiones y autores uno por uno, porque eso depende de lo que instales tú y no del estado de fábrica del producto.

El manual se actualiza con cada versión. Si encuentras algo que no coincide con la versión actual, abre un issue en GitHub / GitCode.