前言¶
本地智能体在运行过程中常面临上下文丢失的问题。传统的记忆方案往往依赖向量数据库或嵌入模型，增加了基础设施的复杂度。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 并刷新浏览器。
典型用法¶
- 记录信息：在 DSH 聊天中输入
Remember this: <具体内容>，内容会进入收件箱。 - 整理记忆：打开右侧栏的 Memory 界面，将收件箱中的行选中并点击“↑ promote”，将其移动到
ME.md或项目文件中。 - 查询历史：使用
memory_history_search工具搜索之前的会话记录。
适用场景与注意¶
该插件适合需要明确记忆边界、不希望引入向量数据库或嵌入服务的本地智能体场景。
- 权限与来源：插件以当前 DSH 进程的权限运行。安装前建议检查源码与许可证（MIT）。
- 注入机制：记住 Agent 永远不会写入注入层（ME.md 等），所有提升操作必须由人工在右侧栏完成。
- 无 LLM 依赖：插件内部不进行 LLM 调用，所有逻辑基于文件读写。
结尾¶
dsh-memento 通过简单的文件系统操作，为本地智能体提供了一种可控的记忆管理方案。更多细节与源码，请访问：https://github.com/janpauldahlke/dsh-memento
