dsh-superlocalmemory:在 DeepSeek Harness 中通过 MCP 接入 SuperLocalMemory

前言

在 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 无隶属或背书关系。

核心功能

  1. MCP 桥接:在 DSH 的 web profile 中插入 id 为 memory-superlocalmemory 的 MCP 客户端行,transport 为 stdio,command 为 slm,args 为 [mcp]。
  2. 工具命名:Harness 侧可见的工具前缀为 mcp__slm__,具体工具名由 SuperLocalMemory 的 MCP 服务提供。
  3. 可替换启动命令:若 Harness 进程环境中的 PATH 找不到 slm,可将配置里的 command 改为 which slm 得到的绝对路径。

记忆内容的存储、检索与策略均由 SuperLocalMemory(slm CLI)负责,本插件不包含记忆实现代码。

安装与启用

前置条件

  1. 已能运行 DeepSeek Harness(例如 npx @deepseek-ai/dsh web,参见 harness README)。
  2. 本机已安装 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 内确认插件已挂载

  1. 打开 Settings > Plugins > Plugin list,应能看到 id 为 memory-superlocalmemory 的 mcp-client 条目,状态为 Mounted 且 Enabled。
  2. 开始一次会话。MCP 工具发现是异步的,需等待 mcp__slm__... 相关工具出现在工具列表中。
  3. 按 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜