前言¶

Agent 在 DeepSeek Harness 中完成一次任务后，默认不会把项目背景、规则约束和后续纠正自动带到下一次会话。如果你希望新会话能带着上下文开工，同时又希望记忆数据仍以 Markdown 留在本机，zhujunpeng12/dsh-memory-system 是一个可以评估的 DSH 插件。

它把记忆数据放在本机 Markdown，默认使用 ~/.dsh-memory/，也可以把 MEMORY_VAULT 指向自己的 Obsidian Vault。

这是什么¶

dsh-memory-system 是 zhujunpeng12 维护的 DeepSeek Harness 记忆插件，许可证为 MIT。

它解决的问题是：让 DSH 跨会话记住项目、规则和纠正，同时避免引入数据库、向量服务或外部服务依赖。它不依赖后台 LLM、不依赖向量检索，也不要求必须使用 Obsidian、数据库或外部 API。

核心能力¶

启动热记忆¶

新会话开始时，系统先注入一个有预算的热包，而不是让 Agent 先翻完整记忆库。热包限制在 ≤14KB，用于让 Agent 在不读全库的情况下带着上下文开工。

可以使用 memory_bootstrap 工具，或在仓库目录运行：

python vault-guard/bootstrap.py --cwd <项目目录> --max-bytes 14000

推荐插件形态通过原生 agent/pre-step 在每个 session 首轮自动执行。

中文冷层召回¶

当任务需要历史细节时，再触发冷层召回。它使用 exact 匹配、中文 bigram BM25 和元数据重排，输出限制在 ≤4.2KB 的冷包，并附 trace。向量检索默认关闭。

可以使用 memory_recall 工具，或运行：

python vault-guard/recall.py --query <问题> --cwd <目录> --force

授权写入¶

写入不是自动发生。memory_write 默认 dry-run，用户确认后才落盘。

落盘过程使用以下机制：

• 30s 租约单写锁
• 5s 心跳
• before-image
• SHA-256 前置条件
• manifest
• receipt

raw 记录只追加，纠错必须使用 supersedes。

使用 memory_write 时，操作类型可以是 op=raw/replace/recover；只有 apply=true 时才落盘。

治理只读¶

memory_govern 用于扫描记忆库中的候选问题，包括：

• 重复
• 冲突
• 过期
• 体量
• 规则生命周期候选

它只读，默认不写。晋升、归档、删除永远需要人确认。

可以运行：

python vault-guard/govern.py --json --max-items 100

轨迹复盘¶

memory_trajectory_review 只读扫描会话轨迹，以用户纠正作为硬信号，产出复盘候选。它不是自动判错，也不是自动写入记忆库。

可以运行：

python vault-guard/trajectory-review.py --cwd <目录>

安装与启用¶

安装前提¶

安装前确认环境中已有：

DeepSeek Harness 0.1.0-rc.7
Node.js 22/24
Python 3.10+

安装命令¶

下面命令把仓库安装到 web profile：

npx @deepseek-ai/dsh plugin --profile web add github:zhujunpeng12/dsh-memory-system

安装完成后，重启 Harness。

启用确认¶

重启后，在新会话让 Agent 运行 memory_gate，并确认新会话收到：

[vault-bootstrap]

这一步用于确认热记忆注入链路是否生效。

典型用法¶

1、重启 Harness 后，先确认新会话收到 [vault-bootstrap]。

2、需要手动注入热包时，运行：

python vault-guard/bootstrap.py --cwd <项目目录> --max-bytes 14000

3、需要查找历史规则、项目约定或纠正记录时，运行：

python vault-guard/recall.py --query <问题> --cwd <目录> --force

4、需要写入持久内容时，先用 memory_write 做 dry-run 预览，确认无误后再让 apply=true 落盘。

5、怀疑记忆库有重复、冲突、过期或体量问题时，运行：

python vault-guard/govern.py --json --max-items 100

6、收尾阶段需要基于会话轨迹产出复盘候选时，运行：

python vault-guard/trajectory-review.py --cwd <目录>

适用场景与注意¶

适合¶

适合以下情况：

• 希望 DSH 跨会话记住项目、规则和纠正
• 希望记忆源是 Markdown，可用编辑器审阅
• 希望中文历史召回可解释，并能看到 trace
• 希望写入有 dry-run、确认和可恢复机制
• 希望记忆数据留在本机，而不是进入数据库或外部服务

不适合¶

不适合以下场景：

• 多租户服务端
• 高频多写者
• 默认语义向量
• 全自动无审批记忆写入

安全与权限¶

dsh-memory-system 的仓库只包含机制，不包含任何个人数据。画像、规则、事件和项目笔记应始终留在使用者本机。

使用前建议检查源码、许可证和写入路径。插件以当前 dsh 进程权限运行，安装前应确认来源可信。写操作默认 dry-run，治理只读，晋升、归档、删除都需要人工确认。

链接¶

• GitHub：https://github.com/zhujunpeng12/dsh-memory-system
• 目录页：本次已核实资料未提供可确认的目录页 URL，本文不列具体地址；可按仓库名 zhujunpeng12/dsh-memory-system 在社区目录中搜索。这里不把它写成官方应用商店。