dsh-agent-memory:给 DSH 装上跨会话长期记忆

[Culeot]

这是什么

dsh-agent-memory 是 DeepSeek Harness(DSH)的跨会话长期记忆插件:会话之间沉淀的知识(用户偏好、已定决策、踩坑教训)自动保存,新会话开局就能用上。零依赖、无 MCP、无向量库、无 embedding API。

• npm:https://www.npmjs.com/package/dsh-agent-memory(`npm i dsh-agent-memory`)
• 源码:https://github.com/Culeot/dsh-agent-memory(MIT)

核心特性

• 跨会话持久:A 会话写入,B 会话开局即可检索;数据存 $DSH_HOME/storages/memory.json,纯 JSON 可查看、可进 git。
• 按需注入:每轮模型执行前,通过 DSH 的 agent/pre-step 钩子按当前消息检索最相关记忆,注入最多 3 条短摘要;检索结果不变时跳过注入,不重复刷屏。
• 自我纠错闭环:同一错误重复出现 2 次,提示固化为 importance=3 的教训,自动注入防止再犯;用户纠正当场固化。
• 中文友好检索:中文 bigram + 单字兜底,英文按词,整串匹配,无需分词库。
• 原生接入:复用 ctx.storageDomain(schema 校验、原子写、事件)、ctx.tools.register、agent.inject(),与官方插件同构。
• 治理四件套:容量淘汰(默认 400 条)、近重复合并(Jaccard 0.7)、TTL 过期、importance=3 删除需确认。
• 外部修改防护:写入前校验文件指纹,外部改动不会静默覆盖;memory_import 走写链批量导入,memory_reload 从磁盘重开合并。

工具

工具	用途
memory_remember	写入记忆(含 TTL)
memory_recall	检索,按相关性×重要性×新鲜度排序
memory_index	浏览清单,kind/tag/scope 过滤
memory_forget	按 id/tags 删除
memory_import	JSONL/JSON 批量导入
memory_reload	外部修改后重开合并

安装

cd ~/.dsh/profiles/<名字>
pnpm add dsh-agent-memory

# ~/.dsh/.agent-presets/<preset>/agent.cordis.yml
- id: memory
  name: 'dsh-agent-memory'

重启 DSH,新会话出现 6 个 memory_* 工具。前置条件:profile 已挂存储三件套(dsh-storage、dsh-storage-json、dsh-storage-domain——web profile 自带)。

质量

45 个单元测试全绿;真机(headless)冒烟通过;检索 top-1 命中 100%(9/9);400 条写入 45ms、召回 3ms。

提案

DSH 目前记忆能力是"文件型"(storage domain、session-query-sqlite、agent-instructions),动态记忆无处安放。本插件把这块补齐,建议官方纳入 packages/memory/*,欢迎以任何形式并入官方仓库。

[Electricitysheep]

记忆插件（embedding + 检索）是"官方没做社区全做"的 memory 家族新成员。

已收录进手册生态章节社区资产清单：https://github.com/Electricitysheep/dsh-handbook/blob/main/docs/07-ecosystem.md

[Culeot]

此帖已迁移至新帖 #1448(https://github.com/deepseek-ai/deepseek-harness/discussions/1448):内容已更新至 v0.7.2,含辩证记忆治理、自我纠错闭环、query-word 检索等全部最新特性。本旧帖保留供历史参考。