跨会话记忆插件Bleed00/dsh-claude-mem

dsh-claude-mem

一个 DeepSeek Harness 插件，集成了 claude-mem：查询持久化的跨会话记忆，在会话开始时注入按项目划分的上下文，保存手动记忆，并驱动会话摘要生成——全部通过本地 claude-mem worker 的 HTTP API 完成。

npm
npm downloads
GitHub
CI
License
TypeScript
Node.js
DeepSeek Harness
dsh-plugin

它注册了面向模型的工具 mem_search、mem_timeline、mem_get_observations、mem_save 和 mem_context，mem-search 技能，以及生命周期钩子（agent/session-start 上下文注入、可选的 tools/post-execute 摄取、可选的 agent/turn-stopping 摘要生成）。它是一个单一的自包含包，没有仅限 monorepo 的依赖。

安装

使用 npx 的一行命令（无需全局安装——npx 会获取 dsh 启动器，而 dsh plugin 会将 add 转发给目标 profile 中的 pnpm）：

npx -y @deepseek-ai/dsh plugin --profile demo add @bleed00/dsh-claude-mem

如果你已经在 PATH 中有 dsh，则使用不带 npx 的相同命令：

dsh plugin --profile demo add @bleed00/dsh-claude-mem

npm（推荐——附带预构建的 lib/，无需构建权限）：

npx -y @deepseek-ai/dsh plugin --profile demo add @bleed00/dsh-claude-mem

GitHub（源代码；首次安装时运行 prepare 构建）：

npx -y @deepseek-ai/dsh plugin --profile demo add github:Bleed00/dsh-claude-mem

GitHub 安装获取的是源代码，而非构建产物，因此 pnpm 会运行此包的 prepare 脚本以从 src/ 构建。pnpm ≥10 在被加入允许列表之前会拒绝运行 git 依赖的 prepare；首次 add 会失败并指出修复方法——将 pnpm 打印的确切包键复制到该 profile 的 pnpm-workspace.yaml 中：

allowBuilds:
'@bleed00/dsh-claude-mem': true
然后重新运行 add。将该许可视为在安装时运行此包代码的权限；固定一个提交以实现可复现的安装：

dsh plugin --profile demo add github:Bleed00/dsh-claude-mem#

本地检出：

dsh plugin --profile demo add ./dsh-claude-mem

要求

- 已安装 DeepSeek Harness，且 dsh 位于 PATH 中。
- claude-mem worker 已在其默认端口（http://127.0.0.1:37700）上运行。可通过 baseUrl 配置或 DSH_MEM_BASE_URL 环境变量覆盖。

配置

| 字段 | 默认值 | 描述 |
|---|---|---|
| baseUrl | http://127.0.0.1: | Worker 基础 URL。 |
| timeoutMs | 30000 | 每个请求的超时时间（毫秒）。 |
| dedupe | true | 在查询结果中合并重复的观察记录（基于内容指纹，绝不基于身份）。 |
| platformSource | 未设置 | 可选的平台过滤器；省略 = 搜索所有记忆。 |
| project | 未设置 | 项目名称；默认为会话 cwd 的基名。 |
| injectContext | true | 注入会话启动上下文。 |
| ingest | false | 将观察到的工具结果保存为记忆。 |
| summarize | false | 在回合停止时总结会话。 |
| toolFilter.names | read, write, edit, bash | 当 ingest 为 true 时观察的工具。 |

平台范围界定是一种信号，而非限制：默认请求不过滤，platformSource 仅添加一个可选的过滤器。

重复处理

Worker 可能会多次持久化同一个观察记录（一条样板式的“会话已启动”记录，或一次重新运行的工具结果）——内容相同，但 id 不同。当 dedupe: true（默认值）时，查询结果会合并这些副本：观察记录的内容指纹由 title + subtitle + text + narrative + facts（规范化后）构建而成，因此仅仅共享一个生成的标题但在叙述上有所不同的两条记录会被保留。第一份副本（id 最小）会被保留。结构化结果（mem_get_observations）按指纹去重；渲染后的索引/文本结果按精确渲染行去重。将 dedupe 设为 false 可查看原始的、未过滤的结果。

在配置文件的 cordis.patch.yml 中覆盖配置的示例

- id: claude-mem
config:
baseUrl: http://127.0.0.1:37700
platformSource: dsh
ingest: true
summarize: true

工具

| 工具 | 用途 |
|---|---|
| mem_search | 搜索记忆；返回一个索引（id、标题、类型）。 |
| mem_timeline | 获取某条观察记录周围的上下文。 |
| mem_get_observations | 获取指定 id 的完整详情。 |
| mem_save | 保存一条手动记忆。 |
| mem_context | 渲染 worker 的会话启动上下文文本。 |

mem-search 技能教会模型 search → filter → fetch 工作流，以保持较低的 token 使用量。

开发

pnpm install
pnpm run build   # tsc + tsdown → lib/index.js
pnpm test
该包面向 Node ≥ 20.12、TypeScript 6.0，并基于 @deepseek-ai/* 框架包（cordis、schemastery、dsh-tools、dsh-llm、dsh-skill、dsh-agent）编写。

许可证

Apache-2.0 © Bleed00