前言¶
DeepSeek Harness（DSH）采用插件化架构，开发者常需要为智能体配置持久化记忆。现有的记忆方案往往涉及向量数据库或自动提取，配置较重。dsh-md-memory 插件提供了一种轻量级方案：模型将需要保留的内容写入 markdown 文件，宿主在会话中注入这些文件。这解决了跨会话记忆的简单需求，同时保持了文件的可读性和可控性。
插件简介¶
该插件由 CuteSamurai24 维护，开源协议为 MIT。它不自动提取聊天内容，也不依赖向量或全文引擎。记忆的写入完全由模型显式调用工具触发，确保了操作的透明度。
安装与卸载¶
插件默认开启。通过以下命令安装：
dsh plugin --profile web add github:CuteSamurai24/dsh-md-memory
安装后需要重启 dsh web 使其生效。
如需卸载，运行：
dsh plugin --profile web remove dsh-md-memory
注意：卸载插件不会删除 ~/.dsh/memory 目录下的文件。
文件结构与内容¶
记忆数据存储在 ~/.dsh/memory 目录下，结构如下：
~/.dsh/memory/
user.md 跨项目的用户信息、身份、基础偏好
agent/MEMORY.md 每次会话通用的热规则（保持简短）
agent/topics/*.md 按需加载的主题文件
在 Windows 系统上，路径对应 C:\Users\<你>\.dsh\memory\。你可以直接用文本编辑器打开这些文件进行查看、编辑或删除。
记忆工具与使用规范¶
插件提供统一的 memory 工具，支持以下操作：
- 读取类：
read、search、list - 写入类：
append、edit、write - 管理类：
create、delete
使用时需注意以下限制：
- 追加规则：向
user.md追加内容时，必须提供一个reason（一句话理由），说明为何这条信息在当前项目之外也成立。 - 容量限制：
user.md限制在 8KB，agent/MEMORY.md限制在 12KB，单个topics/*.md限制在 20KB。长材料应放入topics目录。 - 子代理限制：子代理无法写入记忆，这避免了并行任务中因并发写入导致的冲突。
限制与注意事项¶
该插件并非“第二大脑”，它不承担自动从聊天中提取信息的功能。此外：
- 安全性：不进行密钥扫描，不要让模型在此目录中写入敏感 Token。
- 搜索能力：
search功能仅支持简单的子串匹配，不支持向量检索或全文检索。 - 禁用方式：如需关闭，在
~/.dsh/settings.yaml中添加配置：
md-memory:
enabled: false
结语¶
dsh-md-memory 适合需要在 DSH 中保留简单文件记忆、且希望保持配置透明和轻量的场景。它通过显式的工具调用和文件存储，为开发者提供了一个可控的记忆层。
