zhujunpeng12/dsh-memory-system

README 摘要

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 只追加不覆写 中文召回 中文 bigram BM25 + exact/标题/路径匹配 + 元数据重排，全程可解释 trace 字节预算 热包 14KB / 冷包 4.2KB 硬预算，UTF-8 安全截断 治理只读 L0-L3 边界，自动收集证据、永不自动删改 零依赖 Python 标准库 + Markdown 文件，Windows/macOS/Linux 可跑（仅 backfill.py 历史回放需可选的 zstandard） 系统架构（六层闭环） 展开查看可编辑的 Mermaid 源码图 图例:实线 = 脚本机械执行;虚线 = 按需读取 / 人工核验;菱形 = 用户授权判断。反馈闭环:轨迹复盘产出的规则与事件,回灌到下一次会话的热记忆。 六层职责详解（每一层做什么） ① 启动热记忆 — 每个会话一次的有界上下文 做什么 ：新会话开始时，把「此刻最该知道的记忆」压缩成一个 ≤14KB 热包一次注入，让 Agent 不读全库也能带着上下文开工。 包含 ：机械门禁状态（缺口/锁/同步）、指令预算审计、用户画像、活跃核心规则（按 ⭐ 与引用…

分类