dsh-memento es una costura de capacidad, no otro almacén: un servicio tipado ctx.memory, un proveedor SQLite local (node:sqlite, WAL, 0600, en $DSH_HOME/dsh-memento/memory.db) y sus consumidores — la herramienta memory y una instantánea congelada inyectada en el prompt del sistema.

• La puerta no se puede eludir. Toda ruta de escritura (add / replace / remove / seed) se fuerza a través de la cascada de aprobación dentro del servicio, no en la capa de herramientas. writePolicy: ask | auto | off es configuración invisible para el modelo; replace / remove / consolidate llevan el texto completo de las entradas que cambian en el payload de aprobación, y una escritura denegada deja igualmente una fila de auditoría *-denied.
• Visible para el modelo ⟺ registrado. La instantánea inyectada llega textualmente a request/header.system; cada escritura es reconstruible a partir de approval/asked + approval/decided + la propia tabla de auditoría del plugin.
• Acotada y honesta. Presupuestos estrictos de caracteres por pista y por capa (por defecto usuario 2000 / agente 4000). Un almacén lleno falla con un error estructurado (uso + límite): nunca se trunca, nunca se compacta automáticamente.

Dos pistas × dos capas × clave por agente: una pista user (hechos sobre el usuario) y una pista agent (hechos de entorno y convenciones), cada una dividida en capas user-global y workspace, aisladas por agentPreset. La instantánea se congela una vez por sesión en el primer ensamblado del prompt y nunca cambia a mitad de sesión.

# 1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-memento#main"

# or from npm (published releases)
dsh plugin --profile web add dsh-memento

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: memento'

• canal git (último main): dsh plugin --profile web add git+https://github.com/PerryLink/dsh-memento.git.
• canal npm (versiones publicadas): dsh plugin --profile web add dsh-memento.
• canal tarball: npm pack en este repo, luego dsh plugin --profile web add ./dsh-memento-<version>.tgz.
• desinstalar: dsh plugin --profile web remove dsh-memento (la base de datos de memoria y los registros de sesión se conservan).

Todos los parámetros son campos Schemastery Config (modificables desde cordis.yml). Los valores inválidos fallan de forma ruidosa al cargar. Se sobrescriben bajo la fila memento.

El nombre es dsh-memento (publicado en npm y GitHub). No dsh-recall (confundible con dsh-external/Recall), no el nombre heredado eliminado dsh-memory.

dsh-memento es el ensayo comunitario del protocolo de memoria DSH — una forma candidata para una costura oficial ctx.memory. El protocolo normaliza la costura de este plugin en un contrato entre plugins:

• Entry spec — dos pistas × dos capas × clave por agente, más tags cortos (≤16 × ≤32 caracteres) y un version por entrada que se incrementa en cada replace.

• Write semantics — escrituras condicionales idempotentes por subcadena única; payloads de aprobar-lo-que-se-ve (replace / remove / consolidate llevan el texto completo que cambian).

• Audit contract — cada escritura reconstruible desde approval/asked + approval/decided + el libro mayor del proveedor.

• Budget model — semántica BUDGET_EXCEEDED / AMBIGUOUS_MATCH.

• Schema versioning — reglas de migración con verificaciones de versión ruidosas.

• Spec — docs/protocol-v1.md (中文: protocol-v1.zh.md); JSON Schema normativo en docs/schemas/dsh-memory-protocol-v1.schema.json.

Registro de adaptadores — ctx.memoryAdapters (register / list / adapt / export) permite a plugins de memoria de terceros hablar el protocolo registrando un convertidor de datos puro (register() reversible; la importación usa el seed con puerta de aprobación, la exportación es de solo lectura). Incorporación: docs/adapters-guide.md (中文: adapters-guide.zh.md).

Suite de conformidad — test/protocol-conformance/: un conjunto de casos distribuible que cualquier proveedor que reclame compatibilidad ejecuta (node test/protocol-conformance/run.mjs --provider ./your-factory.mjs); el CI de este repo lo ejecuta contra su propio proveedor como referencia dorada (npm run test:conformance).

• Upstream proposal — docs/upstream-proposal.md (中文: upstream-proposal.zh.md): por qué la costura oficial ctx.memory debería adoptar el protocolo, las diferencias y la ruta de migración.

• Permissions: el manifiesto de workshop declara harness:tool, filesystem:read, filesystem:write y network:none / subprocess:none / shell:none / python:none / credentials:none. La aprobación de escritura usa la costura oficial de aprobación.
• Data: base de datos SQLite local (0600), cero red, cero credenciales.
• Session log: la completitud de auditoría proviene del par de aprobación (approval/asked + approval/decided) más la tabla de auditoría del plugin.

• Solo servicios públicos. Consume tools, systemPrompt y la costura de aprobación; sin cambios en engine / agent-loop / apiproxy / UI oficial.
• Cero red, cero credenciales. Base de datos local con modo de archivo POSIX 0600.
• Fallo ruidoso. Base de datos corrupta, esquema más nuevo o configuración inválida falla al cargar; presupuestos llenos y coincidencias de subcadena ambiguas fallan con errores estructurados.
• Un proceso, un almacén. Varias sesiones comparten el almacén SQLite; dos procesos que comparten un $DSH_HOME escriben el mismo archivo (último escritor gana bajo el bloqueo de SQLite).

• Los eventos de sesión están declarados, aún no emitidos (rc.2). memory/added|updated|removed|recalled|snapshot están declarados por fusión, pero rc.2 no tiene superficie de registro para tipos de evento fuera del repo; la emisión se activa cuando una build del harness los registre.
• La política ask necesita un answerer. Sin un answerer UI/ACP compuesto, las escrituras fallan cerradas.
• Sin indexado FTS5. La búsqueda por subcadena usa instr insensible a mayúsculas (correcto para CJK).

dsh-memento no es un port de Claude Code, Codex o Hermes — pero su diseño absorbió deliberadamente las partes que cada uno hizo bien, y rechazó las que dañaban:

Fuentes: Claude Code memory · Codex AGENTS.md · Hermes memory · Hermes #48181.

Y las partes deliberadamente rechazadas: la auto-resumación oculta hacia estado privado del modelo (los resúmenes de compactación aquí se convierten en propuestas pendientes que esperan un approve/dismiss humano), las ambiciones de almacén/vector-store, y cualquier escritura sin aprobación o rastro de auditoría visible para humanos. También adoptado: la advertencia documentada de Hermes de que dos procesos que comparten un directorio home escriben el mismo archivo de memoria — véase Security boundaries.

npm install              # node ^22.19 || >=24
npm test                 # node --test: 133 tests
npm run test:conformance # dsh-memory-protocol v1 conformance suite
npm run typecheck        # tsc --checkJs gate
npm run check:coverage   # line-coverage gate
npm run check:readmes    # five-language README consistency gate

lib/ tiene cero dependencias de DSH (solo builtins de node:); las importaciones de DSH solo existen en index.mjs.

dsh, dsh-plugin, deepseek-harness, memory, agent-memory, approval, audit, sqlite, cordis, llm

• @Niuniu-Sir — el informe de fallo de arranque en issue #1 que llevó al fallback ~/.dsh incluido en 0.3.1.

Este proyecto es uno de los 15 plugins de DeepSeek Harness mantenidos por PerryLink. Si este te ayuda, los demás probablemente también:

Apache License 2.0 © 2026 dsh-memento contributors