dsh-plugin-memory-four-books

Layered long-term memory for DeepSeek Harness.

Instead of dumping a huge history file into every prompt, this plugin keeps memory in five ordered tiers and only injects what fits. Expensive information (red lines) is always present; cheap details wait on disk until the model asks for them.

Zero dependencies. Plain Markdown and JSONL on disk. No network calls, no background services, no database.

Install

dsh plugin --profile <your-profile> add github:wodexiaoling/dsh-plugin-memory-four-books

The plugin is distributed through GitHub only — it is not published on npm. dsh clones the repository into the profile and links it as a bundle.

To update later:

dsh plugin --profile <your-profile> remove dsh-plugin-memory-four-books
dsh plugin --profile <your-profile> add github:wodexiaoling/dsh-plugin-memory-four-books

How it works

you type
   ↓
agent/pre-step ──→ filtered and appended to 支线/对话.jsonl
   ↓
model runs
   ↓
every 10 min ──→ consolidate ──→ writes tiers only when something changed

Automatic capture. Every message you send is filtered (greetings, duplicates and injected runtime context are dropped) and appended to an append-only journal.

Automatic consolidation. Every ten minutes the journal is summarised into one line per entry, de-duplicated and sorted into tiers. Nothing is deleted — old entries move down a tier.

Tiered injection. Before every model step the plugin rebuilds a prompt block from the tiers:

Tier	Injected	Cap
当天 / today	always, never truncated	400 entries
红线 / red lines	always, never truncated, never decayed	40 entries
进行中 / in progress	latest 30	80 entries
常识 / common sense	latest 70	260 entries
档案 / archive	only on demand	800 entries

The block is cached by file mtime, so an unchanged memory costs nothing.

BM25 recall. memory_recall runs a BM25 index (Chinese 2-gram, k1=1.5 b=0.75) over every tier plus the raw journal, then applies a 120-day half-life decay with a floor of 0.4 so old entries stay findable but stop crowding out recent ones.

Tools

Tool	Purpose
memory_recall	search memory by keyword
memory_remember	store one entry under a tag
memory_consolidate	run consolidation now
memory_status	tier counts, caps, file sizes, automation state

Config

All fields are optional; set them in the plugin row's config:

Field	Default	Meaning
dataDir	$DSH_HOME/memory-four-books	where memory lives
inject	true	inject the tier block into prompts
injectBudget	15000	character budget for the injected block
sectionOrder	45	order of the prompt section
autoRecord	true	capture user messages automatically
autoConsolidate	true	run consolidation on a timer
consolidateMinutes	10	timer interval
dayMaxChars	8000	byte guard for the "today" tier
indexMaxDocs	20000	max journal rows kept in the search index

Where data lives

$DSH_HOME/memory-four-books/
  支线/对话.jsonl            append-only journal
  四册/记忆核心.md            the five tiers (this is what gets injected)
  四册/MEMORY_INDEX.md       one line per topic
  四册/档案库.md             archive
  四册/memory_changelog.md   append-only change log
  归纳台账.jsonl             consolidation ledger

Everything is plain UTF-8. Open it, edit it, back it up, delete it — the plugin rebuilds derived files from the journal.

Privacy

This plugin records what you type, locally. No data leaves the machine: the plugin makes no network requests and starts no server. Memory is stored unencrypted in dataDir.

Disable capture with "autoRecord": false if you only want manual memory_remember.

Limits

• Memory is shared by every session and subagent in a profile. It is not scoped per workspace.
• It is not encrypted.
• It is not part of the session log, so forking a session does not fork its memory.
• Japanese/Chinese/English text is supported; other scripts fall back to single-character n-grams and recall quality drops.
• The plugin assumes DSH >= 0.2.0 (uses agent/pre-step and systemPrompt.section).

License

MIT