前言¶

在 DSH 社区插件中，长期记忆可以作为一个独立能力接入。deepseek-harness-memory 把跨会话记忆保存在 markdown 文件中，并在会话启动时自动注入。下面介绍它的能力、安装方式、典型用法与注意事项。

这是什么¶

deepseek-harness-memory 是一个 Claude Code 风格长期记忆插件（dsh 版）。它由 2303572348 维护，许可证为 MIT，核心目标是提供跨会话持久记忆，并在会话启动时自动注入。

插件把记忆保存在纯 markdown 文件中，使用 MEMORY.md 索引和 YAML frontmatter，与 Claude Code 记忆格式 1:1 兼容。

核心能力¶

持久存储与自动注入¶

插件支持用户级记忆与工作区级记忆：

• 用户级：~/.dsh/memory
• 工作区级：~/.dsh/memory/projects/<key>/

每次 prompt 组装时，插件会把用户级和当前工作区级记忆索引注入系统提示词。这样模型可以在后续会话中继续引用之前保存的记忆。

memory 工具¶

插件提供 memory 工具，支持以下操作：

• add
• update
• delete
• list
• read
• import-claude

这些操作覆盖了记忆的日常增删改查，以及从 Claude Code 记忆导入。

Claude Code 记忆兼容¶

插件与 Claude Code 记忆格式兼容，并支持两种迁移方式：

• 自动回退：读取 ~/.claude/projects/<同key>/memory/ 与 ~/.claude/memory/。该读取为只读，不改原文件。
• 正式导入：通过 import-claude 把 Claude Code 记忆导入 dsh 侧。

多 checkout 记忆归一¶

同一项目如果存在多个 checkout，路径 key 可能不同。projectAliases 可以把多个路径 key 映射到统一 key，使多个 checkout 使用同一份记忆。

配置覆盖¶

插件可通过 cordis.patch.yml 覆盖 memory 行的 config。可覆盖的键包括：

• memoryRoot
• scope
• maxIndexLines
• maxIndexBytes
• maxList
• includeInPrompt
• importClaudeMemory
• projectAliases

安装与启用¶

常规安装¶

先安装 pnpm，因为 dsh plugin 依赖它：

npm install -g pnpm

在插件目录执行正式安装命令：

dsh plugin --profile web add .

执行完成后，重启 dsh web，插件生效。

无 pnpm 的兜底方式¶

如果暂不安装 pnpm，可以把 deepseek-harness-memory 目录复制到：

~/.dsh/profiles/node_modules/deepseek-harness-memory/

然后在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: memory
      name: 'deepseek-harness-memory'

升级与回滚¶

升级插件：

dsh plugin --profile web update deepseek-harness-memory

回滚插件：

dsh plugin --profile web remove deepseek-harness-memory

回滚后，记忆文件保留不删。

典型用法¶

维护记忆¶

在会话中要求模型使用 memory 工具，可以执行：

• add：新增记忆
• update：更新记忆
• delete：删除记忆
• list：列出记忆
• read：读取记忆

导入 Claude Code 记忆¶

自动回退只读 Claude Code 记忆时，需要依赖 importClaudeMemory 相关配置。

正式导入时，可以对模型说：

用 memory 工具 import-claude 导入记忆

也可以调用：

memory action=import-claude

配置 projectAliases¶

如果两个 checkout 需要共用同一项目记忆，可以在配置中加入：

projectAliases:
  C--work-my-project-a: my-project
  C--work-my-project-b: my-project

经过上面的配置，两个路径 key 会映射到同一个 my-project。

适用场景与注意¶

这个插件适合：

• 需要在 DSH 中跨会话保留记忆的用户。
• 已有 Claude Code 记忆，希望复用其格式或导入到 DSH 的用户。
• 同一项目有多个 checkout，希望共用一份记忆的用户。

使用前需要注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 记忆明文存储，勿存密钥/PII；README 明确绝不保存 API 密钥/密码。
• 无自动记忆提取；无 /memory、/toggle-memory 命令。
• lib/index.js 依赖 @deepseek-ai/dsh-tools 与 @deepseek-ai/schemastery，从 profile 的 node_modules 解析。

结尾¶

deepseek-harness-memory 提供了 DSH 侧的跨会话记忆能力，并把记忆组织成 Claude Code 兼容的 markdown 结构。经过上面的安装和配置，它可以在会话启动时自动注入记忆索引，也可以从 Claude Code 既有记忆中回退读取或正式导入。

目录页：https://www.skillhub.cn/plugins/2303572348/deepseek-harness-memory

GitHub：https://github.com/2303572348/deepseek-harness-memory