跳到正文
  • 首页
  • 插件说明
  • dsh-memory-system

zhujunpeng12/dsh-memory-system

70最近提交 2026年8月15日

dsh-memory-system DSH 插件

dsh-memory-system 通过六层机制为 DSH Agent 提供跨会话记忆：启动热记忆、冷层召回、授权写入、治理扫描、轨迹复盘和工作路径规则。仅依赖 Python 标准库和 Markdown 文件，无需数据库或向量服务。记忆数据始终留在用户自己的 Obsidian Vault 中，通过环境变量配置。

skills-workflowsdeveloper-tools

如何安装 dsh-memory-system DSH 插件

dsh plugin add @zhujunpeng12/dsh-memory-system

复制不会执行命令。安装 dsh-memory-system DSH 插件前请核对仓库和版本。

dsh-memory-system DSH 插件数据来源

dsh-memory-system DSH 插件快照日期：2026年8月16日

discovered

dsh-memory-system DSH 插件能做什么

  • 会话启动时注入 ≤14KB 热记忆包，压缩关键上下文
  • 中文双字 BM25 + 精确匹配 + 元数据重排的冷召回，输出 ≤4.2KB 并附带来源追踪
  • 基于租约锁（30s 租约/5s 心跳）的授权事务写入，支持 before-image、SHA-256、清单和收据
  • 只读治理扫描，识别重复、冲突、过期和体量问题，永不自动修改
  • 轨迹复盘使用用户纠正作为硬信号，生成改进候选
  • 零外部依赖：Python 标准库 + Markdown，Windows/macOS/Linux 均可运行

dsh-memory-system DSH 插件适合哪些场景

  • 跨会话维持 Agent 上下文，用于长期项目
  • 持久化用户偏好、项目摘要和决策历史，无需外部数据库
  • 回顾 Agent 会话轨迹，识别重复错误并演进规则集
  • 提供安全、可审计的记忆写入路径，支持 dry-run 预览和用户确认

dsh-memory-system DSH 插件适合谁

  • 需要 Agent 跨会话记住上下文的 DSH 用户
  • 构建需要持久知识的自定义 DSH 工作流的开发者

dsh-memory-system DSH 插件的限制

  • 仅适用于 DSH (DeepSeek Harness) 平台，不是独立记忆系统
  • 需要预先配置 Obsidian Vault 目录和环境变量（MEMORY_VAULT, DSH_HOME）
  • 默认关闭向量检索，仅提供精确匹配和 BM25 召回
  • 写入新记忆始终需要用户确认（先 dry-run，再 apply=true）
  • 轨迹复盘依赖可选的 evidence-ledger 插件获取工具调用账本数据

dsh-memory-system DSH 插件的仓库 README 摘录

以下文字摘自 dsh-memory-system DSH 插件的上游仓库 zhujunpeng12/dsh-memory-system 的 README，版权归原作者，仅作引用。

> 一套给 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） | ## 系统架构（六层闭环） ![DSH 记忆系统流程图](docs/memory-system-flowchart.png) <details> <summary>展开查看可编辑的 Mermaid 源码图</summary> ```mermaid flowchart TD Start([新会话 / 新任务]) --> Hook[SessionStart Hook<br/>

阅读完整 README仓库许可: MIT

dsh-memory-system DSH 插件常见问题

如何安装 dsh-memory-system？

在终端中运行 `dsh plugin add @zhujunpeng12/dsh-memory-system`。或者下载 tarball 后运行 `dsh plugin add ./zhujunpeng12-dsh-memory-system-0.1.0.tgz`。安装完成后重启 DSH，Agent 即可获得六个记忆工具。

这个插件需要数据库或向量服务吗？

不需要。它仅依赖 Python 标准库和 Markdown 文件。向量检索默认关闭，召回机制使用精确匹配和中文双字 BM25。所有数据以纯 Markdown 文件形式存储在本地 Obsidian Vault 中。

如何配置记忆库？

创建一个目录（例如 `~/Documents/Obsidian Vault`），包含必要的子文件夹：`memory/`、`memory/events/`、`memory/index/`、`memory/projects/` 和 `projects/`。设置环境变量 `MEMORY_VAULT` 指向该目录。复制 `.env.example` 调整默认值。然后运行 `bootstrap.py` 或使用 `memory_bootstrap` 工具生成热记忆包。

写入记忆是自动的吗？

不是。所有写入都需要用户确认。`memory_write` 工具默认以 dry-run 模式运行，必须设置 `apply=true` 并通过 `pre-execute` 钩子确认。原始日志只追加，纠错必须使用 `supersedes` 避免覆盖。这确保你完全控制写入的内容。

轨迹复盘功能有什么用？

`memory_trajectory_review` 工具扫描会话日志中的用户纠正（硬信号）和工具调用账本（如果安装了 evidence-ledger 插件）。它会生成以“场景→错误→根因→先决动作”为结构的复盘候选。人工审核后决定是否将重复模式毕业为核心规则，或丢弃。