memory-eternal 0.10.6 → 0.10.8

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,23 @@
-{
-  "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"
+        }
+      ]
+    }
+  ],
+  "PreToolUse": [
+    {
+      "matcher": "Read|Bash|Grep|Glob",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/secret-guard.mjs\""
+        }
+      ]
+    }
+  ]
+}

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

package/hooks/secret-guard.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// 记忆核心 · 凭据读取守卫（Claude Code PreToolUse hook，纯 node、静默失败）
+//
+// 为什么需要它：一旦 agent 知道「本机有密钥」，它很可能直接 `cat ~/.dsh/.credentials.yaml`
+// 或 Read 那个文件 —— 值就进了它的上下文（再经 provider / 日志 / 蒸馏扩散出去）。
+// 「知道去哪取」与「不许直接读」必须成对存在，否则索引反而放大了泄漏面。
+//
+// 生效条件（**默认不打扰任何人**）：本机存在密钥加载器
+//   ~/.config/memory-eternal/secrets.py
+// 没有它（其它用户 / 其它机器）这个 hook 直接放行，什么也不做。
+//
+// 命中判定：工具参数里出现下列文件（Read 的 file_path / Bash 的命令行 / Grep 的 pattern 等）
+//   .credentials.y(a)ml、~/.dsh/.env、gitee-token
+// 命中即以 PreToolUse permissionDecision=deny 拒绝，并指路到 secrets.py --names / --run。
+//
+// 由 hooks/hooks.claude.json 注册（PreToolUse）。也可以手工测试：
+//   echo '{"tool_name":"Read","tool_input":{"file_path":"/x/.credentials.yaml"}}' | node hooks/secret-guard.mjs
+
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
+const LOADER = path.join(os.homedir(), '.config', 'memory-eternal', 'secrets.py')
+const SENSITIVE = [
+  /\.credentials\.ya?ml/i,
+  /[\\/]\.dsh[\\/]\.env(?:$|[\s"'])/i,
+  /[\\/]\.env(?:$|["'\s])/i,          // 通用 .env（含值）——只在本机装了加载器时才拦
+  /gitee-token/i,
+]
+const REASON = [
+  '这道读取被「记忆核心」的凭据守卫拦下了：该文件里是密钥**明文**，读进上下文就等于泄漏',
+  '（值经 provider / 日志 / 自动蒸馏会扩散到多处，且删除也无法收回）。',
+  '',
+  '正确做法：',
+  '  1) 先列名字（不输出值）：python ~/.config/memory-eternal/secrets.py --names',
+  '  2) 再带值执行命令（值只进子进程环境变量）：python ~/.config/memory-eternal/secrets.py --require <KEY> --run -- <命令>',
+  '  3) 需要「有哪些键、放在哪、干什么用」的说明：memory_recall("密钥 目录")',
+  '',
+  '确实需要人工查看时，请在终端里自己打开该文件 —— 不要经由 Agent 的工具读取。',
+].join('\n')
+
+async function readStdin() {
+  try {
+    return 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), 1500) // hook 不能挂住宿主
+    })
+  } catch { return '' }
+}
+
+function targetsCredential(input) {
+  if (!input || typeof input !== 'object') return false
+  const fields = ['file_path', 'path', 'notebook_path', 'command', 'pattern', 'glob', 'query', 'url', 'content']
+  const haystack = fields
+    .map((f) => (typeof input[f] === 'string' ? input[f] : ''))
+    .filter(Boolean)
+    .join('\n')
+  if (!haystack) return false
+  return SENSITIVE.some((re) => re.test(haystack))
+}
+
+async function main() {
+  if (!fs.existsSync(LOADER)) return // 没装加载器 → 不打扰
+  const raw = await readStdin()
+  let payload = null
+  try { payload = JSON.parse(raw || '{}') } catch { return }
+  const tool = String(payload?.tool_name || '')
+  if (!tool) return
+  if (!targetsCredential(payload.tool_input)) return
+  process.stdout.write(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'deny',
+      permissionDecisionReason: REASON,
+    },
+  }))
+}
+
+main().catch(() => { /* hook 静默失败：绝不因为守卫崩了而挡住正常工具 */ })