🧠 最强记忆大脑 dsh-memory-eternal — 给 DeepSeek Harness 装上「第二大脑」

对话结束自动沉淀，跨会话真实不失忆；召回只取相关小块，省 token、少噪音。 全自研、零第三方记忆框架、不改 DSH 源码、一条命令安装——为你装一个「自己说了算」的、可 git 管理的本地记忆库。

🔥 先看痛点：AI 助手为什么「总让人失望」？

这不是你的错觉，是绝大多数 AI 产品共通的硬伤。而解法，正是 Agent 记忆——总结 → 存储 → 按需召回。

🚀 装上它之后：五道痛点逐一被解决

flowchart LR
  A["对话每一轮"] --> B{"turn-stopping<br/>有没有可复用信号?"}
  B -- "无 → 跳过(省LLM)" --> X["❌ 不调模型"]
  B -- "有" --> C["LLM 压缩成知识卡"]
  C --> D{"去重核对"}
  D -- "同一主题" --> E["追加更新到已有卡"]
  D -- "新主题" --> F["写入 02-08 分类目录"]
  F & E --> G["本地 Markdown Vault"]
  G --> H["memory_recall 按需召回"]
  H --> I["AI 下次不再失忆"]

🧬 核心内核设计：为什么要「全自研」

市面上记忆方案很多，但大多依赖第三方框架 / 动不动就起一个 MCP 服务 / 把记忆锁进私有库。本插件把「记忆骨架」整个自己搭出来，零第三方运行时依赖，逻辑能逐行看懂：

与其他热门记忆项目的思路同向（总结→存储→按需召回），但定位不同。 参考同类热门思路，本插件主打「本地、自研、零依赖、可读可控」：

如果你已在用其中某一层，也完全能把本插件当「本地持久记忆底座」叠加使用——它只消费你已配置好的 provider，不抢模型、不改你的习惯。

✨ 功能总览（交互全在这里）

• 全自动沉淀：每轮结束自动判定+压缩成 300-800 字知识卡，无需手动保存
• 双层去重：Jaccard 词法 + 语义追加，不堆重复卡
• .md 全文：frontmatter 里带 kind/title/tags/created/updated，就是普通 Markdown
• Markdown 渲染、长卡折叠、新卡「新」角标、搜索命中高亮、卡片行删除
• 无限滚动懒加载、自定义滚动条配色
• 排序：最近 / 标题 / 热点（按连接数）

• 力导向/径向混合布局：按 kind 分扇区、枢纽在内圈、环间距不重叠，数量大也不乱；几千节点不卡
• 连线 = [[wikilink]] / 共享标签 / 相似度关联；只保留高影响力主干边避免毛球
• 交互：左键凸显关联、右键菜单（打开/凸显/复制/删除）、Shift 框选多选（导出/删除/合并）、图例过滤、时间维着色（3天内绿/2周琥珀/1月橙/更早灰蓝）、滚轮缩放、导图 PNG（下载/另存为/复制/全屏）

• 记忆库导出 MD / JSON、导入（自动去重）
• 导出可选默认下载或自选位置另存为
• 所有操作顶部醒目 toast：✓ 绿 = 成功、✕ 红 = 失败，并显示导出位置/文件名
• 可指向任意目录（如 Obsidian Vault）

🚀 安装（一条命令）

# 已发布后（npm）—— 跨平台通用
dsh plugin --profile web add dsh-memory-eternal

# 从 GitHub
dsh plugin --profile web add github:EternalNight996/dsh-memory-eternal

# 本地联调（改代码即时生效）
dsh plugin --profile web add F:/MyApp/eternal/dsh-memory-eternal

提示：

• dsh 为 DSH CLI（npm i -g @deepseek-ai/dsh）。
• 要官方最新（避免 npmmirror 滞后）：npm_config_registry=https://registry.npmjs.org/ dsh plugin --profile web add dsh-memory-eternal。
• profile 是 pnpm workspace：cd ~/.dsh/profiles/web && pnpm add dsh-memory-eternal@latest（npm install 会报 EUNSUPPORTEDPROTOCOL）。

装完重启 dsh web：设置 → 记忆 出现知识库；侧边栏底部出现「记忆」按钮。此后每轮对话自动沉淀。

🧭 插件发现 / 收录标准

仓库已打 GitHub dsh-plugin topic 并符合社区标准结构，自动被以下机制发现（无需手动 PR）：

🔧 设置

🛠 开发 / 构建 / 测试

npm i
npm test        # 单元测试：vault 去重/检索/图谱 + capture 管线 + API 形状
npm run build   # 打包 client（改 src/client 后需要；改 index.js / lib 无需构建）

dsh-memory-eternal/
├── index.js             # host：设置 + turn-stopping 钩子 + 工具 + JSON API
├── lib/
│   ├── vault.js         # 存储层（frontmatter/去重/检索/图谱）
│   └── capture.js       # 自动沉淀管线（LLM 压缩 + 语义去重 + 预筛）
├── src/client/index.tsx # client：设置页 + 侧边栏「记忆」+ 完整记忆库弹窗
├── build.mjs            # esbuild 打包 client → lib/client.js
├── cordis.patch.yml     # bundle 补丁层（自动挂载 host 行）
└── tests/               # node:test 单测

🗺 Roadmap / 待办（记忆侧核心优化）

已实现：

• 自动沉淀 + 双层去重 + 日配额
• CJK 检索 + 图谱 + 召回工具
• 交互图谱（图例/时间维/框选/删除合并/导出）
• 知识卡管理（MD渲染/折叠/新角标/搜索高亮/无限滚动）
• 备份导入导出（MD/JSON）
• 沉淀预筛（skip LLM）+ 召回相关性/截断（v0.4.3）
• 注入体积可配置（召回条数/摘要长度/是否带正文，设置项）
• 多 Vault / 多 Profile（命名分库，当前激活一个）
• 每日回顾 + 用量统计（今日新增/近7天/分类/今日沉淀清单）
• 整理建议（相似卡对合并/陈旧卡，非破坏预览）
• 召回用户反馈（/feedback，为相关性调优留数据）
• 会话预算（sessionBudgetChars + /budget）

待办（核心功能优化）：

• 多 Vault / 多 Profile、注入体积可配置、每日回顾+用量、自动归档整理、召回用户反馈、会话级 token 预算（v0.4.5）
• 批量智能合并（相似度预分组一键合并）、跨库聚合图谱/检索（vault 级）、语义召回升级（本地 bigram 语义加分，recallEmbedding 预留 embedding）、每日回顾定时生成（00-System/daily-*，30min 轮询幂等）（v0.4.6）
• 上下文压缩接入 harness：记忆侧 /compress 已就绪，待 harness 在会话内调「召回替代 + 压缩旧轮」（需 harness 配合）
• 多 Vault 的跨库合并/去重（跨 profile 识别重复卡）
• 语义召回接入外部 embedding provider（当前为本地零依赖加分）
• 每日回顾主动推送通道（当前生成文件 + 手动查看，推送需 harness/通知渠道）

📦 发布记录

• v0.4.6：记忆侧优化收官——批量智能合并（按相似度并查集聚类、一键合并多组）、跨库聚合图谱/检索（?all=1，多 Vault 合并展示）、语义召回升级（本地 Jaccard bigram 语义加分，recallEmbedding 预留 embedding）、每日回顾定时生成（00-System/daily-YYYY-MM-DD.md，30 分钟轮询幂等）、今日简报（/todayBrief，管理面板一键查看）。
• v0.4.5：记忆侧核心功能优化——注入体积可配置、多 Vault/多 Profile、每日回顾+用量统计、自动归档整理建议（非破坏预览）、召回用户反馈、会话级 token 预算、上下文压缩接口（/compress）。
• v0.4.3：记忆侧省 token/提质量——沉淀预筛（无可复用信号直接跳过、不触发 LLM）；召回按 minScore 过滤弱命中、注入片段截断到 130 字。
• v0.4.2：修复 GitHub/npm 顶部演示 GIF 无法显示（压缩至 README 10MB 阈值以下，8MB）。
• v0.4.1：Marketplace 收录标准落地（dsh.marketplace 元数据 + 自动扫描规则说明）。
• v0.4.0：图谱交互全面增强（图例过滤/时间维/右键菜单/框选/删除合并/导出PNG另存自选位置）+ 知识卡增强（MD渲染/长卡折叠/新角标/搜索高亮/删除/无限滚动）+ 相似度关联 + 导入导出 + 顶部绿红 toast。
• v0.3.0：知识图谱科学布局（多环径向/主干边/默认仅枢纽标签/大图关发光）。
• v0.2.x：GitHub 源安装修复、安装说明跨平台化/去 npx、分类扩展（工具/教训）、peer 依赖放宽。
• v0.1.0：首个可用版本（自动沉淀 + 召回工具 + Markdown Vault + CJK 检索 + 图谱 + 设置页）。

📄 License

MIT

让 DSH 真正记住你：对话自动沉淀，知识随手可查。　⭐ 觉得有用就点个 Star，Let's make AI not forget.