sage-mem 0.4.0 → 0.4.2

package/README.md

@@ -1,115 +1,138 @@
-# sage-mem · DSH 的文件式记忆插件
-
-给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）装上**跨会话记忆**——agent 今天记住的事，明天的新会话自动想起来。
-
-记忆存在**本地 markdown 文件**里（frontmatter + 正文），不是数据库。透明、可检查、防膨胀。
-
-## 为什么用文件
-
-DSH 原生没有记忆系统，每个会话都是白纸。市面上的记忆方案大多走 SQLite + 常驻 worker：
-
-- 记忆写进数据库，**不透明**——想检查存了什么得查表，想清理要连数据库
-- 事件自动捕获会**膨胀**——"用户打了个招呼"这种无实质内容也被存进去
-- 需要一个**常驻 worker 进程** + 端口，多一份运维负担
-
-sage-mem 换成文件式：每条记忆一个 markdown 文件，直接用编辑器打开就能看、能改、能删。存不存由 agent 按规则判断，不是事件全捕获。没有 worker、没有 SQLite、没有端口。
-
-## 功能
-
-- **按问题检索注入**：每次提问，插件扫记忆目录，按相关性把记忆注入 system prompt，agent 第一轮就「想起来」
-- **四类记忆**：`user`（用户是谁）/ `feedback`（工作方式指导）/ `project`（项目状态）/ `reference`（外部信息指针）
-- **文件透明**：记忆就是 `*.md` 文件，frontmatter 存元数据，正文存内容
-- **防膨胀**：写入靠规则引导 agent 判断「存不存」，无实质内容、能靠代码/git 推导的不存
-- **Web 文件管理器**（v0.4）：DSH 设置页「记忆管理」，浏览/查看/编辑/删除记忆文件，添加新记忆
-
-## 架构
-
-```
-DSH（Cordis 插件）
-  └─ sage-mem 插件（按问题检索 + 注入）← 本仓库
-       │  Node fs 直读
-       ▼
-memory/ 目录（markdown 文件，4 类）
-  ├── user_*.md
-  ├── feedback_*.md
-  ├── project_*.md
-  ├── reference_*.md
-  └── MEMORY.md          ← 索引
-```
-
-没有 worker、没有 SQLite、没有 HTTP 端口、没有常驻进程。
-
-## 安装
-
-在你的 DSH profile 的 `package.json` 里加：
-
-```json
-{
-  "dependencies": {
-    "sage-mem": "github:gezi-wen/sage-mem"
-  },
-  "dsh": {
-    "profile": {
-      "bundles": ["sage-mem"]
-    }
-  }
-}
-```
-
-或 clone 后本地 link：
-
-```json
-{
-  "dependencies": {
-    "sage-mem": "link:../sage-mem"
-  }
-}
-```
-
-然后 `pnpm install` 重启 DSH。
-
-## 配置
-
-用环境变量 `SAGE_MEM_DIR` 指定记忆目录，默认 `~/.sage-mem/memory`：
-
-```
-SAGE_MEM_DIR=/path/to/your/memory
-```
-
-记忆文件格式：
-
-```markdown
----
-name: 可选的短名
-description: 一句话说清这条记忆是什么（检索与列表都靠它）
-metadata:
-  type: user        # user / feedback / project / reference
----
-
-记忆正文。
-```
-
-`feedback` 类建议带 `**Why:**`（原因）和 `**How to apply:**`（何时生效）两行，方便判断边界。
-
-## 验证
-
-跨会话记忆链路（实测）：
-
-1. 会话 A 说「记住：我的猫叫芝麻，它喜欢晒太阳」——agent 按规则写进 `memory/`
-2. 开新会话 B 问「我的猫叫什么」
-3. agent 第一轮直接答出「芝麻」——记忆自动注入，无需 agent 自己找
-
-## 相关项目
-
-- [sage-persona](https://github.com/gezi-wen/sage-persona) — 人格（我是谁）
-- [sage-meta](https://github.com/gezi-wen/sage-meta) — 自检（我做得对吗）
-
-sage-mem 是第三道：**我下次应该怎么想**——跨会话沉淀事实与教训。
-
-## 旧版
-
-本仓库早期是 SQLite + worker 架构，已归档到 [`sqlite-worker`](../../tree/sqlite-worker) 分支。文件式是继任实现。
-
-## License
-
-Apache-2.0
+# sage-mem · DSH 的文件式记忆插件
+
+给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）装上**跨会话记忆**——agent 今天记住的事，明天的新会话自动想起来。
+
+记忆存在**本地 markdown 文件**里（frontmatter + 正文），不是数据库。透明、可检查、防膨胀。
+
+## 从 Claude Code 无损迁移
+
+你已经在 Claude Code（CC）里养了一个 agent，舍不得它的记忆和人格？sage-mem 是「CC → DSH」迁移方案的一部分，**记忆与人格都能无损搬过来**：
+
+- **人格**：CC 的 `CLAUDE.md` → DSH 的 `AGENTS.md`，DSH 原生加载，纯文本一字不改就能用。
+- **记忆**：CC 沉淀的跨会话记忆 → sage-mem 的 `memory/` 目录（markdown + frontmatter，四类）。
+
+没有数据库、没有私有格式——全都是 markdown 文本，**直接拷文件就完成迁移**。agent 换了身体，但依然记得你是谁、记得你们聊过什么、记得进行中的项目。
+
+## 为什么用文件
+
+DSH 原生没有记忆系统，每个会话都是白纸。市面上的记忆方案大多走 SQLite + 常驻 worker：
+
+- 记忆写进数据库，**不透明**——想检查存了什么得查表，想清理要连数据库
+- 事件自动捕获会**膨胀**——"用户打了个招呼"这种无实质内容也被存进去
+- 需要一个**常驻 worker 进程** + 端口，多一份运维负担
+
+sage-mem 换成文件式：每条记忆一个 markdown 文件，直接用编辑器打开就能看、能改、能删。存不存由 agent 按规则判断，不是事件全捕获。没有 worker、没有 SQLite、没有端口。
+
+## 功能
+
+- **按问题检索注入**：每次提问，插件扫记忆目录，按相关性把记忆注入 system prompt，agent 第一轮就「想起来」
+- **四类记忆**：`user`（用户是谁）/ `feedback`（工作方式指导）/ `project`（项目状态）/ `reference`（外部信息指针）
+- **文件透明**：记忆就是 `*.md` 文件，frontmatter 存元数据，正文存内容
+- **防膨胀**：写入靠规则引导 agent 判断「存不存」，无实质内容、能靠代码/git 推导的不存
+- **Web 文件管理器**（v0.4）：DSH 设置页「记忆管理」，浏览/查看/编辑/删除记忆文件，添加新记忆
+
+## 架构
+
+```
+DSH（Cordis 插件）
+  └─ sage-mem 插件（按问题检索 + 注入）← 本仓库
+       │  Node fs 直读
+       ▼
+memory/ 目录（markdown 文件，4 类）
+  ├── user_*.md
+  ├── feedback_*.md
+  ├── project_*.md
+  ├── reference_*.md
+  └── MEMORY.md          ← 索引
+```
+
+没有 worker、没有 SQLite、没有 HTTP 端口、没有常驻进程。
+
+## 安装
+
+在你的 DSH profile 的 `package.json` 里加：
+
+```json
+{
+  "dependencies": {
+    "sage-mem": "github:gezi-wen/sage-mem"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": ["sage-mem"]
+    }
+  }
+}
+```
+
+或 clone 后本地 link：
+
+```json
+{
+  "dependencies": {
+    "sage-mem": "link:../sage-mem"
+  }
+}
+```
+
+然后 `pnpm install` 重启 DSH。
+
+## DSH 兼容性
+
+sage-mem 是纯 DSH 插件，在 `package.json` 的 `dsh.compatibility.dshReleases` 里逐版本声明兼容状态：
+
+| DSH 版本 | 状态 |
+| --- | --- |
+| 0.1.2-rc.1 | compatible |
+| 0.1.3-alpha.1 | compatible |
+| 0.1.3-alpha.2 | compatible |
+
+Node.js 要求 `>= 18`（见 `engines.node`）。
+
+## 卸载
+
+在 profile 的 `package.json` 里删掉 `sage-mem` 依赖，并从 `dsh.profile.bundles` 移除 `"sage-mem"`；
+`pnpm install` 后重启 DSH 即可。记忆 markdown 文件留在原目录，不受影响。
+
+## 配置
+
+用环境变量 `SAGE_MEM_DIR` 指定记忆目录，默认 `~/.sage-mem/memory`：
+
+```
+SAGE_MEM_DIR=/path/to/your/memory
+```
+
+记忆文件格式：
+
+```markdown
+---
+name: 可选的短名
+description: 一句话说清这条记忆是什么（检索与列表都靠它）
+metadata:
+  type: user        # user / feedback / project / reference
+---
+
+记忆正文。
+```
+
+`feedback` 类建议带 `**Why:**`（原因）和 `**How to apply:**`（何时生效）两行，方便判断边界。
+
+## 验证
+
+跨会话记忆链路（实测）：
+
+1. 会话 A 说「记住：我的猫叫芝麻，它喜欢晒太阳」——agent 按规则写进 `memory/`
+2. 开新会话 B 问「我的猫叫什么」
+3. agent 第一轮直接答出「芝麻」——记忆自动注入，无需 agent 自己找
+
+## 相关项目
+
+- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — DSH 本体，一切皆插件
+
+## 旧版
+
+本仓库早期是 SQLite + worker 架构，已归档到 [`sqlite-worker`](../../tree/sqlite-worker) 分支。文件式是继任实现。
+
+## License
+
+Apache-2.0

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# sage-mem bundle patch — injects the memory bridge plugin into the profile tree.
-- insert:
-    - id: sage-mem
-      name: 'sage-mem'
+# sage-mem bundle patch — injects the memory bridge plugin into the profile tree.
+- insert:
+    - id: sage-mem
+      name: 'sage-mem'