前言¶
在 DSH（DeepSeek Harness）里做智能体开发时，一个常见问题是会话之间的上下文不容易沉淀：某条规约、某次会话总结、某段处理经验，当前会话能用，下一次会话不一定会自动带入。dsh-memory-manager 就是为这类问题提供的记忆管理插件。下面介绍它的定位、能力、安装方式和典型用法。
这是什么¶
dsh-memory-manager 是为 DSH 打造的记忆管理插件，由 tuanmaoOVO 维护，许可证为 MIT。它是宿主级插件，记忆库数据跨会话共享并存储于磁盘，用于把规约记忆、会话总结、上下文计划和 Agent 记忆工具接入 DSH。
核心功能¶
这个插件主要围绕“记忆库、注入计划、Agent 工具、面板与图谱”几件事展开。已核实的能力包括：
- 跨会话记忆库
- 文件夹记忆库（Obsidian 兼容）
- 不可变快照 + 可编辑标注层
- 记忆标签与启用开关
- 规约记忆自动注入
- 会话总结
- 上下文计划注入
- 6 个 Agent 记忆工具
- 印象（impressions）
- 组合（composedOf）与双向链接（backlink）
- 左侧力导向图谱双视图
- 完整对话侧栏面板
- 消息跳转（JumpReceiver）
- 跨工作区会话列表
- 设置页自由开关
- 非破坏性轮次排除 / 恢复
在使用上，可以先在记忆库中保存规约记忆或会话总结记忆，再按会话选择“加入计划”或打开“临时记忆模式”。如果记忆库中存在规约记忆或会话总结记忆，新会话会自动常驻注入。Agent 工具行为受 modelTools 与 enabled 双重门控，其中 memory_pin / session_inject 需要能确定当前会话。
安装与启用¶
安装前先确认本地已有 DSH 环境，并拿到 dsh-memory-manager 的仓库路径。插件安装命令使用本地文件路径，不是 GitHub 包路径：
dsh plugin --profile <profile名> add file:<本仓库路径>
执行完成后，重启 DSH。插件声明：
node >=18
启用后，DSH 设置页提供自由开关；Agent 工具行为还受 modelTools 与 enabled 双重门控。
典型用法¶
下面是一组按顺序可复现的操作。
1、在 DSH 所在环境执行安装命令：
dsh plugin --profile <profile名> add file:<本仓库路径>
然后重启 DSH。
2、在浏览器打开对话，点击输入栏左侧「记忆 · 已关闭」按钮打开侧栏面板。
3、在「记忆库」页把记忆「加入计划」，或在「计划」页打开「临时记忆模式」。
4、如果记忆库中存在规约记忆或会话总结记忆，新会话会自动常驻注入。
5、点面板头部的「图谱」按钮打开左侧力导向图谱浮层。
6、如需快速体验图谱与检索，可以把 libraryPath 指向：
examples/memory-library/
适用场景与注意¶
适合使用 dsh-memory-manager 的场景包括：
- 需要把规约、会话总结、长期经验沉淀为跨会话记忆库。
- 希望 Agent 通过记忆工具读写记忆，并按计划参与注入。
- 希望在浏览器侧栏面板和左侧图谱中查看、检索、跳转相关记忆。
- 需要非破坏性地排除或恢复某些轮次参与注入。
需要注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 它是宿主级插件，记忆库数据存储于磁盘并跨会话共享，配置
libraryPath时要确认路径可读写。 - Agent 工具不是无条件可用，受
modelTools与enabled双重门控；memory_pin/session_inject需要能确定当前会话。 - 安装命令中的
file:<本仓库路径>是本地文件路径，不要替换为未经确认的远程包路径。
结尾¶
经过上面的安装和启用步骤，dsh-memory-manager 可以把 DSH 中的会话经验从手工整理变成可管理、可注入、可检索的插件能力。先做记忆库体验，再做规约与会话总结注入，是接入它的一个稳妥路径。
GitHub 仓库：https://github.com/tuanmaoOVO/dsh-memory-manager
目录页：以插件线索为准；已核实资料未给出具体 URL。
