memory-eternal 0.10.0 → 0.10.2

package/examples/mcp-memory/memory-eternal.cordis.yml

@@ -1,59 +1,59 @@
-# 记忆核心（memory-eternal）· MCP 对外通道示例 overlay
-#
-# 用途：把 memory-eternal 的 MCP stdio 服务挂进 DSH —— 让 **DSH 自己**也能通过官方
-# `@deepseek-ai/dsh-mcp-client` 使用记忆库（与 Claude Code / Codex / Cursor 走同一条协议路径）。
-#
-# 什么时候需要它：
-#   · 你没装 memory-eternal 插件本体，只想用它的记忆库 → 用这个 overlay；
-#   · 你已经装了插件（推荐）：插件是「一等公民」，这条 MCP 通道**不需要**，因为插件
-#     自带 memory_recall 工具与系统提示段，还能拿到会话事件做自动沉淀。
-#
-# 用法（示例文件不在交付包里自动生效，必须显式 --patch 或合并进用户 patch 层）：
-#   dsh web --patch "<仓库>/examples/mcp-memory/memory-eternal.cordis.yml"
-#   或把下面的 insert 合并进 $DSH_HOME/cordis.patch.yml（本机所有 profile 生效）
-#   或 $DSH_HOME/profiles/<name>/cordis.patch.yml（只对该 profile 生效）
-#
-# 前置条件（二进制已随包提供，无需额外安装）：
-#   · Node 22+（memory-eternal engines 要求）
-#   · 全局安装或 profile 内安装 memory-eternal（提供 bin/dsh-memory.mjs）
-#       全局：npm i -g memory-eternal
-#       profile 内：cd ~/.dsh/profiles/<name> && pnpm add memory-eternal
-#   下面的 args 用的是「profile 内安装」路径；全局安装请改成
-#   args: ['dsh-memory', 'mcp']（Windows 下为 dsh-memory.cmd）。
-
-- insert:
-    - id: memory-eternal-mcp
-      name: '@deepseek-ai/dsh-mcp-client'
-      config:
-        serverName: eternal
-        transport: stdio
-        command: node
-        args:
-          # 如果是全局安装，改成 ['dsh-memory', 'mcp']
-          - 'C:/Users/<你>/.dsh/profiles/web/node_modules/memory-eternal/bin/dsh-memory.mjs'
-          - 'mcp'
-        # 注意：stdio 桥接会主动**剥离名字像凭据的环境变量以及所有 DSH_* 变量**，其余继承。
-        # 因此：
-        #   · 想让 MCP 进程用哪个库，显式在这里写 MEMORY_VAULT_DIR（不要依赖继承）；
-        #   · 想让 MCP 的 memory_capture 具备「LLM 蒸馏」能力，需要在这里显式传 MEMORY_LLM_*
-        #     （这类变量名字含 KEY/TOKEN，很可能被桥接当凭据剥掉）；
-        #   · 不传就是「原文卡」降级模式，仍然可用，只是不压缩。
-        env:
-          # 留空 = 用插件自己的解析顺序（共享配置 memory-eternal-config.json → 默认 ~/.dsh/memory-vault）
-          MEMORY_VAULT_DIR: ''
-          # 可选：MCP 侧蒸馏用的 OpenAI 兼容端点
-          # MEMORY_LLM_BASE_URL: 'https://api.deepseek.com'
-          # MEMORY_LLM_MODEL: 'deepseek-chat'
-          # MEMORY_LLM_API_KEY: '<在此填 key>'
-        cwd: !!js process.cwd()
-
-# 挂上之后 DSH 侧会看到这些工具（前缀由 serverName 决定）：
-#   mcp__eternal__memory_recall   —— 检索记忆（CJK 整词 + 字符 bigram，只读主库/approved）
-#   mcp__eternal__memory_capture  —— 手动沉淀一段内容（走审核闸门，默认落隔离区 pending）
-#   mcp__eternal__memory_stats    —— 记忆库概览
-#
-# 验证（与官方文档同一套三步骤）：
-#   1) 会话 A：让模型调用 mcp__eternal__memory_capture 写入一个唯一值；
-#   2) 新建会话 B（不必重启宿主）：问「我的验证饮料是什么？查记忆」→ 应调用 memory_recall 并返回该值；
-#   3) 继续在 B 里用该偏好做一次推断。
-#   本仓库 tests/e2e-recall.test.mjs 是同一套步骤的自动化版本（走 vault API）。
+# 记忆核心（memory-eternal）· MCP 对外通道示例 overlay
+#
+# 用途：把 memory-eternal 的 MCP stdio 服务挂进 DSH —— 让 **DSH 自己**也能通过官方
+# `@deepseek-ai/dsh-mcp-client` 使用记忆库（与 Claude Code / Codex / Cursor 走同一条协议路径）。
+#
+# 什么时候需要它：
+#   · 你没装 memory-eternal 插件本体，只想用它的记忆库 → 用这个 overlay；
+#   · 你已经装了插件（推荐）：插件是「一等公民」，这条 MCP 通道**不需要**，因为插件
+#     自带 memory_recall 工具与系统提示段，还能拿到会话事件做自动沉淀。
+#
+# 用法（示例文件不在交付包里自动生效，必须显式 --patch 或合并进用户 patch 层）：
+#   dsh web --patch "<仓库>/examples/mcp-memory/memory-eternal.cordis.yml"
+#   或把下面的 insert 合并进 $DSH_HOME/cordis.patch.yml（本机所有 profile 生效）
+#   或 $DSH_HOME/profiles/<name>/cordis.patch.yml（只对该 profile 生效）
+#
+# 前置条件（二进制已随包提供，无需额外安装）：
+#   · Node 22+（memory-eternal engines 要求）
+#   · 全局安装或 profile 内安装 memory-eternal（提供 bin/dsh-memory.mjs）
+#       全局：npm i -g memory-eternal
+#       profile 内：cd ~/.dsh/profiles/<name> && pnpm add memory-eternal
+#   下面的 args 用的是「profile 内安装」路径；全局安装请改成
+#   args: ['dsh-memory', 'mcp']（Windows 下为 dsh-memory.cmd）。
+
+- insert:
+    - id: memory-eternal-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: eternal
+        transport: stdio
+        command: node
+        args:
+          # 如果是全局安装，改成 ['dsh-memory', 'mcp']
+          - 'C:/Users/<你>/.dsh/profiles/web/node_modules/memory-eternal/bin/dsh-memory.mjs'
+          - 'mcp'
+        # 注意：stdio 桥接会主动**剥离名字像凭据的环境变量以及所有 DSH_* 变量**，其余继承。
+        # 因此：
+        #   · 想让 MCP 进程用哪个库，显式在这里写 MEMORY_VAULT_DIR（不要依赖继承）；
+        #   · 想让 MCP 的 memory_capture 具备「LLM 蒸馏」能力，需要在这里显式传 MEMORY_LLM_*
+        #     （这类变量名字含 KEY/TOKEN，很可能被桥接当凭据剥掉）；
+        #   · 不传就是「原文卡」降级模式，仍然可用，只是不压缩。
+        env:
+          # 留空 = 用插件自己的解析顺序（共享配置 memory-eternal-config.json → 默认 ~/.dsh/memory-vault）
+          MEMORY_VAULT_DIR: ''
+          # 可选：MCP 侧蒸馏用的 OpenAI 兼容端点
+          # MEMORY_LLM_BASE_URL: 'https://api.deepseek.com'
+          # MEMORY_LLM_MODEL: 'deepseek-chat'
+          # MEMORY_LLM_API_KEY: '<在此填 key>'
+        cwd: !!js process.cwd()
+
+# 挂上之后 DSH 侧会看到这些工具（前缀由 serverName 决定）：
+#   mcp__eternal__memory_recall   —— 检索记忆（CJK 整词 + 字符 bigram，只读主库/approved）
+#   mcp__eternal__memory_capture  —— 手动沉淀一段内容（走审核闸门，默认落隔离区 pending）
+#   mcp__eternal__memory_stats    —— 记忆库概览
+#
+# 验证（与官方文档同一套三步骤）：
+#   1) 会话 A：让模型调用 mcp__eternal__memory_capture 写入一个唯一值；
+#   2) 新建会话 B（不必重启宿主）：问「我的验证饮料是什么？查记忆」→ 应调用 memory_recall 并返回该值；
+#   3) 继续在 B 里用该偏好做一次推断。
+#   本仓库 tests/e2e-recall.test.mjs 是同一套步骤的自动化版本（走 vault API）。

package/hooks/capture.mjs

@@ -1,77 +1,77 @@
-#!/usr/bin/env node
-// 记忆核心 · 通用「会话结束自动沉淀」hook（claude-code / codex / cursor 共用）。
-//
-// 用法：node capture.mjs <agent>     agent ∈ claude-code | codex | cursor
-// stdin（平台 hook 注入）：
-//   { session_id, transcript_path, hook_event_name, cwd, last_assistant_message, prompt, ... }
-//
-// 行为：读 transcript（JSONL/JSON 兼容）或显式文本字段 → 调 runStandaloneCapture 蒸馏入库。
-// 设计约束：
-//   - 静默失败（hook 崩溃不能影响宿主 agent）
-//   - 幂等（去重/追加在 runStandaloneCapture 内处理）
-//   - 署名 source = agent 名，便于智能体筛选；vault 由 MEMORY_VAULT_DIR 或 ~/.dsh/memory-vault 决定（与全库统一）
-//
-// Windows 友好：纯 node，无外部依赖（同 claude-session.js）。
-
-import { promises as fs } from 'node:fs'
-
-const agent = process.argv[2] || 'agent'
-
-const readStdin = () => new Promise((resolve) => {
-  let buf = ''
-  process.stdin.setEncoding('utf8')
-  process.stdin.on('data', (c) => { buf += c })
-  process.stdin.on('end', () => resolve(buf))
-  setTimeout(() => resolve(buf), 2000)
-})
-
-/** 从 message 对象里抽可读文本（兼容 claude 的 {role,content} 与 codex/cursor 的 {text|content}）。 */
-function textOf(msg) {
-  if (!msg) return ''
-  if (typeof msg === 'string') return msg
-  const c = msg.content
-  if (typeof c === 'string') return c
-  if (Array.isArray(c)) return c.filter((x) => x && x.type === 'text').map((x) => x.text).join('\n')
-  return msg.text || msg.message || ''
-}
-
-/** 读 transcript 文件并抽取最近对话文本。优先 JSONL 行解析，退回整体文本。 */
-async function extractTranscript(transcriptPath) {
-  let text
-  try { text = await fs.readFile(transcriptPath, 'utf8') } catch { return '' }
-  if (!text.trim()) return ''
-  text = text.replace(/^\uFEFF/, '') // 去掉可能存在的 UTF-8 BOM
-  const lines = text.split('\n').filter(Boolean)
-  const parts = []
-  let structured = 0
-  for (const line of lines.slice(-400)) {
-    let rec
-    try { rec = JSON.parse(line); structured++ } catch { continue }
-    const t = textOf(rec?.message)
-    if (t && t.trim().length > 4) {
-      const role = rec?.message?.role || rec?.role || 'msg'
-      parts.push(`${role}: ${t.trim()}`)
-    }
-  }
-  if (structured >= 1 && parts.length) return parts.slice(-30).join('\n\n')
-  // 非结构化：取尾部可读文本（去掉控制字符）
-  return text.replace(/\r/g, '').replace(/\u0000/g, '').slice(-6000)
-}
-
-async function main() {
-  let meta = {}
-  try { meta = JSON.parse((await readStdin()) || '{}') } catch { /* 静默 */ }
-
-  let conversation = ''
-  if (meta.transcript_path) { try { conversation = await extractTranscript(meta.transcript_path) } catch { /* 静默 */ } }
-  if (!conversation || conversation.trim().length < 120) {
-    conversation = meta.last_assistant_message || meta.prompt || meta.context || ''
-  }
-  if (!conversation || conversation.trim().length < 120) return
-
-  const { runStandaloneCapture, defaultVaultDir } = await import('../lib/capture-run.js')
-  const src = agent // 署名 = agent 名（可筛选）；若想保留会话粒度可用 `${agent}:${session_id}`
-  await runStandaloneCapture(defaultVaultDir(), conversation, { source: src })
-}
-
-main().catch(() => { /* hook 静默失败 */ })
+#!/usr/bin/env node
+// 记忆核心 · 通用「会话结束自动沉淀」hook（claude-code / codex / cursor 共用）。
+//
+// 用法：node capture.mjs <agent>     agent ∈ claude-code | codex | cursor
+// stdin（平台 hook 注入）：
+//   { session_id, transcript_path, hook_event_name, cwd, last_assistant_message, prompt, ... }
+//
+// 行为：读 transcript（JSONL/JSON 兼容）或显式文本字段 → 调 runStandaloneCapture 蒸馏入库。
+// 设计约束：
+//   - 静默失败（hook 崩溃不能影响宿主 agent）
+//   - 幂等（去重/追加在 runStandaloneCapture 内处理）
+//   - 署名 source = agent 名，便于智能体筛选；vault 由 MEMORY_VAULT_DIR 或 ~/.dsh/memory-vault 决定（与全库统一）
+//
+// Windows 友好：纯 node，无外部依赖（同 claude-session.js）。
+
+import { promises as fs } from 'node:fs'
+
+const agent = process.argv[2] || 'agent'
+
+const readStdin = () => new Promise((resolve) => {
+  let buf = ''
+  process.stdin.setEncoding('utf8')
+  process.stdin.on('data', (c) => { buf += c })
+  process.stdin.on('end', () => resolve(buf))
+  setTimeout(() => resolve(buf), 2000)
+})
+
+/** 从 message 对象里抽可读文本（兼容 claude 的 {role,content} 与 codex/cursor 的 {text|content}）。 */
+function textOf(msg) {
+  if (!msg) return ''
+  if (typeof msg === 'string') return msg
+  const c = msg.content
+  if (typeof c === 'string') return c
+  if (Array.isArray(c)) return c.filter((x) => x && x.type === 'text').map((x) => x.text).join('\n')
+  return msg.text || msg.message || ''
+}
+
+/** 读 transcript 文件并抽取最近对话文本。优先 JSONL 行解析，退回整体文本。 */
+async function extractTranscript(transcriptPath) {
+  let text
+  try { text = await fs.readFile(transcriptPath, 'utf8') } catch { return '' }
+  if (!text.trim()) return ''
+  text = text.replace(/^\uFEFF/, '') // 去掉可能存在的 UTF-8 BOM
+  const lines = text.split('\n').filter(Boolean)
+  const parts = []
+  let structured = 0
+  for (const line of lines.slice(-400)) {
+    let rec
+    try { rec = JSON.parse(line); structured++ } catch { continue }
+    const t = textOf(rec?.message)
+    if (t && t.trim().length > 4) {
+      const role = rec?.message?.role || rec?.role || 'msg'
+      parts.push(`${role}: ${t.trim()}`)
+    }
+  }
+  if (structured >= 1 && parts.length) return parts.slice(-30).join('\n\n')
+  // 非结构化：取尾部可读文本（去掉控制字符）
+  return text.replace(/\r/g, '').replace(/\u0000/g, '').slice(-6000)
+}
+
+async function main() {
+  let meta = {}
+  try { meta = JSON.parse((await readStdin()) || '{}') } catch { /* 静默 */ }
+
+  let conversation = ''
+  if (meta.transcript_path) { try { conversation = await extractTranscript(meta.transcript_path) } catch { /* 静默 */ } }
+  if (!conversation || conversation.trim().length < 120) {
+    conversation = meta.last_assistant_message || meta.prompt || meta.context || ''
+  }
+  if (!conversation || conversation.trim().length < 120) return
+
+  const { runStandaloneCapture, defaultVaultDir } = await import('../lib/capture-run.js')
+  const src = agent // 署名 = agent 名（可筛选）；若想保留会话粒度可用 `${agent}:${session_id}`
+  await runStandaloneCapture(defaultVaultDir(), conversation, { source: src })
+}
+
+main().catch(() => { /* hook 静默失败 */ })

package/hooks/claude-session.js

@@ -1,56 +1,56 @@
-#!/usr/bin/env node
-// 记忆核心 · Claude Code SessionEnd/PreCompact hook（Windows 友好，纯 node）。
-//
-// Claude Code 在会话结束/压缩前触发，stdin 传入 JSON：
-//   { session_id, transcript_path, hook_event_name, cwd, ... }
-// 本脚本解析 transcript JSONL，提取最近若干轮 user/assistant 文本，蒸馏入库。
-// 由 lib/setup.js 自动注册到 ~/.claude/settings.json 的 hooks.SessionEnd。
-//
-// 特性：静默失败（hook 崩溃不能影响 Claude Code）；幂等（重复跑同一段只追加）。
-
-import { promises as fs } from 'node:fs'
-import path from 'node:path'
-
-async function main() {
-  let input = {}
-  try {
-    const raw = await new Promise((resolve) => {
-      let buf = ''
-      process.stdin.setEncoding('utf8')
-      process.stdin.on('data', (c) => { buf += c })
-      process.stdin.on('end', () => resolve(buf))
-      setTimeout(() => resolve(buf), 2000)
-    })
-    input = JSON.parse(raw || '{}')
-  } catch { /* 静默 */ }
-
-  const transcriptPath = input.transcript_path
-  if (!transcriptPath) return
-  let lines
-  try { lines = (await fs.readFile(transcriptPath, 'utf8')).split('\n').filter(Boolean) } catch { return }
-
-  // 提取尾部对话文本（user 与 assistant 的 message.content 文本部分）
-  const texts = []
-  for (const line of lines.slice(-400)) {
-    let rec
-    try { rec = JSON.parse(line) } catch { continue }
-    const msg = rec?.message
-    if (!msg || !msg.role) continue
-    const content = msg.content
-    let text = ''
-    if (typeof content === 'string') text = content
-    else if (Array.isArray(content)) {
-      text = content.filter((c) => c?.type === 'text').map((c) => c.text).join('\n')
-    }
-    if (text && text.trim().length > 4) texts.push(`${msg.role}: ${text.trim()}`)
-  }
-  const conversation = texts.slice(-30).join('\n\n')
-  if (conversation.trim().length < 120) return
-
-  const { runStandaloneCapture, defaultVaultDir } = await import('../lib/capture-run.js')
-  await runStandaloneCapture(defaultVaultDir(), conversation, {
-    source: `claude-code:${input.session_id || path.basename(transcriptPath)}`,
-  })
-}
-
-main().catch(() => { /* hook 静默失败 */ })
+#!/usr/bin/env node
+// 记忆核心 · Claude Code SessionEnd/PreCompact hook（Windows 友好，纯 node）。
+//
+// Claude Code 在会话结束/压缩前触发，stdin 传入 JSON：
+//   { session_id, transcript_path, hook_event_name, cwd, ... }
+// 本脚本解析 transcript JSONL，提取最近若干轮 user/assistant 文本，蒸馏入库。
+// 由 lib/setup.js 自动注册到 ~/.claude/settings.json 的 hooks.SessionEnd。
+//
+// 特性：静默失败（hook 崩溃不能影响 Claude Code）；幂等（重复跑同一段只追加）。
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+async function main() {
+  let input = {}
+  try {
+    const raw = await new Promise((resolve) => {
+      let buf = ''
+      process.stdin.setEncoding('utf8')
+      process.stdin.on('data', (c) => { buf += c })
+      process.stdin.on('end', () => resolve(buf))
+      setTimeout(() => resolve(buf), 2000)
+    })
+    input = JSON.parse(raw || '{}')
+  } catch { /* 静默 */ }
+
+  const transcriptPath = input.transcript_path
+  if (!transcriptPath) return
+  let lines
+  try { lines = (await fs.readFile(transcriptPath, 'utf8')).split('\n').filter(Boolean) } catch { return }
+
+  // 提取尾部对话文本（user 与 assistant 的 message.content 文本部分）
+  const texts = []
+  for (const line of lines.slice(-400)) {
+    let rec
+    try { rec = JSON.parse(line) } catch { continue }
+    const msg = rec?.message
+    if (!msg || !msg.role) continue
+    const content = msg.content
+    let text = ''
+    if (typeof content === 'string') text = content
+    else if (Array.isArray(content)) {
+      text = content.filter((c) => c?.type === 'text').map((c) => c.text).join('\n')
+    }
+    if (text && text.trim().length > 4) texts.push(`${msg.role}: ${text.trim()}`)
+  }
+  const conversation = texts.slice(-30).join('\n\n')
+  if (conversation.trim().length < 120) return
+
+  const { runStandaloneCapture, defaultVaultDir } = await import('../lib/capture-run.js')
+  await runStandaloneCapture(defaultVaultDir(), conversation, {
+    source: `claude-code:${input.session_id || path.basename(transcriptPath)}`,
+  })
+}
+
+main().catch(() => { /* hook 静默失败 */ })

package/hooks/hooks.claude.json

@@ -1,12 +1,12 @@
-{
-  "SessionEnd": [
-    {
-      "hooks": [
-        {
-          "type": "command",
-          "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" claude-code"
-        }
-      ]
-    }
-  ]
-}
+{
+  "SessionEnd": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" claude-code"
+        }
+      ]
+    }
+  ]
+}

package/hooks/hooks.codex.json

@@ -1,15 +1,15 @@
-{
-  "hooks": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" codex",
-            "statusMessage": "memory-eternal: saving session"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" codex",
+            "statusMessage": "memory-eternal: saving session"
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.cursor.json

@@ -1,11 +1,11 @@
-{
-  "version": 1,
-  "hooks": {
-    "stop": [
-      { "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" cursor" }
-    ],
-    "sessionEnd": [
-      { "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" cursor" }
-    ]
-  }
-}
+{
+  "version": 1,
+  "hooks": {
+    "stop": [
+      { "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" cursor" }
+    ],
+    "sessionEnd": [
+      { "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/capture.mjs\" cursor" }
+    ]
+  }
+}