[Idea] dsh-memory：跨会话长期记忆插件（补上 memory 能力缺口）

[airbate]

看到 #14 在求 memory 能力，也确认了 packages/ 里目前没有独立的 memory 包。想提一个作为社区插件落地的方案，严格走「everything is a plugin」的 seam 设计。

定位

dsh-memory：给 agent 提供跨会话长期记忆。当前 agent 的上下文（session log、compaction、spill）都是「单会话内」的，会话结束后知识就没了；memory 补上「跨会话持久」这一环。

按 capability seam 三角色拆

Service Definition — ctx.memory：

interface MemoryService {
  remember(fact: string, opts?: { tags?: string[]; source?: string }): Promise<MemoryEntry>
  recall(query: string, opts?: { limit?: number }): Promise<MemoryEntry[]>
  forget(id: MemoryId): Promise<void>
}

Service Provider — 默认本地 JSONL store（存 Harness home 下），检索用轻量关键词 + 时间衰减排序，零重依赖；预留可换成向量库 / 远程的 provider。

Consumer（两处）：

• 模型可见工具 memory_add / memory_search，注册到 ctx.tools，schema 自动进入 prompt 组装；
• 自动注入：在 agent/pre-step 或 agent.inject() 处，按当前输入召回最相关的前 N 条，作为一段紧凑上下文注入。

符合仓库不变量

• 「model-visible ⟺ logged」：注入的记忆必须能从 session log 重建——把注入动作写成新的 session event，而不是在 prompt 里拼接不可追溯的文本。
• 纯插件、不动 agent-loop：所有挂点都是已文档化的扩展点（ctx.tools / agent/* / session event）。

为什么值得做

• 社区有直接需求（求一个memory能力 #14）；
• 官方仓库暂无 memory 包，缺口明确；
• 当前主流 agent harness 都在补 memory 能力，这是生态里能立刻产生差异化的一块。

落地方式

作为独立仓库（加 dsh-plugin topic）先出 MVP：本地 JSONL provider + 两个工具 + 自动注入；后续按反馈换 provider。

[Spirtxiaoqi7]

这个 capability seam 方向已经验证可以落地。我们实现了两个彼此独立的社区插件，和这里的 remember / recall / forget 架构高度重合，但在治理和 Prompt 策略上做了不同选择。

mindspace-dsh-session-memory 负责小而高优先级的结构化长期记忆：用户画像、分类偏好、AI 要求、关系/工作使命和扮演预设。模型通过显式工具追加、合并或覆盖冲突事实；用户能直接查看、编辑，活动有 append/merge/replace/skip 审计。存储按 Session 隔离，避免不同 Agent/窗口互相串记忆。

mindspace-dsh-local-rag 负责可搜索的大规模层：全局上传知识库 + 按会话隔离的 DSH 原生压缩摘要。它只在 compaction/end 提交后摄取并去重摘要，不把每轮原始对话写入库；模型通过标准 search_local_memory 工具自主检索。

和本提案最重要的差异是：我们刻意不做“每轮自动召回并注入 Prompt”。当前上下文永远优先，只有模型判断现有信息不足时才调用检索；召回结果标记为不可信参考资料，并保留来源、时间和轮次。这减少 Token 常驻成本，也避免旧记忆覆盖当前指令。

两套插件都不修改 agent-loop，可独立安装/卸载。实现与组合部署说明见 #1109，可以作为 ctx.memory 上游接口设计的一个实际运行参考。

[weijiafu14]

这个缺口现在还有一条已经跑通的路线：直接复用 Pi 生态现成的长期记忆插件，而不用先为 DSH 重写一套。

dsh plugin --profile web add pi2dsh@0.10.0
dsh plugin --profile web add pi-hermes-memory

pi-hermes-memory 通过 pi2dsh 的 Host ABI 在 DSH 中注册自己的记忆工具；我们已经做过真实跨进程验证：一个 DSH 进程写入，退出后由另一个新进程检索，能够召回同一条记忆。安装两个 npm 包即可，不改 DSH agent-loop，也不需要把 memory 私有逻辑塞进 Harness core。

这和本帖的 capability seam 并不冲突：官方/社区仍可以定义 DSH 原生 ctx.memory 服务；pi2dsh 提供的是另一条生态复用路径，让已有 Pi memory 实现今天就能成为 DSH 插件。项目与验证范围： https://github.com/weijiafu14/pi2dsh

[leenkcool]

#1728 可以自己提PR收录 。记得互相赞赏。

你这个挺好。