dsh-timem-memory

Complemento DeepSeek Harness (DSH) para la memoria a largo plazo TiMEM. Una entrada de cordis que instala dos cosas:

1. Puente MCP — Conecta la nube TiMEM MCP a través de @deepseek-ai/dsh-mcp-client (https://api.timem.cloud/mcp), registrando 17 herramientas con el nombre mcp__timem__* para el modelo (4 de memoria, 8 de reglas, 4 de base de conocimiento, 1 ready);

2. Skill de memoria — Registra 5 skills integrados en el sistema de skills de DSH (capa de runtime, rank 250), permitiendo que el modelo ejecute automáticamente el flujo de trabajo «buscar memoria primero en cada turno → trabajar → escribir memoria», sin necesidad de que el usuario entienda la clasificación S0–S6.

Las credenciales se resuelven a través de ctx.credentials (TiMEM_API_KEY / TiMEM_USER_ID), sin codificar claves en ningún archivo de configuración; los cambios en las credenciales activan eventos que vuelven a montar automáticamente el puente MCP, sin necesidad de reiniciar.

Instalación

Requisito previo: DSH instalado, pnpm en el PATH (dsh plugin depende de él).

# 1. 把插件装进目标 profile（任意名字，web / headless / 自定义皆可）
#    GitHub 渠道（当前即可用）：
dsh plugin --profile web add git+https://github.com/auuduu/dsh-timem-memory.git
#    npm 官方商店渠道（发布后）：
# dsh plugin --profile web add dsh-timem-memory

# 2. 在 <DSH_HOME>/profiles/web/cordis.patch.yml 中插入一条目（保存即热生效）
- insert:
    - id: timem-memory
      name: 'dsh-timem-memory'

Explicación de principios para principiantes (qué es el paquete, dónde se instala, cómo DSH lo «activa»): docs/principles.zh.md

Related MCP server: r3 (Recall)

Configurar credenciales

Las credenciales se almacenan en el almacén de credenciales (~/.dsh/.credentials.yaml, permisos 0600, se pueden gestionar en la página de credenciales de la interfaz web de DSH), o en variables de entorno / ~/.dsh/.env (cargadas al inicio). Ejemplo con .credentials.yaml:

DEEPSEEK_API_KEY: sk-…
TiMEM_API_KEY: sk-…          # https://console.timem.cloud/settings/api-key
TiMEM_USER_ID: usr_…         # TiMEM 控制台个人资料页

Después de escribir, el complemento volverá a montar automáticamente el puente MCP (sin necesidad de reiniciar DSH). Si faltan las credenciales de TiMEM, el complemento solo omite el puente y registra un error en el registro, los skills aún se registrarán.

Opciones de configuración

Verificación

Después de reiniciar o aplicar cambios en caliente, pregúntale al modelo en el chat «¿TiMEM está conectado?» — llamará a mcp__timem__ready y confirmará que las 17 herramientas son visibles; o ve a la página de Configuración → Complementos para ver el estado de la entrada timem-memory.

Cómo funciona

• lib/index.js: Cuerpo del complemento cordis (inject: ['credentials', 'skills']). Al activarse: ① Resuelve credenciales → monta el puente MCP con ctx.plugin(mcpClient, …); ② Lee skills/*/SKILL.md dentro del paquete → registra con ctx.skills.register() (se destruye automáticamente con el contexto).

• skills/: 5 paquetes de skill (versión adaptada a DSH de los skills oficiales de TiMEM, nombres de herramientas reescritos como mcp__timem__*, con verificación de disponibilidad incorporada y clasificación S3/S0/S6).

• Actualización en caliente de credenciales: Escucha el evento credentials/updated, cuando coincide con apiKeyRef / userIdRef libera el puente antiguo y lo vuelve a montar con las nuevas credenciales.

Licencia

MIT