DeepSeek Harness (DSH) 的智能体开发中,会话记忆通常随进程重启而丢失。dsh-memory-panel 插件为每个会话提供了持久化、可搜索的记忆,并支持自动注入到系统提示词中。
核心功能¶
该插件为 DSH 提供了一套完整的记忆管理能力,主要包含以下部分:
- 模型工具:
memory_save(创建或更新条目)、memory_search(关键词搜索)、memory_list(按标签过滤列表)、memory_get(读取条目)、memory_delete(删除条目)。 - 自动注入:
memory:recall。插件会自动将排名前 6 的记忆注入到智能体的系统提示词中,并在记忆被标记为[重要]时高亮。 - 管理面板:通过设置菜单中的“记忆”入口,提供可视化的浏览、搜索、创建、编辑和删除功能。
- JSON API:提供
/memory/api/*路由,用于面板与主机的通信。
安装¶
使用官方 CLI 进行安装,无需手动修改配置文件:
dsh plugin --profile <profile-name> add dsh-memory-panel
用法示例¶
作为模型调用工具时,可以直接使用以下接口:
1、保存一条记忆
memory_save(title='User prefers Chinese thinking', content='...', tags=['preference'], importance='high')
2、搜索记忆
memory_search(query='Chinese thinking')
3、列出特定标签的记忆
memory_list(tag='preference')
4、读取完整内容
memory_get(id='m...')
5、删除记忆
memory_delete(id='m...')
工作原理¶
- 存储位置:记忆数据保存在用户主目录下的
.dsh-memory文件夹中,文件名为memories。重启进程后数据依然存在。 - 挂载方式:插件被挂载在 DSH 配置的用户层,因此无论当前激活哪个智能体预设,这些工具对所有会话可见。
- 并发处理:写入操作通过串行化链路执行,避免文件并发写入冲突。
- 排名逻辑:评分权重为 标题 (×3) > 标签 (×2) > 内容 (×1)。中文查询会进行双字分词匹配。
- 刷新机制:记忆缓存每 30 秒自动刷新,或在保存/删除操作时立即刷新。
注意事项¶
- 运行环境:需要 Node.js 版本 >= 20。
- 文件权限:请确保主机进程对用户主目录下的
.dsh-memory文件夹有写入权限。