ConectarConectarDeepSeek Harness

MCP Client

DeepSeek Harness

Conecte el bucle de ejecución de agentes CLI de DeepSeek Harness (dsh) a XMemo mediante el paquete npm nativo dsh-xmemo.

A quién va dirigido y límites

Esta guía conecta el bucle de ejecución de agentes CLI de DeepSeek Harness (dsh) con la memoria persistente de XMemo. La integración opera mediante el paquete de plugin nativo dsh-xmemo (versión 0.1.0) en npm, anclado al repositorio yonro/xmemo-deepseek-plugin @ e7101afb0a (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md). Límite importante: Esta integración es específicamente para la herramienta CLI dsh agent harness; NO es una integración en el chat web de consumo de DeepSeek (chat.deepseek.com), que no admite plugins personalizados ni extensiones MCP.

Requisitos previos

Asegúrese de contar con las siguientes dependencias de tiempo de ejecución y herramientas antes de realizar la conexión:

  • CLI de DeepSeek Harness (dsh) instalada y operativa.
  • Entorno de ejecución Node.js versión 18.0.0 o superior.
  • Cuenta válida de XMemo en https://xmemo.dev.
  • Acceso de red a https://xmemo.dev/mcp a través de HTTPS.

Instalación

Añada el plugin nativo dsh-xmemo a su perfil de DeepSeek Harness mediante el comando documentado en las líneas 90-94 del archivo README:

dsh plugin --profile <name> add dsh-xmemo

Autorización y configuración de credenciales

Configure las credenciales mediante variables de entorno o en la configuración de perfiles de harness. No incluya claves API en texto plano en repositorios de proyectos públicos:

  • Variable de entorno (recomendado): Defina XMEMO_KEY en el entorno antes de iniciar dsh (export XMEMO_KEY='<your-xmemo-token>').
  • Configuración de perfil: Especifique las credenciales de autenticación en el archivo de configuración del perfil de destino (~/.dsh/config.json).

Comportamiento de carga y reinicio

Los procedimientos de reinicio del daemon o recarga del bucle de ejecución no están documentados explícitamente en el README del plugin dsh-xmemo (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md); consulte la documentación de la CLI de DeepSeek Harness o ejecute tareas utilizando su perfil configurado.

Comprobación de conexión (sólo lectura)

Verifique la conectividad mediante una solicitud de recuperación de sólo lectura antes de iniciar los bucles de ejecución del agente:

  • Comprobación: Ejecute una consulta de evaluación de sólo lectura mediante dsh sin modificar el estado de la memoria.
  • Señal de éxito: dsh devuelve resultados de memoria estructurados con campos Reference y Location válidos desde el espacio de trabajo autorizado.

Primera tarea útil: Ciclo de vida de la memoria sintética

Verifique la persistencia de la memoria, la transición de sesión sin estado, la recuperación atribuida al origen y la corrección:

  • 1. Guardar hecho sintético: Almacene una convención de tarea de harness ("Harness demo build target: ESM with strict typing.") en "projects/demo-dsh/conventions".
  • 2. Transición sin estado: Termine la tarea de dsh actual e inicie una nueva ejecución utilizando el perfil configurado.
  • 3. Recuperación con atribución de origen: Consulte "harness build target convention". Confirme los campos Reference y Location devueltos.
  • 4. Corregir memoria: Actualice la convención recordada mediante update_memory con objetivos de compilación actualizados.
  • 5. Limpieza opcional: Realice un borrado suave (forget) de la convención de demostración cuando termine la verificación inicial.

Alcance de la captura automática y prevención de duplicados

Gestión de memoria del bucle de ejecución de DeepSeek Harness:

  • Puntos de control del bucle: dsh-xmemo captura automáticamente los resultados de las tareas, las decisiones arquitectónicas y las resoluciones de errores en los límites de finalización de tareas.
  • Prevención de duplicados: El hash de deduplicación evita volver a capturar un contexto de ejecución idéntico a través de iteraciones repetidas del bucle.
  • Aislamiento de ámbito: El contexto capturado queda estrictamente limitado al espacio de trabajo autenticado y al ámbito del repositorio activo.

Conflictos con proveedores existentes y propiedad del almacenamiento

Límites en tiempo de ejecución y propiedad del almacenamiento:

  • Conflictos de proveedores: Desactive la memoria local efímera predeterminada en dsh.config.json al usar dsh-xmemo para evitar la inyección de contexto redundante o conflictivo.
  • Propiedad del almacenamiento: Las memorias duraderas se almacenan en el backend en la nube de XMemo propiedad del usuario; dsh sólo guarda transcripciones de ejecución efímeras y registros de ejecución locales.
  • Límites sin conexión y de reproducción: Las pérdidas transitorias de conectividad se almacenan temporalmente en búfer local; los períodos prolongados sin conexión provocan el fallo de las escrituras una vez agotado el búfer, y el contexto fuera de línea no se comparte entre agentes hasta restablecer la red.

Recuperación, actualización y eliminación

Procedimientos de solución de problemas, actualización y eliminación para DeepSeek Harness:

  • Recuperación (401 invalid_token): Verifique que XMEMO_KEY esté exportado en el entorno de shell que ejecuta dsh.
  • Actualización y eliminación: Los procedimientos de actualización y eliminación de plugins no están documentados en el README del plugin dsh-xmemo (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md); consulte la documentación de la CLI de DeepSeek Harness para la gestión de perfiles, o revoque credenciales y purgue memorias almacenadas en https://xmemo.dev/me.
  • Eliminación remota: Para purgar memorias almacenadas o revocar tokens de acceso, gestione su espacio de trabajo en https://xmemo.dev/me.

Fuente: Integración de DeepSeek Harness