EternalNight996 / memory-eternal

# 🧠 memory-eternal — 给 AI 装「第二大脑」
 Memory Atlas · 本地优先的 AI 记忆库 
 自动沉淀 · 先审后入 · 知识星图 · 全 Agent 共享 
 简体中文（默认） · English 
 ▲ Memory Atlas · 在线 Demo（示例数据）· 点此打开 
> **对话结束自动沉淀成知识卡，跨会话不失忆；召回只取相关小块，省 token 少噪音。**
> 全自研、零第三方记忆框架、不改 DSH 源码；一个记忆库所有 Agent 共享，SQLite 持久存储，零外部依赖。
 ⭐ 如果它帮你少解释了一遍上下文，点个 Star 就是最大的支持 DSH 一条命令： dsh plugin --profile desktop add memory-eternal 
 🌐 在线体验 · 打开记忆库 Demo （示例数据，不用安装） 
 ▲ 真实运行截图：待审判词 · 知识星图 · 读卡器 
 ▲ v0.14 新增：Web 内终端引导 · 终端原生审核（全选/批驳）· 长文读卡器 
---
## 🧩 支持平台
| 平台 / 宿主 | Memory Atlas UI | 待审 / 批驳 | 知识星图 | 入口与状态 |
|---|---|---|---|---|
| **DSH 桌面版 / Web** | 完整内嵌 | ✅ | ✅ | 左栏「记忆」，已支持 |
| **任意终端（TUI）** | 终端原生 | ✅ 全选 / 批量批驳 | 连接簇 / 邻接表 | `dsh-memory tui`，免绝对路径 |
| **Orca** | 侧栏启动器 | Web 内完成 | Web 内完成 | 右栏「记忆」，本版新增 |
| **dsh-tui** | 原生 `/audit` + 完整 TUI | 原生场景 | 原生场景 | 本版新增 |
| **Codex** | 浏览器打开 | Web 内完成 | Web 内完成 | `memory-open` skill，本版新增 |
| **Claude Code** | 浏览器打开 / Pane | Web 内完成 | Web 内完成 | `/memory-eternal:memory-open`，本版新增 |
| **Cursor** | Webview 内嵌 | ✅ | ✅ | 扩展 Webview，本版新增 |
| **纯 Web** | 主实现 | ✅ | ✅ | `http://127.0.0.1:7999/` |
> 原则：**一套 Web UI 作为唯一真源**；能内嵌的宿主用 Webview，不能内嵌的宿主只做轻量启动器，不复制第二套 UI。所有入口打开同一版本，避免 DSH / Web 版本漂移。
---
## 🖥️ 终端版（TUI）
Web 不是唯一入口。终端版是同一套记忆库的**原生 TUI**，适合快速批卡、全选、长文阅读和低干扰工作流。
### 任意用户，一条命令
不需要克隆仓库、不需要 `cd`、不需要填写本机绝对路径：
 [code] 
已经安装 `memory-eternal` 的机器：
 [code] 
`dsh-memory` 不在 PATH 时，直接用上面的 `npx` 命令；它会临时下载并运行当前 npm 版本。
> `tui` 子命令从 **0.14.1** 开始提供。旧版 `dsh-memory` 会显示帮助；升级：`npm i -g --force memory-eternal@0.15.0`。
### 终端版包含
| 页面 | 能力 |
|---|---|
| 记忆库 | 搜索、类型筛选、今日回看、读卡 |
| 待审 | 全选 / 反选、批量批准、批量驳回、判词 |
| 知识星图 | 连接簇、邻接表、相关卡片 |
| 运行状态 | 知识库、备份、版本、沉淀日志 |
| 回收站 | 恢复、彻底删除 |
| 设置 | 自动沉淀、失败提醒、审核、回收站保留、主题 |
| 读卡器 | 长文换行、目录、相关记忆、滚动 |
### 终端键位
| 键 | 作用 |
|---|---|
| `1–6` | 切换主页面 |
| `Tab` | 循环页面 |
| `↑↓` / `j k` | 移动 |
| `←→` / `t` | 切换类型 |
| `Space` | 多选 / 切换设置 |
| `s` / `Ctrl+A` | 全选 / 反选 |
| `a` | 批准当前或批量 |
| `r` | 驳回当前或批量；回收站里是恢复 |
| `d` | 回收站彻底删除 |
| `Enter` | 读卡 / 切换设置 |
| `L` | 直接打开长文读卡器 |
| `j k` / `PgUp` `PgDn` / `g G` | 读卡器滚动 / 翻页 / 首尾 |
| `/` | 搜索 |
| `Esc` | 返回 / 清空 |
| `?` | 帮助 |
| `q` | 退出 |
### 为什么 Web 不直接嵌 TUI
终端 TUI 依赖 alternate screen、原始键盘事件和字符网格，无法用 iframe 忠实嵌入。 
所以 Web 的「终端版」页面提供可复制命令和预览，真正运行时进入终端；dsh-tui 里则使用原生 `/audit` 场景。
### 限制
- 终端不渲染图片 / 二维码 / Canvas 星图；星图使用连接簇和邻接表。
- 长文、颜色和边框依赖终端字体；Windows 建议 Windows Terminal / VS Code 集成终端。
- 默认只读；真实批驳必须显式加 `--write`；示例数据用 `--demo`。
---
## ✨ 它到底解决什么问题
| 你遇到的 | 以前的做法 | 用了之后 |
| --- | --- | --- |
| 聊了 3 天的项目，新会话全忘 | 手动翻历史 / 重新解释一遍 | 每轮结束自动沉淀成卡，开工前 `memory_recall` 一句就回来 |
| 记忆塞进 prompt，token 爆掉 | 全量粘贴、越聊越贵 | 只召回相关的一小块（可配上限），省 token 也少噪音 |
| AI 写的东西不敢直接信 | 无法追溯、无法回滚 | 卡片带来源 / 时间 / 状态，先审后入，删除进回收站 |
- **看得见**：知识卡 / 图谱 / 健康概览 / 沉淀日志，四层可视化；
- **控得住**：审核模式（全部人工 / 仅高风险）、去重与矛盾扫描、批量合并、每日备份与一键恢复；
- **带得走**：知识库是本地 Markdown + SQLite，可 git 管理、可导出，不锁在插件里。
---
## 🚀 五分钟上手
### 🟦 DeepSeek Harness（DSH）—— 重点
**装**（官方桌面版走插件市场，`dsh web` 用一条 CLI）：
 [code] 
#### 🖥️ 桌面版支持策略（先看这条）
- **优先、且只保证支持官方 DeepSeek Harness 桌面版**（官方 Electron 发行版，profile 名 `desktop`）。v0.9.4 → v0.9.6 三轮修复全