前言¶
DeepSeek Harness (DSH) 的默认对话会话是无状态的。当会话结束或应用重启时,上下文会丢失。对于需要长期记忆、特定命名或隐私隔离的智能体开发场景,这会带来阻碍。dsh-memory 插件通过持久化存储解决了这些问题。
这是什么¶
dsh-memory 是一个静态 profile 插件,由开发者 hmlyx 维护,采用 MIT 许可证。它让 DSH 中的 AI 拥有持久记忆,支持记忆标签页管理、自动命名、多 AI 隐私隔离以及经验自动归档。
核心功能¶
插件提供以下核心能力:
- 记忆标签页:在对话视图中新增「记忆」标签,支持总开关、改名、文件浏览。
- 自动命名:内置 50 个不重复的 AI 名字库,可随机分配。
- 隐私隔离:记录分为私有(global、brief)和共享(shared、experience)两种模式,确保不同 AI 之间的数据隔离。
- 侧栏 AI 名:一键让所有会话侧栏显示各自 AI 的名字。
- 经验共享:通过只读方式共享解决过的问题,实现经验复用。
- 记忆归档:提供
memory_record工具,支持将内容归档为 global、shared、brief、event 或 experience 五种类型。
安装与启用¶
插件以静态 profile 形式安装,无需复杂的配置步骤。
-
放置仓库
将插件仓库放入 DSH 的 profile 目录:
~\.dsh\profiles\web\node_modules\dsh-memory\ -
修改依赖配置
打开~\.dsh\profiles\web\package.json,在dependencies字段中添加:
"dsh-memory": "3.0.0"
- 注册插件
在dsh.profile.bundles字段中添加:
"dsh-memory"
- 重启
重启 DeepSeek Harness 使配置生效。
典型用法¶
插件通过注入工具和 Prompt 指导 AI 进行记忆管理。
1. 使用记忆工具
AI 可调用 memory_record 工具写入记忆。kind 参数决定记忆的类型和可见性:
* global:全局私有记录。
* shared:全局共享记录(其他人可读)。
* brief:简要私有记录。
* event:事件私有记录。
* experience:经验共享记录(解决过的问题,可复用)。
2. 主动记录经验
* 在解决问题或学习技巧时,主动调用工具写经验。
* 在完成任务或开启新任务前,总结带标题的经验。
3. SystemPrompt 注入
在 systemPrompt 中注入 AI 名和记忆义务,无需用户提醒。
4. 标题还原
插件会自动管理侧栏名称。当会话结束时,侧栏名称会自动还原为原始标题。
适用场景与注意¶
- 适用场景:需要长期对话上下文、希望 AI 具备自我命名能力、或需要在不同预设间隔离隐私的开发者。
- 权限注意:插件以当前 DSH 进程的权限运行,请确保安装源可靠。
- 兼容性:与旧动态插件兼容,数据不会迁移或丢失。记忆文件默认存储在对话记忆目录下,可通过
.memory-state.json查看状态。
结尾¶
通过 dsh-memory,DSH 用户可以构建具备长期记忆和隐私隔离能力的智能体。该插件安装后重启即生效,适合任何预设使用。