dsh-mem0-memory 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -5,6 +5,12 @@
 
 ## [Unreleased]
 
+### 0.1.4（2026-08-23）
+
+- **server 自动拉起（autoStartServer）**：DSH 启动时插件探测 mem0 server 的 `/health`（3s 超时）——未在跑则自动 spawn 一次（`detached` 子进程，不随 DSH 退出）；已在跑则不动。用户装了插件 = 期望「与平台同步启动」，忘记手动开 server 也能工作。
+- 设计铁律：① 只探测 HTTP /health（端口有响应 = 在跑，无论谁起的）；② 每个 DSH 进程最多 spawn 一次，失败仅 WARN 绝不重试（OpenClaw 侧 16 进程抢锁事故教训）；③ server 常驻，DSH 退出不带走（最小化动作）。
+- 配置新增：`autoStartServer: true`（默认开，可关）+ `pythonPath`（可选，spawn 用 python 路径，默认 `python`/`python3`）。
+
 ### 0.1.3（2026-08-22）
 
 - **工作区排除（召回侧）**：排除工作区的会话不再召回/注入记忆——插件通过 `ctx.agents.requireInitiator()` 获取当前会话 cwd，判定与 G1 写入侧一致：cwd 路径段 `0_` 前缀（写死约定）+ 新增 `excludeWorkspaces` 配置（名单子串匹配，对应 G1 excluded-workspaces.json）。排除工作区对话省去召回延时（每轮 5-10s），内容本就不入库。

package/README.md

@@ -210,6 +210,8 @@ dsh-mem0-search "关键词" --json                                   # 原始 JS
 | `probePath`      | （空=关）                    | 排障探针日志文件路径（设置后才写文件）                 |
 | `autoImport`     | true                     | 会话结束自动增量导入（关 = 只用手动/定时）             |
 | `excludeWorkspaces` | `[]`                  | 不召回的工作区名单（子串匹配会话 cwd；另 `0_` 前缀工作区写死排除） |
+| `autoStartServer` | true                 | DSH 启动时确保 mem0 server 在跑（探测 /health，未在跑自动拉起一次；DSH 退出不带走 server） |
+| `pythonPath`     | （空）                  | 自动拉起 server 用的 python 路径（默认 `python`/`python3`；venv 用户可指定） |
 
 ## 工作原理
 

package/lib/index.js

@@ -220,6 +220,42 @@ function isExcludedWorkspace(cwd, list) {
   return (list ?? []).some((e) => e && String(cwd).includes(String(e)));
 }
 
+// ─── server ensure（2026-08-23）：DSH 启动时确保 mem0 server 在跑 ─────────
+// 目的：用户装了插件 = 期望「与平台同步启动」——忘记手动开 server 时自动拉起一次。
+// 铁律：① 只探测 HTTP /health（端口有响应 = 在跑，无论谁起的）；② 每个 DSH 进程
+//       最多 spawn 一次，失败仅 WARN 绝不重试（OpenClaw 侧 16 进程抢锁事故教训）；
+//       ③ detached 子进程 + unref——不随 DSH 退出（记忆服务常驻，最小化动作）。
+async function ensureServer(ctx, cfg) {
+  if (!cfg.autoStartServer) return;
+  try {
+    let alive = false;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 3000);
+    try {
+      const resp = await fetch(`${cfg.serverUrl}/health`, { signal: controller.signal });
+      alive = resp.ok;
+    } catch (e) {
+      alive = false;
+    } finally {
+      clearTimeout(timer);
+    }
+    if (alive) return;  // 已在跑（无论谁起的），不动
+
+    // 未在跑：拉起一次（fire-and-forget，不阻塞插件加载）
+    // 注意：PKG_DIR 是 lib/，scripts/ 在包根（上一级）
+    const script = path.join(PKG_DIR, "..", "scripts", "mem0-server.py");
+    const python = cfg.pythonPath || (process.platform === "win32" ? "python" : "python3");
+    let port = "18200";
+    try { port = new URL(cfg.serverUrl).port || "18200"; } catch (e) {}
+    const child = spawn(python, [script, "--port", port], { detached: true, stdio: "ignore" });
+    child.unref();
+    child.once("spawn", () => ctx.logger?.info(`[mem0-memory] mem0 server not detected, auto-started (pid=${child.pid ?? "?"})`));
+    child.on("error", (e) => ctx.logger?.warn(`[mem0-memory] server auto-start failed: ${e.message}`));
+  } catch (e) {
+    ctx.logger?.warn(`[mem0-memory] server auto-start skipped: ${e.message}`);
+  }
+}
+
 export async function apply(ctx, config = {}) {
   // 探针（排障用，默认关闭）：设置 config.probePath 后，apply 执行即写文件——
   // 用于区分「插件未加载」vs「加载了但 pre-step 未触发」。默认不写任何文件。
@@ -243,12 +279,17 @@ export async function apply(ctx, config = {}) {
     source: config.source,   // 可选
     autoImport: config.autoImport !== false,  // 会话结束自动增量导入（默认开，三档机制①）
     excludeWorkspaces: config.excludeWorkspaces ?? [],  // 可选：工作区名单子串（对应 G1 excluded-workspaces.json）
+    autoStartServer: config.autoStartServer !== false,  // DSH 启动时确保 mem0 server 在跑（默认开）
+    pythonPath: config.pythonPath,  // 可选：spawn server 用的 python 路径（默认 python/python3）
   };
   if (!cfg.enabled) {
     ctx.logger?.info("[mem0-memory] disabled");
     return;
   }
 
+  // server ensure（fire-and-forget，不阻塞插件加载）：探测不到就拉起一次
+  ensureServer(ctx, cfg).catch(() => {});
+
   // ─── 会话结束自动增量导入（P2.4：session/disposed 钩子）───────────────
   // fire-and-forget：不阻塞 dispose；子进程间有 .import.lock 互斥（并发安全）。
   // import 脚本定位：插件包内 bin/dsh-mem0-import.mjs（无需用户配置路径）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mem0-memory",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Thin bridge: recall Mem0 memories into DSH agent context via agent/pre-step injection.",
   "type": "module",
   "main": "lib/index.js",