memory-eternal 0.9.16 → 0.9.23

package/lib/config-sync.js

@@ -0,0 +1,89 @@
+// 配置同步（共享文件协议）：让「独立 Web 页」也能保存配置。
+//
+// 背景：独立 web server 进程里没有 DSH 的 settings 服务，`ctx.settings.update` 不存在，
+// 所以它的 /config 过去只能只读 —— 用户点保存永远没反应（issue #12 的另一半）。
+// 方案：独立端把改动写进 `memory-eternal-config.pending.json`，DSH 宿主激活时与运行期
+// 轮询该文件，用 settings.update 应用后删除。DSH 没运行时改动留在文件里，下次启动生效。
+import fs from 'node:fs'
+import path from 'node:path'
+import { configFilePath } from './capture-run.js'
+
+/** 待应用配置文件的路径（与共享配置文件同目录）。 */
+export function pendingConfigPath(env = process.env) {
+  return String(configFilePath(env)).replace(/\.json$/i, '.pending.json')
+}
+
+/** 读待应用改动；文件不存在/损坏都返回 null（不影响主流程）。 */
+export function readPendingConfig(env = process.env) {
+  try {
+    const data = JSON.parse(fs.readFileSync(pendingConfigPath(env), 'utf8'))
+    if (!data || typeof data.patch !== 'object' || data.patch === null || Array.isArray(data.patch)) return null
+    return { at: Number(data.at) || 0, tries: Number(data.tries) || 0, patch: data.patch }
+  } catch { return null }
+}
+
+/** 原子写入待应用改动（tmp + rename），返回写入内容。 */
+export function writePendingConfig(env, patch, now = Date.now(), tries = 0) {
+  const file = pendingConfigPath(env)
+  const data = tries > 0 ? { at: now, tries, patch } : { at: now, patch }
+  const tmp = file + '.' + process.pid + '.tmp'
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8')
+  fs.renameSync(tmp, file)
+  return data
+}
+
+/** 删除待应用文件；不存在也算成功。 */
+export function clearPendingConfig(env = process.env) {
+  try { fs.unlinkSync(pendingConfigPath(env)); return true } catch { return false }
+}
+
+/**
+ * 监听待应用文件的变化（毫秒级触发），用于把「独立页保存 → DSH 应用」从 5 秒轮询
+ * 提升到准即时。监听失败（平台/权限）时退化为不监听 —— 仍有 5 秒轮询兜底。
+ * @returns {() => void} 停止监听
+ */
+export function watchPendingConfig(env, onChange, { debounceMs = 60 } = {}) {
+  const file = pendingConfigPath(env)
+  let timer = null
+  let watcher = null
+  const fire = () => {
+    if (timer) clearTimeout(timer)
+    timer = setTimeout(() => { try { onChange() } catch { /* 回调异常不影响监听 */ } }, debounceMs)
+  }
+  try {
+    watcher = fs.watch(path.dirname(file), (_event, name) => {
+      if (name && !String(name).startsWith('memory-eternal-config.pending')) return
+      fire()
+    })
+    if (typeof watcher.unref === 'function') watcher.unref()
+  } catch { return () => {} }
+  return () => {
+    if (timer) clearTimeout(timer)
+    try { watcher.close() } catch { /* 已关闭 */ }
+  }
+}
+
+/**
+ * 取出并应用一次待应用改动：apply(patch) 成功后删除文件；失败保留（下轮重试）。
+ * @returns {Promise<object|null>} 应用成功的 patch，没有待应用项时返回 null
+ */
+export async function drainPendingConfig(env, apply, maxTries = 5) {
+  const pending = readPendingConfig(env)
+  if (!pending) return null
+  try {
+    await apply(pending.patch)
+  } catch (error) {
+    const tries = (pending.tries || 0) + 1
+    if (tries >= maxTries) {
+      // 连续失败（多半是值不合法）：放弃并删掉，否则会每 5 秒无限重试
+      clearPendingConfig(env)
+      const dropped = new Error('待应用配置连续失败 ' + tries + ' 次已放弃：' + String((error && error.message) || error))
+      dropped.dropped = true
+      throw dropped
+    }
+    writePendingConfig(env, pending.patch, pending.at, tries)
+    throw error
+  }
+  clearPendingConfig(env)
+  return pending.patch
+}

package/lib/sse.js

@@ -0,0 +1,51 @@
+// SSE 推送中心：把「配置/卡片变更」即时推给所有已打开的页面（不必手动刷新）。
+// 两个宿主（DSH 内嵌 + 独立 web）共用同一套实现；纯逻辑，便于单测（注入假 res）。
+export function createHub({ heartbeatMs = 25000 } = {}) {
+  const clients = new Set()
+  let timer = null
+  const send = (res, chunk) => {
+    try { res.write(chunk); return true } catch { return false }
+  }
+  const drop = (res) => {
+    clients.delete(res)
+    try { res.end() } catch { /* 已断开 */ }
+  }
+  const ensureTimer = () => {
+    if (timer || !(heartbeatMs > 0)) return
+    timer = setInterval(() => {
+      for (const res of [...clients]) if (!send(res, ': ping\n\n')) drop(res)
+    }, heartbeatMs)
+    if (typeof timer.unref === 'function') timer.unref()
+  }
+  return {
+    /** 接入一个连接（保持长连接，不要 end）。 */
+    add(res) {
+      try {
+        res.writeHead(200, {
+          'Content-Type': 'text/event-stream; charset=utf-8',
+          'Cache-Control': 'no-store',
+          Connection: 'keep-alive',
+          'X-Accel-Buffering': 'no',
+        })
+      } catch { return false }
+      if (!send(res, 'retry: 3000\n\n')) return false
+      clients.add(res)
+      ensureTimer()
+      const onClose = () => drop(res)
+      try { res.on('close', onClose); res.on('error', onClose) } catch { /* 某些响应对象没有 on */ }
+      return true
+    },
+    /** 广播事件（event: <name>，data: JSON）。返回当前连接数。 */
+    broadcast(event, data) {
+      const chunk = 'event: ' + event + '\ndata: ' + JSON.stringify(data === undefined ? {} : data) + '\n\n'
+      for (const res of [...clients]) if (!send(res, chunk)) drop(res)
+      return clients.size
+    },
+    get size() { return clients.size },
+    close() {
+      if (timer) clearInterval(timer)
+      timer = null
+      for (const res of [...clients]) drop(res)
+    },
+  }
+}

package/lib/web.js

@@ -11,10 +11,10 @@
 // 直接运行：node lib/web.js --port 7999 [--vault <dir>]
 
 import http from 'node:http'
-import { promises as fs, readFileSync } from 'node:fs'
+import { promises as fs, readFileSync, watch } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { createApi, API_PREFIX, encodeBody } from './api.js'
+import { createApi, API_PREFIX, encodeBody, broadcast } from './api.js'
 import { defaultVaultDir, configFilePath } from './capture-run.js'
 import { readCaptureLog, deriveHealth } from './capture-log.js'
 import { nodeBinary, childEnv } from './node-bin.js'
@@ -39,6 +39,17 @@ export function startWebServer({ port = DEFAULT_WEB_PORT, vaultRoot = defaultVau
     getCaptureHealth: async () => deriveHealth(await readCaptureLog(50, process.env)),
   })
 
+  // 共享配置文件变化 → 即时推给已打开的独立页（DSH 端一保存，这边不用刷新就能看到）
+  try {
+    const cfgFile = configFilePath(process.env)
+    const cfgName = path.basename(cfgFile)
+    const w = watch(path.dirname(cfgFile), (_event, name) => {
+      if (name && !String(name).startsWith(cfgName)) return
+      broadcast('config', { at: Date.now(), source: 'file' })
+    })
+    if (typeof w.unref === 'function') w.unref()
+  } catch { /* 监听失败不影响服务；客户端仍会在操作时重新拉取 */ }
+
   const server = http.createServer(async (req, res) => {
     try {
       const url = new URL(req.url, 'http://localhost')

package/package.json

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