@zhujunpeng12/dsh-memory-system

dsh-memory-system — DSH 持久记忆基础设施

一套给 DeepSeek Harness (DSH) Agent 用的本地优先记忆系统：启动热记忆注入、可解释冷召回、租约锁保护的事务写入、只读治理与轨迹复盘。纯 Python + Markdown 文件，无数据库、无向量服务、无外部服务依赖。

重要边界：本仓库只包含「机制」，不包含任何个人数据。 记忆内容（画像、规则、事件、项目笔记）始终留在使用者自己的 Obsidian Vault 里，通过环境变量指向。

为什么需要它

Agent 会话之间默认是失忆的。本系统用 六层机制 把「记忆」变成可工程化的闭环：

1. 启动热记忆 — 每个新会话注入一次 ≤14KB 的热包（门禁 + 指令预算 + 用户画像 + 活跃规则 + 项目摘要 + 近期事件标题）
2. 工作路径 — 按全局/项目 AGENTS.md 规则完成任务
3. 冷层召回 — 双门槛触发（历史引用 + 具体主题），exact + 中文 BM25 + 元数据重排，输出 ≤4.2KB 冷包，向量检索默认关闭（依赖零）
4. 授权写入 — 租约锁（30s 租约 / 5s 心跳 / 陈旧锁恢复）+ 多文件事务（before-image / SHA-256 前置 / manifest / receipt），raw 机械只追加，纠错必须 supersedes
5. 慢治理 — govern.py 只读扫描重复、冲突、过期、体量、规则生命周期候选，默认不写
6. 轨迹复盘 — 只读扫描会话轨迹，用「用户纠正」作为硬信号产出复盘候选

特性亮点

| 能力 | 说明 |
|---|---|
| 写入安全 | 单写者租约锁 + 可恢复事务，多文件变更原子化，raw 只