dsh-memory：DeepSeek Harness 持久三层记忆插件

DeepSeek Harness (DSH) 生态强调“一切皆插件”。在开发智能体时，如何在多轮对话中保留上下文、在跨工作区场景下共享记忆，是常见需求。dsh-memory 是一个宿主端 bundle 插件，旨在为 DSH 提供持久化的三层记忆能力，并解决手动管理记忆带来的维护成本问题。

插件定位¶

该插件由 biubiu23333333 维护，开源协议为 MIT。它以宿主 bundle 的形式运行，负责跨工作区的存储、每回合结束后的强制自动沉淀、以及向 Agent 提供记忆操作工具。它通过系统提示段的注入，让所有预设智能体都能主动使用记忆功能。

核心能力¶

• 三层记忆结构：构建长期记忆、短期记忆和会话摘要三层结构。
• 跨工作区存储：记忆根目录固定为 $DSH_HOME/memory（默认 ~/.dsh/memory），与具体工作区解耦。
• 强制自动沉淀：监听 turn/end(completed) 事件，回合结束后自动执行整合，无 LLM 可用时采用确定性兜底机制。
• Agent 记忆工具：提供 memory_read、memory_write、memory_search 三个工具供 Agent 调用。
• 主动记忆引导：对所有预设生效的系统提示段，引导 Agent 读写记忆。

安装与启用¶

执行以下命令构建并安装：

cd dsh-memory
pnpm pack
dsh plugin --profile web add ./dsh-memory-0.1.0.tgz

安装后，记忆根目录会自动初始化三层骨架。

典型用法¶

• 自动生效：无需在预设中选择“记忆模式”，任何预设（standard / minimal / custom）在会话中自动获得记忆能力。
• 记忆维护：Agent 通过 memory_write 维护长期记忆；Host 在每回合结束后，将原始日志追加到 short-term/<sessionId>.md，并利用 LLM 生成一句话摘要追加到 episodes/<sessionId>.md。
• 存储布局：

  $DSH_HOME/memory/
  ├── long-term/     # profile / facts / decisions / projects
  ├── short-term/    # 原始日志流水
  └── episodes/      # LLM 生成的会话摘要

开发与注意事项¶

• 零构建：纯 ESM 实现，无需构建步骤。
• 运行时依赖：依赖 @deepseek-ai/dsh-tools、dsh-llm、dsh-home-paths，由 DSH 的 profiles module 解析。
• 事件监听：Host 需监听 session/event firehose 上的 turn/end(completed) 事件。

dsh-memory 通过宿主层插件的方式，解决了智能体记忆持久化和跨工作区共享的问题，实现了低成本的记忆自动化。更多详情与源码可参考 GitHub。