memory-eternal 0.9.5 → 0.9.7

package/lib/node-bin.js

@@ -0,0 +1,99 @@
+// 记忆核心 · 子进程用的 node 可执行文件解析
+//
+// 背景（真实故障）：
+// 在 Electron 宿主里（例如 DSH Desktop），`process.execPath` 指向的是
+// Electron 主程序，而不是 node。此前 `ensureWebServer()` / watchdog / 插件的
+// 保活逻辑都用 `spawn(process.execPath, ['.../web.js', ...])` 拉起子进程，
+// 于是在 Electron 宿主下 spawn 出来的是「第二个 Electron 实例」：
+// 它不会执行 web.js，而是立刻退出（或被单实例锁挡掉），而调用方用的是
+// `stdio: 'ignore'` + `.catch(() => {})`，失败被彻底吞掉——表现就是侧边栏
+// 「记忆」弹窗里那个指向 127.0.0.1:7999 的 iframe 永远白屏。
+//
+// 本模块把「找出一个真正能跑 node 脚本的子进程入口」收敛到一处：
+//   1. MEMORY_ETERNAL_NODE 显式指定（逃生口，便于测试与非常规宿主）；
+//   2. 非 Electron 宿主：process.execPath 本身就是 node，直接用；
+//   3. Electron 宿主：优先从 PATH 找真正的 node；
+//   4. 都找不到时退回 process.execPath，并由 childEnv() 打开
+//      ELECTRON_RUN_AS_NODE，让 Electron 二进制以纯 node 模式运行。
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+let cachedBinary = null
+let cachedSource = null
+
+/** 在 PATH 中查找真正的 node 可执行文件；找不到返回 null。 */
+function findNodeOnPath() {
+  const names = process.platform === 'win32' ? ['node.exe', 'node.cmd', 'node'] : ['node', 'node.exe']
+  const dirs = String(process.env.PATH || '').split(path.delimiter)
+  for (const dir of dirs) {
+    if (!dir) continue
+    for (const name of names) {
+      const candidate = path.join(dir, name)
+      try {
+        if (fs.statSync(candidate).isFile()) return candidate
+      } catch {
+        // 目录不存在或无权访问：继续找下一个
+      }
+    }
+  }
+  return null
+}
+
+/**
+ * 返回用于 spawn 子进程（跑 .js 脚本）的可执行文件路径。
+ * @returns {string}
+ */
+export function nodeBinary() {
+  if (cachedBinary) return cachedBinary
+
+  if (process.env.MEMORY_ETERNAL_NODE) {
+    cachedBinary = process.env.MEMORY_ETERNAL_NODE
+    cachedSource = 'env'
+    return cachedBinary
+  }
+
+  if (!process.versions.electron) {
+    cachedBinary = process.execPath
+    cachedSource = 'execPath'
+    return cachedBinary
+  }
+
+  const found = findNodeOnPath()
+  if (found) {
+    cachedBinary = found
+    cachedSource = 'path'
+    return cachedBinary
+  }
+
+  cachedBinary = process.execPath
+  cachedSource = 'electron-run-as-node'
+  return cachedBinary
+}
+
+/** 说明 nodeBinary() 最终选了哪条路径（诊断用，不参与逻辑）。 */
+export function nodeBinarySource() {
+  nodeBinary()
+  return cachedSource
+}
+
+/**
+ * 子进程环境：始终打开 ELECTRON_RUN_AS_NODE。
+ * 真正的 node 会忽略这个变量，所以无条件设置是安全的；而当 nodeBinary()
+ * 只能退回 Electron 二进制时，它就是让子进程以 node 模式运行的关键。
+ * @param {Record<string, string>} [extra]
+ */
+export function childEnv(extra) {
+  return { ...process.env, ...(extra || {}), ELECTRON_RUN_AS_NODE: '1' }
+}
+
+/** 是否只能依赖 Electron 二进制的 node 模式（PATH 上没有真 node）。 */
+export function usesElectronBinary() {
+  return nodeBinarySource() === 'electron-run-as-node'
+}
+
+/** 仅测试用：清掉进程内缓存。 */
+export function resetNodeBinaryCache() {
+  cachedBinary = null
+  cachedSource = null
+}

package/lib/watchdog.js

@@ -19,6 +19,7 @@ import { spawn } from 'node:child_process'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import process from 'node:process'
+import { nodeBinary, childEnv } from './node-bin.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const WEB_JS = path.join(__dirname, 'web.js')
@@ -93,13 +94,17 @@ export function startWatchdog({ port = 7999, vaultRoot, interval = 5000, maxRest
     const targetPort = await findFreePort(port)
     const args = [WEB_JS, '--port', String(targetPort)]
     if (vaultRoot) args.push('--vault', vaultRoot)
-    log(`spawn web: node ${args.join(' ')}`)
-    const c = spawn(process.execPath, args, {
+    log(`spawn web: ${nodeBinary()} ${args.join(' ')}`)
+    const c = spawn(nodeBinary(), args, {
       detached: true,
       stdio: 'ignore',
-      env: { ...process.env, MEMORY_VAULT_DIR: vaultRoot || process.env.MEMORY_VAULT_DIR || '' },
+      env: childEnv({ MEMORY_VAULT_DIR: vaultRoot || process.env.MEMORY_VAULT_DIR || '' }),
       windowsHide: true,
     })
+    // spawn 失败默认静默，显式记录（Electron 宿主下曾因此完全无迹可查）
+    c.on('error', (error) => {
+      log(`web spawn failed (${nodeBinary()}): ${error?.message || error}`)
+    })
     c.on('exit', (code, sig) => {
       spawned.delete(c)
       if (!stopped && code !== 0) log(`web exited code=${code} sig=${sig}`)

package/lib/web.js

@@ -17,6 +17,7 @@ import { fileURLToPath } from 'node:url'
 import { createApi, API_PREFIX, encodeBody } from './api.js'
 import { defaultVaultDir, configFilePath } from './capture-run.js'
 import { readCaptureLog, deriveHealth } from './capture-log.js'
+import { nodeBinary, childEnv } from './node-bin.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const WEB_ROOT = path.join(__dirname, '..', 'web')
@@ -112,13 +113,19 @@ export async function ensureWebServer({ port = DEFAULT_WEB_PORT, vaultRoot = def
   }
   if (found) return found
 
-  // detached spawn：独立进程，父进程退出不影响（常驻）；stdio ignore 防阻塞
+  // detached spawn：独立进程，父进程退出不影响（常驻）；stdio ignore 防阻塞。
+  // 注意用 nodeBinary() 而不是 process.execPath：在 Electron 宿主里后者是
+  // Electron 主程序，spawn 出来不会执行 web.js（见 lib/node-bin.js）。
   const { spawn } = await import('node:child_process')
   const child = spawn(
-    process.execPath,
+    nodeBinary(),
     [path.join(__dirname, 'web.js'), '--port', String(target), '--vault', vaultRoot],
-    { detached: true, stdio: 'ignore', env: { ...process.env, ...spawnEnv, MEMORY_VAULT_DIR: vaultRoot }, windowsHide: true },
+    { detached: true, stdio: 'ignore', env: childEnv({ ...spawnEnv, MEMORY_VAULT_DIR: vaultRoot }), windowsHide: true },
   )
+  // spawn 失败（ENOENT/EACCES/...）默认是静默的，这里显式暴露出来
+  child.on('error', (error) => {
+    process.stderr.write(`[memory-eternal] web server spawn failed (${nodeBinary()}): ${error?.message || error}\n`)
+  })
   child.unref()
 
   const deadline = Date.now() + totalTimeoutMs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-eternal",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
   "license": "MIT",
   "repository": {
@@ -60,7 +60,7 @@
     "build": "node build.mjs",
     "build:client": "node build.mjs",
     "prepublishOnly": "node build.mjs",
-    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/api.test.mjs && node tests/settings-compat.test.mjs && node tests/ssr.test.mjs"
+    "test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/api.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/markdown.test.mjs && node tests/ssr.test.mjs"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
@@ -89,7 +89,8 @@
     },
     "marketplace": {
       "profiles": [
-        "web"
+        "web",
+        "desktop"
       ],
       "requiresBuildApproval": false,
       "requiresRestart": true,
@@ -122,7 +123,8 @@
       },
       "node": ">=22",
       "profiles": [
-        "web"
+        "web",
+        "desktop"
       ]
     }
   }