dsh-memory-eternal 0.5.6 → 0.5.7

package/README.md

@@ -343,8 +343,81 @@ npm i -g github:EternalNight996/dsh-memory-eternal
 | activeVault | '' | 当前激活的 Vault（对应 vaultProfiles 中的 name） |
 | sessionBudgetChars | 80000 | 会话级 token 预算（字符数），供 harness 触发压缩 |
 | recallEmbedding | '' | 语义召回 provider（空=零依赖 bigram + LLM 判定兜底） |
-| autoMcpSetup | 开 | 激活时自动把 MCP 挂到本机已装的 Claude Code/Codex/Cursor（幂等+备份） |
-| autoWeb | 开 | 激活时确保 Web server 常驻（UI 唯一真源，DSH 渲染走 iframe） |
+| autoMcpSetup | **关** | 激活时自动把 MCP 挂到本机已装的 Claude Code/Codex/Cursor（幂等+备份）。**默认关闭**——不碰外部配置，按需开启 |
+| autoWeb | 开 | 激活时拉起 web server（默认 init 模式拉一次）。配 autoWebMode 调保活强度 |
+| autoWebMode | `init` | web server 保活模式：`init`（启动时拉一次）/ `interval`（DSH 进程内周期保活）/ `manual`（不自动拉起，仅 `dsh-memory open` ensure-alive） |
+| webPort | `7999` | web server 端口 |
+| webCheckIntervalMs | `5000` | interval 模式的探活间隔（最小 1000） |
+| webMaxRestart | `10` | interval 模式连续失败超过此次数后停止保活（让人工排查） |
+| watchdogAutoSpawn | **关** | 是否 spawn 一个与 DSH 解耦的独立 watchdog 进程（额外 ~47 MB 常驻）。**默认关闭**——DSH 进程内 setInterval 已够用 |
+
+---
+
+## 🌐 服务自管理 · Self-hosting
+
+**v0.5.7 引入配置化部署强度**——从「自动启用一切」改为「默认保守、用户显式升级强度」。
+
+### 三种 web server 保活模式（autoWebMode）
+
+| 模式 | 行为 | 适合 | 代价 |
+|---|---|---|---|
+| `init`（默认）| DSH 激活时拉一次；之后不管 | 常规用法（DSH 常开） | 47 MB web + 0 监控 |
+| `interval` | DSH 进程内 `setInterval` 周期探活 + 自动拉起（web 死掉复活） | DSH 常开但 web 偶尔被外部 kill | 47 MB web + ~0 监控（DSH 进程内） |
+| `manual` | 完全不自动拉起；只在 `dsh-memory open` 时 ensure-alive | 服务器/CI 想自己控制启停 | 47 MB web（手动起后） |
+
+### 看门狗进程（watchdogAutoSpawn）
+
+DSH 死了也能保活 web 时使用：
+
+```bash
+# 方式 1：UI 设置 → 服务自管理 → 开启 watchdogAutoSpawn
+# DSH 重启后会自动 spawn 一个独立 node watchdog 进程
+
+# 方式 2：手动跑（在另一个终端）
+dsh-memory watchdog --port 7799 --interval 5000 --max-restart 10
+```
+
+**资源**：47 MB（独立 node 进程）/ 0 MB（DSH 进程内 setInterval）。**默认不 spawn**，需要 7×24 保活才开。
+
+### MCP 自动挂载（autoMcpSetup）
+
+**v0.5.7 起默认关闭**。需要时：
+- 设置 → 记忆 → `autoMcpSetup = true` → 重启 DSH 自动写入各 agent 配置
+- 或手动：`dsh-memory setup [--claude-only|--codex-only|--cursor-only] [--dry-run]`
+
+### MCP 配置状态查询
+
+Web UI 顶部「外部 Agent MCP 挂载状态」面板（`GET /memory-eternal/api/setup-status` 只读）：
+
+- **claude-code**：检测 `~/.claude.json` 的 `mcpServers.memory` + `~/.claude/settings.json` 的 SessionEnd hook
+- **codex**：检测 `~/.codex/config.toml` 的 `[mcp_servers.memory]` 段
+- **cursor**：检测 `~/.cursor/mcp.json` 的 `mcpServers.memory`
+
+每项返回：`installed` / `mcpConfigured` / `mcpMatchesCurrentNode`（检测 node 路径是否与当前一致）/ `hook`（仅 claude-code）。**node 路径不一致** = ⚠ 警告（之前在 dsh-desktop 环境 setup 过、现在换 node），提示重跑 `dsh-memory setup` 修复。
+
+### 服务自管理 vs 7×24 部署
+
+| 部署强度 | 配置 | 进程 | 开机自启 |
+|---|---|---|---|
+| 个人开发（默认）| `autoMcpSetup=false` + `autoWeb=true` + `autoWebMode=init` + `watchdogAutoSpawn=false` | web 47 MB | 否 |
+| 常规 DSH 用户 | 加上 `autoWebMode=interval` | web 47 MB | 否 |
+| 7×24 服务化 | + `watchdogAutoSpawn=true` | web 47 MB + watchdog 47 MB | DSH 启动时 spawn（**不是**开机自启——DSH 退出则失效） |
+| 真正开机自启（无 DSH）| 跳过 DSH，走**系统级** watchdog：Windows Task Scheduler 计划任务跑 `dsh-memory watchdog --port 7799 --interval 5000 --max-restart 10` | web 47 MB + watchdog 47 MB | **是**（与 DSH 解耦）|
+
+**关键事实**：**MCP server 不是 daemon**——它是 stdio 协议，agent 启动会话时 spawn、用完即退。**不存在「MCP 开机自启」**的概念。Claude Code / Codex CLI / Cursor 每次开会话就 spawn 一个 MCP 进程，session 结束就退出。
+
+### 进程依赖关系
+
+```
+DSH 宿主 (Cordis 框架)
+  ├─ host plugin: index.js  ← 自动沉淀 / memory_recall / JSON API / web-info
+  ├─ (可选) autoWeb 拉起的 detached node web.js   ← detached, DSH 退出后仍活
+  └─ (可选) watchdogAutoSpawn 拉起的 detached node watchdog.js  ← 同上
+web server (lib/web.js)
+  └─ (被 agent 按需 spawn) stdio MCP server 进程 ← 短生命周期
+```
+
+**所有「常驻」node 进程都依赖 Node 运行时**。**不依赖 Node** 的方案只有**系统级 watchdog**（Windows Task Scheduler 用 PowerShell 脚本）—— 但 web server 本身仍需 node。**Node 是硬依赖**。
 
 ---
 
@@ -403,8 +476,66 @@ dsh-memory-eternal/
 
 ---
 
+## 🆕 v0.5.x 改善项汇总 · Improvements in v0.5.x
+
+> v0.5 是**多宿主化主版本**，自 v0.5.0 起本插件不再只属于 DSH——一个记忆库，所有 Agent 共享。下方按主题归纳 v0.5.0 → v0.5.6 的关键改进（中英对照）。
+>
+> **v0.5 is the multi-host milestone.** From v0.5.0 on, this plugin is no longer DSH-only — one memory vault shared by every Agent. The summary below groups v0.5.0 → v0.5.6 improvements by theme (Chinese / English side by side).
+
+### 🧠 多宿主架构 · Multi-host architecture
+
+| 中文 | English |
+|---|---|
+| **MCP server** 零依赖 stdio（`memory_recall` / `memory_capture` / `memory_stats` 三工具） | Zero-dep **MCP server** on stdio: `memory_recall` / `memory_capture` / `memory_stats` |
+| **CLI 入口 `dsh-memory`** 7 子命令（recall / capture / serve / open / mcp / setup / sweep） | New **CLI `dsh-memory`** with 7 subcommands |
+| **Web 端常驻** 独立进程，DSH 渲染走 iframe = 单一 UI 真源 | **Web UI** runs as detached process; DSH renders via iframe — single source of truth |
+| **自动挂载** 插件激活即检测 Claude Code / Codex / Cursor，幂等 + 备份写入 MCP 配置 | **Auto-mount** to installed agents (Claude Code / Codex / Cursor), idempotent + auto backup |
+| **Claude Code SessionEnd hook** 会话结束 / 压缩前自动沉淀（Windows 友好纯 node 脚本） | **Claude Code SessionEnd hook** auto-captures before session end / pre-compact |
+| **卡格式 `formatVersion` 守卫** 多副本共存 / 版本漂移时只向后兼容读，不会写坏库 | **Card `formatVersion` guard** — backward-compatible reads survive cross-version drift |
+
+### ⚡ 健壮性 · Robustness
+
+| 中文 | English |
+|---|---|
+| **看门狗 `dsh-memory watchdog`** 独立进程保活 web server（不依赖 DSH 宿主），端口探活 + 失败自动拉起 + 重启计数 + SIGINT/SIGTERM 优雅退出。稳态内存 ~47 MB / CPU 接近 0 | **`dsh-memory watchdog`** standalone process keeps web alive — port probe + auto-restart + counter + graceful shutdown. Steady-state ~47 MB RAM / ~0% CPU |
+| **`autoMcpSetup` 默认改 false + `autoWebMode` 三档（init/interval/manual）+ `watchdogAutoSpawn` 默认 false** ——v0.5.7 起部署强度配置化，默认最保守，零外部副作用；显式开启才动外部配置 / spawn watchdog | **`autoMcpSetup` defaults to false + `autoWebMode` (init/interval/manual) + `watchdogAutoSpawn` defaults to false** — v0.5.7 makes deployment intensity configurable, conservative defaults, no external side effects unless explicitly enabled |
+| **`GET /memory-eternal/api/setup-status`** 只读查询各 agent MCP 配置 + hook + node 路径一致性；Web UI 顶部面板一图看清三个 agent 状态 | **`GET /memory-eternal/api/setup-status`** — read-only check of each agent's MCP config + hook + node path consistency; Web UI panel shows all three agents at a glance |
+| **OpenAI 兼容 LLM 适配器** 自动蒸馏用外部端点可配（DeepSeek / Ollama / vLLM / LM Studio），无配置时降级为原文卡 | **OpenAI-compatible LLM adapter** for distillation — works with DeepSeek / Ollama / vLLM / LM Studio; graceful fallback to raw cards when unconfigured |
+| **降级路径捕获** 独立进程（无 DSH 环境）import `@deepseek-ai/dsh-llm` 失败时本地 fallback shim | **DSH-free fallback shim** — independent processes no longer require `@deepseek-ai/dsh-llm` |
+| **`api.js` 抽层** DSH 与独立 web server 共用同一份 API 实现 | **`api.js` extracted** — DSH and standalone web server share the exact same API layer |
+
+### 🛠 整理与工具 · Optimization & tooling
+
+| 中文 | English |
+|---|---|
+| **「⚡ 一键优化」按钮** 整理建议面板顶部新增，可选 checkbox「同时清理陈旧卡」，调 `POST /memory-eternal/api/optimize-execute` | **"⚡ One-click optimize" button** on the Organize panel — optional "Also clean stale" checkbox, calls new `POST /memory-eternal/api/optimize-execute` |
+| **记忆窗口控制条** 侧边栏「记忆」浮窗右上角新增全屏切换 + 关闭 × 按钮（半透明背景 + blur） | **Window controls** in DSH sidebar memory popup — fullscreen toggle + close × in top-right (translucent + blur) |
+| **CLI stdin 流式读修复** Windows cmd 重定向下 `fs.readFileSync(0)` 偶发空字符串，已改为 data/end 流式收集 + readableEnded 兜底 | **CLI stdin stream fix** — replaces unreliable `fs.readFileSync(0)` on Windows with data/end + readableEnded fallback |
+
+### 🩺 质量 · Quality
+
+- **40/40 单元测试全绿**（vault 19 + capture 13 + api 8）/ **All 40 unit tests green**（vault 19 + capture 13 + api 8）
+- **`npm publish` 一键化**：commit → tag → npm → 双端 push → gh release 全自动 / **One-button publish**: commit → tag → npm → push to GitHub + Gitee → gh release
+- **DSH Market 收录徽章** README 顶部，按官方 issue 反馈挂上 / **DSH Market listing badge** on README top, per official issue guidance
+
+### 🐛 v0.5.x bugfixes
+
+| 版本 | 修复 | Version | Fix |
+|---|---|---|---|
+| v0.5.1 | `positional()` 修正 —— 任意 `--flag` 都跳过下一项 | v0.5.1 | `positional()` fix — any `--flag` skips next token |
+| v0.5.2 | capture stdin `fs.readFileSync(0)` → 流式读 | v0.5.2 | stdin `fs.readFileSync(0)` → stream reader |
+| v0.5.3 | capture stdin 流式读 Windows 重定向下偶发空 → `readableEnded` + setTimeout 兜底 | v0.5.3 | stdin stream Windows redirect edge case → `readableEnded` + setTimeout fallback |
+
+---
+
 ## 📦 发布记录
 
+- **v0.5.7**：**服务自管理配置化**——`autoMcpSetup` 默认改 false（不碰外部配置）；新增 `autoWebMode`（init/interval/manual）+ `webPort`/`webCheckIntervalMs`/`webMaxRestart`/`watchdogAutoSpawn` 字段；index.js 按模式分层启停（init 拉一次 / interval DSH 进程内 setInterval / manual 仅 ensure）；新增 `GET /memory-eternal/api/setup-status` 只读路由；Web UI 顶部加「外部 Agent MCP 挂载状态」面板（claude-code/Codex/Cursor 配置 + hook + node 路径一致性）。
+- **v0.5.5**：`dsh-memory watchdog` 子命令 + `lib/watchdog.js`（独立保活 web server，端到端验证：杀 web 子进程 4s 后 watchdog 自动复活）
+- **v0.5.4**：README 顶部新增 DSH Market 收录徽章（按 [Issue #76](https://github.com/2BingLing/dsh-market/issues/76) 官方建议）
+- **v0.5.3**：capture stdin 改回流式 data/end + `readableEnded` 兜底（Node 22/24 Windows cmd 重定向下 `fs.readFileSync(0)` 偶发空字符串）
+- **v0.5.2**：capture stdin `fs.readFileSync(0)` 同步读修复
+- **v0.5.1**：`positional()` 修正——所有 `--flag` 都跳过下一项，避免 stdin 路径下 `--source` 的 value 被误当作位置参数
 - **v0.5.0**：**多宿主化**——MCP server 零依赖 stdio（3 工具：recall/capture/stats），CLI 入口 `dsh-memory`（recall/capture/serve/open/mcp/setup/sweep），Web 端常驻（DSH 渲染走 iframe = 单一 UI 真源），自动挂载到 Claude Code/Codex/Cursor（幂等+备份），Claude Code SessionEnd hook 自动沉淀，卡格式 `formatVersion` 守卫，DSH 用户 / Claude Code 用户均「一条命令安装即用」。`api.js` 抽层 + `capture-run.js` 独立沉淀管线复用。
 - **v0.4.28**：侧边栏底部「记忆」按钮**独占一行**——不再与「主题」等 footer 按钮挤在同一行（`flex-wrap` 同时命中直接包含与中间隔 wrapper 两种情况）。
 - **v0.4.27**：新建卡片 kind 下拉可读背景色；图谱合并/删除节点后**即时联动整理建议**面板刷新。

package/index.js

@@ -17,6 +17,10 @@
 import { promises as fs } from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+const __filename = fileURLToPath(import.meta.url)
+const PACKAGE_ROOT = path.resolve(path.dirname(__filename))
 import z from '@deepseek-ai/schemastery'
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import { ensureVault, search, generateDailyBrief } from './lib/vault.js'
@@ -47,9 +51,20 @@ export const Config = z.object({
   // 会话级 token 预算（字符），供 harness 触发压缩/轮换；记忆侧提供估算与阈值
   sessionBudgetChars: z.number().default(80000),
   // 多宿主：激活时自动把 MCP 挂载到本机已装的 Claude Code/Codex/Cursor（幂等，
-  // MEMORY_ETERNAL_SKIP_AUTO=1 可完全禁用）；web server 默认常驻（UI 唯一真源）。
-  autoMcpSetup: z.boolean().default(true),
+  // MEMORY_ETERNAL_SKIP_AUTO=1 可完全禁用）。**默认 false**——不碰外部配置，需要时显式开启。
+  autoMcpSetup: z.boolean().default(false),
   autoWeb: z.boolean().default(true),
+  // web server 保活模式：
+  //   init    = DSH 激活时拉起一次（默认；最低开销，DSH 死后 web 仍活但无人看守）
+  //   interval= DSH 进程内 setInterval 周期探活+自动拉起（额外 0 内存；DSH 死则停保活）
+  //   manual  = 完全不自动拉起；只在 `dsh-memory open` 时 ensure-alive（最保守）
+  autoWebMode: z.enum(['init', 'interval', 'manual']).default('init'),
+  webPort: z.number().min(1).max(65535).default(7999),
+  webCheckIntervalMs: z.number().min(1000).max(600000).default(5000),
+  webMaxRestart: z.number().min(1).max(1000).default(10),
+  // 是否 spawn 独立 watchdog 进程（与 DSH 解耦，7×24 保活；额外 ~47 MB 常驻）
+  // 默认 false——DSH 进程内 setInterval 已足够常规用法
+  watchdogAutoSpawn: z.boolean().default(false),
 })
 
 const API_PREFIX = '/memory-eternal/api'
@@ -279,22 +294,88 @@ export function apply(ctx, config) {
     })
   }
 
-  // -- 4. 多宿主常驻：自动挂载 MCP + web server 保活 -------------------------
+  // -- 4. 多宿主常驻：MCP 挂载 + web server 保活（按设置项分层） -----------------
   // 全部后台异步、静默失败：插件激活不能被外部环境问题卡住。
+  let intervalTimer = null
+  let watchdogProc = null
   ctx.effect(() => {
     const cfg0 = settings.get() ?? {}
-    if (cfg0.enabled !== false && cfg0.autoMcpSetup !== false && process.env.MEMORY_ETERNAL_SKIP_AUTO !== '1') {
+    if (cfg0.enabled === false) return () => {}
+
+    // (1) MCP 自动挂载：默认关闭；只有用户显式开启才动外部配置。
+    if (cfg0.autoMcpSetup === true && process.env.MEMORY_ETERNAL_SKIP_AUTO !== '1') {
       import('./lib/setup.js')
         .then((m) => m.runSetup({ log: () => {} }))
         .catch(() => {})
     }
-    if (cfg0.enabled !== false && cfg0.autoWeb !== false) {
-      import('./lib/web.js')
-        .then((m) => m.ensureWebServer({ vaultRoot: vaultDir() }))
-        .then(refreshWebInfo)
-        .catch((error) => console.error('[memory-eternal] web server failed:', error?.message || error))
+
+    // (2) web server：根据 autoWeb + autoWebMode 决策
+    const mode = cfg0.autoWebMode || 'init'
+    const port = Number(cfg0.webPort) || 7999
+    const ensureOpts = { port, vaultRoot: vaultDir() }
+    const ensureWeb = () => import('./lib/web.js')
+      .then((m) => m.ensureWebServer(ensureOpts))
+      .then((info) => { refreshWebInfo(info); return info })
+      .catch((error) => console.error('[memory-eternal] web server failed:', error?.message || error))
+
+    if (cfg0.autoWeb === true) {
+      if (mode === 'manual') {
+        // manual：不自动拉起；只在 dsh-memory open / WebFrame 触发 ensure
+        import('./lib/web.js')
+          .then((m) => m.probeWebServer(port))
+          .then((alive) => { if (alive) refreshWebInfo({ url: `http://127.0.0.1:${port}`, port, spawned: false }) })
+          .catch(() => {})
+      } else if (mode === 'init') {
+        // init：拉起一次（首次）；之后不管（用户已设了，那看门狗都不开）
+        ensureWeb()
+      } else if (mode === 'interval') {
+        // interval：DSH 进程内 setInterval 周期保活
+        const intervalMs = Number(cfg0.webCheckIntervalMs) || 5000
+        const maxRestart = Number(cfg0.webMaxRestart) || 10
+        let restartCount = 0
+        const tick = async () => {
+          if (restartCount >= maxRestart) {
+            console.error(`[memory-eternal] web 已连续重启 ${maxRestart} 次，停止保活`)
+            if (intervalTimer) { clearInterval(intervalTimer); intervalTimer = null }
+            return
+          }
+          const alive = await import('./lib/web.js').then((m) => m.probeWebServer(port)).catch(() => null)
+          if (!alive) {
+            restartCount++
+            console.error(`[memory-eternal] web 离线 → 第 ${restartCount}/${maxRestart} 次拉起`)
+            await ensureWeb()
+          } else {
+            // 探到活则重置计数
+            restartCount = 0
+          }
+        }
+        // 立即跑一次（首启 + 间隔循环）
+        ensureWeb()
+        intervalTimer = setInterval(tick, intervalMs)
+      }
+    }
+
+    // (3) 看门狗独立进程：默认不 spawn；开启时启动一个与 DSH 解耦的 node watchdog。
+    if (cfg0.watchdogAutoSpawn === true && cfg0.autoWeb !== false) {
+      import('./lib/watchdog.js')
+        .then((m) => {
+          const port = Number(cfg0.webPort) || 7999
+          const wd = spawn(
+            process.execPath,
+            [path.join(PACKAGE_ROOT, 'lib', 'watchdog.js'), '--port', String(port), '--interval', String(cfg0.webCheckIntervalMs || 5000), '--max-restart', String(cfg0.webMaxRestart || 10)],
+            { detached: true, stdio: 'ignore', env: { ...process.env, MEMORY_VAULT_DIR: vaultDir() }, windowsHide: true },
+          )
+          wd.unref()
+          watchdogProc = wd
+          console.error(`[memory-eternal] watchdog spawned pid=${wd.pid} port=${port}`)
+        })
+        .catch(() => {})
+    }
+
+    return () => {
+      if (intervalTimer) { clearInterval(intervalTimer); intervalTimer = null }
+      // 注意：watchdog 进程是独立的，故意不杀（7×24 用法）—— 配置改变由下次重启 DSH 时重新 spawn 替换
     }
-    return () => {}
   }, 'memory-eternal: multi-host ensure')
 
   // 首次激活时确保 vault 目录存在。

package/lib/api.js

@@ -12,6 +12,7 @@
 
 import { listCards, readCard, search, searchAll, graph, graphAll, overview, exportCards, deleteCard, writeCard, parseCard, stats, optimizeCandidates, optimizeApply, addFeedback, dailyBrief, dailyCounts, mergeCards, ensureVault } from './vault.js'
 import { compressExcerpt } from './capture.js'
+import { getSetupStatus } from './setup.js'
 
 export const API_PREFIX = '/memory-eternal/api'
 
@@ -150,6 +151,12 @@ export function createApi(deps = {}) {
         json(res, 200, result)
         return
       }
+      case '/setup-status': {
+        // 只读查询各 agent MCP 配置状态，不写任何文件
+        const status = await getSetupStatus()
+        json(res, 200, status)
+        return
+      }
       case '/feedback': {
         let raw = ''
         for await (const chunk of req) raw += chunk