memory-eternal 0.15.0 → 0.17.0

package/lib/db.js

@@ -221,6 +221,25 @@ function initTables(db) {
       created_at TEXT DEFAULT (datetime('now'))
     );
 
+    -- 记忆账本：召回注入 / 蒸馏调用的开销流水（回答「到底省不省 token」）
+    CREATE TABLE IF NOT EXISTS ledger (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      ts INTEGER NOT NULL,
+      kind TEXT NOT NULL,
+      session TEXT DEFAULT '',
+      results INTEGER DEFAULT 0,
+      chars INTEGER DEFAULT 0,
+      chars_in INTEGER DEFAULT 0,
+      llm_calls INTEGER DEFAULT 0,
+      provider TEXT DEFAULT '',
+      model TEXT DEFAULT '',
+      ms INTEGER DEFAULT 0,
+      ok INTEGER DEFAULT 1,
+      note TEXT DEFAULT ''
+    );
+    CREATE INDEX IF NOT EXISTS idx_ledger_ts ON ledger(ts);
+    CREATE INDEX IF NOT EXISTS idx_ledger_kind ON ledger(kind);
+
     -- 审核日志：记录所有 status 变更，不可篡改
     CREATE TABLE IF NOT EXISTS audit_log (
       id INTEGER PRIMARY KEY AUTOINCREMENT,

package/lib/ledger.js

@@ -0,0 +1,107 @@
+// 记忆账本：记录「记忆本身的开销」——召回注入了多少字符、蒸馏调了多少次 LLM。
+//
+// 为什么要有它：README 一直说「省 token」，但省不省取决于「被避免的上下文开销」是否大于
+// 「注入 + 蒸馏调用」的成本。没有账本，所有调参都是猜；有账本后至少能回答「我们花了多少」，
+// 再结合召回有用率（feedback 表）判断净收益方向。
+//
+// 只记账，不参与主流程：任何异常都吞掉，绝不能让统计把沉淀/召回弄失败。
+
+import { getDb } from './db.js'
+
+const DAY_MS = 86400000
+
+/** 记一条流水。失败静默返回 false。 */
+export function recordLedger(root, entry = {}) {
+  try {
+    const db = getDb(root)
+    db.prepare(`
+      INSERT INTO ledger (ts, kind, session, results, chars, chars_in, llm_calls, provider, model, ms, ok, note)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(
+      Number(entry.ts) || Date.now(),
+      String(entry.kind || 'other').slice(0, 20),
+      String(entry.session || '').slice(0, 80),
+      Math.max(0, Number(entry.results) || 0),
+      Math.max(0, Number(entry.chars) || 0),
+      Math.max(0, Number(entry.charsIn) || 0),
+      Math.max(0, Number(entry.llmCalls) || 0),
+      String(entry.provider || '').slice(0, 60),
+      String(entry.model || '').slice(0, 80),
+      Math.max(0, Number(entry.ms) || 0),
+      entry.ok === false ? 0 : 1,
+      String(entry.note || '').slice(0, 200),
+    )
+    return true
+  } catch { return false }
+}
+
+const localDay = (ts) => {
+  const d = new Date(Number(ts) || 0)
+  const p = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`
+}
+
+/**
+ * 近 N 天汇总（默认 7 天，最多 90 天）。
+ * - totals：召回次数/注入字符、沉淀次数/LLM 调用/输入输出字符、粗估 token
+ * - byDay：逐日明细（used by 面板画趋势）
+ * - feedback：召回有用率（feedback 表，只有 agent 显式标记才有数据）
+ */
+export function ledgerSummary(root, { days = 7, now = Date.now() } = {}) {
+  const db = getDb(root)
+  const n = Math.min(Math.max(Math.floor(Number(days) || 7), 1), 90)
+  const cutoff = Number(now) - n * DAY_MS
+  const rows = db.prepare('SELECT * FROM ledger WHERE ts >= ? ORDER BY ts').all(cutoff)
+  const recalls = rows.filter((r) => r.kind === 'recall')
+  const captures = rows.filter((r) => r.kind === 'capture')
+  const sum = (arr, k) => arr.reduce((s, r) => s + (Number(r[k]) || 0), 0)
+
+  const byDay = []
+  const index = new Map()
+  for (let i = n - 1; i >= 0; i--) {
+    const key = localDay(Number(now) - i * DAY_MS)
+    const row = { date: key, recalls: 0, injectedChars: 0, captures: 0, llmCalls: 0, captureInChars: 0, captureOutChars: 0 }
+    index.set(key, row)
+    byDay.push(row)
+  }
+  for (const r of rows) {
+    const row = index.get(localDay(r.ts))
+    if (!row) continue
+    if (r.kind === 'recall') { row.recalls += 1; row.injectedChars += Number(r.chars) || 0 }
+    if (r.kind === 'capture') { row.captures += 1; row.llmCalls += Number(r.llm_calls) || 0; row.captureInChars += Number(r.chars_in) || 0; row.captureOutChars += Number(r.chars) || 0 }
+  }
+
+  // 召回有用率：只有调用方显式回传 useful 时才有数据；没有数据时 rate = null（不要假装 0%）
+  let useful = 0
+  let useless = 0
+  try {
+    const fb = db.prepare("SELECT useful, COUNT(*) AS n FROM feedback WHERE created_at >= datetime('now', ?) GROUP BY useful").all(`-${n} days`)
+    for (const r of fb) { if (Number(r.useful) === 1) useful = Number(r.n) || 0; else useless = Number(r.n) || 0 }
+  } catch { /* feedback 表缺失也不影响账本 */ }
+
+  const injectedChars = sum(recalls, 'chars')
+  const captureInChars = sum(captures, 'chars_in')
+  const captureOutChars = sum(captures, 'chars')
+  // 粗估 token：中英混排约 2 字符 ≈ 1 token（保守口径，只用于看量级，不做计费）
+  const estTokens = Math.round((injectedChars + captureInChars + captureOutChars) / 2)
+
+  return {
+    ok: true,
+    days: n,
+    since: cutoff,
+    totals: {
+      recalls: recalls.length,
+      recallResults: sum(recalls, 'results'),
+      injectedChars,
+      captures: captures.length,
+      captureOk: captures.filter((r) => Number(r.ok) === 1).length,
+      captureFail: captures.filter((r) => Number(r.ok) !== 1).length,
+      llmCalls: sum(captures, 'llm_calls'),
+      captureInChars,
+      captureOutChars,
+      estTokens,
+    },
+    byDay,
+    feedback: { useful, useless, total: useful + useless, rate: useful + useless ? useful / (useful + useless) : null },
+  }
+}

package/lib/mcp.js

@@ -16,6 +16,7 @@
 import readline from 'node:readline'
 import { search, overview, stats, ensureVault, listCards, countCards } from './vault.js'
 import { runStandaloneCapture, defaultVaultDir } from './capture-run.js'
+import { recordLedger } from './ledger.js'
 
 const SUPPORTED_PROTOCOL_VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05']
 const DEFAULT_PROTOCOL_VERSION = '2024-11-05'
@@ -83,13 +84,18 @@ export async function callTool(name, args, vaultRoot, meta = {}) {
       if (!query) return toolResult('（未提供检索词）')
       const limit = Math.min(Math.max(Number(args?.limit) || 5, 1), 20)
       const hits = await search(vaultRoot, query, { limit, minScore: 2 })
-      if (hits.length === 0) return toolResult(`记忆库中没有与「${query}」相关的内容。`)
+      if (hits.length === 0) {
+        recordLedger(vaultRoot, { kind: 'recall', results: 0, chars: 0, note: query.slice(0, 120) })
+        return toolResult(`记忆库中没有与「${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, 130)
         return `### ${i + 1}. ${h.title}${tags}\n路径：${h.path}\n${snippet}`
       })
-      return toolResult(`从记忆核心检索到 ${hits.length} 条相关卡片：\n\n${lines.join('\n\n')}`)
+      const out = `从记忆核心检索到 ${hits.length} 条相关卡片：\n\n${lines.join('\n\n')}`
+      recordLedger(vaultRoot, { kind: 'recall', results: hits.length, chars: out.length, note: query.slice(0, 120) })
+      return toolResult(out)
     }
     case 'memory_capture': {
       const text = String(args?.text || '')

package/lib/setup.js

@@ -19,6 +19,39 @@ export const PACKAGE_ROOT = path.join(__dirname, '..')
 export const BIN_PATH = path.join(PACKAGE_ROOT, 'bin', 'dsh-memory.mjs')
 
 const home = os.homedir()
+const appdataDir = process.env.APPDATA || path.join(home, 'AppData', 'Roaming')
+
+/** 从 MCP 客户端 JSON 配置里列出 server 名（兼容 mcpServers 与 VS Code 的 servers 两种键名）。 */
+function listMcpServers(cfg, keys = ['mcpServers', 'servers']) {
+  if (!cfg || typeof cfg !== 'object') return []
+  for (const k of keys) {
+    const v = cfg[k]
+    if (v && typeof v === 'object' && !Array.isArray(v)) return Object.keys(v)
+  }
+  return []
+}
+
+/** 从 codex config.toml 里列出所有 [mcp_servers.<name>] 的 name（跳过 .env 这类二级段）。 */
+function listCodexMcpServers(text) {
+  const names = []
+  for (const m of String(text || '').matchAll(/^\s*\[mcp_servers\.([A-Za-z0-9_-]+)\]\s*$/gm)) names.push(m[1])
+  return [...new Set(names)]
+}
+
+/**
+ * 只读兼容性探测清单：除可一键挂载的 claude-code / codex / cursor 之外，
+ * 自动识别本机常见的 MCP 客户端（存在配置文件才列出），并列出它们已配置的 MCP server。
+ * detectedOnly = 只展示，不提供安装/卸载按钮（不改不认识的配置格式）。
+ */
+const DETECT_ONLY_CLIENTS = [
+  { name: 'gemini-cli', label: 'Gemini CLI', paths: () => [path.join(home, '.gemini', 'settings.json')] },
+  { name: 'windsurf', label: 'Windsurf', paths: () => [path.join(home, '.codeium', 'windsurf', 'mcp_config.json')] },
+  { name: 'cline', label: 'Cline', paths: () => [
+    path.join(appdataDir, 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+    path.join(appdataDir, 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+  ] },
+  { name: 'vscode', label: 'VS Code', paths: () => [path.join(appdataDir, 'Code', 'User', 'mcp.json')], keys: ['servers'] },
+]
 
 async function exists(p) {
   try { await fs.access(p); return true } catch { return false }
@@ -350,7 +383,7 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
   // claude-code
   const claudeJson = path.join(home, '.claude.json')
   if (!(await exists(claudeJson))) {
-    agents.push({ name: 'claude-code', installed: false, mcpConfigured: false, hook: 'unknown' })
+    agents.push({ name: 'claude-code', label: 'Claude Code', compat: 'managed', installed: false, mcpConfigured: false, hook: 'unknown', servers: [] })
   } else {
     let cfg = null
     try { cfg = JSON.parse(await fs.readFile(claudeJson, 'utf8')) } catch {}
@@ -358,6 +391,9 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
     const mcpExists = !!entry
     agents.push({
       name: 'claude-code',
+      label: 'Claude Code',
+      compat: 'managed',
+      servers: listMcpServers(cfg),
       installed: true,
       mcpConfigured: mcpExists,
       mcpMatchesCurrentNode: mcpExists && sameMcpEntry(entry, want),
@@ -381,7 +417,7 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
   // codex
   const codexToml = path.join(home, '.codex', 'config.toml')
   if (!(await exists(codexToml))) {
-    agents.push({ name: 'codex', installed: false, mcpConfigured: false })
+    agents.push({ name: 'codex', label: 'Codex CLI / Desktop', compat: 'managed', installed: false, mcpConfigured: false, servers: [] })
   } else {
     const text = await fs.readFile(codexToml, 'utf8')
     const has = /^\[mcp_servers\.memory\]$/m.test(text)
@@ -392,6 +428,9 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
     if (has) configuredNodePath = parseCodexMemoryEntry(text).command
     agents.push({
       name: 'codex',
+      label: 'Codex CLI / Desktop',
+      compat: 'managed',
+      servers: listCodexMcpServers(text),
       installed: true,
       mcpConfigured: has,
       mcpMatchesCurrentNode: has && configuredNodePath === nodePath,
@@ -405,9 +444,9 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
   const cursorJson = path.join(home, '.cursor', 'mcp.json')
   const cursorDir = path.join(home, '.cursor')
   if (!(await exists(cursorDir))) {
-    agents.push({ name: 'cursor', installed: false, mcpConfigured: false, reason: '~/.cursor 不存在' })
+    agents.push({ name: 'cursor', label: 'Cursor', compat: 'managed', installed: false, mcpConfigured: false, servers: [], reason: '~/.cursor 不存在' })
   } else if (!(await exists(cursorJson))) {
-    agents.push({ name: 'cursor', installed: true, mcpConfigured: false, mcpPath: cursorJson })
+    agents.push({ name: 'cursor', label: 'Cursor', compat: 'managed', installed: true, mcpConfigured: false, servers: [], mcpPath: cursorJson })
   } else {
     try {
       const cfg = JSON.parse(await fs.readFile(cursorJson, 'utf8'))
@@ -415,6 +454,9 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
       const mcpExists = !!entry
       agents.push({
         name: 'cursor',
+        label: 'Cursor',
+        compat: 'managed',
+        servers: listMcpServers(cfg),
         installed: true,
         mcpConfigured: mcpExists,
         mcpMatchesCurrentNode: mcpExists && sameMcpEntry(entry, want),
@@ -425,7 +467,27 @@ export async function getSetupStatus({ nodePath = process.execPath } = {}) {
       })
     } catch { agents.push({ name: 'cursor', installed: true, mcpConfigured: false, mcpPath: cursorJson, reason: 'JSON 解析失败' }) }
   }
-  return { ok: true, agents, lastCheckedAt: Date.now(), want: { command: nodePath, args: want.args } }
+  // 兼容性探测：只列出「本机确实存在配置文件」的其它 MCP 客户端（只读，不提供挂载按钮）
+  for (const spec of DETECT_ONLY_CLIENTS) {
+    let mcpPath = ''
+    for (const p of spec.paths()) { if (await exists(p)) { mcpPath = p; break } }
+    if (!mcpPath) continue
+    let servers = []
+    let reason = ''
+    try { servers = listMcpServers(JSON.parse(await fs.readFile(mcpPath, 'utf8')), spec.keys) } catch { reason = 'JSON 解析失败' }
+    agents.push({
+      name: spec.name, label: spec.label, installed: true, detectedOnly: true, compat: 'detected',
+      mcpConfigured: servers.includes('memory'), servers, mcpPath, reason,
+    })
+  }
+  const allServers = [...new Set(agents.flatMap((a) => a.servers || []))]
+  const summary = {
+    detectedAgents: agents.filter((a) => a.installed).length,
+    mountedAgents: agents.filter((a) => a.mcpConfigured).length,
+    totalServers: allServers.length,
+    allServers,
+  }
+  return { ok: true, agents, summary, lastCheckedAt: Date.now(), want: { command: nodePath, args: want.args } }
 }
 
 // -- 会话结束自动沉淀 hook（connect <agent>，agentmemory 的 `connect --with-hooks` 兜底路径）--

package/orca-plugin/orca-plugin.json

@@ -1,36 +1,36 @@
-{
-  "manifestVersion": 1,
-  "id": "memory-eternal",
-  "publisher": "eternalnight996",
-  "name": "memory-eternal",
-  "version": "0.15.0",
-  "description": "Memory Atlas for Orca: open the local memory vault, pending review and knowledge graph from a sandboxed Orca panel.",
-  "author": {
-    "name": "EternalNight996",
-    "url": "https://github.com/EternalNight996"
-  },
-  "repository": "https://github.com/EternalNight996/memory-eternal",
-  "icon": "assets/icon.png",
-  "engines": {
-    "orca": ">=1.4.0"
-  },
-  "pluginApi": 1,
-  "contributes": {
-    "panels": [
-      {
-        "id": "memory",
-        "title": "记忆",
-        "icon": "brain",
-        "entry": "panel.html"
-      }
-    ]
-  },
-  "capabilities": [
-    {
-      "kind": "workspace:read"
-    },
-    {
-      "kind": "terminal:send"
-    }
-  ]
-}
+{
+  "manifestVersion": 1,
+  "id": "memory-eternal",
+  "publisher": "eternalnight996",
+  "name": "memory-eternal",
+  "version": "0.17.0",
+  "description": "Memory Atlas for Orca: open the local memory vault, pending review and knowledge graph from a sandboxed Orca panel.",
+  "author": {
+    "name": "EternalNight996",
+    "url": "https://github.com/EternalNight996"
+  },
+  "repository": "https://github.com/EternalNight996/memory-eternal",
+  "icon": "assets/icon.png",
+  "engines": {
+    "orca": ">=1.4.0"
+  },
+  "pluginApi": 1,
+  "contributes": {
+    "panels": [
+      {
+        "id": "memory",
+        "title": "记忆",
+        "icon": "brain",
+        "entry": "panel.html"
+      }
+    ]
+  },
+  "capabilities": [
+    {
+      "kind": "workspace:read"
+    },
+    {
+      "kind": "terminal:send"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
   "icon": "assets/icon.png",
   "license": "MIT",
@@ -43,7 +43,7 @@
     ".mcp.json",
     "cordis.patch.yml",
     "README.md",
-    "README.en.md",
+    "README.zh-CN.md",
     "LICENSE"
   ],
   "engines": {
@@ -70,7 +70,7 @@
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
     "panel-check": "node scripts/panel-check.mjs",
-    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/ssr.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs && node tests/llm-route.test.mjs && node tests/host-managed.test.mjs && node tests/replace-claim.test.mjs && node tests/version-check-self.test.mjs && node tests/setup-codex.test.mjs && node tests/listener-netstat.test.mjs && node tests/issue-46-overlay.test.mjs && node tests/graph-initial-zoom.test.mjs && node tests/card-head-actions.test.mjs && node tests/card-reader-ux.test.mjs && node tests/tag-filter.test.mjs && node tests/ui-overflow.test.mjs && node tests/version-card-state.test.mjs && node tests/llm-routes-proxy.test.mjs && node tests/model-strikes.test.mjs && node tests/support-bundle.test.mjs && node tests/health-panel.test.mjs && node tests/issue-48-timeout.test.mjs"
+    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/graph-warmup.test.mjs && node tests/loading-hints.test.mjs && node tests/web-entry.test.mjs && node tests/tui-scroll.test.mjs && node tests/tui-audit-scene.test.mjs && node tests/tui-plugin-boot.test.mjs && node tests/capture-session-id.test.mjs && node tests/ssr.test.mjs && node tests/window-controls.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs && node tests/llm-route.test.mjs && node tests/host-managed.test.mjs && node tests/replace-claim.test.mjs && node tests/version-check-self.test.mjs && node tests/setup-codex.test.mjs && node tests/listener-netstat.test.mjs && node tests/issue-46-overlay.test.mjs && node tests/graph-initial-zoom.test.mjs && node tests/card-head-actions.test.mjs && node tests/card-reader-ux.test.mjs && node tests/tag-filter.test.mjs && node tests/ui-overflow.test.mjs && node tests/version-card-state.test.mjs && node tests/llm-routes-proxy.test.mjs && node tests/model-strikes.test.mjs && node tests/support-bundle.test.mjs && node tests/health-panel.test.mjs && node tests/issue-48-timeout.test.mjs && node tests/ledger.test.mjs"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
@@ -116,7 +116,10 @@
       "notes": "Read/write under ~/.dsh/memory-vault only (plugin-private Markdown vault). No outbound network, no credentials, no shell. Hooks/MCP run via the `node` binary that hosts the DSH process."
     },
     "lifecycle": {
-      "scripts": ["prepare", "prepublishOnly"],
+      "scripts": [
+        "prepare",
+        "prepublishOnly"
+      ],
       "details": {
         "prepare": "node build.mjs",
         "prepublishOnly": "node build.mjs"

package/scripts/release.mjs

@@ -132,15 +132,16 @@ let notes = ''
 if (notesFile) {
   notes = fs.readFileSync(path.resolve(ROOT, notesFile), 'utf8')
 } else {
-  // 从 README 更新日志表里取该版本那一行（| **v0.10.0** | 日期 | 说明 |）
-  const readme = fs.readFileSync(path.join(ROOT, 'README.md'), 'utf8')
-  const row = readme.split(/\r?\n/).find((l) => l.startsWith(`| **${tag}**`))
+  // 从 docs/CHANGELOG.md 取该版本那一行（| **v0.10.0** | 日期 | 说明 |）；README 精简为落地页后兼容旧位置
+  const logFile = ['docs/CHANGELOG.md', 'README.md'].map((f) => path.join(ROOT, f)).find((f) => fs.existsSync(f))
+  const logText = logFile ? fs.readFileSync(logFile, 'utf8') : ''
+  const row = logText.split(/\r?\n/).find((l) => l.startsWith(`| **${tag}**`))
   notes = [
     `## ${tag}`,
     '',
     `npm: https://www.npmjs.com/package/memory-eternal/v/${pkg.version}`,
     '',
-    row ? row.replace(/^\|\s*/, '').replace(/\s*\|\s*$/, '').split(/\s*\|\s*/).slice(1).join(' — ') : '（README 更新日志里没有这一版，请用 --notes-file 指定）',
+    row ? row.replace(/^\|\s*/, '').replace(/\s*\|\s*$/, '').split(/\s*\|\s*/).slice(1).join(' — ') : '（CHANGELOG 里没有这一版，请用 --notes-file 指定）',
   ].join('\n')
 }
 say(notes.split('\n').slice(0, 6).join('\n') + (notes.split('\n').length > 6 ? '\n…' : ''))