shayexiangpaimeng/dsh-memory

@shayexiangpaimeng/dsh-memory

面向 DeepSeek Harness 智能体的仅追加分层记忆。

上下文会缩，记忆不该缩。

一个社区插件（dsh-plugin），为智能体提供持久、仅追加的记忆流，具备五层分区、写入闸门、关键词召回、时间轴读取和声明锚点验证。由 DeepSeek Harness 的深度用户构建，是对那套自记忆系统首次构建（2026 年 8 月）以来一直让一个陪伴型 AI 保持连续性的记忆系统的通用化、无隐私再实现。

它做什么

- 仅追加写入流 —— 每次追加写入一行 JSONL；历史永不重写。
- 五层分区 —— permanent（永不遗忘）/ session（本次会话）/ rolling（近期上下文）/ config（配置）/ ephemeral（不保存）。
- 写入闸门 —— 空事件、未知层、未知状态和孤立的 supersedes 指针会在它们腐化记忆流之前被拒绝或标记。
- 声明锚点验证 —— 没有 anchor（测量值 / 校验和 / 命令输出）的修复声明（“已修复……”）会被标记为警告：声明与磁盘脱节 = 已诊断的缺陷，而非疏忽。
- 全流锚点审计（memory_audit）—— 写入时警告是软约束，因为声明可以被改写为普通陈述。审计读取文件，因此无法被绕开。
- 时间轴读取（memory_recent）—— 最新优先，可选时间窗口和关键词过滤。关键词召回无法回答“最新的是什么”或“这有多久没被碰过了”：这些词从不会出现在条目中。
- 退役与替换链 —— 撤回一个结论而无需重写它：追加一条带 supersedes:  的新条目，可选地将旧条目标记为 status: retired。已退役条目保留在流中以供审计，但会从注入摘要中过滤掉，因此被撤回的声明无法作为当前事实回来。
- 提示状态渲染 —— 动态的 memory:state 部分在每次组装时渲染最近的 permanent + session 层，来自启动时预热一次的缓存（预热后保持每会话读取一次）。
- 关键词召回 —— 不区分大小写的子串评分，最新优先。

工具

| 工具 | 用途 |
| --- | --- |
| memory_append | 向流中追加一个事件，可选 layer、anchor、status、supersedes |
| memory_recall | 对流的 关键词召回（主题问题） |
| memory_recent | 时间轴读取：最新优先，可选窗口和关键词过滤 |
| memory_verify | 检查修复声明是否带有锚点 |
| memory_audit | 扫描整个流，查找不带锚点的修复声明 |

0.2 中的新内容

这里的一切都来自将 0.1 设计又运行了一段时间，每一项都对应一个实际发生过的失败：

- 一条时间轴。 仅靠召回能很好地回答主题问题，却很差地回答时间问题——被问到“最新的是什么”时，它返回了一条三个月前的条目，带着
同样的措辞，同样自信地陈述。memory_recent 是单独的路径。
- 锚点审计。 写入时的警告可以通过措辞来规避；对文件进行审计则无法规避。
- 退役 + 替换链。 治理通常检查“新东西是否被写入”；更罕见的 bug 是“旧东西又回来了”。已退役的条目必须留在权威流中，并且排除在所有投影之外。

工具描述直接承载了指引（“主题性 → memory_recall，时间性 → memory_recent”），因为工具描述才是模型在选择工具时实际阅读的内容；系统提示中的规则只是软约束。

安装

从 GitHub（当前分发渠道）：

npm i github:shayexiangpaimeng/dsh-memory

从 npm registry（发布后）：

npm i @shayexiangpaimeng/dsh-memory

在 cordis.yml 中挂载：

plugins:
- '@shayexiangpaimeng/dsh-memory'

存储路径默认为 ~/.dsh-memory/memory.jsonl；可通过 config.filePath 覆盖。注入层默认为 permanent + session；可通过 config.summaryLayers 覆盖。

开发

npm install
npm test        # vitest, no API key required
npm run build   # tsc → lib/

已知限制与推迟的工作

- 召回是基于关键词子串评分，而非向量搜索。向量索引被推迟；存储格式足够稳定，可以在相同的 recall() 契约背后添加一个。
- memory_recent 的边界使用 Date.parse 解析，因此裸日期（2026-09-01）表示 UTC 午夜。无法解析的边界会抛出错误，而不是被忽略——一个静默匹配所有内容的过滤器比一个错误更糟。
- status 和 supersedes 是可选字段：由 0.1 写入的流可以原样加载，缺失的 status 表示 active。
- 提示词部分从启动时预热的缓存渲染；在首次组装之前追加的条目会被包含，但在非常首次启动时冷缓存可能会在一次组装中渲染出空的部分。
- DeepSeek Harness 处于开发者预览阶段；systemPrompt/tools API 可能会破坏兼容性。本包跟随 DSH 发布；请固定你的 Harness 版本。