dsh-plugin-memory-four-books
适用于 DeepSeek Harness 的分层长期记忆：红线 / 今日 / 进行中 / 常识 / 归档，支持 BM25 检索、自动捕获和自动整合。零依赖，纯文本。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wodexiaoling/dsh-plugin-memory-four-books#348b7b19a367ac1daf83ff479f068d8154cf4b55Plugin Memory Four Books 以 dsh-plugin-memory-four-books 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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.
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
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.
| 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 |
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 |
$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.
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.
>= 0.2.0 (uses agent/pre-step and systemPrompt.section).MIT