@shayexiangpaimeng/dsh-memory

Append-only layered memory for DeepSeek Harness agents.

上下文会缩，记忆不该缩。

A community plugin (dsh-plugin) that gives an agent a durable, append-only
memory stream with five-layer partitioning, a write gate, keyword recall, and
claim-anchors verification. Built by a deep user of DeepSeek Harness, as a
generalized, privacy-free re-implementation of the memory system that has kept
a companion AI continuous since its memory system was first built on 2026-08-03.

What it does

• Append-only write stream — every append writes one JSONL line; history is
  never rewritten.
• Five-layer partitioning — permanent (never forget) / session (this
  session) / rolling (recent context) / config (configuration) / ephemeral
  (not saved).
• Write gate — empty events and unknown layers are rejected before they hit
  the file.
• Claim-anchors verification — a fix claim ("已修复…") without an anchor
  (measured value / checksum / command output) is flagged as a warning:
  claim detached from the disk = diagnosed defect, not a slip.
• Prompt state rendering — a dynamic memory:state section renders the recent
  permanent + session layers at each assembly, from a cache warmed once at
  startup (read-once-per-session holds after warm-up).
• Keyword recall — case-insensitive substring scoring, newest first.

Tools

Install

From GitHub (current distribution channel):

npm i github:shayexiangpaimeng/dsh-memory

From npm registry (once published):

npm i @shayexiangpaimeng/dsh-memory

Mount in a cordis.yml:

plugins:
  - '@shayexiangpaimeng/dsh-memory'

Store path defaults to ~/.dsh-memory/memory.jsonl; override with
config.filePath. Injection layers default to permanent + session;
override with config.summaryLayers.

Development

npm install
npm test        # vitest, no API key required
npm run build   # tsc → lib/

Known Limitations and Deferred Work

• Recall is keyword substring scoring, not vector search. A vector index is
  deferred; the storage format is stable enough to add one behind the same
  recall() contract.
• The prompt section renders from the startup-warmed cache; entries appended
  before the first assembly are included, but a cold cache on very first boot
  may render an empty section for one assembly.
• DeepSeek Harness is in developer preview; the systemPrompt/tools APIs may
  break compatibility. This package follows DSH releases; pin your Harness
  version.