前言¶
在 DSH 的多会话工作流里，常见的问题是：用户偏好、已验证步骤和失败教训没有稳定载体，新的会话又要重新说明。已有做法通常是把上下文复制到提示词，或手动维护一份笔记；这种方式依赖人工更新，也容易遗漏。
下面介绍 dsh-memory。它是面向 DeepSeek Harness（DSH）的长期记忆插件，用于把已完成会话中的可复用信息抽取出来，形成摘要与记忆文件，并注入后续会话。
这是什么¶
dsh-memory 是一个记忆类插件，仓库为 yan5236/dsh-memory，许可证为 MIT。
它解决的是 DSH 会话之间的长期记忆问题：会话结束后做结构化抽取，达到冷却后全局整合，随后把摘要常驻注入到会话中，并提供记忆查询与添加工具。
该插件需要 DeepSeek Harness。它通过 GitHub 分发，而不是 npm；package identifier 为 @nanmicoder/dsh-memory。
核心功能¶
下面列出已核实的几项能力：
- 会话结束后按会话抽取结构化记忆，默认防抖窗口为 3 分钟。
- 达到冷却后，全局整合新的 raw memories 到
MEMORY.md和memory_summary.md，默认冷却为 6 小时。 memory_summary.md作为摘要常驻注入每个会话。- 提供
memory_list、memory_read、memory_search、memory_add四个记忆工具。 - 会话内容按数据处理，输入输出进行脱敏，记忆路径限制在 memory root。
- 使用持久化 claim 避免重复抽取或重复整合；失败后带退避重试。
- 提供 Settings → Long-term memory 页面，用于查看统计、手动运行和配置。
- 提供记忆管理器，支持文件树、编辑和两步删除。
- Phase 1 和 Phase 2 可分别设置
off/low/high/max推理 effort。
其中，memory_add 仅在用户明确要求时写入。
安装与启用¶
先确认 DSH 环境可用。下面以 web profile 为例。
在终端执行安装命令，把插件添加到 web profile：
dsh plugin --profile web add 'git+https://github.com/yan5236/dsh-memory.git#main'
安装后先做配置验证，确认插件已经进入 profile：
dsh --profile web --dump-config
输出中应包含：
- id: dsh-memory
如果 dump-config 缺少这一行，需要将 @nanmicoder/dsh-memory 加入 profile 的 dsh.profile.bundles 数组。
经过上面的步骤，启动 DSH：
dsh web
启动后打开：
Settings → Long-term memory
记忆文件默认位于：
$DSH_HOME/memories/
典型用法¶
启用插件后，可以从页面和会话工具两处使用。
在 Settings → Long-term memory 页面，可以查看统计、手动运行和配置插件。常见配置项包括：
memoryRoot
provider
model
consolidationCooldownMs
idleDebounceMs
maxRolloutsPerRun
maxSummaryChars
其中，memoryRoot 对应记忆文件根目录，默认路径为 $DSH_HOME/memories；consolidationCooldownMs 对应全局整合冷却时间，默认值为 6 小时；idleDebounceMs 对应会话结束后的防抖窗口，默认值为 3 分钟。
在 DSH 会话中，模型可以使用四个记忆工具：
memory_list
memory_read
memory_search
memory_add
memory_add 不是自动写入工具，仅在用户明确要求时写入。
另外，也可以将 README 中的 one-prompt install 代码块粘贴到 DSH 会话中，由 agent 执行安装、注册和验证。如果某一步写入 $DSH_HOME/profiles 被权限策略阻止，应请求用户切换 Full access 或批准操作，不得绕过或静默失败。
适用场景与注意¶
这个插件适合需要跨会话保留偏好、步骤和失败教训的 DSH 使用者，尤其是使用 web profile、希望减少重复说明并保留可查询记忆文件的场景。
使用前注意以下几点：
- 该插件以当前 DSH 进程权限运行，因此会读写 DSH 相关文件。
- 安装前应检查源码和许可证；许可证为 MIT。
- 插件通过 GitHub 分发，不是 npm 包；package identifier 为
@nanmicoder/dsh-memory。 package.json声明engines.node为^22.19.0 || >=24.0.0。- 社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系；不要把插件分发源理解为官方应用商店。
- 本文资料中未提供可验证的目录页 URL；仓库地址为
https://github.com/yan5236/dsh-memory。
结尾¶
dsh-memory 的核心价值是：把会话中的可复用信息抽成长期记忆，通过摘要注入和四个记忆工具，让后续会话减少重复指令。经过安装、验证和启动后，可以在 Settings → Long-term memory 页面查看统计、手动运行和配置。仓库地址：https://github.com/yan5236/dsh-memory。
