memory-eternal 0.10.4 → 0.10.6

package/lib/config-sync.js

@@ -98,6 +98,62 @@ export function clearPendingConfig(env = process.env) {
   try { fs.unlinkSync(pendingConfigPath(env)); return true } catch { return false }
 }
 
+/**
+ * 直接把 patch 合并进**共享配置文件**（宿主无关路径：本机没有 DSH 宿主时用）。
+ *
+ * 只在「确认没有活着的 DSH 宿主」时调用（见 lib/host-heartbeat.js）：宿主活着时共享文件是
+ * 它的派生镜像，绕过它直写会与 volatile 配置分叉，下一次 syncConfigFile() 就会盖回来。
+ * 合并（而不是整体替换）是有意为之：老版本写下的键、以及其它工具手工加的键都要留住。
+ *
+ * @returns {object} 合并后的完整配置
+ */
+export function applySharedConfigDirect(env, patch) {
+  const file = configFilePath(env)
+  let current = {}
+  try {
+    const parsed = JSON.parse(fs.readFileSync(file, 'utf8'))
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) current = parsed
+  } catch { current = {} }
+  const next = { ...current, ...(patch && typeof patch === 'object' ? patch : {}) }
+  writeFileAtomicSync(file, JSON.stringify(next, null, 2))
+  return next
+}
+
+// 宿主守卫类报错的特征串 —— 同一族缺陷在不同宿主/不同服务上的措辞不同（issue #21）：
+//   · Cordis HMR 宿主（官方桌面版）：runExclusive 拒绝嵌套事务
+//   · dsh-tui 一类宿主：能力守卫在 settings.update 内部的 describe() 上抛
+const HOST_GUARD_PATTERNS = [
+  /HMR transactions cannot be nested/i,
+  /is unavailable from a plugin activation/i,
+]
+
+/** 这个报错是不是「宿主不允许插件从自己的回调上下文写配置」。 */
+export function isHostGuardError(message) {
+  const s = String(message || '')
+  return HOST_GUARD_PATTERNS.some((re) => re.test(s))
+}
+
+/**
+ * 把「应用失败」翻译成给用户看的话（诊断信息 / 自动沉淀日志 / 独立页提示共用）。
+ *
+ * host-guard 类**不是配置内容的问题**，所以说清「去哪改」比重复报错有用得多：
+ * 宿主自己的设置页走的写路径由宿主实现，不受插件上下文限制。
+ *
+ * @returns {{kind:'host-guard'|'other', hint:string}}
+ */
+export function describeApplyFailure(message) {
+  const raw = String(message || '')
+  if (!raw) return { kind: 'other', hint: '' }
+  if (isHostGuardError(raw)) {
+    return {
+      kind: 'host-guard',
+      hint: '此宿主不允许插件从自己的回调上下文里写配置（原报错：' + raw + '）—— 与配置内容无关。请到「DSH 设置 → 记忆」里改同一项（那条写路径由宿主自己实现，不受此限制），或直接编辑 profile 的配置补丁层。',
+    }
+  }
+  return { kind: 'other', hint: '原报错：' + raw + '；可到「DSH 设置 → 记忆」重试，或查看「反馈异常」里的诊断信息。' }
+}
+
+
 /**
  * 监听待应用文件的变化（毫秒级触发），用于把「独立页保存 → DSH 应用」从 5 秒轮询
  * 提升到准即时。监听失败（平台/权限）时退化为不监听 —— 仍有 5 秒轮询兜底。
@@ -224,7 +280,11 @@ export async function drainPendingConfig(env, apply, maxTries = 5) {
     const reason = String((error && error.message) || error)
     if (tries >= maxTries) {
       writePendingConfig(env, pending.patch, pending.at, tries, { dropped: true, lastError: reason })
-      const dropped = new Error('待应用配置连续失败 ' + tries + ' 次已放弃（原报错：' + reason + '）；改动仍保留在 ' + pendingConfigPath(env) + '，可修正后重新保存')
+      // 失败原因分两类：宿主守卫类（不是配置内容的问题，要说清去哪改）与其它。
+      const advice = describeApplyFailure(reason)
+      const dropped = new Error('待应用配置连续失败 ' + tries + ' 次已放弃（原报错：' + reason + '）'
+        + (advice.kind === 'host-guard' ? '。' + advice.hint : '')
+        + '；改动仍保留在 ' + pendingConfigPath(env) + '，可修正后重新保存')
       dropped.dropped = true
       dropped.lastError = reason
       throw dropped

package/lib/host-heartbeat.js

@@ -0,0 +1,72 @@
+// 宿主心跳：让「独立 Web 端」知道本机此刻有没有活着的 DSH 宿主（issue #21 的宿主无关写路径）。
+//
+// 为什么需要它：配置只有一个权威写入者 —— DSH 宿主（插件用 settings.update 应用，再由
+// index.js 的 syncConfigFile 写共享配置文件）。独立 Web 进程里没有 settings 服务，只能把改动
+// 写进「待应用」文件、等宿主来 drain。但**非 DSH 宿主**（Codex / Claude Code / Cursor，
+// 或只跑 `dsh-memory serve` 的用户）根本没有宿主来 drain：改动会永远停在 pending 文件里，
+// 保存等于没保存 —— 而界面上那句「下次启动生效」在那类环境下是错的（不会有"下次启动 DSH"）。
+//
+// 判据：宿主活着时周期性刷新 `<共享配置>.host.json`（pid + 版本 + 时间戳）。
+// 独立端保存后若「没人消费 pending」且「心跳不新鲜」，即判定本机没有宿主 → 直接原子写共享配置。
+// 反之（宿主活着）**绝不**绕过宿主写文件：那会与宿主的 volatile 配置分叉，下一次
+// syncConfigFile() 就会把改动盖回去。
+import fs from 'node:fs'
+import { configFilePath } from './capture-run.js'
+import { writeFileAtomicSync } from './config-sync.js'
+
+/** 心跳文件路径（与共享配置同目录：`xxx.json` → `xxx.host.json`）。 */
+export function hostMarkerPath(env = process.env) {
+  return String(configFilePath(env)).replace(/\.json$/i, '.host.json')
+}
+
+/** 进程存活判定（EPERM = 存在但无权发信号，仍算活着）。 */
+export function isProcessAlive(pid) {
+  const n = Number(pid)
+  if (!Number.isFinite(n) || n <= 0) return false
+  try {
+    process.kill(n, 0)
+    return true
+  } catch (error) {
+    return Boolean(error && error.code === 'EPERM')
+  }
+}
+
+/** 写/刷新心跳（原子写：这是跨进程判据，读方可能正好在写）。 */
+export function writeHostMarker(env = process.env, info = {}, now = Date.now()) {
+  const data = { pid: process.pid, at: now, ...info }
+  writeFileAtomicSync(hostMarkerPath(env), JSON.stringify(data, null, 2))
+  return data
+}
+
+/** 读心跳；文件不存在 / 内容损坏都返回 null。 */
+export function readHostMarker(env = process.env) {
+  try {
+    const data = JSON.parse(fs.readFileSync(hostMarkerPath(env), 'utf8'))
+    if (!data || typeof data !== 'object') return null
+    return {
+      pid: Number(data.pid) || 0,
+      at: Number(data.at) || 0,
+      version: String(data.version || ''),
+    }
+  } catch { return null }
+}
+
+/** 删除心跳（插件 dispose 时尽力而为；宿主被硬杀时靠新鲜度判定兜底）。 */
+export function clearHostMarker(env = process.env) {
+  try { fs.unlinkSync(hostMarkerPath(env)); return true } catch { return false }
+}
+
+/**
+ * 本机此刻有没有活着的 DSH 宿主：心跳新鲜（默认 45s，宿主每 15s 刷一次）**且**那个 pid 还在。
+ * 两个条件都要，避免「宿主崩了但心跳文件还在」被误判成有宿主。
+ *
+ * @param {Record<string,string>} [env]
+ * @param {{maxAgeMs?:number, now?:number, isAlive?:(pid:number)=>boolean}} [opts]
+ * @returns {boolean}
+ */
+export function hostAlive(env = process.env, { maxAgeMs = 45000, now = Date.now(), isAlive = isProcessAlive } = {}) {
+  const marker = readHostMarker(env)
+  if (!marker || !marker.pid || !marker.at) return false
+  if (now - marker.at > Math.max(0, Number(maxAgeMs) || 0)) return false
+  return isAlive(marker.pid)
+}

package/lib/watchdog.js

@@ -263,6 +263,15 @@ export async function stopWatchdogs({ env = process.env, port, timeoutMs = 5000,
       if (!found || !found.pid) continue
       warnings.push(`端口 ${p} 仍被 pid ${found.pid} 占用（${found.command || '命令行未知'}）；status 显示的版本可能不是端口上真正服务的版本`)
     }
+    // 顺带回收「上一代退让到 port+1… 的孤儿 web」：它们不在锁里，配置端口的兜底永远够不到它们
+    // （8001/8002 上常驻的那两个就是这么来的）。三道门由 sweepOrphanWebs 把握，只收自家的。
+    for (const p of ports) {
+      try {
+        const sweep = await sweepOrphanWebs({ env, port: p, findListener, kill: killFn, isAlive: alive, lock: { watchdogs: readWatchdogLock(env).watchdogs } })
+        for (const pid of sweep.killed) portStopped.push(pid)
+        for (const w of sweep.warnings) warnings.push(w)
+      } catch { /* 回收失败不影响 stop 主流程 */ }
+    }
   }
   return {
     stopped: [...new Set(stopped.filter((p) => !failed.includes(p)))],
@@ -489,6 +498,66 @@ export function looksLikeOurWeb(command, { webJs = WEB_JS } = {}) {
   return Boolean(target) && norm(s).includes(target)
 }
 
+/**
+ * 退让端口窗口：配置端口 + 紧随其后的若干个。
+ *
+ * web 在目标端口被占时会退到 port+1…（见 startWatchdog 的 findFreePort），这些落点正是
+ * 「孤儿 web」的诞生地：退让出来的那个 web 一旦失去托管它的 watchdog，就再没人来认领它。
+ */
+export function fallbackPortWindow(port, span = 9) {
+  const base = Number(port) || 0
+  const n = Math.max(0, Number(span) || 0)
+  const out = []
+  for (let i = 1; i <= n; i++) out.push(base + i)
+  return out
+}
+
+/**
+ * 收掉「本插件拉起、但没有任何托管者认领」的孤儿 web。
+ *
+ * 为什么必须单独做这件事：web 子进程是 detached 启动的（stdio ignore + unref），watchdog 被
+ * 硬终止时（Windows 上 process.kill(pid,'SIGTERM') 就是无条件终止）它的退出处理器不会执行；
+ * 若该 web 当初退让到了 port+1，登记它的锁条目也随 watchdog 一起消失 —— 于是它会一直占着
+ * 8001/8002 之类的端口，`status` 只探配置端口，永远发现不了它。0.10.4 起 stop/restart 会按
+ * 「端口占用者」兜底，但那只覆盖配置端口本身。
+ *
+ * 三道门缺一不可（宁可漏收，绝不误杀）：
+ *   ① 端口落在 [port+1, port+span] 窗口内 —— 配置端口上的服务不归它管；
+ *   ② 命令行确实是本插件的 web（复用收紧过的 looksLikeOurWeb，别人的 node web.js 不动）；
+ *   ③ 该 pid 不在锁文件里任何 watchdog 的 pid / webPid 上 —— 登记在案的一律不动。
+ *
+ * @param {{env?:object, port:number, span?:number, kill?:Function, isAlive?:Function, findListener?:Function, lock?:object}} opts
+ * @returns {Promise<{killed:number[], kept:Array<{pid:number,port:number,reason:string}>, warnings:string[]}>}
+ */
+export async function sweepOrphanWebs({ env = process.env, port, span = 9, kill, isAlive, findListener, lock } = {}) {
+  const alive = isAlive || isPidAlive
+  const killFn = kill || ((pid) => { try { process.kill(pid, 'SIGTERM'); return true } catch { return false } })
+  const probeListener = async (p) => {
+    try { return findListener ? await findListener(p) : await findPortListener(p) } catch { return null }
+  }
+  const entries = lock && Array.isArray(lock.watchdogs) ? lock.watchdogs : readWatchdogLock(env).watchdogs
+  const registered = new Set()
+  for (const w of entries) {
+    if (Number(w.pid) > 0) registered.add(Number(w.pid))
+    if (Number(w.webPid) > 0) registered.add(Number(w.webPid))
+  }
+  const killed = []
+  const kept = []
+  const warnings = []
+  for (const p of fallbackPortWindow(port, span)) {
+    const found = await probeListener(p)
+    if (!found || !found.pid) continue
+    const pid = Number(found.pid)
+    const command = String(found.command || '')
+    if (!looksLikeOurWeb(command)) { kept.push({ pid, port: p, reason: 'not-ours' }); continue }
+    if (registered.has(pid)) { kept.push({ pid, port: p, reason: 'registered' }); continue }
+    if (!alive(pid)) { kept.push({ pid, port: p, reason: 'already-exited' }); continue }
+    if (!killFn(pid)) { warnings.push(`端口 ${p} 上的孤儿 web（pid ${pid}）未能终止，请手工处理`); continue }
+    killed.push(pid)
+  }
+  return { killed, kept, warnings }
+}
+
 /** 探测端口是否有任何 TCP 监听（即便不是我们的服务也占用）。 */
 export async function probeTcp(port, timeoutMs = 600) {
   return new Promise((resolve) => {
@@ -530,6 +599,16 @@ export function startWatchdog({ port = 7999, vaultRoot, interval = 5000, maxRest
     if (child && !child.killed) {
       try { child.kill('SIGTERM') } catch {}
     }
+    // 目标端口上已经有**本插件自己的** web（上一代 watchdog 留下的、或正在启动还没来得及回
+    // /overview 的那个）→ 本轮不重复拉起，更不退让到 port+1：退让出来的那个一旦失去托管者
+    // 就是孤儿（8001/8002 的来历）。保活交给 tick 的探活，等它真的死了再起。
+    try {
+      const found = await findPortListener(port)
+      if (found && found.pid && looksLikeOurWeb(found.command)) {
+        log(`端口 ${port} 上已有本插件的 web（pid ${found.pid}）→ 本轮不重复拉起（不制造退让实例）`)
+        return port
+      }
+    } catch { /* 探测失败按原逻辑继续 */ }
     const targetPort = await findFreePort(port)
     const args = [WEB_JS, '--port', String(targetPort)]
     if (vaultRoot) args.push('--vault', vaultRoot)
@@ -633,6 +712,16 @@ export function startWatchdog({ port = 7999, vaultRoot, interval = 5000, maxRest
     process.exit(0)
   }
 
+  // 启动时顺手回收「上一代退让到 port+1… 的孤儿 web」——不这么做的话，那些 web 会一直占着
+  // 8001/8002 之类的端口，而 tick 只探配置端口，永远发现不了它们（它们当初的托管者已退出）。
+  ;(async () => {
+    try {
+      const sweep = await sweepOrphanWebs({ port })
+      if (sweep.killed.length) log(`已回收上一代的孤儿 web：pid ${sweep.killed.join(', ')}（端口 ${fallbackPortWindow(port).join('/')} 窗口）`)
+      for (const w of sweep.warnings) log(`⚠ ${w}`)
+    } catch { /* 回收失败不影响保活主流程 */ }
+  })()
+
   // 首次探测
   ;(async () => {
     const alive = await probe(port)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
   "license": "MIT",
   "repository": {
@@ -64,7 +64,7 @@
     "prepublishOnly": "node build.mjs",
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
-    "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"
+    "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"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"