🧠 dsh-memory-eternal — 给 AI 装「第二大脑」

🍴 本仓库是 fork（维护版），不是原作者仓库

原作者 / 原项目：EternalNight996/dsh-memory-eternal（MIT；代码版权与署名归原作者）。本 fork 由 pokiimon 维护，基线取自 Kewnn 的兼容性 PR #7。 fork 的改动集中在：DSH 0.2.0-rc.x 兼容性（客户端 inject、设置写入通道、捕获钩子）+ 界面改进（左下角入口改为嵌入式卡片、独立配置页图标、只读写接口口径修正）。上游若合并同类修复，请优先用上游版本。

🚨 重要：已升级到新版本 memory-eternal

本插件已升级为面向 多智能体通用 的独立新项目，不再只依赖单一 DSH 服务。新功能与持续开发请移步：

📦 npm：npm i memory-eternal（or dsh plugin --profile web add memory-eternal）

🐙 GitHub / Gitee：EternalNight996/memory-eternal

npm version GitHub stars license

对话结束自动沉淀，跨会话不失忆；召回只取相关小块，省 token 少噪音。 全自研、零第三方记忆框架、不改 DSH 源码、一个记忆库所有 Agent 共享，纯 Markdown 可 git 管理。

⭐ 觉得好用就点个 Star！
_{DSH 一条命令：dsh plugin --profile web add dsh-memory-eternal}

对话自动沉淀 + 图形化知识库 + 知识图谱（演示）

🚀 五分钟上手

🟦 DeepSeek Harness（DSH）—— 重点

装（dsh-desktop 用 DSH CLI，一条命令）：

# dsh-desktop 用户（推荐）：DSH CLI 直接装进 profile
dsh plugin --profile web add dsh-memory-eternal

# 或直接在 profile（pnpm workspace）里更新。注意用 pnpm，npm install 会报 EUNSUPPORTEDPROTOCOL
cd ~/.dsh/profiles/web && pnpm add dsh-memory-eternal@latest

重启 dsh web 后，三样东西立即生效：

效果	在哪看
自动沉淀知识卡	每轮对话结束自动发生，无需操作
`memory_recall` 工具	Agent 需要历史时自动调用
图形化界面	侧边栏底部「记忆」按钮 / 设置 → 记忆

入口：侧边栏底部「记忆」按钮 → 记忆库（左栏含知识卡 / 知识图谱 / 用量 / 审核中心 / 回收中心 / 记忆配置）；「DSH 设置 → 记忆」= 纯配置页。

改配置：记忆库左栏「记忆配置」（或 DSH 设置 → 记忆）→ DSH 记忆配置 / 成本控制 / 自动审核配置 / 服务自管理，点「保存配置」即写入。autoWebMode/watchdogAutoSpawn 的改动需重启 DSH 生效。

🟨 Claude Code

npm i -g dsh-memory-eternal     # 装 CLI + MCP（写 ~/.claude.json mcpServers.memory）
dsh-memory connect claude       # 写 ~/.claude/settings.json 的 SessionEnd hook → 会话结束自动沉淀

装完即用：会话里说「recall 一下数据库选型」→ 自动检索记忆；会话结束 → 自动沉淀进统一 ~/.dsh/memory-vault（新卡 pending 待审核）。

🟧 Codex CLI / Cursor

npm i -g dsh-memory-eternal     # 装完自动写 Codex config.toml / Cursor mcp.json 的 mcpServers.memory
dsh-memory connect codex        # 写用户级 ~/.codex/hooks.json 的 Stop hook → 会话结束自动沉淀（含 Codex Desktop）
dsh-memory connect cursor       # 写 ~/.cursor/hooks.json 的 stop/sessionEnd hook → 自动沉淀

重启工具 → MCP 已在列表，会话里直接：用 memory_recall 查一下项目历史决策；会话结束自动沉淀进统一 ~/.dsh/memory-vault（新卡 pending 待审核）。

三种 agent 同一套库：全部写入 ~/.dsh/memory-vault，每卡 submittedBy 区分作者（DeepSeek Harness / claude-code / codex / cursor），主库只显已审核、审核中心管新卡。

原生插件（可选，平台 Marketplace）：仓库含 .claude-plugin / .codex-plugin / .cursor-plugin 清单，可 claude /plugin marketplace add EternalNight996/dsh-memory-eternal + /plugin install、codex plugin marketplace add EternalNight996/dsh-memory-eternal + codex plugin add、Cursor Settings→Plugins。connect 走用户级 hooks.json（更稳，不依赖 Marketplace 审核；Codex Desktop 也走这条）。

只保留本插件（卸载其它记忆插件，如 agentmemory）：dsh-memory 只写自己的键（mcpServers.memory / 含 capture.mjs 的 hooks），不依赖、也不冲突任何其它记忆插件。卸载其它插件需在其自身配置层删除对应条目（如 Codex 的 [marketplaces.*] 与 hooks.state.*、其 hooks.json 事件、~/.agentmemory 数据目录）。

🟩 浏览器（不依赖任何 Agent）

dsh-memory open    # 起 web + 开浏览器（默认 http://127.0.0.1:7999）

统计 / 搜索 / 知识卡（增删改合并导入导出）/ 知识图谱，全在此。与 DSH 内嵌页同一份 UI，数据同步。

zcode（智谱）：暂无原生 MCP，经社区 zcode-open-bridge 转 MCP 或用 CLI。

📖 命令速查

dsh-memory recall "数据库选型"       # 检索
dsh-memory capture "重要结论..."     # 手动沉淀（- 读 stdin）
dsh-memory sweep ~/.claude/projects  # 挖掘已有会话记录
dsh-memory setup [--dry-run]         # 重跑/预览自动挂载（幂等）
dsh-memory connect <claude|codex|cursor>  # 写会话结束自动沉淀 hook（用户级 hooks.json，含 Codex Desktop）
dsh-memory mcp                       # MCP stdio（挂任意 MCP 客户端）
dsh-memory serve [--port 7999]       # 前台跑 web
dsh-memory open                      # ensure web 存活 + 开浏览器
dsh-memory watchdog [--port 7799]    # 看门狗保活 web（独立进程）

单独装（不发 DSH）时 dsh-memory 命令来自 npm i -g。

⚙️ 服务自管理（白话）

三个概念，别搞混：

web server 怎么保活（autoWebMode）→ init=DSH 启动时拉一次（默认）；interval=DSH 进程内定时探活自动拉起（0 额外内存）；manual=全手动只从 dsh-memory open 起。
看门狗进程（watchdogAutoSpawn，默认开）→ 一个独立 node 进程，DSH 退出了它也能拉起 web（约 +47 MB 内存）。只在要 7×24 保活时开。
自动挂载 MCP（autoMcpSetup，默认关）→ 是否自动把 MCP 写进 Claude Code/Codex/Cursor 配置。关 = 不碰你本机配置文件，需要时手动 dsh-memory setup。

改这些：记忆库左栏「记忆配置」（或 DSH 设置 → 记忆）→ 表格里改，点「保存配置」；autoWebMode/watchdogAutoSpawn 需重启 DSH 生效。

MCP 是协议不是常驻服务：agent 开会话才 spawn，用完即退，没有「开机自启」一说。

三种部署强度

场景	配置	内存
个人开发（默认）	`autoWebMode=init` + `watchdogAutoSpawn=off`	web 47 MB
常驻 7×24	`watchdogAutoSpawn=on`	web + watchdog 47+47 MB
真正开机自启（无 DSH）	Windows 计划任务跑 `dsh-memory watchdog --port 7799 --interval 5000 --max-restart 10`	同上

⚙️ 记忆配置（大白话）

所有配置都在 记忆库左栏「记忆配置」（或 DSH 设置 → 记忆）里改，点「保存配置」生效。下图就是配置页全貌（含插件信息 / Agent MCP 挂载状态 / 自动审核配置）：

记忆配置页

一、最常用

配置项	默认	大白话说明
自动沉淀	开	每轮聊完自动把有用的内容存成知识卡
自动召回	开	AI 需要历史时自动帮你查记忆
记忆库目录	`~/.dsh/memory-vault`	记忆存哪，纯 Markdown 可 git 管理

二、省钱包（重要）

配置项	默认	大白话说明
蒸馏知识卡	开	把对话压缩成精炼知识卡（要调 AI，花钱）。关掉 = 存原文，一分钱不花
语义去重喂 AI	开	判断新内容是不是重复（要调 AI）。关掉 = 用简单去重，省一次 AI 调用
蒸馏输出上限	900	压缩一次最多写多少字，越大越准越费钱
召回相关性阈值	2	检索要「多像」才返回，越大越准但漏得越多（越省）
捕获最小长度	200	对话太短不存，避免闲聊浪费
日配额	60	一天最多存几张，防 AI 烧钱
沉淀诊断日志	关	打开后每次跳过都会在宿主控制台留下 `[memory-eternal] capture: …`，用于排查「库里一直没有卡」
无路由时存原文卡	关	解析不出模型路由（宿主只暴露"可配置 provider 目录"这类情况）时，仍落一张原文卡，而不是静默放弃

设置页能不能直接改配置？ 看宿主。0.1.x 时代插件持有可写的设置段，页面直接写； 0.2.x 移除了该 API，插件改为把「保存」翻译成宿主的 SettingsForms.mutate(ns, ops) 持久化（自 0.7.2 起）。并且宿主只接受标了 volatile 的字段，否则报 Plugin entry "memory-eternal" has no volatile fields。所以自 0.7.3 起按「运行时是否每次重新读」划线：沉淀 / 召回 / 去重 / 审核 / 回收 / 库位置这些字段标了 volatile，保存后立即生效；autoMcpSetup、autoWeb、autoWebMode、webPort、 webCheckIntervalMs、webMaxRestart、watchdogAutoSpawn 只在启动阶段读一次，宿主会拒写并提示改 profile 的 cordis.patch.yml 行 config 再重启。

⚠️ 标了 volatile 的字段，宿主交给插件的是「引用对象」而不是值（要 .get() 才是当前值，等价于宿主内部的 plainConfig()）。所以插件读配置前先做一层还原——少了这层， schema 里一标 volatile，启动就 TypeError: cfg.vaultDir.trim is not a function，整个 fiber 挂掉、路由全部没挂上（自 0.7.4 起修）。

🧩 设置页整份表单一起提交也不会失败（自 0.7.5 起迭代到 0.7.6）：页面里既有沉淀/召回这类热改字段，也有端口 / 保活 / 看门狗这类启动期字段，而宿主是按字段逐个校验的。现在的做法是两类字段都标 volatile、都能存下来，插件再单独点名哪些「需要重启 DSH 才生效」（返回里的 needsRestart，GET /config 也会给出 bootOnly 清单）——写下去 ≠ 立刻生效，这一点如实说，不假装热改。

沉淀为什么没出卡？ 自动沉淀在每轮结束时按顺序过四道关：开关 → 本轮文本长度（捕获最小长度，计的是该轮用户+助手文本）→ 日配额 → 模型路由（resolveRoute）。前两道被卡住是设计使然；第四道以前是静默返回——宿主没给可用路由时既没卡、也没任何提示。现在打开「沉淀诊断日志」就能看到具体是哪一道，或者直接打开「无路由时存原文卡」让内容先落盘。

🐞 0.2.x 上还有一道更隐蔽的坑（自 0.7.7 起修）：会话事件在 agent.session.snapshotEvents() 上，而 agent.session 没有 events 字段（宿主 packages/core/session/src/index.ts:649）。老代码只认 .events → 钩子在 Array.isArray 那一步静默 return：没卡、没报错，连 captureDebug 的日志都不会出现（因为连 runCapture 都没进）。现在统一走 resolveSessionEvents() 兼容读取（快照方法 → 旧字段 → 空数组），钩子层自己也会写诊断：控制台 + $DSH_HOME/memory-eternal-capture.log。

🧭 插件在会话中途被加载/重启时不会吞掉整段历史（自 0.7.8 起）：第一次见到某个会话只登记水位线、跳过存量事件，从下一轮开始增量沉淀；单轮文本超过 TURN_TEXT_MAX（20000 字符）时保留最新部分。否则重启后的第一轮会把整段会话一次性喂给模型（贵、且会产出一张巨大的垃圾卡）。

三、服务怎么跑

配置项	默认	大白话说明
保活模式 `autoWebMode`	init	`init`=DSH 启动时开一次 web；`interval`=定时检查挂了自动重启；`manual`=全靠手动
看门狗 `watchdogAutoSpawn`	开	后台一个独立进程保证 web 不死（+47 MB 内存）。个人用可关
自动挂载 MCP `autoMcpSetup`	关	让 Claude Code / Codex / Cursor 也能用你的记忆库。开=自动配好它们；关=不碰你电脑配置，手动跑 `dsh-memory setup`

💰 想省钱：把「蒸馏知识卡」关掉、调低「蒸馏输出上限」、调高「召回相关性阈值」。

🎯 一键推荐配置（按场景点一下）

配置页顶部有 🟢 A 轻量省心 / 💰 B 极致省钱 / ⭐ C 高质量 三个按钮，点一下自动填好对应值，再点保存即可：

方案	场景	保活	看门狗	蒸馏	蒸馏上限	召回阈值	内存	LLM 成本
🟢 A 轻量省心	个人开发（默认）	init	关	开	900	2	~47 MB	正常
💰 B 极致省钱	预算敏感/多 Agent	init	关	关	500	3	~47 MB	近 0
⭐ C 高质量	长项目/团队	interval	开	开	1200	1	~94 MB	高

🛡️ 审核中心 & 回收中心

新卡默认进审核中心（pending），由你确认后才入主库；驳回的进「已驳回」，可恢复或删除进回收站。命中免审条件（审核模式=全部免审 / 免审智能体 / 免审类型）的新卡直接入库；回收站软删卡 30 天内可恢复，超期自动永久删除。

审核中心

待审核 / 已驳回 双页签，按类型 / 日期 / 智能体筛选，全选后一键「批准 / 驳回 / 删除进回收站」。
审核规则在「记忆配置 → 自动审核配置」：审核模式（全部要审 / 全部免审）+ 免审智能体 + 免审类型 + 回收保留天数。

🥇 为什么审核系统更靠谱（对比其它记忆产品）

多数记忆产品（mem0 / Zep / agentmemory…）对话一结束就自动全量入库，好坏不论——噪音、错误事实、敏感内容一起进库，之后又被召回，污染上下文、放大幻觉。

dsh-memory-eternal 走人机协同审核，只让可信内容进主库：

维度	其它记忆产品	dsh-memory-eternal 审核系统
入库	自动全量，无把关	新卡先进审核中心（pending），人工批准才入主库
质量	未过滤噪音/错误	只保留你确认过的卡 → 召回更准、噪声更低
可信	无来源/审核追溯	每卡带 `submittedBy` 作者 + `pending/approved/rejected` 审核状态
免打扰	—	免审智能体 / 免审类型命中 → 可信卡直接入库，零等待
容错	删了就没	回收站软删，30 天内可恢复

🧬 为什么全自研

市面上记忆方案多，但大多依赖第三方框架 / 动不动起 MCP 服务 / 记忆锁私有库。本插件把骨架自己搭，零第三方运行时依赖，逻辑逐行可读：

模块	自研实现	替代什么
去重	词法 Jaccard bigram（0.62）+ 语义去重	防重复卡
检索	CJK 感知：中文整词 + 字符 bigram	无需全文搜索引擎
图谱	力导向 + `[[wikilink]]`/共享标签连边	知识关联一眼看清
存储	带 frontmatter 的普通 `.md`	不锁库、可读、可 git、可被任意工具读

与热门项目同向（总结→存储→按需召回），但定位不同：本地、自研、零依赖、可读可控。如果你已在用 mem0/Zep 等，也能把它当「本地持久记忆底座」叠加使用。

🛠 开发 / 测试

npm i
npm test        # 单元测试：vault 去重/检索/图谱 + capture 管线 + API 形状
npm run build   # 构建 lib/client.js（DSH 内嵌）+ web/app.js（独立 web bundle）

📄 License

MIT

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

English README: README.en.md

🧠 dsh-memory-eternal — 给 AI 装「第二大脑」

🍴 本仓库是 fork（维护版），不是原作者仓库

原作者 / 原项目：EternalNight996/dsh-memory-eternal（MIT；代码版权与署名归原作者）。本 fork 由 pokiimon 维护，基线取自 Kewnn 的兼容性 PR #7。 fork 的改动集中在：DSH 0.2.0-rc.x 兼容性（客户端 inject、设置写入通道、捕获钩子）+ 界面改进（左下角入口改为嵌入式卡片、独立配置页图标、只读写接口口径修正）。上游若合并同类修复，请优先用上游版本。

🚨 重要：已升级到新版本 memory-eternal

本插件已升级为面向 多智能体通用 的独立新项目，不再只依赖单一 DSH 服务。新功能与持续开发请移步：

📦 npm：npm i memory-eternal（or dsh plugin --profile web add memory-eternal）

🐙 GitHub / Gitee：EternalNight996/memory-eternal

npm version GitHub stars license

对话结束自动沉淀，跨会话不失忆；召回只取相关小块，省 token 少噪音。 全自研、零第三方记忆框架、不改 DSH 源码、一个记忆库所有 Agent 共享，纯 Markdown 可 git 管理。

⭐ 觉得好用就点个 Star！
_{DSH 一条命令：dsh plugin --profile web add dsh-memory-eternal}

对话自动沉淀 + 图形化知识库 + 知识图谱（演示）

🚀 五分钟上手

🟦 DeepSeek Harness（DSH）—— 重点

装（dsh-desktop 用 DSH CLI，一条命令）：

# dsh-desktop 用户（推荐）：DSH CLI 直接装进 profile
dsh plugin --profile web add dsh-memory-eternal

# 或直接在 profile（pnpm workspace）里更新。注意用 pnpm，npm install 会报 EUNSUPPORTEDPROTOCOL
cd ~/.dsh/profiles/web && pnpm add dsh-memory-eternal@latest

重启 dsh web 后，三样东西立即生效：

效果	在哪看
自动沉淀知识卡	每轮对话结束自动发生，无需操作
`memory_recall` 工具	Agent 需要历史时自动调用
图形化界面	侧边栏底部「记忆」按钮 / 设置 → 记忆

🟨 Claude Code

npm i -g dsh-memory-eternal     # 装 CLI + MCP（写 ~/.claude.json mcpServers.memory）
dsh-memory connect claude       # 写 ~/.claude/settings.json 的 SessionEnd hook → 会话结束自动沉淀

装完即用：会话里说「recall 一下数据库选型」→ 自动检索记忆；会话结束 → 自动沉淀进统一 ~/.dsh/memory-vault（新卡 pending 待审核）。

🟧 Codex CLI / Cursor

npm i -g dsh-memory-eternal     # 装完自动写 Codex config.toml / Cursor mcp.json 的 mcpServers.memory
dsh-memory connect codex        # 写用户级 ~/.codex/hooks.json 的 Stop hook → 会话结束自动沉淀（含 Codex Desktop）
dsh-memory connect cursor       # 写 ~/.cursor/hooks.json 的 stop/sessionEnd hook → 自动沉淀

重启工具 → MCP 已在列表，会话里直接：用 memory_recall 查一下项目历史决策；会话结束自动沉淀进统一 ~/.dsh/memory-vault（新卡 pending 待审核）。

三种 agent 同一套库：全部写入 ~/.dsh/memory-vault，每卡 submittedBy 区分作者（DeepSeek Harness / claude-code / codex / cursor），主库只显已审核、审核中心管新卡。

原生插件（可选，平台 Marketplace）：仓库含 .claude-plugin / .codex-plugin / .cursor-plugin 清单，可 claude /plugin marketplace add EternalNight996/dsh-memory-eternal + /plugin install、codex plugin marketplace add EternalNight996/dsh-memory-eternal + codex plugin add、Cursor Settings→Plugins。connect 走用户级 hooks.json（更稳，不依赖 Marketplace 审核；Codex Desktop 也走这条）。

只保留本插件（卸载其它记忆插件，如 agentmemory）：dsh-memory 只写自己的键（mcpServers.memory / 含 capture.mjs 的 hooks），不依赖、也不冲突任何其它记忆插件。卸载其它插件需在其自身配置层删除对应条目（如 Codex 的 [marketplaces.*] 与 hooks.state.*、其 hooks.json 事件、~/.agentmemory 数据目录）。

🟩 浏览器（不依赖任何 Agent）

dsh-memory open    # 起 web + 开浏览器（默认 http://127.0.0.1:7999）

统计 / 搜索 / 知识卡（增删改合并导入导出）/ 知识图谱，全在此。与 DSH 内嵌页同一份 UI，数据同步。

zcode（智谱）：暂无原生 MCP，经社区 zcode-open-bridge 转 MCP 或用 CLI。

📖 命令速查

dsh-memory recall "数据库选型"       # 检索
dsh-memory capture "重要结论..."     # 手动沉淀（- 读 stdin）
dsh-memory sweep ~/.claude/projects  # 挖掘已有会话记录
dsh-memory setup [--dry-run]         # 重跑/预览自动挂载（幂等）
dsh-memory connect <claude|codex|cursor>  # 写会话结束自动沉淀 hook（用户级 hooks.json，含 Codex Desktop）
dsh-memory mcp                       # MCP stdio（挂任意 MCP 客户端）
dsh-memory serve [--port 7999]       # 前台跑 web
dsh-memory open                      # ensure web 存活 + 开浏览器
dsh-memory watchdog [--port 7799]    # 看门狗保活 web（独立进程）

单独装（不发 DSH）时 dsh-memory 命令来自 npm i -g。

⚙️ 服务自管理（白话）

三个概念，别搞混：

web server 怎么保活（autoWebMode）→ init=DSH 启动时拉一次（默认）；interval=DSH 进程内定时探活自动拉起（0 额外内存）；manual=全手动只从 dsh-memory open 起。
看门狗进程（watchdogAutoSpawn，默认开）→ 一个独立 node 进程，DSH 退出了它也能拉起 web（约 +47 MB 内存）。只在要 7×24 保活时开。
自动挂载 MCP（autoMcpSetup，默认关）→ 是否自动把 MCP 写进 Claude Code/Codex/Cursor 配置。关 = 不碰你本机配置文件，需要时手动 dsh-memory setup。

改这些：记忆库左栏「记忆配置」（或 DSH 设置 → 记忆）→ 表格里改，点「保存配置」；autoWebMode/watchdogAutoSpawn 需重启 DSH 生效。

MCP 是协议不是常驻服务：agent 开会话才 spawn，用完即退，没有「开机自启」一说。

三种部署强度

场景	配置	内存
个人开发（默认）	`autoWebMode=init` + `watchdogAutoSpawn=off`	web 47 MB
常驻 7×24	`watchdogAutoSpawn=on`	web + watchdog 47+47 MB
真正开机自启（无 DSH）	Windows 计划任务跑 `dsh-memory watchdog --port 7799 --interval 5000 --max-restart 10`	同上

⚙️ 记忆配置（大白话）

所有配置都在 记忆库左栏「记忆配置」（或 DSH 设置 → 记忆）里改，点「保存配置」生效。下图就是配置页全貌（含插件信息 / Agent MCP 挂载状态 / 自动审核配置）：

记忆配置页

一、最常用

配置项	默认	大白话说明
自动沉淀	开	每轮聊完自动把有用的内容存成知识卡
自动召回	开	AI 需要历史时自动帮你查记忆
记忆库目录	`~/.dsh/memory-vault`	记忆存哪，纯 Markdown 可 git 管理

二、省钱包（重要）

配置项	默认	大白话说明
蒸馏知识卡	开	把对话压缩成精炼知识卡（要调 AI，花钱）。关掉 = 存原文，一分钱不花
语义去重喂 AI	开	判断新内容是不是重复（要调 AI）。关掉 = 用简单去重，省一次 AI 调用
蒸馏输出上限	900	压缩一次最多写多少字，越大越准越费钱
召回相关性阈值	2	检索要「多像」才返回，越大越准但漏得越多（越省）
捕获最小长度	200	对话太短不存，避免闲聊浪费
日配额	60	一天最多存几张，防 AI 烧钱
沉淀诊断日志	关	打开后每次跳过都会在宿主控制台留下 `[memory-eternal] capture: …`，用于排查「库里一直没有卡」
无路由时存原文卡	关	解析不出模型路由（宿主只暴露"可配置 provider 目录"这类情况）时，仍落一张原文卡，而不是静默放弃

设置页能不能直接改配置？ 看宿主。0.1.x 时代插件持有可写的设置段，页面直接写； 0.2.x 移除了该 API，插件改为把「保存」翻译成宿主的 SettingsForms.mutate(ns, ops) 持久化（自 0.7.2 起）。并且宿主只接受标了 volatile 的字段，否则报 Plugin entry "memory-eternal" has no volatile fields。所以自 0.7.3 起按「运行时是否每次重新读」划线：沉淀 / 召回 / 去重 / 审核 / 回收 / 库位置这些字段标了 volatile，保存后立即生效；autoMcpSetup、autoWeb、autoWebMode、webPort、 webCheckIntervalMs、webMaxRestart、watchdogAutoSpawn 只在启动阶段读一次，宿主会拒写并提示改 profile 的 cordis.patch.yml 行 config 再重启。

⚠️ 标了 volatile 的字段，宿主交给插件的是「引用对象」而不是值（要 .get() 才是当前值，等价于宿主内部的 plainConfig()）。所以插件读配置前先做一层还原——少了这层， schema 里一标 volatile，启动就 TypeError: cfg.vaultDir.trim is not a function，整个 fiber 挂掉、路由全部没挂上（自 0.7.4 起修）。

🧩 设置页整份表单一起提交也不会失败（自 0.7.5 起迭代到 0.7.6）：页面里既有沉淀/召回这类热改字段，也有端口 / 保活 / 看门狗这类启动期字段，而宿主是按字段逐个校验的。现在的做法是两类字段都标 volatile、都能存下来，插件再单独点名哪些「需要重启 DSH 才生效」（返回里的 needsRestart，GET /config 也会给出 bootOnly 清单）——写下去 ≠ 立刻生效，这一点如实说，不假装热改。

沉淀为什么没出卡？ 自动沉淀在每轮结束时按顺序过四道关：开关 → 本轮文本长度（捕获最小长度，计的是该轮用户+助手文本）→ 日配额 → 模型路由（resolveRoute）。前两道被卡住是设计使然；第四道以前是静默返回——宿主没给可用路由时既没卡、也没任何提示。现在打开「沉淀诊断日志」就能看到具体是哪一道，或者直接打开「无路由时存原文卡」让内容先落盘。

🐞 0.2.x 上还有一道更隐蔽的坑（自 0.7.7 起修）：会话事件在 agent.session.snapshotEvents() 上，而 agent.session 没有 events 字段（宿主 packages/core/session/src/index.ts:649）。老代码只认 .events → 钩子在 Array.isArray 那一步静默 return：没卡、没报错，连 captureDebug 的日志都不会出现（因为连 runCapture 都没进）。现在统一走 resolveSessionEvents() 兼容读取（快照方法 → 旧字段 → 空数组），钩子层自己也会写诊断：控制台 + $DSH_HOME/memory-eternal-capture.log。

🧭 插件在会话中途被加载/重启时不会吞掉整段历史（自 0.7.8 起）：第一次见到某个会话只登记水位线、跳过存量事件，从下一轮开始增量沉淀；单轮文本超过 TURN_TEXT_MAX（20000 字符）时保留最新部分。否则重启后的第一轮会把整段会话一次性喂给模型（贵、且会产出一张巨大的垃圾卡）。

三、服务怎么跑

配置项	默认	大白话说明
保活模式 `autoWebMode`	init	`init`=DSH 启动时开一次 web；`interval`=定时检查挂了自动重启；`manual`=全靠手动
看门狗 `watchdogAutoSpawn`	开	后台一个独立进程保证 web 不死（+47 MB 内存）。个人用可关
自动挂载 MCP `autoMcpSetup`	关	让 Claude Code / Codex / Cursor 也能用你的记忆库。开=自动配好它们；关=不碰你电脑配置，手动跑 `dsh-memory setup`

💰 想省钱：把「蒸馏知识卡」关掉、调低「蒸馏输出上限」、调高「召回相关性阈值」。

🎯 一键推荐配置（按场景点一下）

配置页顶部有 🟢 A 轻量省心 / 💰 B 极致省钱 / ⭐ C 高质量 三个按钮，点一下自动填好对应值，再点保存即可：

方案	场景	保活	看门狗	蒸馏	蒸馏上限	召回阈值	内存	LLM 成本
🟢 A 轻量省心	个人开发（默认）	init	关	开	900	2	~47 MB	正常
💰 B 极致省钱	预算敏感/多 Agent	init	关	关	500	3	~47 MB	近 0
⭐ C 高质量	长项目/团队	interval	开	开	1200	1	~94 MB	高

🛡️ 审核中心 & 回收中心

审核中心

待审核 / 已驳回 双页签，按类型 / 日期 / 智能体筛选，全选后一键「批准 / 驳回 / 删除进回收站」。
审核规则在「记忆配置 → 自动审核配置」：审核模式（全部要审 / 全部免审）+ 免审智能体 + 免审类型 + 回收保留天数。

🥇 为什么审核系统更靠谱（对比其它记忆产品）

dsh-memory-eternal 走人机协同审核，只让可信内容进主库：

维度	其它记忆产品	dsh-memory-eternal 审核系统
入库	自动全量，无把关	新卡先进审核中心（pending），人工批准才入主库
质量	未过滤噪音/错误	只保留你确认过的卡 → 召回更准、噪声更低
可信	无来源/审核追溯	每卡带 `submittedBy` 作者 + `pending/approved/rejected` 审核状态
免打扰	—	免审智能体 / 免审类型命中 → 可信卡直接入库，零等待
容错	删了就没	回收站软删，30 天内可恢复

🧬 为什么全自研

市面上记忆方案多，但大多依赖第三方框架 / 动不动起 MCP 服务 / 记忆锁私有库。本插件把骨架自己搭，零第三方运行时依赖，逻辑逐行可读：

模块	自研实现	替代什么
去重	词法 Jaccard bigram（0.62）+ 语义去重	防重复卡
检索	CJK 感知：中文整词 + 字符 bigram	无需全文搜索引擎
图谱	力导向 + `[[wikilink]]`/共享标签连边	知识关联一眼看清
存储	带 frontmatter 的普通 `.md`	不锁库、可读、可 git、可被任意工具读

与热门项目同向（总结→存储→按需召回），但定位不同：本地、自研、零依赖、可读可控。如果你已在用 mem0/Zep 等，也能把它当「本地持久记忆底座」叠加使用。

🛠 开发 / 测试

npm i
npm test        # 单元测试：vault 去重/检索/图谱 + capture 管线 + API 形状
npm run build   # 构建 lib/client.js（DSH 内嵌）+ web/app.js（独立 web bundle）

📄 License

MIT

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

English README: README.en.md

pokiimon/dsh-memory-eternal-fork

🧠 dsh-memory-eternal — 给 AI 装「第二大脑」

🍴 本仓库是 fork（维护版），不是原作者仓库

🚨 重要：已升级到新版本 memory-eternal

🚀 五分钟上手

🟦 DeepSeek Harness（DSH）—— 重点

🟨 Claude Code

🟧 Codex CLI / Cursor

🟩 浏览器（不依赖任何 Agent）

📖 命令速查

⚙️ 服务自管理（白话）

三种部署强度

⚙️ 记忆配置（大白话）

一、最常用

二、省钱包（重要）

三、服务怎么跑

🎯 一键推荐配置（按场景点一下）

🛡️ 审核中心 & 回收中心

🥇 为什么审核系统更靠谱（对比其它记忆产品）

🧬 为什么全自研

🛠 开发 / 测试

📄 License

Community comments

pokiimon/dsh-memory-eternal-fork

🧠 dsh-memory-eternal — 给 AI 装「第二大脑」

🍴 本仓库是 fork（维护版），不是原作者仓库

🚨 重要：已升级到新版本 memory-eternal

🚀 五分钟上手

🟦 DeepSeek Harness（DSH）—— 重点

🟨 Claude Code

🟧 Codex CLI / Cursor

🟩 浏览器（不依赖任何 Agent）

📖 命令速查

⚙️ 服务自管理（白话）

三种部署强度

⚙️ 记忆配置（大白话）

一、最常用

二、省钱包（重要）

三、服务怎么跑

🎯 一键推荐配置（按场景点一下）

🛡️ 审核中心 & 回收中心

🥇 为什么审核系统更靠谱（对比其它记忆产品）

🧬 为什么全自研

🛠 开发 / 测试

📄 License

Community comments