@deepseek-ai/dsh-memory-connect

跨会话记忆插件 — 让 AI Agent 拥有持久记忆和全局身份
Cross-session memory plugin for DeepSeek Harness (DSH)

---

English | 中文

Overview

dsh-memory-connect is a cross-session memory sharing plugin for DeepSeek Harness. It automatically extracts, stores, and recalls memories across sessions, giving your AI agent persistent, intelligent memory with context explosion prevention and global Soul identity.

Zero-config — works out of the box with SQLite FTS5 and DSH's built-in LLM.

🚨 v0.4.0 — The "it actually works now" release

v0.3.0 registered the service but never instantiated it (Cordis lazily constructs services — passing the class to ctx.provide() means the constructor never runs), and the "recall" feature wrote a computed context to a field no one ever read. In practice the plugin did nothing.

v0.4.0 fixes the activation chain and wires recall into the system prompt: a systemPrompt.context provider injects ## Related Memories from Previous Sessions on every turn. Zero-config runnable: a bare dsh plugin add used to crash on config.openAt (Cordis passes undefined config when the patch has no config: block) — apply() now fills in full defaults (DB at ~/.dsh/memory.db, openAt: startup). Verified end-to-end on dsh v0.1.1-rc.2 / Node 24: tell session A "my cat is named Mimi", start a fresh session B and ask — the model answers correctly from memory.

See CHANGELOG.md for the full breakdown.

Features

Feature	Description
🧠 Global Soul	Persistent identity across all workspaces via ~/.dsh/soul.md
🔍 Auto Extraction	Extracts facts, preferences, decisions, and context from conversations
🧠 Cross-Session Recall	FTS5 keyword recall injected into the system prompt every turn (recency fallback when no query text is available)
🛡️ Context Explosion Prevention	Token budget management prevents context window overflow
⏰ Scheduled Maintenance	Automatic periodic decay and consolidation via built-in scheduler
🤖 LLM Consolidation	Intelligent memory merging using DSH's built-in ctx.llm (zero-config)
📉 Memory Decay	Old, unused memories naturally fade; frequently accessed ones persist
🎯 Smart Prioritization	Memory selection based on relevance × recency × frequency
🗜️ Memory Compression	Automatic compression when approaching token limits

🧠 Global Soul (Identity)

The Soul feature provides a persistent identity that follows you across all workspaces.

How it works

1. Create ~/.dsh/soul.md with your identity information
2. The plugin automatically loads and injects it into every session
3. Your preferences, tech stack, and coding style are always available

Example Soul file

# 🧠 Soul — Global Identity

## 👤 Identity
- GitHub: your-username
- Role: Developer/Designer/Product Manager

## 💻 Tech Stack
- TypeScript, React, Node.js, DSH/Cordis

## 🎨 Coding Style
- Functional programming
- ES Modules
- Zero-config preferred

## ⚠️ Preferences
- No class components
- No redundant comments

Installation

⚠️ Not on npm yet — install from GitHub (v0.4.0):

# 方式 A：dsh plugin add（推荐，自动装入 profile）
dsh plugin --profile <你的profile> add github:Asher-2000/dsh-memory-connect

…