DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

wangzhen110 /

wangzhen110/dsh-omni-memory

Verified

全息记忆:DeepSeek Harness 长期记忆插件(源码可见 · 仅限个人自用 · 禁止商用与转售)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@2b6309f9

全息记忆(Omni memory)

给 DeepSeek Harness 的长期记忆内核:只增不改的原文留底 + 会自我校验的结论 + 按项目分层 + 三路混合召回。

⚠️ 许可提醒:本项目采用 CC BY-NC 4.0 —— 可自由使用、修改、二次开发、借鉴, 但禁止任何商业用途,且必须署名作者。商用请走 商业授权 流程。

tests license


它解决什么问题

普通对话记忆要么"全记"(噪声爆炸),要么"靠模型自觉"(漏记)。全息记忆把两件事拆开:

层 谁负责 特点
转录(原文) 系统自动 只增不改、可检索、可按上限墓碑化
结论(笔记/事实) 模型判断后写入 带来源、可校验、可遗忘、可修订
事实 结构化三元组 双时态(何时为真/何时失效),冲突自动失效旧值
实体图 事实自动生成 支持 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 个工作日内回复授权范围与费用。

—/ 5

No ratings yet

Verified DSH bundle

Commit 2b6309f9b10d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout