业务定位:当前 AI 助手的记忆要么靠模型参数(换模型即丢失、不可审计),要么靠 RAG 向量库(会"脑补"未发生的内容、无法单点撤销)。本项目把记忆做成一层外挂的系统提示词中间件:每条记忆都是原文 + 稀疏符号标签,可逐条解释、逐条撤销、离线存储,且任何环节失败都只降级为"不注入",绝不阻断对话。
主要能力:
能力 说明
符号编码 归一化 + Aho–Corasick 多模式匹配,产出带权重与极性的稀疏标签;不做语义理解、不调用任何模型做判断
长期存储 独立 SQLite(WAL + 外键),每条记忆带 sha256 校验;JSONL 文件兜底;schema 版本化自动迁移
最小注入 前部强约束(systemPrompt.section,order 860)+ 后部参考记忆(带来源的动态上下文);top-3 / 400 token / 披露闸门
披露与租户隔离 scope 按用户 / 群隔离(如 qq:user:),audience ≤ origin 才允许注入,防止私聊内容在群里被复述
写入闸门与去重 基于身份窗口与证据充分性判定,负标签优先——宁可不注入,也不注入错误内容
安全与合规 AES-256-GCM 加密归档、密钥环管理、sha256 完整性校验、mem_purge 五步物理清除 + crypto-shredding、脱敏
工具集 mem_stats / mem_search / mem_verify / mem_export / mem_purge 五个 mem_ 前缀工具,重名自动降级
可运营 备份脚本、Web 控制台、注入回执(audit kind=inject),全程可审计
典型场景:QQ 机器人的多租户长期记忆(已在 VM 真机跑通"QQ → 打标 → 门控 → SQLite"端到端);也可作为任何 DSH Agent 的可解释记忆层。
总体架构:输入 → 两道闸门(写入 / 披露)→ 符号编码 → 三项激活 → 预算竞争 → 显式抑制 → 提示词装配;后台挂生命周期晋升与再巩固撤销。所有读写带租户键,时间只作用一次,LLM 不参与"记忆是否成立"的判定。
核心模块(dsh-memory/src/,23 个):
入口与注入:index.ts(name / inject / apply 插件契约)、inject.ts(token 估算、audience 解析、注入块与激活记录)、standing.ts(常驻强约束)、render.ts(渲染)
编码与召回:segment.ts(归一化 + 模式匹配流水线)、tag.ts / vocab.ts(标签与词表)、association.ts(联想强度)、recall.ts / rerank.ts(召回与重排)、identity.ts(身份与去重窗口)、write-gate.ts(写入闸门)
存储与迁移:store.ts(统一接口)、sqlite-store.ts(node:sqlite 主实现)、jsonl-store.ts(兜底)、migrate.ts(按 schema_version 迁移,当前 v8)
安全与运维:keyring.ts(密钥环)、backup.ts(加密归档与解密)、sanitize.ts(脱敏)、llm-review.ts(每日 LLM 复盘,可选)
控制台:console-schema.ts / console-queries.ts / web-routes.ts(Web UI 路由与查询)
关键技术决策:
稀疏符号而非稠密 embedding——避免虚假记忆、支持单点撤销;
注入走双通道——强约束用 ctx.systemPrompt.section(每步重组的指令),参考记忆用带来源的动态上下文(模型能识别"这是历史"),绝不伪造 user 消息;
存储与宿主解耦——独立 node:sqlite 单文件,卸载插件不影响数据,可用任何 SQLite 工具恢复;
失败关闭 / 失败开放分明——披露闸门异常拒绝注入,抑制模块异常则放行;记忆层故障永不影响主对话;
确定性、可复算、每步可解释——随机性须显式记录种子,用户可追问"你为什么记得这个 / 为什么说漏了"。