前言¶
DSH 智能体开发里有一个具体痛点：会话结束后上下文会被清空，之前确认过的事实、任务经验和环境信息不会自动保留。dsh-layered-memory 是 DeepSeek Harness（DSH）的跨会话长期记忆插件。它把值得留下的信息写成文件放在磁盘上，之后的会话再按需取回。
这是什么¶
该插件定位为 DSH 的记忆插件，仓库地址为 https://github.com/DDDFXYqiming/dsh-layered-memory，采用 MIT 授权。
它围绕以下能力提供服务：
- 跨会话长期记忆
- 命名空间隔离
- L1 索引注入
- L2 环境事实
- L3 任务经验
- BM25 全文检索
- 内容级近重复去重
- 跨命名空间提升
- 重试序列蒸馏
- 溯源
- 归档与回滚
- 自动维护
- 渐进式工具暴露
插件共提供 14 个记忆工具。它作为 DSH 插件运行，插件以当前 dsh 进程权限运行，安装前应先检查源码与许可证。
核心能力¶
先看工具暴露方式。progressive 模式下，Agent 按需调用一次 memory_activate，这批工具才进入它的工具列表。
下面按已核实的使用路径介绍几个关键工具：
1、memory_write
写入 fact/sop，evidence 必填。该插件要求只写成功验证过的信息。
2、memory_search
使用 BM25 全文检索，包含已归档条目。需要跨库查找时，可使用 all_namespaces。
3、memory_index
重建 L1 索引自动段，并保留 [RULES] 手动段。
4、memory_promote
用于跨命名空间提升，例如把项目局部经验提升到全局 default。
5、memory_update
用于同主题记忆演进。系统不做自动矛盾检测；一致性靠查重、memory_update、memory_maintain 合并候选、按时间线裁决保障。
6、memory_maintain
用于维护过程中的合并候选与一致性处理。
在写入边界上，已验证事实可压缩、迁移、supersede 或 archive，但严禁物理丢弃。插件也不存时间戳、PID、临时路径等易变状态。
安装¶
先确认运行环境：
Node >=22.19
peerDependencies 要求 @deepseek-ai/cordis >=4.0.0-rc <5 及多个 @deepseek-ai 包
从 GitHub 安装：
dsh plugin --profile web add github:DDDFXYqiming/dsh-layered-memory
本地开发时也可以直接使用仓库目录：
dsh plugin --profile web add <本目录>
典型用法¶
下面是一组可复现的调用顺序：
1、如果插件处于 progressive 模式，先让 Agent 调用 memory_activate，让这批记忆工具进入工具列表。
2、需要写入记忆时，调用 memory_write 写入 fact/sop。evidence 必填，只写成功验证过的信息。
3、需要查找记忆时，调用 memory_search 做 BM25 全文检索。检索范围包含已归档条目；需要跨命名空间查找时，使用 all_namespaces。
4、L1 索引需要重建时，调用 memory_index。该操作会重建 L1 索引自动段，并保留 [RULES] 手动段。
5、某条经验从项目局部上升到全局可用时，调用 memory_promote，将项目局部经验提升到全局 default。
开发与测试¶
开发环境可使用以下命令：
pnpm test
pnpm test:smoke
单元测试会 import @deepseek-ai/dsh-tools / @deepseek-ai/schemastery，这些是 DSH 内置包。
在 pnpm 11 预检环境中，可能因 DSH 私有包报 ERR_PNPM_FETCH_404。仓库建议/已配置 verifyDepsBeforeRun: false。
适用场景与注意¶
这个插件适合需要跨会话保留已验证事实、任务经验和环境信息的 DSH 智能体场景，尤其适合按命名空间隔离不同项目或工作区记忆的用法。
使用前注意几点：
- 插件以当前 dsh 进程权限运行，安装前应检查源码和 MIT 许可证。
memory_write的evidence必填，只写成功验证过的信息。- 不保存时间戳、PID、临时路径等易变状态。
- 系统不做自动矛盾检测，一致性依赖查重、
memory_update、memory_maintain合并候选和按时间线裁决。 - 已验证事实可以压缩、迁移、supersede 或 archive，但不应物理丢弃。
结尾¶
dsh-layered-memory 的价值在于把 DSH 会话中的已验证信息沉淀为可检索、可演进、可隔离的跨会话记忆。DSH 生态的理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应写成官方应用商店。
仓库地址：https://github.com/DDDFXYqiming/dsh-layered-memory。
