memory-eternal 0.1.0

package/bin/dsh-memory.mjs

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+// 记忆核心 · CLI（多宿主统一入口）
+//
+// 用法：
+//   dsh-memory recall <query> [--limit N] [--vault DIR]   检索知识卡
+//   dsh-memory capture <text | - > [--source TAG]         手动沉淀（- 读 stdin）
+//   dsh-memory serve [--port N] [--vault DIR]             启动 Web UI（前台常驻）
+//   dsh-memory open [--port N]                            确保 Web 存活并用浏览器打开
+//   dsh-memory mcp                                        MCP stdio server（各 agent 挂载）
+//   dsh-memory setup [--claude-only|--codex-only|--cursor-only] [--dry-run] [--no-hooks]
+//                                                         自动挂载 MCP 到已装的 agent
+//   dsh-memory sweep <dir>                                挖掘 Claude Code 会话 JSONL
+//
+// 环境变量：
+//   MEMORY_VAULT_DIR       vault 目录（默认 ~/.dsh/memory-vault）
+//   MEMORY_LLM_BASE_URL / MEMORY_LLM_KEY / MEMORY_LLM_MODEL   蒸馏 LLM（OpenAI 兼容）
+//   MEMORY_ETERNAL_SKIP_AUTO=1   setup 时不动外部配置
+
+import path from 'node:path'
+import process from 'node:process'
+
+const argv = process.argv.slice(2)
+const cmd = argv[0] || 'help'
+const argOf = (name) => {
+  const i = argv.indexOf(name)
+  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : null
+}
+const has = (name) => argv.includes(name)
+
+/** 取位置参数（跳过子命令、flag 与 flag 的值） */
+const positional = () => {
+  const isFlag = (s) => typeof s === 'string' && s.startsWith('--')
+  const out = []
+  for (let i = 1; i < argv.length; i++) {
+    const a = argv[i]
+    if (isFlag(a)) { i++; continue }   // 跳过 flag + 它的值（任意 flag 都吃掉下一项）
+    out.push(a)
+  }
+  return out
+}
+
+async function main() {
+  switch (cmd) {
+    case 'recall': {
+      const query = positional().join(' ')
+      const { search } = await import('../lib/vault.js')
+      const { defaultVaultDir } = await import('../lib/capture-run.js')
+      const root = path.resolve(argOf('--vault') || defaultVaultDir())
+      const limit = Math.min(Math.max(Number(argOf('--limit')) || 5, 1), 20)
+      const hits = await search(root, query, { limit, minScore: 2 })
+      if (!hits.length) {
+        console.log(JSON.stringify({ ok: true, hits: [], note: `记忆库中没有与「${query}」相关的内容` }, null, 2))
+        return
+      }
+      console.log(JSON.stringify({ ok: true, vaultDir: root, hits }, null, 2))
+      return
+    }
+    case 'capture': {
+      const raw = positional().join(' ')
+      let text = raw
+      if (raw === '-' || (!raw && !process.stdin.isTTY)) {
+        // 同步读 stdin 在 Windows 重定向下偶尔返回空（Node 22/24 行为差异）。
+        // 改用流式读：先确保 readable 事件触发，再收集全部 data/end。
+        text = await new Promise((resolve) => {
+          let buf = ''
+          const done = () => resolve(buf)
+          process.stdin.setEncoding('utf8')
+          process.stdin.on('data', (c) => { buf += c })
+          process.stdin.on('end', done)
+          process.stdin.on('error', done)
+          // 兜底：若 stdin 已被消费完（同步场景），立即结束
+          if (process.stdin.readableEnded) done()
+          setTimeout(done, 3000)
+        })
+      }
+      const { runStandaloneCapture, defaultVaultDir } = await import('../lib/capture-run.js')
+      const root = path.resolve(defaultVaultDir())
+      const out = await runStandaloneCapture(root, text, { source: argOf('--source') || 'cli' })
+      console.log(JSON.stringify({ ...out, vaultDir: root }, null, 2))
+      process.exitCode = out.ok ? 0 : 1
+      return
+    }
+    case 'serve': {
+      const { startWebServer, DEFAULT_WEB_PORT } = await import('../lib/web.js')
+      const { defaultVaultDir } = await import('../lib/capture-run.js')
+      const port = Number(argOf('--port')) || DEFAULT_WEB_PORT
+      const vault = path.resolve(argOf('--vault') || defaultVaultDir())
+      await startWebServer({ port, vaultRoot: vault })
+      process.on('SIGINT', () => process.exit(0))
+      process.on('SIGTERM', () => process.exit(0))
+      return
+    }
+    case 'open': {
+      const { ensureWebServer, DEFAULT_WEB_PORT } = await import('../lib/web.js')
+      const { defaultVaultDir } = await import('../lib/capture-run.js')
+      const port = Number(argOf('--port')) || DEFAULT_WEB_PORT
+      const { url } = await ensureWebServer({ port, vaultRoot: path.resolve(defaultVaultDir()) })
+      console.log(url)
+      const plat = process.platform
+      const { exec } = await import('node:child_process')
+      if (plat === 'win32') exec(`start "" "${url}"`)
+      else if (plat === 'darwin') exec(`open "${url}"`)
+      else exec(`xdg-open "${url}"`)
+      return
+    }
+    case 'mcp': {
+      const { startMcpServer } = await import('../lib/mcp.js')
+      startMcpServer()
+      return
+    }
+    case 'watchdog': {
+      const { startWatchdog } = await import('../lib/watchdog.js')
+      const { defaultVaultDir } = await import('../lib/capture-run.js')
+      const port = Number(argOf('--port')) || 7999
+      const interval = Number(argOf('--interval')) || 5000
+      const maxRestart = Number(argOf('--max-restart')) || 10
+      const vaultRoot = argOf('--vault') ? path.resolve(argOf('--vault')) : defaultVaultDir()
+      const autoStart = !has('--no-restart')
+      console.log(`dsh-memory watchdog 启动 → 目标端口 ${port}，间隔 ${interval}ms，最大重拉 ${maxRestart} 次${autoStart ? '' : '（--no-restart）'}`)
+      console.log(`vault: ${vaultRoot}\n按 Ctrl+C 退出`)
+      startWatchdog({ port, interval, maxRestart, vaultRoot, autoStart })
+      return
+    }
+    case 'setup': {
+      const { runSetup } = await import('../lib/setup.js')
+      const only = []
+      if (has('--claude-only')) only.push('claude')
+      if (has('--codex-only')) only.push('codex')
+      if (has('--cursor-only')) only.push('cursor')
+      const out = await runSetup({ only, withHooks: !has('--no-hooks'), dryRun: has('--dry-run') })
+      const done = out.results.filter((r) => r.ok).length
+      console.log(`\n记忆库目录：默认 ~/.dsh/memory-vault（MEMORY_VAULT_DIR 可改）`)
+      console.log(`完成：${done}/${out.results.length} 项。Web UI: dsh-memory open`)
+      return
+    }
+    case 'connect': {
+      // 会话结束自动沉淀 hook：不依赖 plugin（Codex Desktop 也适用），写用户级 hooks.json
+      const agent = positional()[0] || ''
+      if (!agent) {
+        console.error('用法：dsh-memory connect <claude|codex|cursor> [--dry-run]')
+        process.exitCode = 1
+        return
+      }
+      const { connectAgentHooks } = await import('../lib/setup.js')
+      const out = await connectAgentHooks(agent, { dryRun: has('--dry-run'), log: (m) => console.log(m) })
+      if (out && out.ok) console.log(`\n✓ ${agent} 会话结束自动沉淀 hook 已就绪（写入统一 ~/.dsh/memory-vault，新卡进待审核）`)
+      else { console.error(`✗ ${agent} 连接失败：` + JSON.stringify(out)); process.exitCode = 1 }
+      return
+    }
+    case 'sweep': {
+      const dir = argv[1]
+      if (!dir || dir.startsWith('--')) {
+        console.error('用法：dsh-memory sweep <dir>（如 ~/.claude/projects）')
+        process.exitCode = 1
+        return
+      }
+      const { sweepSessions } = await import('../lib/sweep.js')
+      const out = await sweepSessions(dir)
+      console.log(JSON.stringify(out, null, 2))
+      return
+    }
+    default:
+      console.log(`dsh-memory — 记忆核心 CLI
+
+用法：
+  dsh-memory recall <query> [--limit N]       检索知识卡
+  dsh-memory capture <text | -> [--source T]  手动沉淀（- 读 stdin）
+  dsh-memory serve [--port N]                 Web UI（前台）
+  dsh-memory open                             确保 Web 存活并打开浏览器
+  dsh-memory mcp                              MCP stdio server
+  dsh-memory setup [--dry-run] ...            自动挂载 MCP 到已装 agent
+  dsh-memory connect <claude|codex|cursor>   写会话结束自动沉淀 hook（不依赖 plugin，含 Codex Desktop）
+  dsh-memory sweep <dir>                      挖掘会话 JSONL
+  dsh-memory watchdog [--port N] [--interval MS] [--max-restart N]  看门狗保活 web server
+
+环境变量：MEMORY_VAULT_DIR / MEMORY_LLM_BASE_URL / MEMORY_LLM_KEY / MEMORY_LLM_MODEL`)
+  }
+}
+
+main().catch((error) => {
+  console.error(String(error?.stack || error))
+  process.exit(1)
+})

package/cordis.patch.yml

@@ -0,0 +1,15 @@
+# 记忆核心（memory-eternal）bundle 补丁层。
+# 安装后由 package.json 的 dsh.bundle.patch 自动生效；后层
+# （profile 自己的 cordis.patch.yml / --patch）可按 id 覆盖或禁用本行。
+#
+# 客户端 UI（设置 → 记忆：统计 / 搜索 / 知识图谱）由 package.json 的
+# dsh.client 元数据自动挂载，无需在此声明任何 client 行。
+
+- insert:
+    - id: memory-eternal
+      name: memory-eternal
+      config:
+        enabled: true
+        autoCapture: true
+        autoRecall: true
+        vaultDir: ''

package/hooks/capture.mjs

@@ -0,0 +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 静默失败 */ })

package/hooks/claude-session.js

@@ -0,0 +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 静默失败 */ })

package/hooks/hooks.claude.json

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

package/hooks/hooks.codex.json

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

package/hooks/hooks.cursor.json

@@ -0,0 +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" }
+    ]
+  }
+}