DeepSeek Harness 接入记忆 MCP:为什么「它记住了」可能只是模型在复述?

简介: 给 DSH 接入记忆 MCP 时,最容易出现的误判是「它记住了」:同一会话里问它,对答如流;换一个会话,却一片空白。本文记录我在接入和验证时遇到的六个坑:三个示例默认全关、工具发现是异步的、同会话验证是假阳性、存储范围会悄悄漂移、关掉连接不等于删掉数据,以及 stdio 桥会剥掉像凭据的环境变量。

记忆 MCP 最容易让人误判的,不是它没工作,而是它「看起来工作了」。 我曾在同一个会话里让 agent 记住一个测试值,再问它,得到的回答完全正确。但这一步其实什么也证明不了:模型完全可以直接复述我刚才说过的话。

环境:DeepSeek Harness Desktop(通过 Cordis overlay 加载 MCP)、macOS。示例来自官方记忆 MCP 指南,全部依赖第三方服务器。DSH 只负责启动 stdio 子进程或连接 Streamable HTTP 服务、发现工具,并以 mcp__<serverName>__<tool> 的形式暴露工具。

先说清责任边界:存储和提供方特有行为由提供方负责。 DSH 不下载服务器、不初始化数据库、不选 embedding、不建账号、不迁移数据,也不监管独立的 HTTP 服务。HTTP 服务必须提前运行;stdio 子进程则随插件生命周期启动和停止。下面按发现顺序记录我实际踩到的六个坑。

坑一:三个示例默认都关闭

随附的三个组合默认一个也没启用。要使用哪个示例,就传入对应的 overlay:

dsh web --patch "$PWD/apps/cli/config/examples/mcp-memory/mcp-reference-memory.cordis.yml"

先安装固定版本的服务器:

npm install --global @modelcontextprotocol/server-memory@2026.7.4

三个示例的传输方式和默认存储位置各不相同,选择前先确认:

示例 前置条件 默认存储位置
Memorix stdio;Node 22.18+ 和 memorix@1.3.0 ~/.memorix/data,按 DSH 工作目录识别 Git 项目
MCP Reference Memory stdio;@modelcontextprotocol/server-memory@2026.7.4 $HOME/.dsh-mcp-reference-memory.jsonl,本地知识图谱
Engram stdio;Go 1.25.10+ 和 v1.20.0 安装方式,或匹配的二进制 ~/.engram,按 DSH 工作目录识别 Git 项目

还有几处容易想当然:Memorix 提供本地启发式模式,不需要模型或 embedding 服务;Reference Memory 存储实体、关系和观察,搜索只对名称、类型和观察做大小写不敏感的子串匹配,没有语义检索、没有 embedding、没有自动摘要、没有冲突解决,也没有遗忘策略;Engram 自己负责存储和项目选择。以上都是文档中对应固定版本的行为,不能推广到其他版本或服务器。

坑二:工具发现是异步的

客户端通过异步方式发现工具。服务启动后立刻发送提示词,很可能早于工具注册完成,于是看到的是「工具不存在」,而不是「服务没起来」。这两种情况的排查方向完全不同:

  • 工具一直没出现:检查 overlay 是否生效、服务器是否安装、插件配置是否正确;
  • 工具出现了但调用失败:查看服务器自己的输出,确认子进程是否崩溃或正在重连;
  • 搜索成功但没有结果:对照写入时实际使用的文件、目录或项目标识。

因此,第一步永远是等 mcp__... 工具出现,再判断记忆是否生效。

坑三:同会话回答正确,是假阳性

这是我花时间最多的一步。正确的验证方式是两个会话、同一存储范围:

  1. 会话 A:让 agent 记住一个唯一且不敏感的测试值,确认它调用了写入工具并返回成功;
  2. 在同一运行中的 Host 新建会话 B,不复制会话 A 的对话;
  3. 在会话 B 要求查询该值,确认它调用了搜索或召回工具,并核对结果;
  4. 在会话 B 继续问一个需要用到该值的问题,看回答。

这样才能区分「持久召回」和「模型复述当前对话里已有的信息」。新建会话只改变对话历史,不需要重启 Host。

也要留意验证的适用范围:即使这样验证通过,也只证明这个值在当前存储范围下的测试结果,不保证所有后续请求都会使用记忆。指南中的可选模型指令只是行为提示(用户要求记住时写入、历史可能相关时搜索),并不强制调用。

坑四:存储范围会悄悄漂移

两个会话的测试要有效,前提是存储范围不变。如果提供方按工作目录识别项目,而你在两次测试之间换了目录,访问的就不再是同一个库。结果看起来像「写入丢了」,实际是查错了地方。

排查前先记录三项:使用哪个提供方、配置从哪一层生效、数据实际落在哪里。存储位置可以这样覆盖:

提供方 覆盖方式
Reference Memory MEMORY_FILE_PATH
Memorix MEMORIX_DATA_DIR
Engram ENGRAM_DATA_DIR、ENGRAM_PROJECT

改完位置或项目标识后,先用新的测试值重新走一遍写入和读取,再迁移真正的工作流。

坑五:关掉连接 ≠ 删掉数据

这两件事很容易混淆。关闭连接,只是移除 DSH 这一侧的 client:

  • 只在命令行传入 overlay:下次启动时省略它即可;
  • 已合并进持久 patch:从对应层移除那一条 insert,按需重新加载或重启,其余 patch 保留。

持久位置有两个:profile 级 $DSH_HOME/profiles/<name>/cordis.patch.yml 和机器级 $DSH_HOME/cordis.patch.yml。编辑前先查看已有内容,把目标插入合并进去,不要覆盖整个文件;以后关闭时也只删除那一条。

但数据仍由提供方保存。指南把存储完全交给提供方,没有定义通用删除流程:删除前要查提供方文档,也要检查备份和其他使用同一存储的客户端。一个 DSH profile 停用 overlay,不代表同机其他进程读不到那份存储。

坑六:stdio 桥会剥掉环境变量

stdio 桥在启动子进程前,会移除名称通常表示凭据的环境变量,以及所有 DSH_* 变量。但其他环境变量仍然继承,这不能作为安全保证。

上游密钥应通过配置项 config.env 传入,不要明文写进 YAML:

config:
  env:
    UPSTREAM_API_KEY: ...   # 由环境或密钥管理注入,不写死在文件里

环境过滤可以减少意外泄漏,但不能证明任意服务器代码是安全的。需要检查服务实际接收和持久化了什么。

失败与恢复:崩溃之后会发生什么

MCP 子进程崩溃后,指南描述的处理方式是退避重连并重新同步工具:故障期间调用会失败;重试预算耗尽后,工具会被注销,直到重新加载或重启。

因此,排查「工具消失了」时要区分两种情况:一是插件配置或安装有问题(工具从一开始就不该出现);二是子进程崩溃且重试预算耗尽(工具先出现,后来才消失)。查看服务器输出和崩溃日志,可以区分这两种情况。

我用的验证清单

  1. 传入 overlay 了吗?服务器安装的是文档中那个固定版本吗?
  2. mcp__... 工具出现了吗?(没出现就先别往下走)
  3. 会话 A 写入成功了吗?核对工具返回值,不要只看模型的自然语言回复。
  4. 会话 B 是新会话,且没有复制前面的对话吗?
  5. 两次测试的存储范围(文件、目录、项目标识)一致吗?
  6. 召回失败时,先区分「工具没出现 / 调用失败 / 搜索无结果」这三种情况,再修改配置。
  7. 数据位置或项目标识改动后,用新的测试值重新跑一遍写入和召回。
  8. 分开处理关连接和删数据;删除前查提供方文档和备份。

安全边界(这段不能省)

  • 示例不代表背书,也不是安全认证。服务、依赖、存储和数据处理方式都要自行评估。
  • 首次测试只用唯一且无害的值,不要把真实密钥、私人信息或第三方数据放进测试提示词。
  • 工具出现或一次测试成功,都不能证明敏感数据适合存进去;要查第三方的保留和访问策略。
  • 团队共享机器上要注意文件权限和同机其他客户端。
  • 升级服务器或更换提供方后,安装要求、数据位置和身份选择都要重新确认,再重跑写入和新会话召回。
  • 三个提供方的存储方式和检索能力各不相同,一个提供方的结论不能套用到另一个上。

真正决定这套东西能不能用的,不是「它能不能记住」,而是你是否说清楚了存储范围、删除路径和访问权限。记忆一旦写进第三方存储,就从「对话里的一句话」变成了「一份需要治理的数据」。


相关阅读

本文由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
文中引用的插件与 MCP 文档收录于:https://dsh-plugin.com/zh/blog

目录
相关文章
|
7天前
|
网络协议 JavaScript 开发工具
DSH 接入内网 MCP 踩坑记录:OAuth 代理与三层静默失败
自带的 MCP 插件只支持 stdio 与静态 header,接不了必须走 OAuth 的内网服务;用 mcp-remote 做 stdio 代理补上这一层之后,剩下的时间全部花在插件加载体系的三层静默失败上:模块解析域、insert 语义、YAML 缩进。全文附 10 条坑、可复用检查清单和三样取证工具。
139 1
DSH 接入内网 MCP 踩坑记录:OAuth 代理与三层静默失败
|
1月前
|
缓存 开发工具 git
DSH skill 怎么安装、放在哪个目录?DeepSeek Harness 技能与插件的区别与用法
dsh skill 不是插件:它是给模型的可加载 Markdown 指令集,由本地提供方按 rank 扫描六个根目录发现,用 dsh plugin add 装不进去。本文讲清六个根目录的优先级、SKILL.md 写法与两个调用开关。
2624 4
DSH skill 怎么安装、放在哪个目录?DeepSeek Harness 技能与插件的区别与用法
|
8月前
|
存储 人工智能 NoSQL
理解 Agent 记忆:从无状态模型到持久化记忆架构
大语言模型本质无状态,对话历史无法自动留存。Agent需长期记忆支撑连续性任务,但简单堆砌上下文不可行。本文系统阐释Agent记忆的四层架构(工作/情景/语义/程序记忆),及其写入、检索与遗忘机制,并对比Mem0、Letta等主流方案,揭示记忆正成为AI Agent技术栈中独立、标准的关键基础设施。
1675 7
理解 Agent 记忆:从无状态模型到持久化记忆架构
|
8月前
|
传感器 存储 机器学习/深度学习
Agent架构综述:从Prompt到Context
本文剖析Agent技术从Prompt驱动到Context核心的演进本质:Prompt是静态任务入口,Context则是动态智能基座。文章系统梳理三阶段架构升级(V1.0至V3.0),解析五大核心层级与四大关键技术支柱,并指出轻量化、跨Agent协同、端到端驱动等未来方向。
884 2
|
6月前
|
存储 缓存 人工智能
缓存输入便宜120倍,DeepSeek V4 怎么做到的
DeepSeek V4创新采用CSA+HCA混合注意力架构,支持1M超长上下文,并通过KV缓存压缩、磁盘存储与智能命中复用,大幅降低prefill成本。其Pro版未命中/命中输入价差达120倍,显著高于竞品,真正实现长上下文“又便宜又高效”。
1492 0
缓存输入便宜120倍,DeepSeek V4 怎么做到的
|
7月前
|
存储 设计模式 人工智能
从无状态到有状态:长时运行 Agent 的 5 种架构模式
本文详解长时运行AI Agent的5大生产级架构模式:Checkpoint-and-Resume实现断点续传;Delegated Approval支持原地暂停与人机协同;Memory-Layered Context分层管理长期记忆与工作记忆;Ambient Processing赋能无提示事件驱动;Fleet Orchestration实现多Agent协同治理——让Agent真正成为可靠、有状态、可运维的系统进程。
966 3
从无状态到有状态:长时运行 Agent 的 5 种架构模式
|
5月前
|
人工智能 自然语言处理 前端开发
Hermes Agent与Claude Code协同开发完整指南:架构、阿里云部署与实战案例
在AI驱动软件开发的成熟阶段,单一代码工具很难覆盖需求拆解、流程管控、经验沉淀、代码实现、测试调试全链路工作。Hermes Agent作为具备长记忆、自主任务调度、自我进化能力的智能主控,搭配Claude Code专业代码生成、重构、调试工具,能够形成类似企业“技术主管+资深开发工程师”的硅基协同团队,完整覆盖从自然语言需求到可运行代码的端到端开发闭环。依托阿里云Dev云开发机、轻量应用服务器两种部署载体,普通开发者与企业团队均可零复杂配置快速搭建这套AI研发体系,同时兼容阿里云百炼全系列大模型服务,下文从架构分工、部署渠道、完整配置、标准工作流、实战案例、配套资源几个维度完整讲解。
709 0
|
5月前
|
人工智能 API C++
OpenCode vs Claude Code:一文看懂两者的核心区别与选型建议
本文深度解析2026年两大主流AI编程工具——闭源旗舰Claude Code与开源标杆OpenCode的本质差异:非模型之争,而是“极致体验”与“绝对自由”的产品哲学分野,助开发者精准选型。
|
5月前
|
人工智能 自然语言处理 数据可视化
企业如何应用智能客服?瓴羊Quick Service用好智能客服系统落地应用策略
本文剖析智能客服“上线即吃灰”困局,提出瓴羊Quick Service四大落地策略:结构化知识构建、人机协同坐席辅助、数据驱动效果评估、组织保障运营机制,助力企业从“可用”迈向“好用”,实现服务数智化升级。(239字)

热门文章

最新文章