前言¶

本地智能体在运行过程中常面临上下文丢失的问题。传统的记忆方案往往依赖向量数据库或嵌入模型，增加了基础设施的复杂度。DeepSeek Harness（DSH）插件 dsh-memento 提供了一种基于文件的有界记忆方式，它不依赖嵌入、向量存储或 LLM 调用，仅通过文件系统管理状态，适合追求可控性和轻量化的本地开发场景。

是什么¶

dsh-memento 是一个 DeepSeek Harness 插件，由用户 janpauldahlke 维护。它为本地智能体提供有界文件记忆，核心数据存储在 ~/.dsh/memory/ 目录下，通过 ME.md（个人资料）和项目 MEMORY.md（项目记忆）进行注入，并辅以收件箱机制处理临时草稿。

核心功能¶

插件在 DSH Web UI 的右侧栏提供 Memory 界面，主要包含以下能力：

• 文件编辑与注入：通过右侧栏直接编辑 ME.md 和项目文件。编辑后的内容会作为注入层，供 Agent 在新会话中读取。
• 收件箱：提供临时的草稿区。在聊天中触发 Remember this: 或使用 memory_remember 工具时，内容会被追加到收件箱。收件箱是追加且永不注入的，仅供 Agent 读取。
• 人工提升：Agent 永远不会自动写入注入层。用户需要通过右侧栏将收件箱中的内容“提升”到 ME.md 或项目草稿中，保存后才会生效。
• 工具支持：
  • memory_remember：将一行文本追加到收件箱。
  • memory_history_search：对已结束的会话日志进行只读的“考古”搜索。

安装与启用¶

安装该插件需要 Node.js 版本 >= 20，并确保运行 DeepSeek Harness Web Profile。

dsh plugin --profile web add dsh-local-memento

安装后需要重启 dsh web 并刷新浏览器。

典型用法¶

1. 记录信息：在 DSH 聊天中输入 Remember this: <具体内容>，内容会进入收件箱。
2. 整理记忆：打开右侧栏的 Memory 界面，将收件箱中的行选中并点击“↑ promote”，将其移动到 ME.md 或项目文件中。
3. 查询历史：使用 memory_history_search 工具搜索之前的会话记录。

适用场景与注意¶

该插件适合需要明确记忆边界、不希望引入向量数据库或嵌入服务的本地智能体场景。

• 权限与来源：插件以当前 DSH 进程的权限运行。安装前建议检查源码与许可证（MIT）。
• 注入机制：记住 Agent 永远不会写入注入层（ME.md 等），所有提升操作必须由人工在右侧栏完成。
• 无 LLM 依赖：插件内部不进行 LLM 调用，所有逻辑基于文件读写。

结尾¶

dsh-memento 通过简单的文件系统操作，为本地智能体提供了一种可控的记忆管理方案。更多细节与源码，请访问：https://github.com/janpauldahlke/dsh-memento