biubiu23333333/dsh-memory

dsh-memory

为 DeepSeek Harness（DSH）提供持久化三层记忆，
以宿主侧 bundle 插件形式实现：跨工作区存储、每回合强制自动沉淀、agent 可见的记忆工具，
以及一段让每个 agent 预设都主动使用记忆的系统提示词段落。

DSH 持久三层记忆宿主插件：跨工作区共享记忆库 + 每回合强制自动沉淀 + agent 记忆工具
+ 对所有预设生效的主动记忆引导。

能力 / What it gives you

| 需求 | 实现 |
|---|---|
| 长期记忆 | long-term/：profile / facts / decisions / projects（agent 用 memory_write 维护） |
| 短期记忆 | short-term/.md：每回合结束宿主自动追加原始流水 |
| 会话摘要 | episodes/.md：每回合结束宿主自动用 LLM 追加一句话要点 |
| 跨 workspace 共享 | 记忆根固定为 $DSH_HOME/memory（默认 ~/.dsh/memory），与任何工作区解耦；读写走宿主层，不受 agent 文件沙箱限制 |
| 强制自动沉淀 | 宿主监听 session/event 的 turn/end(completed)，回合自然结束即沉淀，不依赖 agent 自觉；无 LLM 可用时确定性摘要兜底 |
| 模型工具 | memory_read / memory_write / memory_search（宿主执行） |
| 主动记忆引导 | 注册 systemPrompt 段（host 层，对所有预设生效）：会话开始必读长期记忆、学到事实主动写入、答"你记得吗"先检索。无需任何 agent 预设 |

插件装在宿主层，任何预设（standard / minimal / 自建）的会话都自动获得全部记忆能力——
不需要选择"记忆模式"。

安装 / Install

1. 构建 tarball 并安装进目标 profile（reconcile 自动加入 bundle 层）
cd dsh-memory
pnpm pack
dsh plugin --profile web add ./dsh-memory-0.1.0.tgz

2. 重启 dsh web
systemctl restart dsh-web        # systemd 部署
或重新运行 dsh web

或者一键：./install.sh [profile]（默认 profile 为 web）。安装后记忆根自动初始化三层骨架。

记忆库布局 / Layout

$DSH_HOME/memory/
├── README.md
├── long-term/
│   ├── profile.md        # 用户画像
│   ├── facts.md          # 事实
│   ├── decisions.md      # 决定
│   └── projects.md       # 项目笔记
├── episodes/.md   # 自动：每回合追加一行 LLM 摘要
└── short-term/.md # 自动：每回合追加原始流水

根目录可用配置 root（profile patch 里给 dsh-memory 行加 config）或环境变量
DSH_MEMORY_ROOT 覆盖；legacyRoot 配置可把旧目录一次性并入。

开发说明 / Development notes

- 纯 ESM、零构建：package.json 声明 dsh.bundle.patch → cordis.patch.yml
在 profile root 插入一行，host 插件注册工具/事件/提示段。
- 依赖 @deepseek-ai/dsh-tools / dsh-llm / dsh-home-paths，运行时由 DSH
的 profiles module fallback 解析（无需自带依赖）。
- 自动沉淀：监听 session/event firehose（host 可靠接收）上的
turn/end(reason.kind === 'completed') → 追加 short-term 原始流水 → 尽力用
ctx.llm.stream 生成一句话要点追加 episodes；同 session+turn 去重，不阻塞事件流。
- 主动引导：ctx.systemPrompt.section({ name: 'dsh-memory', ... }) 在 host 注册，
因此注入到每个预设的 agent 系统提示。

License

MIT