memory-eternal 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
+  "name": "memory-eternal",
+  "version": "0.1.0",
+  "description": "璁板繂鏍稿績锛圡emory Eternal锛夛細鐭ヨ瘑鍗¤嚜鍔ㄦ矇娣€/鍙洖锛岀粺涓€ ~/.dsh/memory-vault锛屼細璇濈粨鏉熻嚜鍔ㄥ叆搴撹繘寰呭鏍搞€?,
+  "author": {
+    "name": "EternalNight996",
+    "url": "https://github.com/EternalNight996"
+  },
+  "license": "MIT",
+  "hooks": { "source": "./hooks/hooks.claude.json" },
+  "skills": ["./skills/"],
+  "mcp_servers": [
+    {
+      "name": "memory",
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/bin/dsh-memory.mjs", "mcp"]
+    }
+  ]
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/.codex-plugin/plugin.json

@@ -0,0 +1,29 @@
+{
+  "name": "memory-eternal",
+  "version": "0.1.0",
+  "description": "璁板繂鏍稿績锛圡emory Eternal锛夛細鐭ヨ瘑鍗¤嚜鍔ㄦ矇娣€/鍙洖锛岀粺涓€ ~/.dsh/memory-vault锛屼細璇濈粨鏉熻嚜鍔ㄥ叆搴撹繘寰呭鏍搞€?,
+  "author": {
+    "name": "EternalNight996",
+    "url": "https://github.com/EternalNight996"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/EternalNight996/dsh-memory-eternal",
+  "repository": "https://github.com/EternalNight996/dsh-memory-eternal",
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "hooks": "./hooks/hooks.codex.json"
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/.cursor-plugin/plugin.json

@@ -0,0 +1,28 @@
+{
+  "name": "memory-eternal",
+  "version": "0.1.0",
+  "description": "璁板繂鏍稿績锛圡emory Eternal锛夛細鐭ヨ瘑鍗¤嚜鍔ㄦ矇娣€/鍙洖锛岀粺涓€ ~/.dsh/memory-vault锛屼細璇濈粨鏉熻嚜鍔ㄥ叆搴撹繘寰呭鏍搞€?,
+  "author": {
+    "name": "EternalNight996",
+    "url": "https://github.com/EternalNight996"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/EternalNight996/dsh-memory-eternal",
+  "repository": "https://github.com/EternalNight996/dsh-memory-eternal",
+  "mcpServers": "./.mcp.json",
+  "hooks": "./hooks/hooks.cursor.json"
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "memory": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/bin/dsh-memory.mjs", "mcp"],
+      "env": {}
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EternalNight996
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,224 @@
+# 🧠 memory-eternal — A "second brain" for your AI
+
+<p align="center">
+  <img src="https://img.shields.io/badge/DeepSeek%20Harness-plugin-3B82F6" alt="DSH plugin" />
+  <img src="https://img.shields.io/npm/v/memory-eternal" alt="npm version" />
+  <img src="https://img.shields.io/github/stars/EternalNight996/memory-eternal?style=flat" alt="GitHub stars" />
+  <img src="https://img.shields.io/github/license/EternalNight996/memory-eternal" alt="license" />
+  <a href="https://dsh.market/"><img src="https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed.svg" alt="DSH Market listed" /></a>
+</p>
+
+> **Auto-captures knowledge after every conversation and survives across sessions; recall fetches only the relevant chunks — saves tokens, less noise.**
+> Fully self-built, zero third-party memory framework, no DSH source changes, one vault shared by every Agent, plain Markdown & git-manageable.
+
+<p align="center"><strong>⭐ Star it if you like it!</strong> <br/><sub>DSH one-liner: <code>dsh plugin --profile web add memory-eternal</code></sub></p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/memory-eternal.gif" width="880" alt="Auto-capture + visual library + knowledge graph (demo)" />
+</p>
+
+---
+
+## 🚀 Get Started in 5 Minutes
+
+### 🟦 DeepSeek Harness (DSH) — focus
+
+**Install** (dsh-desktop via DSH CLI, one command):
+
+```bash
+# dsh-desktop (recommended): install via DSH CLI into the profile
+dsh plugin --profile web add memory-eternal
+
+# or update directly in the profile (pnpm workspace). Use pnpm — `npm install` throws EUNSUPPORTEDPROTOCOL
+cd ~/.dsh/profiles/web && pnpm add memory-eternal@latest
+```
+
+After **restarting dsh web**, three things are live immediately:
+
+| Effect | Where |
+|---|---|
+| Auto-capture of knowledge cards | Happens every turn, no action needed |
+| `memory_recall` tool | Agent calls it automatically when it needs history |
+| Visual UI | Sidebar bottom `Memory` button / Settings → Memory |
+
+**Entry**: The sidebar-footer `Memory` button opens the vault (its left rail includes Cards / Graph / Usage / **Audit Center** / Recycle Bin / **Memory Config**); "DSH Settings → Memory" is the pure config page.
+
+**Edit config**: Vault left rail "Memory Config" (or DSH Settings → Memory) → DSH memory config / cost control / auto-audit config / self-hosting — just hit "Save Config". `autoWebMode` / `watchdogAutoSpawn` changes require a DSH restart.
+
+### 🟨 Claude Code
+
+```bash
+npm i -g memory-eternal     # installs CLI + MCP (auto-writes ~/.claude.json + SessionEnd hook)
+```
+
+Ready after install: say "recall 数据库选型" in a session → auto-retrieves memory; on session end / before context compaction → auto-captures.
+
+### 🟧 Codex CLI / Cursor
+
+```bash
+npm i -g memory-eternal     # auto-writes Codex config.toml / Cursor mcp.json
+```
+
+Restart the tool → MCP is in the list; just use: `用 memory_recall 查一下项目历史决策`.
+
+### 🟩 Browser (no Agent needed)
+
+```bash
+dsh-memory open    # starts web + opens browser (default http://127.0.0.1:7999)
+```
+
+Stats / search / card grid (add-edit-merge-import-export) / knowledge graph — all here. Same UI as the DSH embed; data stays in sync.
+
+> **zcode (Zhipu)**: no native MCP; bridge via [zcode-open-bridge](https://github.com/tizerluo/zcode-open-bridge) or use the CLI directly.
+
+---
+
+## 📖 Command Reference
+
+```bash
+dsh-memory recall "database selection"   # retrieve
+dsh-memory capture "important note..."   # manual capture (- reads stdin)
+dsh-memory sweep ~/.claude/projects      # mine existing sessions
+dsh-memory setup [--dry-run]             # re-run / preview auto-mount (idempotent)
+dsh-memory mcp                           # MCP stdio (mount to any MCP client)
+dsh-memory serve [--port 7999]           # run web in foreground
+dsh-memory open                          # ensure web alive + open browser
+dsh-memory watchdog [--port 7799]        # watchdog keep-alive (standalone process)
+```
+
+When not running on DSH, the `dsh-memory` command comes from `npm i -g`.
+
+---
+
+## ⚙️ Self-hosting (plain words)
+
+Three concepts, don't mix them:
+
+- **How the web server stays alive** (`autoWebMode`) → `init`=pull once at DSH start (default); `interval`=DSH in-process timer probes & auto-restarts (0 extra memory); `manual`=fully manual, only from `dsh-memory open`.
+- **Watchdog process** (`watchdogAutoSpawn`, default on) → a **standalone** node process that can pull web up even after DSH exits (~+47 MB RAM). Only turn on for 7×24 keep-alive.
+- **Auto-mount MCP** (`autoMcpSetup`, default off) → whether to auto-write MCP into Claude Code/Codex/Cursor config. Off = don't touch your machine config; run `dsh-memory setup` manually when needed.
+
+**Change these**: Vault left rail "Memory Config" (or DSH Settings → Memory) → edit the table and save; `autoWebMode` / `watchdogAutoSpawn` need a DSH restart.
+
+**MCP is a protocol, not a resident service**: the agent spawns it per session and exits when done — no "auto-start on boot" concept.
+
+### Three deployment intensities
+
+| Scenario | Config | Memory |
+|---|---|---|
+| Personal dev (default) | `autoWebMode=init` + `watchdogAutoSpawn=off` | web 47 MB |
+| Resident 7×24 | `watchdogAutoSpawn=on` | web + watchdog 47+47 MB |
+| True boot auto-start (no DSH) | Windows Task Scheduler runs `dsh-memory watchdog --port 7799 --interval 5000 --max-restart 10` | same |
+
+---
+
+## ⚙️ Memory Config (plain words)
+
+> All settings live in the **vault left rail "Memory Config"** (or DSH Settings → Memory) — edit and hit "Save". Here's the full page (plugin info / Agent MCP mount status / auto-audit config):
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/memory-config.png" width="880" alt="Memory config page" />
+</p>
+
+### 1. Most used
+
+| Setting | Default | In plain words |
+|---|---|---|
+| Auto capture | on | auto-store useful content as cards after each turn |
+| Auto recall | on | AI auto-queries memory when it needs history |
+| Vault dir | `~/.dsh/memory-vault` | where memory lives, plain Markdown & git-able |
+
+### 2. Save money (important)
+
+| Setting | Default | In plain words |
+|---|---|---|
+| **Distill cards** | on | **compress** a conversation into a sharp card (calls AI, costs money). **Off = store raw text, zero cost** |
+| **Dedup feeds AI** | on | judge if new content is a duplicate (calls AI). **Off = simple dedup**, saves one AI call |
+| Distill output cap | 900 | max chars per compress, bigger = sharper but pricier |
+| Recall min score | 2 | how "close" a match must be to return; bigger = sharper but leaks more (cheaper) |
+| Min capture chars | 200 | too-short chats aren't stored (avoids small-talk waste) |
+| Daily quota | 60 | max cards per day, prevents AI burning money |
+
+### 3. How the service runs
+
+| Setting | Default | In plain words |
+|---|---|---|
+| Keep-alive `autoWebMode` | init | `init`=open web once at DSH start; `interval`=periodically check & restart if dead; `manual`=fully manual |
+| Watchdog `watchdogAutoSpawn` | on | a **standalone process** keeps web alive (+47 MB). Personal use can turn off |
+| Auto-mount MCP `autoMcpSetup` | off | **lets Claude Code / Codex / Cursor use your memory**. On = auto-configures them; Off = never touches your config, run `dsh-memory setup` manually |
+
+> 💰 **To save money**: turn `Distill cards` off, lower `Distill output cap`, raise `Recall min score`.
+
+### 🎯 One-click presets
+
+Top of the config page: **🟢 A Light / 💰 B Budget / ⭐ C Premium** — click to fill, then Save:
+
+| Plan | Scenario | Keep-alive | Watchdog | Distill | Distill cap | Recall min | Memory | LLM cost |
+|---|---|---|---|---|---|---|---|---|
+| 🟢 **A Light** | Personal dev (default) | init | off | on | 900 | 2 | ~47 MB | normal |
+| 💰 **B Budget** | Tight budget / many Agents | init | off | **off** | 500 | 3 | ~47 MB | **~0** |
+| ⭐ **C Premium** | Long projects / teams | interval | **on** | on | 1200 | 1 | ~94 MB | high |
+
+---
+
+## 🛡️ Audit Center & Recycle Bin
+
+New cards go to the **Audit Center** (`pending`) by default and enter the main vault only after you approve them; rejected ones move to "Rejected", where you can restore or delete to the recycle bin. Cards matching an exemption (audit mode = skip all / exempt agents / exempt kinds) go straight in; recycle-bin cards are recoverable within 30 days, then auto-purged.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/audit-center.png" width="880" alt="Audit Center" />
+</p>
+
+- **Pending / Rejected** tabs, filtered by type / date / agent; select all and approve / reject / delete-to-recycle in one click.
+- Rules in "Memory Config → Auto-audit config": `audit mode` (audit all / skip all) + `exempt agents` + `exempt kinds` + `recycle retention days`.
+
+### 🥇 Why the audit system is more reliable (vs other memory products)
+
+Most memory products (mem0 / Zep / agentmemory…) auto-ingest **everything** the moment a conversation ends, good or bad — noise, wrong facts, and sensitive content all go in and get recalled later, **polluting context and amplifying hallucinations**.
+
+memory-eternal uses **human-in-the-loop auditing** — only trusted content enters the main vault:
+
+| Dimension | Other memory products | memory-eternal audit system |
+|---|---|---|
+| Ingest | Auto-ingest all, no gate | New cards first enter the **Audit Center (`pending`)**, approved before entering the vault |
+| Quality | No filtering of noise/errors | Only cards you've confirmed → more accurate recall, less noise |
+| Traceability | No source/audit trail | Every card carries `submittedBy` author + `pending/approved/rejected` state |
+| No-friction | — | Exempt agents / exempt kinds hit → trusted cards go straight in, zero wait |
+| Safety | Delete = gone forever | Recycle-bin soft delete, recoverable within 30 days |
+
+---
+
+## 🧬 Why Fully Self-built
+
+Most memory solutions lean on third-party frameworks / spin up an MCP service / lock memory in a private store. This plugin builds the skeleton itself — **zero third-party runtime deps**, logic readable line by line:
+
+| Module | Self-built | Replaces |
+|---|---|---|
+| Dedup | lexical Jaccard bigram (0.62) + semantic dedup | duplicate-card prevention |
+| Retrieval | CJK-aware: Chinese whole-word + char bigram | no full-text search engine needed |
+| Graph | force-directed + `[[wikilink]]`/shared-tag edges | see knowledge links at a glance |
+| Storage | plain `.md` with frontmatter | not locked in, readable, git-able, any tool can read |
+
+> Same direction as popular projects (summarize→store→recall), but positioned differently: **local, self-built, zero-dep, readable & controllable**. If you already use mem0/Zep etc., just layer this as a "local persistent memory base".
+
+---
+
+## 🛠 Development / Test
+
+```bash
+npm i
+npm test        # unit tests: vault dedup/retrieval/graph + capture pipeline + API shapes
+npm run build   # builds lib/client.js (DSH embed) + web/app.js (standalone web bundle)
+```
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+> **Make your AI truly remember: dialogue auto-captured, knowledge at your fingertips.** ⭐ Star it if you like, Let's make AI not forget.
+>
+> 中文 README: [README.md](README.md)

package/README.md

@@ -0,0 +1,236 @@
+# 🧠 memory-eternal — 给 AI 装「第二大脑」
+
+<p align="center">
+  <img src="https://img.shields.io/badge/DeepSeek%20Harness-plugin-3B82F6" alt="DSH plugin" />
+  <img src="https://img.shields.io/npm/v/memory-eternal" alt="npm version" />
+  <img src="https://img.shields.io/github/stars/EternalNight996/memory-eternal?style=flat" alt="GitHub stars" />
+  <img src="https://img.shields.io/github/license/EternalNight996/memory-eternal" alt="license" />
+  <a href="https://dsh.market/"><img src="https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg" alt="DSH Market 收录" /></a>
+</p>
+
+> **对话结束自动沉淀，跨会话不失忆；召回只取相关小块，省 token 少噪音。**
+> 全自研、零第三方记忆框架、不改 DSH 源码、一个记忆库所有 Agent 共享，纯 Markdown 可 git 管理。
+
+<p align="center"><strong>⭐ 觉得好用就点个 Star</strong>！ <br/><sub>DSH 一条命令：<code>dsh plugin --profile web add memory-eternal</code></sub></p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/memory-eternal.gif" width="880" alt="对话自动沉淀 + 图形化知识库 + 知识图谱（演示）" />
+</p>
+
+---
+
+## 🚀 五分钟上手
+
+### 🟦 DeepSeek Harness（DSH）—— 重点
+
+**装**（dsh-desktop 用 DSH CLI，一条命令）：
+
+```bash
+# dsh-desktop 用户（推荐）：DSH CLI 直接装进 profile
+dsh plugin --profile web add memory-eternal
+
+# 或直接在 profile（pnpm workspace）里更新。注意用 pnpm，npm install 会报 EUNSUPPORTEDPROTOCOL
+cd ~/.dsh/profiles/web && pnpm add memory-eternal@latest
+```
+
+**重启 dsh web** 后，三样东西立即生效：
+
+| 效果 | 在哪看 |
+|---|---|
+| 自动沉淀知识卡 | 每轮对话结束自动发生，无需操作 |
+| `memory_recall` 工具 | Agent 需要历史时自动调用 |
+| 图形化界面 | 侧边栏底部「记忆」按钮 / 设置 → 记忆 |
+
+**入口**：侧边栏底部「记忆」按钮 → 记忆库（左栏含 知识卡 / 知识图谱 / 用量 / **审核中心** / 回收中心 / **记忆配置**）；「DSH 设置 → 记忆」= 纯配置页。
+
+**改配置**：记忆库左栏「记忆配置」（或 DSH 设置 → 记忆）→ DSH 记忆配置 / 成本控制 / 自动审核配置 / 服务自管理，点「保存配置」即写入。`autoWebMode`/`watchdogAutoSpawn` 的改动需重启 DSH 生效。
+
+### 🟨 Claude Code
+
+```bash
+npm i -g 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
+
+```bash
+npm i -g 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/memory-eternal` + `/plugin install`、`codex plugin marketplace add EternalNight996/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）
+
+```bash
+dsh-memory open    # 起 web + 开浏览器（默认 http://127.0.0.1:7999）
+```
+
+统计 / 搜索 / 知识卡（增删改合并导入导出）/ 知识图谱，全在此。与 DSH 内嵌页同一份 UI，数据同步。
+
+> **zcode（智谱）**：暂无原生 MCP，经社区 [zcode-open-bridge](https://github.com/tizerluo/zcode-open-bridge) 转 MCP 或用 CLI。
+
+---
+
+## 📖 命令速查
+
+```bash
+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 挂载状态 / 自动审核配置）：
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/memory-config.png" width="880" alt="记忆配置页" />
+</p>
+
+### 一、最常用
+
+| 配置项 | 默认 | 大白话说明 |
+|---|---|---|
+| 自动沉淀 | 开 | 每轮聊完自动把有用的内容存成知识卡 |
+| 自动召回 | 开 | AI 需要历史时自动帮你查记忆 |
+| 记忆库目录 | `~/.dsh/memory-vault` | 记忆存哪，纯 Markdown 可 git 管理 |
+
+### 二、省钱包（重要）
+
+| 配置项 | 默认 | 大白话说明 |
+|---|---|---|
+| **蒸馏知识卡** | 开 | 把对话**压缩**成精炼知识卡（要调 AI，花钱）。**关掉 = 存原文**，一分钱不花 |
+| **语义去重喂 AI** | 开 | 判断新内容是不是重复（要调 AI）。**关掉 = 用简单去重**，省一次 AI 调用 |
+| 蒸馏输出上限 | 900 | 压缩一次最多写多少字，越大越准越费钱 |
+| 召回相关性阈值 | 2 | 检索要「多像」才返回，越大越准但漏得越多（越省） |
+| 捕获最小长度 | 200 | 对话太短不存，避免闲聊浪费 |
+| 日配额 | 60 | 一天最多存几张，防 AI 烧钱 |
+
+### 三、服务怎么跑
+
+| 配置项 | 默认 | 大白话说明 |
+|---|---|---|
+| 保活模式 `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 天内可恢复，超期自动永久删除。
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/audit-center.png" width="880" alt="审核中心" />
+</p>
+
+- **待审核 / 已驳回** 双页签，按类型 / 日期 / 智能体筛选，全选后一键「批准 / 驳回 / 删除进回收站」。
+- 审核规则在「记忆配置 → 自动审核配置」：`审核模式`（全部要审 / 全部免审）+ `免审智能体` + `免审类型` + `回收保留天数`。
+
+### 🥇 为什么审核系统更靠谱（对比其它记忆产品）
+
+多数记忆产品（mem0 / Zep / agentmemory…）对话一结束就**自动全量入库**，好坏不论——噪音、错误事实、敏感内容一起进库，之后又被召回，**污染上下文、放大幻觉**。
+
+memory-eternal 走**人机协同审核**，只让可信内容进主库：
+
+| 维度 | 其它记忆产品 | memory-eternal 审核系统 |
+|---|---|---|
+| 入库 | 自动全量，无把关 | 新卡先进**审核中心（pending）**，人工批准才入主库 |
+| 质量 | 未过滤噪音/错误 | 只保留你确认过的卡 → 召回更准、噪声更低 |
+| 可信 | 无来源/审核追溯 | 每卡带 `submittedBy` 作者 + `pending/approved/rejected` 审核状态 |
+| 免打扰 | — | 免审智能体 / 免审类型命中 → 可信卡直接入库，零等待 |
+| 容错 | 删了就没 | 回收站软删，30 天内可恢复 |
+
+---
+
+## 🧬 为什么全自研
+
+市面上记忆方案多，但大多依赖第三方框架 / 动不动起 MCP 服务 / 记忆锁私有库。本插件把骨架自己搭，**零第三方运行时依赖**，逻辑逐行可读：
+
+| 模块 | 自研实现 | 替代什么 |
+|---|---|---|
+| 去重 | 词法 Jaccard bigram（0.62）+ 语义去重 | 防重复卡 |
+| 检索 | CJK 感知：中文整词 + 字符 bigram | 无需全文搜索引擎 |
+| 图谱 | 力导向 + `[[wikilink]]`/共享标签连边 | 知识关联一眼看清 |
+| 存储 | 带 frontmatter 的普通 `.md` | 不锁库、可读、可 git、可被任意工具读 |
+
+> 与热门项目同向（总结→存储→按需召回），但定位不同：**本地、自研、零依赖、可读可控**。如果你已在用 mem0/Zep 等，也能把它当「本地持久记忆底座」叠加使用。
+
+---
+
+## 🛠 开发 / 测试
+
+```bash
+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](README.en.md)