dsh-memory-standard

English | 简体中文

A Memory Standard Protocol (mm) plugin for the DeepSeek Harness (dsh): a deterministic, layered, cross-agent memory system built on plain markdown files — not a proprietary protocol.

The dsh ecosystem has dozens of memory plugins but no shared standard, and the official core only ships a default-off MCP memory example. This plugin claims the missing "standard seat": deterministic budgets + layered MEMORY.md + cross-agent mutual recognition + session-log ingestion that works with official compaction/session logs.

• Layered memory — MEMORY.md is the hand-loaded index (hard cap: 200 lines / 25 KiB, default); detailed notes live in memories/<topic>.md and load on demand.
• Deterministic budgets — over any budget is a structured error with usage metrics demanding an index rewrite, never a silent truncation. Writes carry a character budget and return usage so an agent can compress on the spot.
• Cross-agent mutual recognition — a documented plain-markdown format, portable mm://<memoryId>/<topic> URIs, a JSON Schema (schema/memory.schema.json), and an open read/write API. No closed protocol.
• Write timing — mem_write API plus session-end / periodic nudging; writes persist to disk immediately and load in the next session (in-session reads stay frozen, protecting any prompt cache).
• Ingestion collaboration — mem_digest recognizes official dsh session logs / compaction output as a memory source and distills candidate memories (optional, self-contained, LLM-free).
• Toolchain — dsh tools mem_read, mem_write, mem_search, mem_budget, mem_digest, plus a dsh-memory CLI.

The core library is dependency-free (Node built-ins only) and works both inside dsh and standalone.

Status

Developer-preview dsh ecosystem; format version mm v1 (see SPEC.md). Compatible with the installed @deepseek-ai/dsh CLI and bundle format (dsh.bundle.patch + cordis.patch.yml + apply(ctx)).

---

Quick start

1. Integrate with dsh (local directory bundle)

From the directory that contains this package (dsh-memory-standard/):

dsh plugin --profile demo add ./

# or install directly from this GitHub repository
dsh plugin --profile demo add github:JohnXu22786/memory-standard
# or from npm once published
dsh plugin --profile demo add dsh-memory-standard
# the standalone CLI is also published as a global npm bin
npm install -g dsh-memory-standard

# boot the profile; the five mem_* tools + the 'memory-standard' system section load
dsh --profile demo

dsh plugin forwards to pnpm inside the profile; peer dependencies (@deepseek-ai/cordis, @deepseek-ai/dsh-tools, @deepseek-ai/schemastery) resolve from the dsh installation. Verified against [email protected].

Notes for other install paths:

• As a dev overlay → copy cordis.patch.yml and point a --patch overlay at the package's entry (name = package name for the row).
• The plugin auto-initializes the memory root ($DSH_HOME/memory, or $DSH_MEMORY_ROOT) on first load — no manual init needed.

2. Configure

The bundle ships defaults; every value is overridable by overriding the memory-standard row by id in a later layer (profile cordis.patch.yml, $DSH_HOME overlay, or --patch):

…