dsh-persist
Persistent memory for DeepSeek Harness: per-conversation notes, selective injection, project memory, semantic Vault search (bge-m3, free optional key) and automatic retrieval — agents stop forgetting.
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:tluoluo/dsh-persist说明文档
阅读完整 README ↗dsh-persist
给 DeepSeek Harness 的 agent 装上"不会失忆"的长期记忆。 Persistent memory for DeepSeek Harness agents.
它解决什么问题
默认情况下 DSH 的 agent 换对话就失忆——上下文一关,什么都不记得。dsh-persist 把记忆做成 文件系统上的分层结构,每个对话按需注入:
| 层 | 存储 | 对标 | 怎么被读取 |
|---|---|---|---|
| 用户画像 + 长期记忆 | USER.md / MEMORY.md | 长期记忆(LTM) | 每对话可选注入 |
| 关键记忆 | memory.json | 速查卡片 | 每对话可选注入;工具读写 |
| 对话记忆 | sessions//memory.md | 工作记忆 | 只注入本对话 |
| 项目记忆 | projects//memory.md | PARA 的 Project 层 | 按项目勾选注入 |
| Vault 语义记忆 | vault.md + vault.db | Zettelkasten 卡片盒 | 语义/关键词召回,可自动检索 |
特性
- 对话独有记忆——每个对话一本"不会丢的笔记本",其他对话看不到、不注入
- 选择性注入——勾选什么才注入什么;新对话默认零注入,不占上下文
- 项目记忆互通——同一工作目录共享项目经验;命名项目可把同目录的多项目分开
- Vault 语义检索——配一个免费 key 就能"按意思"找记忆;不配自动降级为关键词搜索
- 自动召回——每轮按你的消息自动检索相关记忆注入(
DSH_MEMORY_AUTO_VAULT=0可关) - 记忆 tab——对话顶部可视化编辑 + 注入配置 + 实时预览(所见即所得)
- 全部纯文本——
~/.dsh-memory/下每个文件人类可读可改,随时备份、迁移、导出
快速上手
dsh plugin --profile web add dsh-persist # 1. 安装
# 2. 重启 DSH(dsh --profile web)
# 3. 打开对话 → 顶部「记忆」tab → 勾选要注入的块
想让 agent 记住什么,直接对它说"记住这个",它会自动写入本对话记忆。
要开语义搜索:在 硅基流动免费申请 key,设置环境变量
SILICONFLOW_API_KEY=... 后重启即可(不配也能用,自动降级为关键词搜索)。
怎么装?
曾用名
dsh-memory(npm 名已被占用,故改名dsh-persist)。存储路径~/.dsh-memory/、路由/dsh-memory/不变,旧数据无需迁移。
:Node.js (推荐 24+;测试用 自 22.6 起可用)。Vault 层用内置 :23.4+ 默认可用,22.6–23.3 需 标志;更低版本插件照常加载,仅 Vault 工具自动降级禁用(记忆/注入/UI 不受影响)。宿主为 DeepSeek Harness(需提供 / / / / 服务与 UI 槽位)。