重建式回忆 linkpain/dsh-recall-rebuild

dsh-recall-rebuild

重建式回忆增强插件(DeepSeek Harness):增强现有记忆插件,让"回忆"从"念档案"变成"想起来了"。
Enhancer for DSH memory plugins: recall that feels like remembering, not quoting a file.

dsh-prime-memory 等现有 DSH 记忆插件已经把存储层做得非常扎实——跨会话捕获、蒸馏、持久化都很成熟,值得先装它们。本插件不做重复的事,只在一个环节上做增强:回忆的呈现方式——把检索到的记忆碎片交给 LLM 重建为带语境与情绪的回忆片段再注入,让"想起来了"更自然,而不是"念档案"。

痛点:回忆不应该是"念档案"

传统记忆插件(录音式):检索 → 把原文/摘要塞进上下文。

用户:我今天心情不太好。
助手(传统):根据我的记录,你喜欢喝冰美式咖啡、养了一只叫煤球的猫、上周去过成都出差。你怎么了?

本插件(重建式回忆):检索 → LLM 按当前对话现场重建 → 注入一段"回忆"。

用户:我今天心情不太好。
助手(本插件):记得你养了只叫煤球的黑猫,平时它一蹭你你就笑;上周你还说靠冰美式续命。今天是不顺心了吗?

同一份记忆,前者是"读档案",后者是"想起来了"。对桌宠、虚拟角色、陪伴型助手来说,这决定了它像机器还是像活人。

特性

- 只读增强,零污染:以 readOnly 打开现有记忆库($DSH_HOME/memory/memory.db),不重写捕获管线、不写任何数据,装/卸都不影响原插件;
- 多记忆源可插拔:source 支持 dsh-prime-memory(SQLite FTS5)、@max-null/dsh-memory(JSON 记忆库)与 dsh-memory-palace(Markdown 文件)三种底层记忆,auto 自动探测,后续可继续扩展;
- IM 用户级命名空间隔离:QQ/微信 多人共用角色时,自动解析桥接插件注入的 <dsh_im_source> sender 信息,把记忆按用户隔离——「用户 A 的记忆」不会注入给「用户 B」;同一人多会话记忆共享;隔离索引写在插件自己的目录,仍不碰底层记忆库;
- 生成式重建:在 agent/pre-step 用会话末尾消息召回碎片,LLM 重建为带语境/情绪/时间感的回忆片段,替代生硬原文注入;
- 与生态共存不错位:注入消息 source.kind='plugin:recall-rebuild',不会被 prime-memory 当作新用户消息再次捕获/蒸馏;replace 策略原位替换对方的原文召回,append 策略追加,不重复注入;
- 永不阻塞对话:无记忆库/无模型路由/超时/重建失败,一律静默跳过本轮;
- 重建质量可观测:每轮在 ~/.dsh/recall-rebuild/logs/recall-YYYY-MM-DD.log 写一条 JSONL 审计日志,「原始检索碎片 ↔ 重建后片段」同屏对比 + 注入方式/耗时/跳过原因,附带 stats.json 统计——零额外注入、零 token 成本,自己判断重建效果;
- 睡眠巩固 + 联想扩散(长期记忆子系统):空闲时把累积的碎片「聚类 → LLM 抽象为稳定记忆 → 联想图扩散 → 低频遗忘降权」,巩固层条目在召回时优先注入、命中越用越稳、强关联主题顺带想起——更接近人脑的「夜间回放迁移到新皮层」;产出只存本插件目录,底层记忆库保持只读;
- 巩固层交互命令:/recall-rebuild list | now | edit <id> <内容> | forget <id>——像管理自己的记忆一样查看长期记忆、立即触发一次巩固、修正记错的、主动忘掉不想留的(操作遵循同一套用户隔离视图);
- 零部署硬件成本:不买显卡、不租 GPU,重建调用走宿主已有的 LLM 路由,每轮只消耗百级 token;
- 零额外运行时依赖:用 Node 22+ 内置 node:sqlite 读库,安装即用。

适合谁

- DSH 桌宠 / 虚拟角色 / 陪伴型 AI 玩家——想要"像人一样记着你",而不是"查到你的档案";
- 已把角色接入 QQ / 微信 等 IM 的 DSH 用户——角色同时服务多个人的私聊/群聊时,希望每个用户的记忆互不串味,同一人跨会话记忆共享;
- 觉得现有记忆插件"注入的原文太生硬、像在念记录"的开发者与用户。

安装

前置:

- DeepSeek Harness 0.1.0-rc.2 … 0.2.1-rc.3;
- Node ≥ 22.5(需要内置 node:sqlite);
- 已安装并运行过 dsh-prime-memory(0.26.x,SQLite 记忆库)、dsh-memory(@max-null,JSON 记忆库)或 dsh-memory-palace(Markdown 记忆文件),且已有记忆数据。

dsh plugin --profile <你的配置文件名> add dsh-recall-rebuild
安装后无需手动改 profile 的 cordis.patch.yml（包内组合层自动插入插件行）。
如需覆盖配置，在 profile 的 cordis.patch.yml 写顶层裸 patch（同 id 再 insert 会报 duplicate loader entry，按行整体替换、不深合并）：

- id: recall-rebuild
name: dsh-recall-rebuild
config:
enabled: true
rebuild:
maxResults: 5
maxOutputChars: 600
timeoutMs: 8000
inject:
strategy: replace # replace = 替换 prime-memory 的原文注入; append = 追加

工作原理

flowchart LR
U["IM 用户新消息(带 <dsh_im_source> sender)"] --> P["agent/pre-step(本插件 prepend)"]
P --> K["提取当前用户键(senderId / chatId)"]
P --> Q["构造召回查询(会话末尾消息)"]
Q --> S[("记忆库prime(SQLite)/ dsh-memory(JSON)/ palace(Markdown)")]
S --> F["用户命名空间过滤(auto/strict/off)"]
S -. "碎片累积(pending)" .-> C["睡眠巩固(空闲异步)聚类 → LLM 抽象 → 联想 → 遗忘"]
C --> C2[("巩固层~/.dsh/recall-rebuild/consolidated")]
C2 -. "active 条目 + 联想扩散" .-> F
F --> R["LLM 重建式回忆(碎片 → 带语境的回忆片段)"]
R --> I["注入回忆片段source.kind = plugin:recall-rebuild"]
F --> N[("归属索引~/.dsh/recall-rebuild/namespaces")]
F -. 命中候选归属当前用户 .-> N
P --> M["模型推理"]
I --> M
M --> A["回复"]
R -. "失败/超时 → 静默跳过" .-> M

一句话流程：提取用户 → 检索 → 用户隔离过滤 → 合并巩固层 → 重建 → 注入，而不是检索 → 注入；碎片在空闲时「睡眠巩固」沉淀为稳定记忆，下次召回优先想起。

与现有插件的错开与共存

- 注入消息 source.kind 用 v4 语义 plugin:recall-rebuild，与 prime-memory 的 plugin:memory 互不干扰；capture 侧只收 source.kind==='user'，天然不被二次捕获。
- strategy=replace 时只替换本轮已存在的原文召回消息；没有则退化为追加，不重复注入。

配置项

| 键 | 默认 | 说明 |
| enabled | true | 总开关 |
| dataDir | '' | 记忆库目录；空 = $DSH_HOME/memory |
| source | auto | 记忆来源：auto 自动探测（prime → dsh-memory → palace）；prime = dsh-prime-memory SQLite 库；dsh-memory = @max-null/dsh-memory JSON 记忆库；palace = dsh-memory-palace Markdown 文件 |
| rebuild.enabled | true | 重建式回忆开关；false 退化为原文检索注入 |
| rebuild.maxResults | 5 | 每轮检索条数 |
| rebuild.maxMemoryChars | 400 | 单条记忆进重建 prompt 的字符上限 |
| rebuild.maxTotalChars | 2000 | 重建 prompt 记忆总量上限 |
| rebuild.maxOutputChars | 600 | 重建片段输出上限 |
| rebuild.temperature | 0.7 | 重建调用温度 |
| rebuild.maxTokens | 1024 | 重建调用输出 token 上限 |
| rebuild.timeoutMs | 8000 | 重建总超时；超时跳过本轮 |
| inject.strategy | replace | replace = 原位替换 prime-memory 的原文召回；append = 追加 |
| inject.maxChars | 1200 | 注入正文单条上限 |
| inject.includeSources | true | 注入时附记忆来源 id 标注 |
| query.tailMessages | 8 | 召回查询取会话末尾消息条数 |
| query.maxChars | 1200 | 召回查询字符上限 |
| user.isolation | auto | IM 用户隔离模式：auto 剔除「明确属于其他用户」的记忆（无主记忆默认可见，命中后归位）；strict 只注入「已归属当前用户」的记忆（新用户零记忆起步）；off 不过滤。桌面直接对话自动不隔离 |
| user.isolationDir | '' | 归属索引目录；空 = <DSH_HOME>/recall-rebuild/namespaces |
| user.sourceTagPattern | '' | 覆盖内置 <dsh_im_source> 解析正则；不同桥接插件字段不同时可自定义（需含一个捕获组取用户 id） |
| observability.logEnabled | true | 每轮重建审计日志开关（JSON Lines，按天滚动） |
| observability.logDir | '' | 日志目录；空 = <DSH_HOME>/recall-rebuild/logs |
| observability.includeFragments | true | 日志是否记录原始检索碎片（与重建片段同屏对比）；false 只记重建结果 |
| observability.statsEnabled | true | 是否写统计文件 stats.json（30s 节流） |
| consolidate.enabled | true | 睡眠巩固总开关 |
| consolidate.dir | '' | 巩固层目录；空 = <DSH_HOME>/recall-rebuild/consolidated |
| consolidate.minFragments | 20 | 待巩固碎片累积多少条触发一次巩固 |
| consolidate.minIntervalMs | 21600000 | 距上次巩固最短间隔（6h） |
| consolidate.checkIntervalMs | 3600000 | 定时检查间隔（1h） |
| consolidate.maxFragmentsPerRun | 50 | 单次巩固最多处理碎片数 |
| consolidate.clusterThreshold | 0.25 | 聚类相似度阈值（同主题碎片 ≥ 阈值归为一簇） |
| consolidate.maxCluster | 8 | 单簇最多碎片数 |
| consolidate.maxOutputChars | 400 | 单条巩固输出字符上限 |
| consolidate.temperature | 0.4 | 巩固调用温度（低于重建，求稳） |
| consolidate.maxTokens | 1024 | 巩固调用输出 token 上限 |
| consolidate.timeoutMs | 20000 | 单簇巩固超时（离线任务可放宽） |
| consolidate.confidenceThreshold | 0.4 | 遗忘阈值：置信度低于它且长期未命中 → dormant（召回降权） |
| consolidate.dormantDays | 30 | 多少天未命中（且低置信）进入 dormant |
| commands.enabled | true | 巩固层交互命令总开关 |
| commands.name | recall-rebuild | 注册的命令名（不含前导 /）；与其它插件冲突时改名 |

长期记忆子系统：睡眠巩固与联想扩散

类比人脑：底层记忆插件 = 海马体（即时捕获碎片），本插件的巩固层 = 新皮层（把碎片沉淀为稳定记忆）。这层只存在本插件自己的目录（~/.dsh/recall-rebuild/consolidated/），底层记忆库始终保持只读。

一次巩固（空闲异步，不阻塞对话）做什么：

1. 累积：每轮检索命中的碎片进入 pending.json（去重、限量）；
2. 聚类：纯本地按 2-gram 相似度把同主题碎片分簇（无需 LLM、零成本）；
3. LLM 抽象：每簇交给宿主 LLM，提炼为 1-3 条稳定的长期记忆（stable-fact / pattern / preference / relationship / mood），忽略一次性噪音；
4. 联想扩散：本轮产出的条目两两建立关联边（links.json 权重累加）——召回命中一条时，强关联主题顺带想起；
5. 遗忘（只读侧）：低置信 + 30 天未命中的条目进入 dormant（召回降权，不删除、不写底层库）；
6. 越用越稳：每次命中 touchCount+1，高置信条目优先注入。

触发：启动后空闲 10s 查一次，之后每 checkIntervalMs 查一次；pending 达标且距上次巩固超 minIntervalMs 才真正执行；失败保留 pending 下次再试。

加固了这一层的定位：它不替代底层记忆插件，也不重复存储——底层负责「记住」，巩固层负责「把记住的东西变成稳定的自己」。

管理长期记忆（命令）

像管理自己的记忆一样管理巩固层（命令在支持 / 命令的 DSH 界面输入；宿主没有命令服务时自动跳过，不影响插件主体）：

| 命令 | 作用 |
| /recall-rebuild list [--all] | 查看长期记忆：类型 / 置信度 / 命中次数 / 更新时间；dormant（已降权）单独标出。默认只显示当前用户的记忆 + 共享记忆，--all 查看全部（含其它 IM 用户） |
| /recall-rebuild now | 立即触发一次睡眠巩固（绕过最短间隔；pending 为空时提示） |
| /recall-rebuild edit <id> <新内容> | 修正一条记忆的内容（人也会记错、改口） |
| /recall-rebuild forget <id> | 主动删除一条记忆及其联想边（与被动遗忘不同，这是显式操作，不写底层库） |
| /recall-rebuild help | 显示用法 |

命令的可见范围与召回隔离是同一套规则：当前会话能识别 IM 用户时，只能查看/修改「该用户 + 无主共享」的记忆；桌面会话（识别不到用户）或 --all 时不受限。命令名冲突时用 commands.name 改名。

观测：怎么判断重建是否真的更好

每轮运行后，打开日志目录（~/.dsh/recall-rebuild/logs/）：

- recall-YYYY-MM-DD.log：每轮一行 JSON，同一轮里 fragments（原始检索碎片）与 rebuilt（重建后片段）并排——直接对比同一份记忆的两种呈现，自己判断哪种更"像人"；
- stats.json：累计轮数 / 命中轮 / 重建成功 / 注入 / 替换数，看重建的覆盖面和替换率。

字段速览：round 轮次、userKey 当前 IM 用户、hitCount 命中数、memoryIds 依据记忆 id、fragments 原始碎片、rebuilt 重建片段、injection 注入方式（replaced 替换了对方原文召回 / appended 追加 / none 未注入）、latencyMs 耗时、error 跳过原因。

想运行时真·对比（同一轮同时看到原文召回与重建片段），把 inject.strategy 设为 append；想零成本对比，看日志即可。

Roadmap

- [ ] 更多记忆源 adapter（dsh-memory-vault、dsh-auto-memory、dsh-memory-gate 等变体）；
- [x] IM 用户级命名空间隔离（跨 QQ/微信的同一人记忆共享）—— v0.1.3 已实现；
- [x] 重建质量可观测（每轮 JSONL 日志 + stats）—— v0.1.4 已实现；
- [x] 睡眠巩固 / 联想扩散（长期记忆子系统：聚类 → LLM 抽象 → 联想 → 遗忘）—— v0.1.5 已实现；
- [x] 巩固层交互命令（list / now / edit / forget，管理长期记忆）—— v0.1.6 已实现；
- [ ] 巩固层条目编辑/手动触发、更多记忆源 adapter（欢迎提 issue）。

局限（如实声明）

1. 只增强召回/呈现层：底层库捕获了什么，重建就基于什么；库缺字段（如没有情绪标注）时，重建不会凭空造出它。
2. 用户隔离是观察式启发式，非底层强隔离：底层记忆库（prime 等）没有 IM 用户字段，本插件靠「谁在会话中命中过这条记忆，它就归谁」建立归属。因此：auto 模式防得住「已明确归属他人」的记忆，防不住「从未被命中过的无主记忆」（它们默认可见，命中后归位）；strict 模式从零记忆起步，聊过的话题才开始归位。需要强隐私隔离且不介意冷启动时用 strict。
3. 用户识别依赖桥接插件约定：优先解析 <dsh_im_source> JSON（senderId/chatId/threadId/botId），兜底常见字段（senderId/userId/openid/fromUser）；不同桥接字段不同时用 user.sourceTagPattern 覆盖。识别不到用户（桌面会话）时不做隔离。
4. 幻觉受控但非零：重建 prompt 明确禁止编造碎片外事实，但 LLM 仍有漂移概率；注入标注记忆依据 id 便于审计。需要强事实的场景可关掉重建（rebuild.enabled=false）。
5. token 消耗：每轮召回命中即产生一次重建调用（通常百级 token），由宿主模型路由计费；巩固只在空闲且碎片达标时发生，每次几十~几百 token。
6. 日志零成本但非自动诊断：日志只记录事实（碎片/重建/耗时/跳过原因），不做好坏判定；用户可对比判断，或切换 inject.strategy=append 运行时对比。
7. 巩固层是启发式蒸馏，非底层改写：聚类基于 2-gram 相似度（可能把近义不同词的两条碎片分到不同簇）；LLM 抽象有轻幻觉风险（已在 prompt 禁止编造）；dormant 只是召回降权，不会删底层库、也不会在本插件内物理删除。
8. 未覆盖：LoRA 权重内化等权重级记忆不在本插件范围（见 Roadmap）。
9. 交互命令依赖宿主命令服务：支持 / 命令的界面（桌面/Web UI）都有；无命令服务的组合（如 headless）下命令静默不注册，插件其余功能不受影响。

开发与验证

npm install
npm run typecheck # tsc --noEmit
npm run build # 编译到 dist/
node scripts/verify.mjs # 运行时验证:导出/Config/prime FTS+LIKE/palace Markdown/dsh-memory JSON/降级
npm pack --dry-run # 检查发布包内容

License

MIT

English Overview

dsh-recall-rebuild 是 DeepSeek Harness（DSH）中记忆插件的增强器。现有记忆插件，比如 dsh-prime-memory（SQLite）、@max-null/dsh-memory（JSON）或 dsh-memory-palace（Markdown），已经把存储做得很好——跨会话捕获、蒸馏和持久化都很成熟，所以先装一个。本插件不重复这些工作；它只增强一层：记忆如何被召回——不再原样注入原始片段，而是让 LLM 把它们重建成有上下文的回忆，这样「记得」感觉自然，而不是像在引用文件。

本插件升级的是召回/呈现层：

- 以只读方式打开现有记忆库（$DSH_HOME/memory/memory.db），从不写入，从不碰捕获管线；
- 每次模型步进前，它检索记忆碎片，让 LLM 把它们重建成有上下文、带情绪色彩的回忆片段（只用碎片内的事实——不编造）；
- IM（QQ/微信……）按用户隔离记忆：解析 IM 桥接插件附在消息上的 <dsh_im_source> 块，提取 senderId/chatId，再靠一份归属索引，把每个用户的记忆挡在其他用户的召回之外。这份索引放在它自己的目录里（<DSH_HOME>/recall-rebuild/namespaces），底层记忆库依旧只读不写。模式有三种：auto（丢弃明显属于他人的记忆；无主记忆保守可见，直到被认领）、strict（只注入已归属当前用户的记忆）、off（不过滤）。桌面聊天检测不到用户时，一律不过滤；
- 通过 agent/pre-step 注入，带 source.kind='plugin:recall-rebuild'，因此不会被底层记忆插件再次捕获；replace 策略就地替换掉另一个插件的原始文本召回，append 则追加在旁边；
- 绝不阻塞对话：存储缺失、模型路由缺失、超时、重建失败，全都静默跳过这一步；
- 重建质量可观察：每轮往 ~/.dsh/recall-rebuild/logs/recall-YYYY-MM-DD.log 追加一行 JSONL 审计记录——原始片段与重建片段并排对照，外加注入模式 / 延迟 / 跳过原因，还有限流的 stats.json——零额外注入、零 token 开销，重建是否胜过原始召回，你自己判断；
- 睡眠巩固 + 联想扩散（长期记忆层）：空闲时把累积的片段聚类（本地 2-gram 相似度），由 LLM 蒸馏成稳定记忆（stable-fact/pattern/preference/relationship/mood），连进一张扩散激活图，低置信度且长期未用的条目衰减为 dormant（召回时降权，从不删除，从不写入基础存储）。巩固过的条目优先召回，命中越多越稳定，强链接还会让相关话题一并浮现——更接近大脑夜间巩固白天经历的方式。所有内容都放在 <DSH_HOME>/recall-rebuild/consolidated/ 下；
- 用斜杠命令管理长期记忆：/recall-rebuild list [--all]（查看巩固记忆，含类型/置信度/命中次数）、now（立即触发一次巩固）、edit <id> <text>（修正记错的条目）、forget <id>（显式删除条目及其链接）。命令视图遵循同样的按用户隔离规则；宿主没有命令服务时，静默跳过注册；
- 零基础设施成本：不需要 GPU/VM——重建调用走宿主现有的 LLM 路由，每次命中约几百 token；只用 Node 内置的 node:sqlite。

适合谁：DSH 桌面宠物 / 虚拟角色 / 陪伴类用户，希望机器人「像人一样记住」而不是「引用一个文件」，也包括桥接到 QQ/微信的角色。

安装（先装 dsh-prime-memory）：

dsh plugin --profile <your-profile> add dsh-recall-rebuild