@yushenghai/dsh-memory-plugin

面向 DeepSeek Harness 的持久记忆插件。它支持项目事实与用户偏好的人工维护、已完成对话的自动保留、收件箱异步预取、当前问题召回、可选语义向量，以及本地实体共现图。

架构图

flowchart LR
  用户消息 --> 收件箱事件[agent/inbox/inserted]
  收件箱事件 --> 预取[预取查询]
  用户消息 --> 预执行事件[agent/pre-step]
  预执行事件 --> 召回[召回当前问题]
  召回 --> 提供者注册表[记忆提供者注册表]
  提供者注册表 --> 本地提供者[本地记忆提供者]
  提供者注册表 -. 可选 .-> 外部提供者[外部记忆提供者]
  本地提供者 --> 存储域[storage-domain：事实、关系边、人工记忆]
  本地提供者 -. 可选 .-> 嵌入器[MemoryEmbedder 向量嵌入器]
  召回 --> 参考上下文[召回结果参考上下文]
  参考上下文 --> 模型请求[Harness 模型请求]
  模型请求 --> 停止事件[agent/turn-stopping]
  停止事件 --> 自动保留[保留已完成的用户与助手对话]
  自动保留 --> 提供者注册表
  记忆工具[memory 工具：添加、替换、删除、召回] --> 提供者注册表
  记忆工具 --> 存储域

本地提供者通过当前 Harness 存储后端持久化数据，并使用独立的 ysh_memory 存储域，因此不会与其它记忆插件共用记录。可选的嵌入插件提供向量排序；外部提供者则可通过公开注册表替换保留和召回实现。

安装

dsh plugin --profile default add @yushenghai/dsh-memory-plugin

插件会自动加入 cordis.patch.yml 层。可使用下面的命令检查最终组合：

dsh --profile default --dump-config

配置

provider: local 启用内置的持久化提供者。仅当另一个插件注册了匹配的 MemoryEmbedder 时才设置 embeddingProvider；它会增加语义向量排序，但不会替换本地图谱。

默认补丁配置了受限的人工记忆、最多 1,000 条动态事实、自动保留和 30 秒预取缓存。可在配置文件的 ysh-memory 条目中覆盖这些值。

配置项	默认值	作用
memoryCharLimit	2200	会话开始时注入的人工项目记忆最大字符数。
userCharLimit	1375	会话开始时注入的人工用户偏好最大字符数。
recallLimit	4	每次召回返回的最大事实数量。
recallMaxChars	6000	加入模型请求的召回参考上下文最大字符数。
maxFactCount	1000	保留的动态事实最大数量；超过后优先删除最早的事实。
semanticWeight	0.55	可选嵌入提供者的语义排序权重。
lexicalWeight	0.20	共享词项的排序权重。
entityWeight	0.15	精确实体匹配的排序权重。
graphWeight	0.025	已连接实体的图谱排序权重。
prefetchTtlMs	30000	收件箱预取结果的缓存时长（毫秒）。
autoRetain	true	是否将已完成的用户/助手对话保留为动态事实。
autoRetainMinUserChars	16	自动保留所需的最小用户消息字符数。
autoRetainMaxChars	4000	自动保留时用户与助手内容各自的最大字符数。

至少应有一个排序权重大于零。修改权重时，建议让它们的总和接近 1，便于理解相对排序效果。

兼容性

此插件面向 DeepSeek Harness 0.1.2-alpha.2 及更高版本。所选 Profile 需要包含 @deepseek-ai/dsh-base 提供的常规存储、Agent、LLM 与工具服务。

发布

pnpm install
pnpm run typecheck
pnpm run build
pnpm publish --access public

从 Git 安装时，prepare 会构建插件。使用者必须在其 Profile 的 pnpm-workspace.yaml 中显式允许该构建；使用已包含 dist/ 的 npm 发布包则不需要此授权。