dsh-memory-eternal 0.4.27 → 0.5.0

package/README.md

@@ -146,7 +146,169 @@ dsh plugin --profile web add F:/MyApp/eternal/dsh-memory-eternal
 > - 要**官方最新**（避免 npmmirror 滞后）：`npm_config_registry=https://registry.npmjs.org/ dsh plugin --profile web add dsh-memory-eternal`。
 > - **profile 是 pnpm workspace**：`cd ~/.dsh/profiles/web && pnpm add dsh-memory-eternal@latest`（`npm install` 会报 `EUNSUPPORTEDPROTOCOL`）。
 
-装完**重启 dsh web**：设置 → 记忆 出现知识库；侧边栏底部出现「记忆」按钮。此后每轮对话自动沉淀。
+装完**重启 dsh web**：设置 → 记忆 出现知识库（iframe 加载 Web 端）；侧边栏底部出现「记忆」按钮。此后每轮对话自动沉淀。
+
+## 🌐 多宿主：装完即用（Claude Code / Codex / Cursor / 浏览器）
+
+从 v0.5 起，本插件不再只属于 DSH——**一个记忆库，所有 Agent 共享**：
+
+```
+┌────────── 核心引擎（vault.js + capture.js，零耦合）──────────┐
+│  ① DSH 原生插件        ② MCP server        ③ Web 端         │
+│     自动沉淀+召回          stdio 零依赖        UI 唯一真源      │
+│     UI=iframe 壳          Claude/Codex/      浏览器直接访问    │
+│                           Cursor             DSH 渲染也走它   │
+└──────────────────────────────────────────────────────────────┘
+```
+
+### 自动挂载（零手动）
+
+插件激活时自动检测本机已装的 Agent，**幂等写入 MCP 配置**（改动前自动备份）：
+
+- **Claude Code** → `~/.claude.json` 的 `mcpServers` + `~/.claude/settings.json` 的 SessionEnd hook（会话结束自动沉淀）
+- **Codex CLI** → `~/.codex/config.toml` 的 `[mcp_servers.memory]`
+- **Cursor** → `~/.cursor/mcp.json`
+
+下次打开对应工具，`memory_recall` / `memory_capture` / `memory_stats` 三个工具直接可用。不想自动配置？设置里关 `autoMcpSetup`，或环境变量 `MEMORY_ETERNAL_SKIP_AUTO=1`。
+
+### Web 端（默认常驻）
+
+插件激活时自动拉起独立 Web server（detached 进程，不占 DSH 宿主），**UI 唯一真源**——DSH 内的设置页与浏览器访问的是同一份：
+
+```bash
+dsh-memory open            # 确保 Web 存活 + 浏览器打开（默认 http://127.0.0.1:7999）
+dsh-memory serve --port 8080   # 前台跑 Web server
+```
+
+### CLI 速查
+
+```bash
+dsh-memory recall "数据库选型"      # 检索
+dsh-memory capture "重要结论..."    # 手动沉淀
+dsh-memory sweep ~/.claude/projects # 挖掘已有会话记录
+dsh-memory setup --dry-run          # 重跑自动挂载（幂等）
+dsh-memory mcp                      # MCP stdio（挂给任意 MCP 客户端）
+```
+
+### 蒸馏 LLM（可选）
+
+MCP / hooks / CLI 的自动蒸馏需要一个 OpenAI 兼容端点（DSH 内免配）：
+
+```bash
+export MEMORY_LLM_BASE_URL=https://api.deepseek.com   # 或 Ollama/vLLM/LM Studio
+export MEMORY_LLM_KEY=sk-xxx
+export MEMORY_LLM_MODEL=deepseek-chat
+```
+
+未配置时：recall 全功能；capture 降级为原文卡（不蒸馏）。
+
+### 单一副本原则（防版本漂移）
+
+MCP/hooks/CLI 全部指向 DSH profile 内那一份代码（`~/.dsh/profiles/web/node_modules/dsh-memory-eternal`）。**更新只需一条命令**：`cd ~/.dsh/profiles/web && pnpm add dsh-memory-eternal@latest`，DSH + MCP + Web 齐步走。纯 Claude Code 用户（无 DSH）可 `npm i -g dsh-memory-eternal`，独立副本独立库。卡格式带 `formatVersion` 守卫，跨版本只向后兼容读，多副本共存不会写坏库。
+
+---
+
+## 📖 使用
+
+> **核心心智模型：一个库（`~/.dsh/memory-vault`，纯 Markdown + 可 git），一群 Agent（DSH / Claude / Codex / Cursor）自动记、随时忆，一个网页（`dsh-memory open`）看全局。**
+
+### DSH 内使用（现状，0 步骤）
+
+```bash
+# 重启 dsh web 后生效新版插件
+```
+
+- **自动沉淀**：每轮对话结束自动把可复用内容蒸馏成知识卡，无需操作
+- **`memory_recall` 工具**：Agent 在需要历史决策/项目背景时主动调用
+- **可视化**：设置 → 记忆 或侧边栏底部「记忆」按钮 → 内嵌打开 Web 端（同一份 UI）
+- **多 Vault**：设置里 `vaultProfiles` 命名分库 + `activeVault` 切换；跨库聚合检索 `?all=1`
+
+### Claude Code 使用
+
+装完即用——MCP 与 SessionEnd hook 都已自动挂载：
+
+- 会话中说「recall 一下数据库选型」→ Claude 自动调 `memory_recall`
+- 会话结束/上下文压缩前 → hook 自动蒸馏入库
+- 想看记了什么：`dsh-memory open`
+
+### Codex CLI / Cursor 使用
+
+重启对应工具后，MCP 已在工具的 MCP 列表里，会话内直接：
+
+```
+用 memory_recall 查一下项目的历史决策
+用 memory_stats 看库内有多少张卡
+```
+
+### Web 端使用
+
+```bash
+dsh-memory open              # 确保 Web 存活 + 浏览器打开（默认 http://127.0.0.1:7999）
+dsh-memory serve --port 8080 # 自定义端口前台运行
+```
+
+打开后所见即所得：统计概览 / 中文片段检索 / 知识卡网格（删除/编辑/合并/导入导出）/ 增强知识图谱（力导向+时间维着色+右键菜单+框选+PNG 导出）。与 DSH 内嵌「记忆」页面渲染同一份 UI（单一真源），数据天然同步。
+
+### CLI 速查
+
+```bash
+dsh-memory recall "数据库选型"      # 检索知识卡（输出 JSON）
+dsh-memory capture "重要结论..."    # 手动沉淀（- 读 stdin）
+dsh-memory sweep ~/.claude/projects # 挖掘已有会话记录
+dsh-memory setup --dry-run          # 预览自动挂载（幂等）
+dsh-memory mcp                      # MCP stdio（手动挂任意 MCP 客户端）
+dsh-memory serve --port 7999        # 前台 Web server
+dsh-memory open                     # 确保 Web 存活 + 浏览器打开
+```
+
+### 蒸馏 LLM（可选）
+
+MCP / hooks / CLI 的自动蒸馏需要一个 OpenAI 兼容端点（DSH 内免配——复用 dsh 的 llm）：
+
+```bash
+export MEMORY_LLM_BASE_URL=https://api.deepseek.com   # 或 Ollama/vLLM/LM Studio
+export MEMORY_LLM_KEY=sk-xxx
+export MEMORY_LLM_MODEL=deepseek-chat
+```
+
+未配置时：recall 全功能；capture 降级为原文卡（不蒸馏，仍可正常用）。
+
+### zcode（智谱）说明
+
+zcode 暂无原生 MCP 支持，可经社区 [zcode-open-bridge](https://github.com/tizerluo/zcode-open-bridge) 转 MCP 后挂载，或直接用 CLI（`dsh-memory capture / recall / sweep`）。
+
+---
+
+## 🔄 更新
+
+**单副本原则**是更新能「一条命令搞定」的根基——所有入口都指向同一份代码。
+
+```bash
+# DSH 用户（最常见）：profile 里更新 → DSH + MCP + Web 齐步走
+cd ~/.dsh/profiles/web
+pnpm add dsh-memory-eternal@latest
+
+# 纯 Claude Code / Cursor 用户（无 DSH）：全局包更新
+npm i -g dsh-memory-eternal@latest
+```
+
+更新完后：
+- **DSH 用户**：重启 dsh web（插件 reload）→ `autoMcpSetup` 自动幂等跳过（配置已是最新），`autoWeb` 进程已是新版
+- **Claude/Codex/Cursor 用户**：重启对应工具，stdin MCP 进程由 agent 重 spawn → 加载新版
+
+不会出现的版本漂移：所有 agent 入口指向同一份代码，不存在「DSH 是新版、Claude Code 是旧版」导致的格式/行为不一致。卡文件 `formatVersion` 字段是最后一道防线，跨版本只向后兼容读。
+
+如果想从 GitHub 拉未发布版（dev/特性分支）：
+
+```bash
+# DSH 用户
+cd ~/.dsh/profiles/web && pnpm add github:EternalNight996/dsh-memory-eternal
+
+# 全局
+npm i -g github:EternalNight996/dsh-memory-eternal
+```
+
+---
 
 ### 🧭 插件发现 / 收录标准
 
@@ -178,6 +340,8 @@ dsh plugin --profile web add F:/MyApp/eternal/dsh-memory-eternal
 | activeVault | '' | 当前激活的 Vault（对应 vaultProfiles 中的 name） |
 | sessionBudgetChars | 80000 | 会话级 token 预算（字符数），供 harness 触发压缩 |
 | recallEmbedding | '' | 语义召回 provider（空=零依赖 bigram + LLM 判定兜底） |
+| autoMcpSetup | 开 | 激活时自动把 MCP 挂到本机已装的 Claude Code/Codex/Cursor（幂等+备份） |
+| autoWeb | 开 | 激活时确保 Web server 常驻（UI 唯一真源，DSH 渲染走 iframe） |
 
 ---
 
@@ -218,6 +382,12 @@ dsh-memory-eternal/
 - **整理建议**（相似卡对合并/陈旧卡，非破坏预览）
 - **召回用户反馈**（`/feedback`，为相关性调优留数据）
 - **会话预算**（`sessionBudgetChars` + `/budget`）
+- **用量趋势图 + 笔记模板（4种）**（v0.4.25）
+- **一键清理陈旧卡片** + **优化面板增强**（v0.4.25）
+- **新建卡片 kind 下拉可读背景色**（v0.4.27）
+- **图谱合并/删除即时联动整理建议**（v0.4.27）
+- **一键合并相似按钮从图谱工具栏移到整理建议面板**（v0.4.26）
+- **多宿主**：MCP server + CLI `dsh-memory` + Web 端常驻 + 自动挂载 Claude/Codex/Cursor + SessionEnd hook + `formatVersion` 守卫（v0.5.0）
 
 **待办（核心功能优化）**：
 - [x] ~~多 Vault / 多 Profile~~、~~注入体积可配置~~、~~每日回顾+用量~~、~~自动归档整理~~、~~召回用户反馈~~、~~会话级 token 预算~~（v0.4.5）
@@ -226,11 +396,18 @@ dsh-memory-eternal/
 - [ ] 多 Vault 的**跨库合并/去重**（跨 profile 识别重复卡）
 - [ ] 语义召回**接入外部 embedding provider**（当前为本地零依赖加分）
 - [ ] 每日回顾**主动推送通道**（当前生成文件 + 手动查看，推送需 harness/通知渠道）
+- [ ] **多宿主体验进一步收口**：zcode bridge 内置 / Codex sweep 增字段适配 / Web 端暗色主题微调
 
 ---
 
 ## 📦 发布记录
 
+- **v0.5.0**：**多宿主化**——MCP server 零依赖 stdio（3 工具：recall/capture/stats），CLI 入口 `dsh-memory`（recall/capture/serve/open/mcp/setup/sweep），Web 端常驻（DSH 渲染走 iframe = 单一 UI 真源），自动挂载到 Claude Code/Codex/Cursor（幂等+备份），Claude Code SessionEnd hook 自动沉淀，卡格式 `formatVersion` 守卫，DSH 用户 / Claude Code 用户均「一条命令安装即用」。`api.js` 抽层 + `capture-run.js` 独立沉淀管线复用。
+- **v0.4.28**：侧边栏底部「记忆」按钮**独占一行**——不再与「主题」等 footer 按钮挤在同一行（`flex-wrap` 同时命中直接包含与中间隔 wrapper 两种情况）。
+- **v0.4.27**：新建卡片 kind 下拉可读背景色；图谱合并/删除节点后**即时联动整理建议**面板刷新。
+- **v0.4.26**：一键合并相似按钮从图谱工具栏移到整理建议面板，操作路径更直观。
+- **v0.4.25**：**用量趋势图**（近7天柱状图）；**笔记模板**（4种：需求/决策/接口/复盘）；**一键清理陈旧卡片**；优化面板增强 + `mergeCards` 修复。
+- **v0.4.24**：preview 清理 + `.gitignore` 完善；README 设置文档补充；瘦身确认打包。
 - **v0.4.23**：项目瘦身——README 图片改 GitHub raw 链接，`files` 白名单移除 assets/docs/PUBLISH，npm 包从 ~10MB 降至 **50 KB**（99.5% 缩减）；`/budget` 路由 500 防御降级 + fetchAll 容错；跨库聚合路由 try/catch 安全回退。
 - **v0.4.22**：每日回顾简报「查看/收起」toggle（并入用量面板）、去掉左侧栏第 5 项。
 - **v0.4.21**：筛选按钮移到搜索框右边；`mergeCards` 抽取到 vault.js + 单元测试覆盖。
@@ -246,6 +423,45 @@ dsh-memory-eternal/
 
 ---
 
+## 📜 Git 历史（近 30 条）
+
+| Commit | 描述 |
+|--------|------|
+| `b6aee65` | fix(v0.4.27): 新建卡片kind下拉可读背景色/图谱合并删除即时联动整理建议 |
+| `60c7271` | fix(v0.4.26): 一键合并相似按钮从图谱工具栏移到整理建议面板 |
+| `93ce8f5` | v0.4.25: 用量趋势图/笔记模板(4种)/一键清理陈旧/优化面板增强/mergeCards修复 |
+| `b5d326a` | v0.4.24: preview清理/.gitignore + README设置文档补充 + 瘦身确认打包 |
+| `1c16e1b` | chore(v0.4.23): 项目瘦身——README图片改GitHub raw链接，files白名单移除assets/docs/PUBLISH |
+| `a0d75f0` | refactor(v0.4.22): 每日回顾简报回收/并入用量统计(查看/收起)/去掉左栏第5项 |
+| `4d8d91d` | feat(v0.4.21): 筛选按钮移到搜索框右边/mergeCards 抽取+测试覆盖 |
+| `f88f4d3` | refactor(v0.4.20): 去重——每日回顾移除重复今日卡片列表仅保留简报;标签筛选并入左下角筛选下拉 |
+| `d879ed4` | fix(v0.4.19): 知识图谱筛选下拉化+加载中持久化修复(/graph ok:false设error) |
+| `c503e96` | fix(v0.4.18): /budget 500防御降级+fetchAll容错budget不再阻断用量/整理面板 |
+| `904abd9` | feat(v0.4.17): 用量加载失败红色提示+重试/左侧栏加今日简报独立视图 |
+| `e522979` | test(v0.4.16): 补API形状测试——stats/optimizeCandidates/cross-vault(graphAll+searchAll) |
+| `f30762c` | test(v0.4.16): 补单元测试——stats/optimizeCandidates/语义检索+反馈/跨库聚合/每日简报/compressExcerpt |
+| `e379a9d` | feat(v0.4.16): 召回反馈反哺排序+图谱标签过滤/标签云+卡片读者有用/无关反馈 |
+| `43b0efb` | feat(v0.4.15): 图谱搜索节点定位——输入命中即居中放大并选中 |
+| `54d0c88` | fix(v0.4.14): 用量/整理加载失败显性提示+图谱右键合并按钮 |
+| `b28a07b` | feat(v0.4.13): 去掉统一管理/左侧栏改为独立功能项(卡片/图谱/用量/整理) |
+| `783af40` | feat(v0.4.12): 管理改左侧栏第三视图内嵌渲染/收缩图标换/图谱搜索同卡片样式 |
+| `4428b77` | feat(v0.4.11): 管理入左侧栏/卡片与图谱输入框独立分开切换 |
+| `7db1e93` | feat(v0.4.10): 左侧栏美化——分栏分隔线/收缩按钮/标签按钮 |
+| `51b39ec` | fix(v0.4.9): UI——卡片/图谱切换改固定左侧栏+选中色可读/图谱展示全部去滚动条 |
+| `ac7b318` | feat(v0.4.8): UI增强——卡片/图谱切按钮移顶端栏凸显/去掉无效自选位置 |
+| `887d1a5` | fix(v0.4.7): 管理面板TDZ崩溃——fetchAll提升为函数声明，修正useEffect依赖 |
+| `faf1e7c` | fix(v0.4.6): 修复i18n对象闭合导致的esbuild构建失败 |
+| `9d5ac70` | feat(v0.4.6): 记忆侧收官——批量智能合并/跨库聚合/语义召回加分/每日回顾定时生成 |
+| `7951eee` | feat(v0.4.5): 记忆侧核心优化——注入可配置/多Vault/每日回顾统计/整理建议/召回反馈 |
+| `0275444` | docs(v0.4.4): 重构README为热产品——痛点Before/After+内核设计+权威类比 |
+| `f32a746` | feat(v0.4.3): 记忆侧省token/提质量——沉淀预筛+召回相关性minScore+片段截断 |
+| `ee11948` | fix(v0.4.2): 压缩产品演示GIF至README 10MB阈值下（12MB→8MB） |
+| `29d5c85` | feat(v0.4.1): Marketplace收录标准（dsh.marketplace元数据+自动扫描规则说明） |
+
+> 完整历史：`git log --oneline` 或访问 [GitHub Commits](https://github.com/EternalNight996/dsh-memory-eternal/commits/main)
+
+---
+
 ## 📄 License
 
 MIT

package/bin/dsh-memory.mjs

@@ -0,0 +1,148 @@
+#!/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 valuesTaken = new Set(['--limit', '--vault', '--source', '--port'])
+  const out = []
+  for (let i = 1; i < argv.length; i++) {
+    const a = argv[i]
+    if (valuesTaken.has(a)) { i++; continue }
+    if (a.startsWith('--')) continue
+    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)) {
+        text = await new Promise((resolve) => {
+          let buf = ''
+          process.stdin.setEncoding('utf8')
+          process.stdin.on('data', (c) => { buf += c })
+          process.stdin.on('end', () => resolve(buf))
+        })
+      }
+      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 '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 '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 sweep <dir>                     挖掘会话 JSONL
+
+环境变量：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/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 静默失败 */ })