前言¶
在 DeepSeek Harness(DSH)里跑智能体时,会话之间的上下文默认不会自动保留。若希望「记住」的事实能在新会话里被召回,常见做法是接一层记忆服务,并通过 MCP 把工具暴露给 Harness。
SuperLocalMemory 是本地优先的智能体记忆层:任意支持 MCP 的 Harness 可以共用同一份记忆。dsh-superlocalmemory 并不实现记忆逻辑,只是把 SuperLocalMemory 以 stdio MCP 的形式挂到 DSH 官方 MCP 客户端插件上。下面介绍它的定位、安装方式与验证步骤。
这是什么¶
dsh-superlocalmemory 是 qualixar 维护的 DSH bundle(当前 package 版本为 4.2.11)。仓库说明将其描述为:通过 stdio MCP 把 SuperLocalMemory 接到 Harness 上的薄配置包。
bundle 内仅包含一条针对 @deepseek-ai/dsh-mcp-client 的配置:启动 slm mcp,使 SuperLocalMemory 的工具在 Harness 中以 mcp__slm__<tool> 的形式出现。该 bundle 采用 MIT 许可证;SuperLocalMemory 本体为独立项目,许可证为 AGPL-3.0-or-later,安装与使用须遵守其仓库条款。本 bundle 与 DeepSeek 无隶属或背书关系。
核心功能¶
- MCP 桥接:在 DSH 的
webprofile 中插入 id 为memory-superlocalmemory的 MCP 客户端行,transport为 stdio,command为slm,args为[mcp]。 - 工具命名:Harness 侧可见的工具前缀为
mcp__slm__,具体工具名由 SuperLocalMemory 的 MCP 服务提供。 - 可替换启动命令:若 Harness 进程环境中的
PATH找不到slm,可将配置里的command改为which slm得到的绝对路径。
记忆内容的存储、检索与策略均由 SuperLocalMemory(slm CLI)负责,本插件不包含记忆实现代码。
安装与启用¶
前置条件¶
- 已能运行 DeepSeek Harness(例如
npx @deepseek-ai/dsh web,参见 harness README)。 - 本机已安装 SuperLocalMemory,且
slm在 shell 的PATH中可用:
npm install -g superlocalmemory
# or: pipx install superlocalmemory
slm --version
安装 bundle¶
在 npm 包可用时,使用官方安装命令:
dsh plugin --profile web add dsh-superlocalmemory
在包尚未发布到 npm 时,README 给出的方式是从仓库目录本地添加(将路径换成你本机 clone 后的目录):
dsh plugin --profile web add ./dsh-superlocalmemory
安装后需重启 dsh web。bundle 会追加到对应 profile 的 bundle 列表,并通过 patch 插入如下 MCP 客户端配置(与仓库 cordis.patch.yml 一致):
- insert:
- id: memory-superlocalmemory
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: slm
transport: stdio
command: slm
args: [mcp]
若不想安装 bundle,也可把上述行复制到 $DSH_HOME/profiles/<name>/cordis.patch.yml,或单次启动时执行 dsh web --patch ./cordis.patch.yml。
典型用法¶
在 Harness 内确认插件已挂载¶
- 打开 Settings > Plugins > Plugin list,应能看到 id 为
memory-superlocalmemory的mcp-client条目,状态为 Mounted 且 Enabled。 - 开始一次会话。MCP 工具发现是异步的,需等待
mcp__slm__...相关工具出现在工具列表中。 - 按 Harness 文档 mcp-memory 指南 做写入与跨会话召回:在当前会话让智能体记住一条唯一事实,新开会话再询问是否仍能召回。
单独验证 MCP 服务¶
在不经过 DSH 的情况下,可确认 slm 的 MCP 模式能启动并等待 stdin 上的 MCP 消息:
slm mcp
适用场景与注意¶
适合谁:已在或计划使用 DSH web profile,并希望用本地优先、可被多个 MCP Harness 共享的记忆层时,可用本 bundle 减少手写 cordis.patch.yml 的步骤。
权限与安全:MCP 客户端以当前 dsh 进程的用户与权限启动 slm,记忆数据与文件访问范围取决于 SuperLocalMemory 与本机环境。安装前应阅读 GitHub 仓库 与 SuperLocalMemory 源码及许可证,确认符合你的合规与部署要求。
生态说明:DSH 社区插件目录(如 SkillHub)为独立站点,与 DeepSeek、幻方无官方从属关系;本介绍中的安装与配置均以 qualixar 仓库 README 为准。
结尾¶
dsh-superlocalmemory 的价值在于用一条官方 MCP 客户端配置把 SuperLocalMemory 接到 Harness,工具以 mcp__slm__* 暴露,便于在 DSH 里做跨会话记忆验证与日常使用。
- 目录页:https://www.skillhub.cn/plugins/qualixar/dsh-superlocalmemory
- GitHub:https://github.com/qualixar/dsh-superlocalmemory