memory-eternal 0.16.0 → 0.17.0

package/README.zh-CN.md

@@ -0,0 +1,138 @@
+# 🧠 memory-eternal —— 给 AI 装一个可信的第二大脑
+
+[![GitHub stars](https://img.shields.io/github/stars/EternalNight996/memory-eternal?style=flat)](https://github.com/EternalNight996/memory-eternal/stargazers)
+[![npm](https://img.shields.io/npm/v/memory-eternal)](https://www.npmjs.com/package/memory-eternal)
+[![release](https://img.shields.io/badge/release-v0.17.0-FF7A45)](https://github.com/EternalNight996/memory-eternal/releases)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+[English (default)](README.md) · **简体中文（镜像）**
+
+<p align="center">
+  <a href="https://eternalnight996.github.io/memory-eternal/demo/"><img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/demo.gif" width="900" alt="memory-eternal 20 秒演示：审核队列、记忆账本、知识星图" /></a>
+</p>
+<p align="center"><sub>▲ 20 秒演示 —— 审核队列 · 记忆账本 · 知识星图 · <a href="https://eternalnight996.github.io/memory-eternal/demo/">在线 Demo</a></sub></p>
+
+> **你的 AI 每次会话都失忆。给它一个可信的记忆库。**
+>
+> 本地优先、先审后入、可度量 —— 一个 SQLite 库，DSH / Claude Code / Codex / Cursor 与任意 MCP 客户端共享。
+
+- 🔍 **先审核，再入库** —— 新卡先进待审队列，Web 或终端里批准/驳回；每次状态变更写入不可篡改的审计日志。
+- 🧾 **记忆账本** —— 召回注入了多少、蒸馏调了几次、召回到底有没有用，全部可查。
+- 🏠 **本地优先，零云端** —— SQLite + Markdown 存在你自己的磁盘上。没有第三方记忆框架、不需要账号、不外发请求。
+
+<p align="center"><strong>⭐ 如果它帮你少解释了一遍上下文，点个 Star 就是最大的支持</strong><br/><sub>DSH 一条命令：<code>dsh plugin --profile desktop add memory-eternal</code></sub></p>
+
+## ⚡ 快速开始
+
+**DeepSeek Harness（桌面版 / Web）**
+
+```bash
+dsh plugin --profile desktop add memory-eternal
+# 重开 DSH → 左栏「记忆」
+```
+
+**Claude Code、Codex 或 Cursor —— 通过 MCP 共享同一个库**
+
+```bash
+npm i -g memory-eternal
+dsh-memory connect claude    # 或：codex / cursor
+```
+
+**任意 MCP 客户端**
+
+```bash
+npx -y -p memory-eternal dsh-memory mcp
+```
+
+**浏览器或终端**
+
+```bash
+dsh-memory open              # http://127.0.0.1:7999
+npx -y -p memory-eternal dsh-memory tui   # 终端里的实时待审队列
+```
+
+## 🧾 真的省 token 吗？
+
+大多数记忆产品都说自己省 token。我们认为你应该自己验证。插件内置**记忆账本**（运行状态 → 记忆账本），记录：
+
+| 记录项 | 含义 |
+|---|---|
+| 召回：命中数 + 注入字符 | 到底有多少记忆进入了上下文 |
+| 沉淀：LLM 调用次数 + 输入/输出字符 | 蒸馏花了你多少成本 |
+| 有用率：有用 / 没用 反馈 | 召回的记忆是否真的帮上了忙 |
+
+诚实的算式：
+
+```text
+净收益 ≈ 被避免的上下文开销 −（注入字符 + 蒸馏调用 × 单价）
+```
+
+| 场景 | 你要付 | 你能省 |
+|---|---|---|
+| 有决策与踩坑记录的多会话项目 | 每次召回约 0.6–0.9k token | 重新解释上下文（约 1.5–3k）或重读文件（3–6k） |
+| 一次性问题、低命中率 | 召回注入 | 通常什么也省不到 |
+
+> 以上是示意数字，不是 benchmark —— 用账本测你自己的。如果召回有用率长期低于约 60%，就调小（更少条数、更短摘要）或直接关掉记忆。
+
+## 🛡️ 先审核，再入库
+
+一个「什么都自动吞进去」的记忆系统，迟早会把错误事实当成真相召回。memory-eternal 默认**先审后入**：
+
+- 新卡先进入**待审队列**，人工批准后才进主库；
+- 在 Web、终端 TUI 或 CLI 里批准 / 驳回 / 批量处理；
+- 每次状态变更追加到**不可篡改的审计日志**（谁 / 什么 / 何时 / 为什么）—— 由 SQLite 层强制，而不是靠约定；
+- Agent 可以读取和提议，但**不能批准自己写的卡**；
+- 删除的卡进回收站（默认保留 30 天）。
+
+## 🧩 一个库，所有 Agent
+
+| 入口 | 你能得到什么 |
+|---|---|
+| **DSH 桌面版 / Web** | 内嵌记忆界面：审核、图谱、配置、账本 |
+| **Claude Code / Codex / Cursor** | MCP server，同一个本地库，<code>dsh-memory connect</code> |
+| **任意 MCP 客户端** | <code>npx -y -p memory-eternal dsh-memory mcp</code> |
+| **终端** | <code>dsh-memory tui</code> —— 实时队列、全选、批量批/驳、长文读卡 |
+| **浏览器** | <code>dsh-memory open</code> → http://127.0.0.1:7999 |
+
+## 📸 截图
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/graph.png" width="32%" alt="知识星图：按类型分簇、标签连边" />
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/audit.png" width="32%" alt="审核中心：类型条、队列与判词栏" />
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/status.png" width="32%" alt="运行状态：库、备份、自动沉淀与版本" />
+</p>
+<p align="center"><sub>▲ 知识星图 · 审核中心 · 运行状态</sub></p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/tui-audit.png" width="49%" alt="终端原生审核：全选、批量批准/驳回" />
+  <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/screen/tui-reader.png" width="49%" alt="终端原生长文读卡器" />
+</p>
+<p align="center"><sub>▲ 终端原生审核与长文读卡 —— <code>dsh-memory tui</code></sub></p>
+
+## 📚 文档与链接
+
+- [英文完整手册](docs/GUIDE.md) · [完整手册（中文）](docs/GUIDE.zh-CN.md)
+- [私有化部署（Docker / systemd）](docs/DEPLOY.md)
+- [更新日志](docs/CHANGELOG.md) · [架构](docs/ARCHITECTURE.md)
+- [终端插件（dsh-tui）](dsh-tui-plugin/README.md) · [Orca 启动器](orca-plugin/README.md) · [Cursor / VS Code 扩展](cursor-extension/README.md)
+- [反馈问题](https://github.com/EternalNight996/memory-eternal/issues)
+
+## 💬 交流群
+
+**遇到问题、想提需求、或者想聊聊 DSH 插件开发 —— 欢迎进群：**
+
+| QQ 交流群 | 微信交流群 |
+|:---:|:---:|
+| <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/support/group-qr.jpg" width="240" alt="QQ 群二维码" /> | <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/support/group-wechat.png" width="240" alt="微信群二维码" /> |
+
+**如果这个插件帮你省了时间，可以请作者喝杯咖啡（两个码任选其一）：**
+
+| 微信收款码 | 微信赞赏码 |
+|:---:|:---:|
+| <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/support/wechat-pay.jpg" width="200" alt="微信收款码" /> | <img src="https://raw.githubusercontent.com/EternalNight996/memory-eternal/main/assets/support/wechat-reward.jpg" width="200" alt="微信赞赏码" /> |
+
+> 打赏完全自愿，不影响任何功能；插件本体始终开源免费（MIT）。详见 [SPONSOR.md](SPONSOR.md)。
+
+## 📄 License
+
+MIT —— 随便用、随便自托管、随便二次开发。

package/bin/dsh-memory.mjs

@@ -4,7 +4,7 @@
 // 用法：
 //   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 serve [--port N] [--host H] [--vault DIR]  启动 Web UI（前台常驻；--host 0.0.0.0 用于容器/内网，需自行加认证）
 //   dsh-memory open [--port N]                            确保 Web 存活并用浏览器打开
 //   dsh-memory tui [--live] [--write]                     打开完整终端客户端（无需绝对路径）
 //   dsh-memory mcp                                        MCP stdio server（各 agent 挂载）
@@ -18,6 +18,7 @@
 //   dsh-memory refine [--vault DIR] [--json]              矛盾扫描候选（不调模型）；--apply --a A --b B --action keepA|keepB|merge|keepBoth 落裁决
 //   dsh-memory refine --junk [--purge --path P] [--json]   注入垃圾卡（技能目录等注入文本沉淀成的卡）：列清单 / 送回收站
 //   dsh-memory refine --goals [--keep --path A --path B]   同目标不同做法：聚类需模型（面板里跑）；--keep 落"都保留"
+//   dsh-memory ledger [--days N] [--json]                 记忆账本：召回注入 / 蒸馏调用 / 召回有用率
 //
 // 环境变量：
 //   MEMORY_VAULT_DIR       vault 目录（默认 ~/.dsh/memory-vault）
@@ -105,8 +106,10 @@ async function main() {
       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
+      // 默认只监听本机：私有化/容器部署时显式 --host 0.0.0.0，并在前面加 TLS + 认证的反向代理
+      const host = argOf('--host') || process.env.MEMORY_WEB_HOST || '127.0.0.1'
       const vault = path.resolve(argOf('--vault') || defaultVaultDir())
-      await startWebServer({ port, vaultRoot: vault })
+      await startWebServer({ port, vaultRoot: vault, host })
       process.on('SIGINT', () => process.exit(0))
       process.on('SIGTERM', () => process.exit(0))
       return
@@ -148,6 +151,32 @@ async function main() {
       startMcpServer()
       return
     }
+    case 'ledger': {
+      const { ledgerSummary } = await import('../lib/ledger.js')
+      const { defaultVaultDir } = await import('../lib/capture-run.js')
+      const root = path.resolve(argOf('--vault') || defaultVaultDir())
+      const days = Math.min(Math.max(Math.floor(Number(argOf('--days')) || 7), 1), 90)
+      let s
+      try { s = ledgerSummary(root, { days }) } catch (e) {
+        console.error('读取记忆账本失败：' + (e?.message || e))
+        process.exitCode = 1
+        return
+      }
+      if (has('--json')) { console.log(JSON.stringify(s, null, 2)); return }
+      const fmt = (n) => Number(n || 0).toLocaleString('en-US')
+      console.log('记忆账本（最近 ' + s.days + ' 天）\n')
+      console.log('召回   ' + fmt(s.totals.recalls) + ' 次 · 注入 ' + fmt(s.totals.injectedChars) + ' 字符')
+      console.log('沉淀   ' + fmt(s.totals.captures) + ' 次 · LLM ' + fmt(s.totals.llmCalls) + ' 次 · 输入 ' + fmt(s.totals.captureInChars) + ' / 输出 ' + fmt(s.totals.captureOutChars) + ' 字符')
+      console.log('估算   ≈ ' + fmt(s.totals.estTokens) + ' tokens（中英混排按 2 字符 ≈ 1 token，仅看量级）')
+      console.log('')
+      console.log(s.feedback.rate === null
+        ? '召回有用率  暂无反馈（Agent 回传 useful 后才有数据）'
+        : '召回有用率  ' + Math.round(s.feedback.rate * 100) + '%（有用 ' + fmt(s.feedback.useful) + ' / 无用 ' + fmt(s.feedback.useless) + '）')
+      console.log('\n最近 ' + s.days + ' 天：')
+      for (const d of s.byDay) console.log('  ' + d.date + '  召回 ' + fmt(d.recalls) + ' · 注入 ' + fmt(d.injectedChars) + ' 字符 · 沉淀 ' + fmt(d.captures))
+      console.log('\n提示：--json 输出原始数据；Web 面板「运行状态 → 记忆账本」可看趋势。')
+      return
+    }
     case 'status': {
       const { watchdogStatus, probeServedVersion, findPortListener, looksLikeOurWeb } = await import('../lib/watchdog.js')
       const port = argOf('--port')
@@ -590,7 +619,7 @@ MCP 侧只提供只读的 memory_audit_list —— 批准/驳回必须由人显
 用法：
   dsh-memory recall <query> [--limit N]       检索知识卡
   dsh-memory capture <text | -> [--source T]  手动沉淀（- 读 stdin）
-  dsh-memory serve [--port N]                 Web UI（前台）
+  dsh-memory serve [--port N] [--host H]      Web UI（前台；私有化部署见 docs/DEPLOY.md）
   dsh-memory open                             确保 Web 存活并打开浏览器
   dsh-memory mcp                              MCP stdio server
   dsh-memory setup [--dry-run] ...            自动挂载 MCP 到已装 agent
@@ -601,6 +630,7 @@ MCP 侧只提供只读的 memory_audit_list —— 批准/驳回必须由人显
   dsh-memory status [--port N] [--json]      查看常驻看门狗（pid/端口/版本/存活）
   dsh-memory stop [--port N] [--json]        停止常驻看门狗（显式命令，配置变更不会自动停）
   dsh-memory restart [--port N] [--vault DIR] 停止并重新拉起看门狗（应用新版本）
+  dsh-memory ledger [--days N] [--json]      记忆账本：召回注入 / 蒸馏调用 / 有用率
   dsh-memory audit list [--status pending] [--kind K] [--json]  列出待审/驳回卡片
   dsh-memory audit approve <path...> | reject <path...> [--reason "原因"]  人工批量审批
 

package/cursor-extension/package.json

@@ -2,7 +2,7 @@
   "name": "memory-eternal",
   "displayName": "Memory Atlas",
   "description": "Memory-eternal: open the local Memory Atlas library, review queue and knowledge graph in a Cursor/VS Code webview.",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "publisher": "EternalNight996",
   "license": "MIT",
   "repository": {

package/dsh-tui-plugin/dsh-plugin.json

@@ -2,7 +2,7 @@
   "$schema": "urn:dsh-std:community-draft:dsh-plugin:0.15",
   "id": "memory-eternal-tui",
   "name": "memory-eternal-tui",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "manifestVersion": "0.15",
   "description": "Open Memory Atlas from dsh-TUI: native /audit scene plus browser launcher.",
   "facets": {

package/dsh-tui-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal-tui",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Memory Atlas for dsh-TUI: /audit scene with reason/severity, batch confirmation and reject reasons.",
   "type": "module",
   "main": "main.js",

package/index.js

@@ -34,6 +34,7 @@ import { createHub } from './lib/sse.js'
 import { summarizeTurn, summarizeTurnDetailed, routeCandidates, sessionRouteFrom, extractLastTurn, sliceNewEvents, sessionEvents, sessionEventApi, createCaptureHealth, resolveRoute, captureCard, captureUpdate, pickNeighbors, hasUsableContent, deriveTitle, looksTruncated, maxTokenLadder, DEFAULT_CAPTURE_MAX_TOKENS, MAX_CAPTURE_MAX_TOKENS } from './lib/capture.js'
 import { createApi, json, encodeBody, crossOriginError, emptyNumericFields } from './lib/api.js'
 import { appendCaptureLog, readCaptureLog, rotateCaptureLog } from './lib/capture-log.js'
+import { recordLedger } from './lib/ledger.js'
 import { missingWebAssets, missingAssetsReason } from './lib/web-assets.js'
 import { writeHostMarker, clearHostMarker } from './lib/host-heartbeat.js'
 import { nodeBinary, childEnv } from './lib/node-bin.js'
@@ -737,6 +738,8 @@ export function apply(ctx, config) {
       let failure = null          // 主失败 = **第一个**候选的失败（通常是显式配置的那个，信息量最大）
       const failures = []         // 全部候选的失败，用于汇总上报（#18 根因 2）
       const maxTokens = Number(cfg.captureMaxTokens) || DEFAULT_CAPTURE_MAX_TOKENS
+      const captureT0 = Date.now()
+      let llmCalls = 0
       for (let i = 0; i < routes.length; i++) {
         route = routes[i]
         // issue #48：超时不再硬编码 45s（本地 30B 冷启动 40–60s 必超时），且超时后**同候选**用更长超时重试一次。
@@ -744,7 +747,7 @@ export function apply(ctx, config) {
         const isTimeoutFailure = (x) => /ABORTED|TIMEOUT|ETIMEDOUT|aborted/i.test(String((x && (x.code + ' ' + x.message)) || ''))
         // issue #51：把真实会话 id 透传给 LLM（opencode-go 网关靠它注入 x-opencode-session，
         // 缺了首跳固定 400 MissingSessionID）。同一会话的蒸馏请求也因此能被网关按会话归并。
-        const attempt = (budget, ms) => summarizeTurnDetailed(llm, route, text, { signal: AbortSignal.timeout(ms), existing: neighbors, maxTokens: budget, sessionId })
+        const attempt = (budget, ms) => { llmCalls++; return summarizeTurnDetailed(llm, route, text, { signal: AbortSignal.timeout(ms), existing: neighbors, maxTokens: budget, sessionId }) }
         let detailed = await attempt(maxTokens, baseTimeout)
         if (detailed.failure && isTimeoutFailure(detailed.failure)) {
           const longer = Math.min(Math.max(Math.round(baseTimeout * 2.5), baseTimeout + 30000), 180000)
@@ -781,6 +784,21 @@ export function apply(ctx, config) {
         }
         break // skip（太短 / 不值得保存）或没有更多候选
       }
+      // 账本：记下这次沉淀的真实开销（输入字符 / LLM 调用次数 / 输出字符），失败也记（便于看失败率与白烧次数）
+      try {
+        recordLedger(root, {
+          kind: 'capture',
+          session: sessionId,
+          charsIn: String(text || '').length,
+          chars: result ? JSON.stringify(result).length : 0,
+          llmCalls,
+          provider: route.provider,
+          model: route.model,
+          ms: Date.now() - captureT0,
+          ok: !!result,
+          note: failure ? failure.code : '',
+        })
+      } catch { /* 账本失败不影响沉淀主流程 */ }
       // 真失败要亮红并进提示段：此前只有笼统的「蒸馏无输出」，真实原因（如缺凭证）完全不可见。
       if (failure) { health.fail(`蒸馏失败（${failure.provider}）：${failure.code} ${failure.message}`); touchPrompt() }
       // 主因 + 兜底候选失败汇总：卡片 reason 与 created 日志都用这个，避免把排查者引向错误方向。
@@ -1010,7 +1028,10 @@ export function apply(ctx, config) {
           } catch { /* 单个库失败不影响其它库 */ }
         }
         if (multi) hits = hits.slice(0, limit)
-        if (hits.length === 0) return `记忆库中没有与「${query}」相关的内容。`
+        if (hits.length === 0) {
+          recordLedger((targets[0] && targets[0].root) || vaultDir(workspace), { kind: 'recall', results: 0, chars: 0, note: query.slice(0, 120) })
+          return `记忆库中没有与「${query}」相关的内容。`
+        }
         const lines = hits.map((h, i) => {
           const tags = h.tags.length ? ` [${h.tags.join(', ')}]` : ''
           const snippet = String(h.summary || '').replace(/\s+/g, ' ').trim().slice(0, defLen)
@@ -1019,7 +1040,9 @@ export function apply(ctx, config) {
           return `### ${i + 1}. ${h.title}${tags}${from}\n路径：${h.path}\n${snippet}${body}`
         })
         const where = multi ? `（作用域 ${scope || 'all'}，共 ${targets.length} 个库）` : ''
-        return `从记忆核心检索到 ${hits.length} 条相关卡片${where}：\n\n${lines.join('\n\n')}`
+        const out = `从记忆核心检索到 ${hits.length} 条相关卡片${where}：\n\n${lines.join('\n\n')}`
+        recordLedger((targets[0] && targets[0].root) || vaultDir(workspace), { kind: 'recall', results: hits.length, chars: out.length, note: query.slice(0, 120) })
+        return out
       },
     }))
   }

package/lib/api.js

@@ -20,6 +20,7 @@ import { listCards, countCards, readCard, search, searchAll, graph, graphAll, ov
 import { compressExcerpt, DEFAULT_CAPTURE_MAX_TOKENS } from './capture.js'
 import { buildDiagnostics } from './feedback.js'
 import { getSetupStatus, runSetup, mcpAgentAction } from './setup.js'
+import { ledgerSummary } from './ledger.js'
 import { backupDb, dbStatus, rebuildGuidance, withDbRetry } from './db.js'
 import { createHub } from './sse.js'
 import { probeServedVersion, restartResident, currentPkgVersion, readWatchdogLock, isPidAlive, probeLockWritable } from './watchdog.js'
@@ -952,6 +953,14 @@ export function createApi(deps = {}) {
         json(res, 200, { ok: true })
         return
       }
+      case '/ledger': {
+        // 记忆账本：近 N 天召回注入 / 蒸馏调用开销 + 召回有用率
+        try {
+          const days = Number(query.get('days')) || 7
+          json(res, 200, { ok: true, ...ledgerSummary(vaultRoot, { days }) })
+        } catch (e) { json(res, 200, { ok: false, error: String(e?.message || e) }) }
+        return
+      }
       case '/budget': {
         try {
           const cfg = getSettings() ?? {}

package/lib/capture-run.js

@@ -11,6 +11,7 @@ import fs from 'node:fs'
 import { captureCard, captureUpdate, pickNeighbors, summarizeTurnDetailed, routeCandidates, stripRuntimeNoise, hasUsableContent, deriveTitle, isUsableTitle } from './capture.js'
 import { resolveVaultDir, defaultVaultRoot } from './vault-resolve.js'
 import { createLlmFromEnv } from './llm-openai.js'
+import { recordLedger } from './ledger.js'
 
 /**
  * 解析当前 vault 目录。
@@ -63,6 +64,28 @@ export async function runStandaloneCapture(vaultRoot, text, { source = '', llm,
   const title = deriveTitle(clean)
   if (!isUsableTitle(title)) return { ok: false, action: 'skipped', reason: 'cannot derive a usable title' }
 
+  // 记忆账本：独立进程（MCP / CLI / hooks）的沉淀也要记账 —— 否则「哪个入口花了 token」永远说不清。
+  const t0 = Date.now()
+  let llmCalls = 0
+  let routeUsed = null
+  let outChars = 0
+  const finish = (res) => {
+    try {
+      recordLedger(vaultRoot, {
+        kind: 'capture',
+        charsIn: clean.length,
+        chars: outChars,
+        llmCalls,
+        provider: routeUsed ? routeUsed.provider : '',
+        model: routeUsed ? routeUsed.model : '',
+        ms: Date.now() - t0,
+        ok: !!(res && res.ok === true),
+        note: res && res.action ? res.action : '',
+      })
+    } catch { /* 账本失败不影响沉淀 */ }
+    return res
+  }
+
   // 自动审核：共享配置文件(DSH)优先，其次 env，默认 all（独立进程无 DSH settings）
   // 注：`shared` 原先在回调里局部读取，第 80 行的路由兜底却引用了外层同名变量 → ReferenceError
   // 被下面的 try/catch 静默吞掉，导致 captureProvider/captureModel 在本进程从不生效。这里提到函数级。
@@ -85,9 +108,12 @@ export async function runStandaloneCapture(vaultRoot, text, { source = '', llm,
   // 有 LLM：蒸馏判定链（与 DSH 侧一致）
   if (llmClient && route) {
     try {
+      routeUsed = route
       const neighbors = await pickNeighbors(vaultRoot, { title: '', body: clean.slice(0, 400) }, 8)
+      llmCalls++
       const detailed = await summarizeTurnDetailed(llmClient, route, clean, { existing: neighbors, signal: AbortSignal.timeout(45000) })
       const result = detailed.card
+      if (result) outChars = JSON.stringify(result).length
       // 独立进程也必须把真实失败暴露出来（走 stderr），别再静默降级成「无输出」
       if (detailed.failure) {
         process.stderr.write(`[memory-eternal] 蒸馏失败（${route.provider}/${route.model}）：${detailed.failure.code} ${detailed.failure.message}\n`)
@@ -95,18 +121,18 @@ export async function runStandaloneCapture(vaultRoot, text, { source = '', llm,
       if (result && result.save === true) {
         if (result.append_to) {
           await captureUpdate(vaultRoot, result.append_to, result.update, { threshold: 0.62 })
-          return { ok: true, action: 'appended', path: result.append_to }
+          return finish({ ok: true, action: 'appended', path: result.append_to })
         }
         const card = { kind: result.kind, title: result.title, tags: result.tags, body: result.body, source, status: resolveAuditStatus(result.kind, source || 'agent'), submittedBy: source || 'agent', severity: 'info', reason: 'AI 自动沉淀（蒸馏卡）' }
         const out = await captureCard(vaultRoot, card, { threshold: 0.62 })
-        if (out.ok) return { ok: true, action: 'created', path: out.path ?? out.rel }
+        if (out.ok) return finish({ ok: true, action: 'created', path: out.path ?? out.rel })
         if (out.duplicate) {
           await captureUpdate(vaultRoot, out.duplicate.path, `${result.title}：${result.body.slice(0, 400)}`, { threshold: 0.62 })
-          return { ok: true, action: 'appended', path: out.duplicate.path }
+          return finish({ ok: true, action: 'appended', path: out.duplicate.path })
         }
-        return { ok: false, action: 'failed', reason: String(out.reason || 'write failed') }
+        return finish({ ok: false, action: 'failed', reason: String(out.reason || 'write failed') })
       }
-      if (result && result.save === false) return { ok: true, action: 'skipped', reason: 'model judged not durable' }
+      if (result && result.save === false) return finish({ ok: true, action: 'skipped', reason: 'model judged not durable' })
     } catch (error) {
       // LLM 失败 → 落入降级路径，不能让一次网络抖动丢掉沉淀
     }
@@ -114,6 +140,7 @@ export async function runStandaloneCapture(vaultRoot, text, { source = '', llm,
 
   // 降级：无 LLM（或 LLM 调用失败）→ 原文卡（kind 默认 content，dedup 开）
   // 标题用 deriveTitle 派生（不再 slice 硬切）；正文用剥离噪声后的 clean。
+  outChars = clean.length
   const out = await captureCard(vaultRoot, {
     kind: 'content',
     title,
@@ -125,10 +152,10 @@ export async function runStandaloneCapture(vaultRoot, text, { source = '', llm,
     severity: 'info',
     reason: 'AI 自动沉淀（原文卡）',
   }, { threshold: 0.62 })
-  if (out.ok) return { ok: true, action: 'created', path: out.path ?? out.rel, degraded: true }
+  if (out.ok) return finish({ ok: true, action: 'created', path: out.path ?? out.rel, degraded: true })
   if (out.duplicate) {
     await captureUpdate(vaultRoot, out.duplicate.path, clean.slice(0, 400), { threshold: 0.62 })
-    return { ok: true, action: 'appended', path: out.duplicate.path, degraded: true }
+    return finish({ ok: true, action: 'appended', path: out.duplicate.path, degraded: true })
   }
-  return { ok: false, action: 'failed', reason: String(out.reason || 'write failed') }
+  return finish({ ok: false, action: 'failed', reason: String(out.reason || 'write failed') })
 }