sage-mem

sage-mem · DSH 的文件式记忆插件 _(sage-mem)_ English · README.en.md

给 DeepSeek Harness（DSH）装上跨会话记忆：每条记忆都是本地的一个 Markdown 文件。 File-based cross-session memory for DeepSeek Harness — every memory is a plain markdown file you can open, edit and delete. No database, no worker, no port.

当前发布版本：2.5.1 —— 顶部 npm 徽章是动态权威。契约基线：1.0.0 —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在 契约冻结。

如果它对你有用，给个 Star 是最直接的反馈。 目录 这是什么 为什么是文件，不是数据库 核心特性 快速开始 界面预览 记忆文件格式 检索与注入 写入安全 自动做梦 从 Claude Code 迁移 配置参考 稳定性与版本策略 权限与隐私 兼容性 架构 参与开发 常见问题 卸载 维护者 致谢 相关项目 旧版 License 这是什么

DSH 原生没有记忆系统。每开一个新会话都是一张白纸：不记得你是谁、不记得昨天做到哪、不记得项目进行到哪一步，于是你每次都要重新交代一遍。

sage-mem 补上这一层，做法是：把该记住的事写成一张张卡片，存在你自己电脑上。在 DSH 把问题交给模型之前，插件按问题挑出最相关的几张、贴在模型眼前。

所以准确的说法不是「模型记得你」，而是「在它开口之前，有人把相关的纸条递进了它手里」。撤走纸条，它又是那个失忆的同事。

记忆的形态是一条记忆一个 .md 文件（YAML frontmatter + 正文）：用编辑器就能打开、能改、能删，也能直接拿 git 管。这份记忆始终在你自己手里，不在某个数据库里。 为什么是文件，不是数据库

大多数记忆方案走「SQLite + 常驻 worker」：记忆写进数据库就不透明（想看看存了什么得去查表），事件全捕获又会让库膨胀（「用户打了个招呼」也算一条），还要额外养一个进程和一个端口。 核心特性 界面上还有四块能力（都可以不用）：记忆管理页、类型与标签筛选、时间线（默认是条目列表，可切星空视角）、体检与归档。

1.8.0 起，记忆管理还能从侧栏直接进：侧栏多一个「记忆管理」图标，点它把中央主区切到本页（页顶有「返回会话」）。 设置页「记忆管理 → 自动做梦 → 设置」里可以关掉这个入口（默认开，立即生效、不用重启）； 1.8.2 起，插件详情页也有同一个开关（「插件 → sage-mem」那张卡），改完立即生效； 关掉只影响侧栏图标，「设置 → 记忆管理」这个入口永远保留。 从 1.8.2 开始，sage-mem 在插件列表里有了自己的图标（金色记忆卡片），不再是默认的通用方图标。

记忆管理页的「文件列表」头部还有一个「打开记忆文件夹」按钮：用系统文件管理器打开当前记忆目录 （Windows Explorer / macOS Finder / Linux 文件管理器）。host 侧起一个 detached 进程就返回，不等窗口。

记忆目录还是空的时候，空态里有一个「建立索引骨架」按钮：一键写入 MEMORY.md 的引导文件 （索引格式 + 四类记忆说明）。已经存在 MEMORY.md 时只提示、不覆盖；它不走新的 remote， 用的是原有的保留名读取 / 写入接口。 快速开始

需要 DSH 0.1.2-rc.1 或更高（见兼容性）、Node.js >= 18。