sage-mem 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bowen Zheng
+
+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.md

@@ -0,0 +1,117 @@
+# sage-mem · DSH 的记忆系统插件
+
+给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）装上**跨会话记忆**——agent 今天记住的事，明天的新会话自动想起来。
+
+## 为什么需要它
+
+DSH 原生没有记忆系统。每个会话都是白纸：用户说过「我喜欢在深夜写代码」，下个会话再问「我喜欢什么」，agent 只能答不知道。
+
+sage-mem 补上这一块。它监听 DSH 的事件流，把会话内容沉淀到 SQLite，新会话启动时自动检索注入历史记忆。
+
+**中文优先**。市面上的记忆方案在中文检索上普遍失效（SQLite FTS5 默认分词器对中文全部 0 命中）。sage-mem 的 worker 用 trigram 分词 + 短词兜底，中文实测全命中。
+
+## 功能
+
+- **自动捕获**：工具调用（读写文件、执行命令）自动记录，无需手动整理
+- **AI 压缩**：会话内容由 LLM 压缩成结构化记忆（事实、摘要），中文输出
+- **跨会话注入**：新会话启动时自动检索并注入历史记忆，agent 不用自己翻
+- **中文检索**：trigram 分词（≥3 字查询）+ LIKE 兜底（<3 字短词如「猫」「芝麻」）
+
+## 架构
+
+```
+DSH（Cordis 插件）
+  └─ sage-mem 插件（事件监听 → HTTP 转发）← 本仓库
+       │  HTTP 127.0.0.1
+       ▼
+sage-mem worker（Bun 常驻，fork 自 claude-mem）← gezi-wen/claude-mem
+       │
+       ▼
+SQLite（FTS5 trigram 中文分词 + LLM 压缩）
+```
+
+设计选择：记忆逻辑复用 [claude-mem](https://github.com/thedotmack/claude-mem)（Apache-2.0，9 万星），fork 后加中文修复，DSH 侧只写一个轻量桥接插件。改动最小，能追上游更新。
+
+## 安装
+
+### 1. 部署 worker
+
+```bash
+git clone https://github.com/gezi-wen/claude-mem.git
+cd claude-mem
+git checkout sage-mem-worker   # 含中文 trigram 修复
+bun install
+```
+
+配置 `~/.claude-mem/settings.json`（worker 数据目录）：
+
+```json
+{
+  "CLAUDE_MEM_PROVIDER": "openrouter",
+  "CLAUDE_MEM_OPENROUTER_BASE_URL": "https://api.deepseek.com",
+  "CLAUDE_MEM_OPENROUTER_MODEL": "deepseek-chat",
+  "CLAUDE_MEM_CHROMA_ENABLED": "false",
+  "CLAUDE_MEM_MODE": "code--zh"
+}
+```
+
+`~/.claude-mem/.env` 放 API key（任意 OpenAI 兼容服务均可，不限于 DeepSeek）：
+
+```
+OPENROUTER_API_KEY=<你的 API key>
+```
+
+启动：
+
+```bash
+bun src/services/worker-service.ts --daemon
+```
+
+### 2. 安装插件
+
+在你的 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。
+
+## 验证
+
+跨会话中文记忆链路（实测）：
+
+1. 会话 A 说「记住：我的猫叫芝麻，它喜欢晒太阳」
+2. 开新会话 B 问「我的猫叫什么」
+3. agent 直接答出「芝麻」——记忆自动注入，无需 agent 自己找
+
+搭配 [sage-persona](https://github.com/gezi-wen/sage-persona)（我是谁）和 [sage-meta](https://github.com/gezi-wen/sage-meta)（我做得对吗）组成 Sage 三件套——这是三道题的第三道：**我下次应该怎么想**。
+
+## 已知边界
+
+- trigram 分词对 `<3` 字符查询无效，worker 已加 LIKE 兜底
+- worker 不可用时插件静默跳过（不阻塞 DSH），记忆功能暂缺
+- MVP 存储统一在 `project=sage` 空间，按工作区分项目是后续计划
+
+## License
+
+MIT（worker fork 为 Apache-2.0，见 [gezi-wen/claude-mem](https://github.com/gezi-wen/claude-mem)）

package/cordis.patch.yml

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

package/lib/index.js

@@ -0,0 +1,130 @@
+/**
+ * sage-mem — 记忆桥接插件。
+ *
+ * 把 DSH 的事件流翻译成 sage-mem worker（fork 自 claude-mem）的 HTTP 调用：
+ *   user/message        → POST /api/sessions/init        存用户 prompt
+ *   tool/call + result  → POST /api/sessions/observations 捕获工具 IO
+ *   turn/end            → POST /api/sessions/summarize   触发压缩
+ *                         + 拉取最新记忆上下文缓存
+ *   agent/session-start → 同步注入上个会话的记忆缓存（避免异步注入的时序丢失）
+ *
+ * 注入用「上一回合结束时的缓存」而非当场 fetch：agent/session-start 时 turn
+ * 组装已经开始，异步 fetch 回来再 inject 会被 inbox 消费时序吞掉。缓存在上个
+ * turn/end 时已就绪，session-start 同步注入必然生效。
+ *
+ * worker 不可用时静默跳过，不阻塞 DSH 主流程。worker 进程由启动脚本管理
+ * （sage-bundle 阶段统一装配，先起 worker 再起 dsh）。
+ *
+ * 这是 Sage 的第三道题：我下次应该怎么想 —— 跨会话沉淀事实与教训。
+ */
+
+const WORKER_URL = process.env.SAGE_MEM_WORKER_URL || 'http://127.0.0.1:37700'
+const REQUEST_TIMEOUT_MS = 3000
+const PROJECT = 'sage' // MVP：统一记忆空间；后续可按 cwd 分项目
+
+export const name = 'sage-mem'
+export const inject = []
+
+/**
+ * 构造 UserMessage（手写，零依赖：dsh-llm 无法从 workspace 插件解析）。
+ * source 必需——DSH 消费消息时访问 message.source.kind，纯字符串会崩。
+ */
+function pluginMessage(text, plugin) {
+  return {
+    id: crypto.randomUUID(),
+    role: 'user',
+    content: [{ type: 'text', text }],
+    source: { kind: 'plugin', plugin },
+  }
+}
+
+export function apply(ctx) {
+  // tool/call 先记 callId，等 tool/result 配对后一起送 worker
+  const pendingCalls = new Map()
+  // 上个会话的记忆上下文（turn/end 时拉取，下个 session-start 同步注入）
+  let cachedContext = ''
+  // 最后一条 assistant 消息（summarize 需要）
+  let lastAssistantText = ''
+
+  async function post(path, body) {
+    try {
+      return await fetch(WORKER_URL + path, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+      })
+    } catch {
+      return null // worker 不可用：静默跳过，不阻塞 DSH
+    }
+  }
+
+  function textOf(message) {
+    const blocks = Array.isArray(message?.content) ? message.content : []
+    const texts = blocks.filter(b => b?.type === 'text').map(b => b.text).filter(Boolean)
+    return texts.length ? texts.join('\n') : null
+  }
+
+  // 1. 会话启动：同步注入上个会话的记忆缓存
+  // 注意：事件名是 'agent/session-start'（'emit' 只是分发模式，不是事件名）
+  ctx.on('agent/session-start', (payload) => {
+    const { agent } = payload
+    if (cachedContext) {
+      agent.inject(pluginMessage(`以下是过往会话沉淀的记忆（sage-mem 检索）：\n\n${cachedContext}`, 'sage-mem'))
+    }
+  })
+
+  // 2. 会话内事件：写入记忆
+  ctx.on('session/event', (subject, event) => {
+    const sessionId = subject?.header?.id
+    if (!sessionId) return
+
+    switch (event.type) {
+      case 'user/message': {
+        const text = textOf(event.data)
+        if (!text) return
+        post('/api/sessions/init', { contentSessionId: sessionId, project: PROJECT, prompt: text })
+        break
+      }
+      case 'assistant/message': {
+        // payload 是 { turn, step, message, usage }，message 嵌套一层
+        const text = textOf(event.data?.message)
+        if (text) lastAssistantText = text
+        break
+      }
+      case 'tool/call': {
+        pendingCalls.set(event.data.callId, { name: event.data.name, arguments: event.data.arguments })
+        break
+      }
+      case 'tool/result': {
+        const message = event.data?.message
+        const call = pendingCalls.get(message?.callId)
+        pendingCalls.delete(message?.callId)
+        if (!call) return
+        post('/api/sessions/observations', {
+          contentSessionId: sessionId,
+          tool_name: call.name,
+          tool_input: call.arguments,
+          tool_response: message.content,
+        })
+        break
+      }
+      case 'turn/end': {
+        post('/api/sessions/summarize', {
+          contentSessionId: sessionId,
+          ...(lastAssistantText ? { last_assistant_message: lastAssistantText } : {}),
+        })
+        // 拉取最新记忆上下文，缓存给下一个会话注入
+        fetch(`${WORKER_URL}/api/context/inject?project=${encodeURIComponent(PROJECT)}`, {
+          signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        })
+          .then(r => (r.ok ? r.text() : null))
+          .then(text => {
+            if (text) cachedContext = text
+          })
+          .catch(() => {})
+        break
+      }
+    }
+  })
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "sage-mem",
+  "description": "Sage memory plugin: bridges DSH session events to the sage-mem worker (forked claude-mem) for cross-session memory",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "cordis.patch.yml"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gezi-wen/sage-mem.git"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin"
+  ]
+}