Í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 — tres capas; en el día a día solo tocas la de arriba.
• 2 · Instalación — qué paquete corresponde a cada plataforma y cómo se instala.
• 3 · Primera apertura — el asistente de seis pasos y por qué «cerrar» no es «salir».
• 4 · La interfaz principal — qué gestiona cada una de las cuatro zonas.
• 5 · La primera conversación — cómo pedir las cosas con claridad.
• 6 · El menú de la bandeja — aquí están todos los accesos de nivel de sistema.
• 7 · Configuración — qué se puede cambiar en cada sección.
• 8 · Profile — cómo cambiar entre varias configuraciones y cómo volver atrás si una falla.
• 9 · Complementos preinstalados — 35 complementos en siete categorías, uno a uno, y cómo gestionarlos y volver a instalarlos.
• 10 · Modo seguro y modo de recuperación — cómo rescatar la aplicación cuando un complemento la rompe.
• 11 · Actualización — cinco fases y cuatro operaciones que conviene tener a mano.
• 12 · Cuando algo falla — tabla de síntomas y exportación de diagnósticos.
• 13 · Datos y ayuda — dónde están los archivos y dónde buscar más documentación.

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.

Esta versión (la edición Essentials) se diferencia además de la versión general del repositorio del software en un punto: no es una aplicación vacía que se queda esperando a que instales complementos, sino que lleva dentro del instalador 35 complementos ya elegidos y que encajan entre sí. Al terminar la instalación y abrirla por primera vez, esas capacidades ya están esperando en la página de Complementos, sin que tengas que buscarlas una a una en npm.

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.

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. Al desinstalar ocurre lo mismo: primero se confirma y se cierra el programa en marcha, para que la desinstalación no se quede a medias con archivos ocupados.

Nota: la página de descargas ofrece ahora mismo tres paquetes: Windows x64, macOS universal y Linux x64. La compilación arm64 para Linux se publica en el canal de pruebas y todavía no está en el enlace de descarga estable; si en un equipo ARM aparecen problemas con módulos nativos, usa la versión x64 de la plataforma correspondiente o el artefacto del canal de pruebas.

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 seis pasos; puedes omitirlo cuando quieras y completarlo después en Configuración:

La última página te muestra primero una visión general por categorías: memoria y contexto, interfaz y espacio de trabajo, agentes y habilidades, documentos y medios, código e ingeniería, robótica y simulación, conexión y automatización, y en cada una se explica «qué puede hacer por ti esta categoría» y cuántos complementos la forman. Solo al pulsar «Finalizar y empezar» el asistente instala uno a uno y, cuando le toca a cada complemento, muestra su nombre, versión, categoría, descripción completa y una frase de agradecimiento a quien lo aporta. Durante la instalación no tienes que hacer nada: espera a que avance el progreso; son 35 paquetes uno tras otro, así que el primer arranque tarda algo más de lo normal.

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

Con los complementos preinstalados, en la barra lateral y en el cuadro de entrada aparecen además algunas entradas: el centro de habilidades, el tablero de tareas, el panel de gastos, el historial de entradas, los equipos de expertos, etc. Todas las aportan los complementos de la sección 9 y desaparecen al desactivar el complemento correspondiente.

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 dile lo nuevo.
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:

• Alcance: qué directorio y qué archivos puede tocar; no lo dejes a su criterio.
• Criterio de aceptación: qué cuenta como terminado (que arranque, que pasen las pruebas, que no queden celdas vacías en la tabla).
• Restricciones: lo que no se puede tocar, el formato que hay que conservar y si puede o no usar la red.

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:

Los «modos: mejorado / compatible / extendido» que mencionaba la versión anterior del manual ya no existen: desde 2.2.9 el modo de ventana es fijo y en Configuración solo queda el apartado «Aspecto de la ventana (material)».

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:

En el modo seguro esta página es de solo lectura, y el acceso desde el navegador, la red local, la conexión remota 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.

Tres reglas prácticas:

• Si un Profile queda roto, cambias a otro y sigues trabajando; no hace falta rescatarlo primero.
• Un Profile nuevo solo trae los componentes base oficiales, así que los 35 complementos preinstalados solo se instalan en el Profile con el que se completó el asistente. Si cambias de Profile y quieres seguir usándolos, revisa la lista real en la página de Complementos e instala los que falten.
• Borrar un Profile lo mueve a la carpeta de copias de recuperación (no lo borra de inmediato) y conserva las sesiones y los ajustes compartidos; pero para ese Profile ya no está disponible, así que confírmalo antes de hacerlo.

9. Complementos preinstalados

Esta sección es la más importante de este manual. El instalador de 2.2.9 trae 35 complementos repartidos en siete categorías, que se instalan automáticamente en el Profile actual al completar el asistente por primera vez. A continuación se explica «qué se instala y cómo se instala», después se presentan uno a uno por categorías y, por último, cómo gestionarlos y volver a instalarlos.

9.1 Qué viene preinstalado de fábrica

El instalador distribuye juntos los paquetes de los 35 complementos (directorio plugins/) y, al terminar el asistente por primera vez, los instala uno a uno en el Profile. No son «descargas opcionales», sino que están ahí nada más instalar: al abrir la página de Complementos verás los 35 en «Complementos instalados», activados por defecto.

9.2 Cómo ocurre la preinstalación

Algunos detalles que conviene conocer:

• La instalación es una a una: por cada complemento, el asistente muestra su nombre, versión, categoría, descripción y autor. No cierres la ventana hasta que terminen todos.
• El criterio de éxito es que el nombre del paquete aparezca entre las dependencias del package.json del Profile, no que el comando no dé error; al terminar también se añade el nombre a profile.bundles, porque si no quedaría «instalado pero no activado».
• Que falle un complemento no bloquea el arranque: si alguno falla, se muestra un cuadro resumen con la lista de nombres y motivos, se escribe en el registro de escritorio (bundled plugin not installed: <nombre>: <motivo>) y el asistente termina igualmente. Después puedes comprobar en la página de Complementos cuáles están realmente en la lista.
• Solo se instalan en el Profile con el que se completó el asistente. Los Profile creados después nacen limpios; si los necesitas, repite el asistente o instálalos desde la página de Complementos.

9.3 Lista detallada por categorías

A continuación se enumeran los 35 complementos en siete categorías. La v que sigue al nombre es la versión incluida; la frase «Recomendado para» es una sugerencia para elegir, no una limitación de la función.

9.4 Desactivar, desinstalar y volver a instalarlos

• Primero desactivar, luego desinstalar: desactivar solo hace que no se cargue en el siguiente arranque, y tanto los archivos como la configuración siguen ahí, listos para volver a activarlo. Desinstalar pasa por dsh plugin remove y borra el paquete; la interfaz pregunta antes con un aviso de que «lo que aportaba desaparecerá al desinstalarlo».
• Desinstalar complementos preinstalados no libera casi nada de espacio: los .tgz originales del instalador siguen en el directorio plugins/ del programa, y lo que se borra es la copia instalada en el Profile. Si de verdad quieres adelgazar, usa un instalador sin esos paquetes en lugar de desinstalarlos uno a uno.
• Volver a instalarlos: Configuración → Herramientas de escritorio → «Asistente de configuración», vuelve a la página 6 y pulsa «Finalizar y empezar»; instalará los paquetes que falten en el Profile. También puedes instalarlos a mano por las vías de 9.5.
• Los componentes protegidos no se pueden tocar: los que necesita el propio gestor de complementos (Host, servicio web, acceso a archivos, etc.) llevan la marca «La gestión de complementos lo necesita; no se puede apagar ni desinstalar»; los componentes integrados como dsh-base y dsh-web-app ni siquiera entran en la lista gestionable y solo se consultan en «Configuración → Complementos integrados».

9.5 Instalar más complementos: tres vías

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

• Instalar uno nuevo: pulsa «Agregar complemento», elige «Instalar un complemento de terceros» e indica el nombre del paquete npm (por ejemplo dsh-xxx o @autor/complemento), la dirección de un repositorio de GitHub o un directorio de este equipo. Durante la instalación puedes elegir el origen: registro predeterminado, registro oficial, espejo de China continental o un registro npm interno personalizado.
• Gestionar lo instalado: en «Complementos instalados» puedes habilitar, desactivar, desinstalar y buscar actualizaciones, además de ver la versión, el origen y el estado de cada complemento.

Mercado de plugins: hay dos disponibles, dsh-community-market (el mercado abierto integrado, que admite fuentes de datos propias, Beta) y dsh-market (el mercado popular de la comunidad, con datos de awesome-dsh-plugin; dentro del paquete el complemento se llama dshmarket). Solo uno puede estar activo a la vez; el mercado es en sí mismo un complemento, así que también se puede activar o desactivar directamente en la página de Complementos.

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

9.6 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 «se ha instalado; reinicia DSH para cargarlo». Para confirmar que quedó bien instalado:

1. Abre la página de Complementos y comprueba que aparece en «Complementos instalados» y que está habilitado.
2. Mira si en la barra lateral ha aparecido su entrada (el mercado, el tablero, los equipos de expertos 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.7 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. Vale igual para los complementos preinstalados: no se distinguen de los que instalas después.

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:

• Averiguar si «el problema es de los complementos»: si en modo seguro todo funciona, el origen está casi seguro en un complemento o en la configuración.
• Conversar, leer y escribir archivos con normalidad desde la interfaz web y sacar adelante lo urgente.
• Consultar los registros y exportar los diagnósticos (el paquete de diagnóstico también se exporta desde el Asistente de recuperación).

Limitaciones (por diseño):

• La página de Configuración de escritorio queda fija en solo lectura y no se puede modificar.
• El acceso desde el navegador, el acceso a la red local, la conexión remota y las notificaciones de escritorio, que dependen de configuración persistente, no están disponibles.
• En la parte superior de la interfaz se muestra siempre el aviso «Modo seguro», que recuerda que ahora se ejecuta en un entorno temporal.

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:

• Cuando lo pides tú desde la bandeja con «Asistente de recuperación…».
• Cuando el arranque falla varias veces seguidas y la aplicación se retira sola al Asistente de recuperación.
• Cuando la interfaz no llega a levantarse, aparece un diálogo aparte, «Recuperar DSH Desktop», desde el que se puede reintentar la recuperación sin reiniciar el servicio en segundo plano.

El asistente te dice tres cosas: por qué has entrado (si entraste a mano, lo indica con la frase «se ha entrado manualmente en el modo de recuperación»), 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.

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

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

• Comprobar a mano: bandeja → «Buscar actualizaciones…», o Configuración → Versión y actualizaciones → «Buscar actualizaciones».
• Reiniciar: Configuración → Versión y actualizaciones → «Reiniciar»; si la barra de título avisa de una actualización, también se puede pulsar ahí.
• Limpiar restos de instalación: cuando una actualización falla suele ser porque la instancia anterior tiene los archivos ocupados. Sal de la aplicación desde la bandeja y vuelve a ejecutar el instalador; no hace falta borrar directorios a mano.
• Volver atrás: si solo quieres regresar al último estado que arrancaba, usa «Revertir» del asistente de recuperación. Si lo que quieres es cambiar al instalador del canal estable, basta con descargar la versión correspondiente de la página de descargas e instalarla encima; el Profile y los complementos se conservan.

12. Cuando algo falla

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 dónde buscar ayuda

Más documentación

• README.md / README.zh.md: instalación, compilación y entorno de desarrollo.
• docs/: arquitectura, proceso de publicación y guía de desarrollo de complementos.
• En la misma carpeta, Nonead-DSH-Desktop-User-Manual.en.md y las versiones HTML en ocho idiomas: el contenido se corresponde, así que sirven para contrastar.
• CHANGELOG.md: los cambios de cada versión; en la entrada de 2.2.9 hay una «lista de complementos integrados (35)» que coincide con este manual.

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 35 complementos que se distribuyen con el paquete vienen de los siguientes autores y equipos (por orden alfabético; un mismo autor puede aportar varios):

La versión concreta, la autoría y la descripción completa de cada complemento viajan en plugins/manifest.json, y también se pueden consultar en la ficha de cada uno en la página de Complementos.

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.