READMESource: main@2b6309f9
全息记忆(Omni memory)
给 DeepSeek Harness 的长期记忆内核:只增不改的原文留底 + 会自我校验的结论 + 按项目分层 + 三路混合召回。
⚠️ 许可提醒:本项目采用 CC BY-NC 4.0 —— 可自由使用、修改、二次开发、借鉴, 但禁止任何商业用途,且必须署名作者。商用请走 商业授权 流程。
它解决什么问题
普通对话记忆要么"全记"(噪声爆炸),要么"靠模型自觉"(漏记)。全息记忆把两件事拆开:
| 层 | 谁负责 | 特点 |
|---|---|---|
| 转录(原文) | 系统自动 | 只增不改、可检索、可按上限墓碑化 |
| 结论(笔记/事实) | 模型判断后写入 | 带来源、可校验、可遗忘、可修订 |
| 事实 | 结构化三元组 | 双时态(何时为真/何时失效),冲突自动失效旧值 |
| 实体图 | 事实自动生成 | 支持 2 跳关联召回 |
| 分层 | 按工作目录自动判定 | 全局规则 vs 项目专属,互不污染 |
核心能力
- 混合检索:词面(FTS5 trigram + 中文二元索引)+ 向量(512 维字符 n-gram,可选接真语义嵌入)+ 图游走,RRF 融合排序
- 自动召回:每轮用你的消息预取 top-3 注入上下文(可关)
- 模型复核归类(可选):写入先按规则落层;显式开启后,后台让模型复核,判错自动迁移并留痕。默认关闭,不把正文发给外部模型
- 冲突标记:显式声明或近重复自动标记
contested,只标记不删除;画像与自动召回默认排除 contested - 做梦校验:离线拿转录核对笔记,发现"与原文矛盾"时只标记为待复核;替代需单条确认(
memory_dream_replace),且可一键反替代 - 记忆星图:整屏旋臂星系,拖拽旋转/滚轮缩放/分层切换;单击任意星点弹出记忆卡,搜索命中会亮起脉冲光环
- 活跃视图:列表/搜索默认只显示活跃记忆;历史(被替代、已删除、已失效)通过面板「审计」查看并可单条恢复
- 备份/导出/导入:
memory_export导出可移植 JSON(含墓碑),memory_import合并导入(默认 dry-run),memory_restore复活单条 - 隐私:全部数据在本地 SQLite(
$DSH_HOME/memory/omni.db),HTTP 只监听 loopback;写操作只接受 POST 并校验 Origin/CSRF 头
安装
插件市场
在 DSH 插件市场搜索「全息记忆 / Omni memory」安装,重启或刷新后左栏出现「全息记忆」入口。
本地安装(开发者)
cd memory-core
npm test # 217 个用例
npm run check # 语法与 JSON 校验
然后在 DSH 插件管理器中选择本地目录安装。
配置
所有开关通过环境变量控制,修改后需重启 DSH。
| 变量 | 默认 | 说明 |
|---|---|---|
OMNI_AUTO_RECALL |
开 | 0 关闭每轮自动召回 |
OMNI_SCOPE_JUDGE |
off |
模型复核归类:off / auto / always;开启后写入正文会发给复核模型 |
OMNI_JUDGE_PROVIDER / OMNI_JUDGE_MODEL |
自动 | 指定复核用的模型 |
OMNI_EMBED_URL |
未设置 | 接 OpenAI 兼容 /embeddings 启用真语义 |
OMNI_EMBED_MODEL |
text-embedding-3-small |
远程嵌入模型 |
OMNI_EMBED_KEY |
— | 远程嵌入鉴权 |
OMNI_EMBED_PROVIDER |
未设置 | 预设:openai / dashscope / zhipu / siliconflow(自动填 url/model) |
OMNI_EMBED_BATCH |
64 |
每请求最大输入条数 |
OMNI_EMBED_RETRIES |
2 |
429/5xx 重试次数(250ms、750ms 退避) |
OMNI_EMBED_TIMEOUT_MS |
10000 |
远程嵌入超时 |
OMNI_DREAM_INTERVAL_MS |
0(关) |
定时做梦校验 |
OMNI_DISABLE_VECTOR |
未设置 | 1 关闭向量路线(诊断用) |
OMNI_DISABLE_GRAPH |
未设置 | 1 关闭图路线 |
模型工具
| 工具 | 作用 |
|---|---|
memory_write |
写入笔记 / 事实 / 原始观察(事实可声明 cardinality: multi 保留多值) |
memory_search |
混合检索(支持全局 / 项目 / 全部) |
memory_profile |
读取常驻画像 |
memory_timeline |
某实体的时间线(事实 + 相关笔记) |
memory_forget |
墓碑化一条记忆 |
memory_dream |
拿转录核对笔记(默认 dry-run;apply 只标记,commit 才批量替代) |
memory_dream_proposals |
列出待确认的替代候选(只读) |
memory_dream_replace |
单条替代(需 confirm: true) |
memory_dream_rollback |
反替代:复活原笔记、墓碑化生成笔记 |
memory_compact |
转录增长治理(默认 dry-run) |
memory_reindex |
回填缺失向量(hashed / remote);bigrams: true 一次重建全库 CJK 两字索引 |
memory_link_entity |
登记实体别名并合并事实/边(默认 dry-run) |
memory_persona |
读取/修正/自动提炼用户设定:称呼 / 性格 / 习惯 / 偏好 / 其他 |
memory_export |
导出 JSON 备份(默认含墓碑;activeOnly 只导活跃) |
memory_import |
合并导入备份(默认 dry-run,按内容去重,重建向量) |
memory_restore |
恢复一条被墓碑化的记忆(重建索引) |
数据与隐私
- 数据文件:
$DSH_HOME/memory/omni.db(SQLite WAL,单文件,备份即复制;默认明文落盘,未加密) - 所有 HTTP 路由仅绑定 loopback,非本机请求返回 403;写操作只接受 POST,并校验
Origin与x-omni-csrf头 - 不主动上传任何内容;只有你显式配置
OMNI_EMBED_URL时,文本才会发送到该嵌入端点;OMNI_SCOPE_JUDGE默认off,不会把写入正文发给模型
测试与指标
- 自动化用例:217 / 217 通过
- 检索延迟:10,000 行语料 p95 ≈ 2.2ms;100,000 行 ≈ 5.8ms;1,000,000 行 ≈ 13.3ms;1M + 5 万向量 + 100 万 bigram ≈ 56ms(两段式有界检索,见 ADR-020)
- 黄金集(20 语料 / 24 问题):词面 MRR 0.776 → 混合检索 0.927
npm test
npm run bench # 延迟基准
npm run bench:golden # 黄金集
兼容性
- DeepSeek Harness 0.2.2-rc.3(Desktop,Windows)
- Node 24(使用内置
node:sqlite,无原生编译依赖) - 客户端零依赖:星图为 Canvas 2D 手写投影,不引入 three.js 等库
文档
- 设计规格(需求、架构、数据模型、契约、失败模式、追溯矩阵)
- 架构决策记录(26 份)
- 威胁模型(信任边界、残余风险、新增路由检查清单)
- 备份/恢复设计见 ADR-019
- 1M 行检索改造见 ADR-020
- 做梦校验的安全边界见 ADR-021
- 进程鉴权与加密的评估结论见 ADR-022
- 多值关系设计见 ADR-023
- 实体别名与多值画像见 ADR-024
- 用户设定见 ADR-026
- 远程 embedding 加固与 ANN 边界见 ADR-025
- 更新日志
- 架构图
许可证
CC BY-NC 4.0(署名 · 非商业)— 不是 OSI 开源许可,但源码完全公开可用。
- ✅ 可以:个人使用、学习、复制、修改、二次开发、借鉴设计,甚至发布你的修改版
- 🚫 不可以:任何商业用途(含公司内部生产使用、付费服务、SaaS、外包交付、销售/转售/捆绑收费)
- ⚠️ 必须:署名作者(保留作者、项目链接、协议声明;修改需注明「已修改」)
最低署名写法(可直接复制):
基于「全息记忆 (Omni Memory)」by wangzhen110
https://github.com/wangzhen110/dsh-omni-memory · CC BY-NC 4.0
已修改
完整署名规则与更多模板见 ATTRIBUTION.md,法律文本见 LICENSE。
商业授权
需要商业使用(公司内部生产经营、付费服务、SaaS/托管、外包交付、销售/转售/捆绑收费等)时, 请先取得作者书面许可。
优先渠道(推荐):在仓库开 Issue,公开可追踪、回复更快 https://github.com/wangzhen110/dsh-omni-memory/issues
备用渠道:64271785@qq.com(标题请注明「商业授权 + 用途」)
作者会在 3 个工作日内回复授权范围与费用。
No comments yet. Be the first to write one.