Persistent memory for DeepSeek Harness with curated facts, automatic turn retention, and graph- and vector-ranked recall.
Install
# from npm (prebuilt)
dsh plugin --profile web add @yushenghai/dsh-memory-plugin
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:yushenghai1106/dsh-memory-plugin
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
面向 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 与工具服务。
与 Hermes 的记忆系统对比
关于 Hermes 的基础记忆、外部 Provider 生态，以及本插件的图谱和向量召回边界，请阅读从 Hermes 记忆系统到 DSH 持久记忆插件。
发布
pnpm install
pnpm run typecheck
pnpm run build
pnpm publish --access public
从 Git 安装时，prepare 会构建插件。使用者必须在其 Profile 的 pnpm-workspace.yaml 中显式允许该构建；使用已包含 dist/ 的 npm 发布包则不需要此授权。
Links
More in this category
vectorize-io/hindsight#coding-agents★ 51291
Hindsight, agent memory that learns: long-term project memory with auto recall and retain, knowledge pages, deep reflection, and per-repo memory banks.
volcengine/OpenViking#examples/dsh-memory-plugin★ 40273
OpenViking memory and context bundle for DeepSeek Harness: pre-step auto-recall and profile injection, session capture, `viking://` URI guarding, and recall/write memory tools backed by an OpenViking server.
agentscope-ai/ReMe#dsh★ 3646
Connects DeepSeek Harness to ReMe's local-first, self-evolving personal knowledge base: automatically captures completed main-agent conversations as user-owned Markdown memory, searches conversations and source material through reme_search with BM25, optional embeddings, and wikilink expansion, and schedules daily memory consolidation.
zilliztech/memsearch#MemSearch★ 2759
Shared Markdown memory for DSH and other coding agents, with automatic capture, pre-step context injection, searchable recall, and memory-to-skill self-evolution through a review panel.
vshulcz/deja-vu#extensions/dsh★ 1244
Reads the session files thirty-three other coding agents on this machine already wrote — Claude Code, Codex, Cursor, VS Code Copilot Chat, opencode, OpenClaw, Hermes, Kimi, Cline, Zed and more — including sessions from before it was installed: six tools (deja_recall, deja_session, deja_blame, deja_fix, deja_how, deja_remember), a /deja command, and optional automatic recall added to the runtime context. Local BM25 index, no LLM, no embeddings, no network (dsh plugin --profile web add dsh-deja).
adoresever/graph-memory★ 655
Traceable, searchable cross-session memory for DeepSeek Harness — conversation knowledge as typed graph nodes (TASK/SKILL/EVENT) and typed edges.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.