memory-eternal 0.10.4 → 0.10.5

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "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"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"