sage-mem 0.5.2 → 0.5.3

package/README.md

@@ -4,6 +4,10 @@
 
 记忆存在**本地 markdown 文件**里（frontmatter + 正文），不是数据库。透明、可检查、防膨胀。
 
+> **DSH 版本兼容性（0.5.3 核对于 `0.1.7-rc.1`）**
+> `session.deriveMessages()`（仍是同步）、`system-prompt/assemble` 事件、以及 `context.agent.session` 这条链，在 0.1.6 → 0.1.7 之间**均未改变**，本插件在 0.1.7 上无需改动即可工作。
+> 0.5.3 另加了一层防御：`deriveMessages()` 若哪天被改成异步，或 `Session` 上的历史读取接口被改名（0.1.7 起 `snapshotEvents` / `eventAt` / `ownEvents` 已标记弃用），插件会在**日志里报警**，而不是像以前那样静默地不再注入记忆。0.1.6 上的行为与 0.5.2 完全一致。
+
 ## 从 Claude Code 无损迁移
 
 你已经在 Claude Code（CC）里养了一个 agent，舍不得它的记忆和人格？sage-mem 是「CC → DSH」迁移方案的一部分，**记忆与人格都能无损搬过来**：

package/lib/index.js

@@ -36,7 +36,7 @@ const MAX_BASELINE = 5
  *      frontmatter 里的 originSessionId / birthday 等字段一并抹掉。
  *
  * 判定依据是「丢了能不能从别处重建」：memory 目录**不在任何版本控制下**
- * （在 E:\shengdian 下 `git rev-parse` 直接报 not a git repository），
+ * （该目录里没有 .git，`git rev-parse` 直接报 not a git repository），
  * deleteFile 是 unlink、没有回收站，所以宁严勿松。
  * 这几个文件要改，用文件工具直接编辑。
  */
@@ -246,8 +246,17 @@ export class MemoryGateway extends TypertRemoteService {
       try {
         const agent = context?.agent
         const session = agent?.session
-        if (!session || typeof session.deriveMessages !== 'function') return assembled
-        const messages = [...session.deriveMessages()]
+        if (!session) return assembled
+        // DSH 0.1.7 起 Session 的历史读取接口在陆续调整（snapshotEvents / eventAt /
+        // ownEvents 已弃用）。deriveMessages 在 0.1.7-rc.1 实测仍在且仍同步，但这三行
+        // 不是白写的：方法一旦被改名或改成异步，老写法要么静默不注入、要么把 Promise
+        // 当数组展开成空。宁可日志里响一声，也不要"记忆不注入但日志一字没有"。
+        if (typeof session.deriveMessages !== 'function') {
+          warnLog(ctx, 'session.deriveMessages() 不可用 —— 记忆召回已跳过（DSH session API 变了？）', sessionId)
+          return assembled
+        }
+        const derived = session.deriveMessages()
+        const messages = [...(derived && typeof derived.then === 'function' ? await derived : derived)]
 
         // 关键：DSH 0.1.5 把工具结果（source.kind === 'tool'）和注入内容
         // （source.kind === 'plugin'）也存成 role: 'user' 的消息。只按 role 取

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sage-mem",
   "description": "File-based memory plugin for DeepSeek Harness (DSH) — cross-session memory in transparent markdown files, with a memory star-map view",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {