@furongjun1999/dsh-memory 0.4.8 → 0.4.9

package/dsh/update-lingshu.ps1

@@ -0,0 +1,337 @@
+#Requires -Version 5.1
+<#
+  update-lingshu.ps1 —— 灵枢大脑（@furongjun1999/dsh-memory）一键更新
+
+  为什么需要它（2026-09-16 实测得到的三条教训）：
+    1) 目录锁：pnpm 装新版本的最后一步是把 dsh-memory_tmp_NNN 重命名成 dsh-memory。
+       只要 DSH 主进程还活着（工作目录锚在这个包内），Windows 就拒绝重命名，
+       报 EPERM ... rename ... dsh-memory_tmp_NNN。所以更新前必须先停 DSH。
+    2) 发布龄闸门：pnpm 有供应链 minimumReleaseAge 策略，刚发布的版本默认解析不进来，
+       必须在 pnpm-workspace.yaml 的 minimumReleaseAgeExclude 里显式放行，
+       否则 pnpm 会安静地"更新成功"，版本号却一动不动。
+    3) 慢网：本机到 registry.npmjs.org 可能只有几十 KB/s，27MB 的包会撞上 pnpm 默认
+       60s 下载超时。本脚本改用 curl 断点续传 + sha512 校验，再按文件覆盖安装
+       （不重命名目录），最后逐文件哈希核对与发布包是否一致。
+
+  用法：
+    update-lingshu.bat                            双击：更新到 npm 最新版并重启 DSH
+    powershell -File update-lingshu.ps1 -DryRun   只看要做什么，不落任何修改
+    powershell -File update-lingshu.ps1 -NoRestart
+    powershell -File update-lingshu.ps1 -UsePnpm  走 pnpm 官方安装路线（慢网可能超时）
+    powershell -File update-lingshu.ps1 -Tarball C:\path\dsh-memory-0.4.9.tgz
+    powershell -File update-lingshu.ps1 -Force    已是最新也重装一遍
+
+  日志：%TEMP%\update-lingshu.log
+#>
+[CmdletBinding()]
+param(
+  [string]$Profile = 'web',
+  [switch]$NoRestart,
+  [switch]$DryRun,
+  [switch]$Force,
+  [switch]$UsePnpm,
+  [string]$Tarball = ''
+)
+
+$ErrorActionPreference = 'Stop'
+
+$Pkg         = '@furongjun1999/dsh-memory'
+$ProfileDir  = Join-Path $env:USERPROFILE ('.dsh\profiles\' + $Profile)
+$PluginDir   = Join-Path $ProfileDir 'node_modules\@furongjun1999\dsh-memory'
+$WsFile      = Join-Path $ProfileDir 'pnpm-workspace.yaml'
+$PkgJson     = Join-Path $ProfileDir 'package.json'
+$LogFile     = Join-Path $env:TEMP 'update-lingshu.log'
+$Stamp       = Get-Date -Format 'yyyyMMdd-HHmmss'
+$script:TargetVersion = ''
+$script:Stopped       = $false
+
+function Log {
+  param([string]$m, [string]$c = 'Gray')
+  $line = '[' + (Get-Date -Format 'HH:mm:ss') + '] ' + $m
+  Write-Host $line -ForegroundColor $c
+  try { Add-Content -Path $LogFile -Value $line -Encoding UTF8 } catch { }
+}
+
+function Get-InstalledVersion {
+  $p = Join-Path $PluginDir 'package.json'
+  if (-not (Test-Path $p)) { return '' }
+  $m = [regex]::Match((Get-Content $p -Raw -Encoding UTF8), '"version"\s*:\s*"([^"]+)"')
+  if ($m.Success) { return $m.Groups[1].Value }
+  return ''
+}
+
+function Get-LatestVersion {
+  $v = (& npm view $Pkg version 2>$null | Out-String).Trim()
+  if ($v -notmatch '^\d+\.\d+\.\d+') { throw ('无法从 npm 取到最新版本（返回: ' + $v + '）') }
+  return $v
+}
+
+function Get-NpmIntegrity {
+  param([string]$Version)
+  $v = (& npm view ($Pkg + '@' + $Version) dist.integrity 2>$null | Out-String).Trim()
+  if ($v -notmatch '^sha512-') { throw ('无法取到 ' + $Version + ' 的 dist.integrity，拒绝在无法校验的情况下覆盖安装') }
+  return $v
+}
+
+function Get-FileSha512 {
+  param([string]$Path)
+  $hex = (Get-FileHash $Path -Algorithm SHA512).Hash
+  $bytes = New-Object byte[] ($hex.Length / 2)
+  for ($i = 0; $i -lt $hex.Length; $i += 2) { $bytes[$i / 2] = [Convert]::ToByte($hex.Substring($i, 2), 16) }
+  return 'sha512-' + [Convert]::ToBase64String($bytes)
+}
+
+function Set-ReleaseGate {
+  param([string]$Version)
+  $text = Get-Content $WsFile -Raw -Encoding UTF8
+  $pattern = "(?m)^(\s*-\s*'?)" + [regex]::Escape($Pkg) + "@([^'\r\n]*)('?)\s*$"
+  $m = [regex]::Match($text, $pattern)
+  if ($m.Success) {
+    $list = $m.Groups[2].Value
+    $has = $false
+    foreach ($v in ($list -split '\|\|')) { if ($v.Trim() -eq $Version) { $has = $true } }
+    if ($has) {
+      Log ('发布龄闸门已放行 ' + $Version)
+    } elseif ($DryRun) {
+      Log ('[dry-run] 将把 ' + $Version + ' 追加进 minimumReleaseAgeExclude')
+    } else {
+      $new = $m.Groups[1].Value + $Pkg + '@' + $list.Trim() + ' || ' + $Version + $m.Groups[3].Value
+      $text = $text.Replace($m.Value, $new)
+      Log ('已放行发布龄闸门: ' + $Pkg + '@' + $Version)
+    }
+  } else {
+    if ($text -match '(?m)^minimumReleaseAgeExclude:') {
+      throw 'pnpm-workspace.yaml 的 minimumReleaseAgeExclude 不是单行列表，请手动把最新版本加进去'
+    }
+    if ($DryRun) {
+      Log '[dry-run] 将新增 minimumReleaseAgeExclude 段落'
+    } else {
+      $text = $text.TrimEnd() + [Environment]::NewLine + 'minimumReleaseAgeExclude:' + [Environment]::NewLine + "  - '" + $Pkg + '@' + $Version + "'" + [Environment]::NewLine
+      Log '已新增 minimumReleaseAgeExclude 放行条目'
+    }
+  }
+  if ($text -notmatch '(?m)^fetchTimeout:') {
+    if ($DryRun) {
+      Log '[dry-run] 将把 pnpm 下载超时放宽到 900s（慢网必需）'
+    } else {
+      $text = $text.TrimEnd() + [Environment]::NewLine + 'fetchTimeout: 900000' + [Environment]::NewLine
+      Log '已把 pnpm 下载超时放宽到 900s（慢网必需）'
+    }
+  }
+  if (-not $DryRun) { [System.IO.File]::WriteAllText($WsFile, $text, (New-Object System.Text.UTF8Encoding($false))) }
+}
+
+function Set-ProfileRange {
+  param([string]$Version)
+  $text = Get-Content $PkgJson -Raw -Encoding UTF8
+  $pattern = '("' + [regex]::Escape($Pkg) + '"\s*:\s*")(?<v>[^"]*)(")'
+  $m = [regex]::Match($text, $pattern)
+  if (-not $m.Success) { throw ('profile package.json 里没有 ' + $Pkg + '，请先用 dsh plugin --profile ' + $Profile + ' add 安装') }
+  $old = $m.Groups['v'].Value
+  $newRange = '^' + $Version
+  if ($old -eq $newRange) {
+    Log ('依赖区间已是 ' + $newRange)
+    return
+  }
+  if ($DryRun) {
+    Log ('[dry-run] 将把依赖区间 ' + $old + ' 改成 ' + $newRange)
+    return
+  }
+  $text = $text.Replace($m.Value, $m.Groups[1].Value + $newRange + $m.Groups[3].Value)
+  [System.IO.File]::WriteAllText($PkgJson, $text, (New-Object System.Text.UTF8Encoding($false)))
+  Log ('依赖区间 ' + $old + ' → ' + $newRange)
+}
+
+function Sync-Lockfile {
+  if ($DryRun) { Log '[dry-run] 将执行 pnpm install --lockfile-only'; return }
+  Push-Location $ProfileDir
+  try {
+    $o = (& pnpm install --lockfile-only 2>&1 | Out-String)
+    if ($LASTEXITCODE -eq 0) {
+      Log 'lockfile 已同步到目标版本'
+    } else {
+      Log 'lockfile 同步失败（不致命，稍后由安装步骤兜底）' 'Yellow'
+    }
+  } catch {
+    Log ('lockfile 同步异常: ' + $_.Exception.Message) 'Yellow'
+  } finally { Pop-Location }
+}
+
+function Get-Tarball {
+  param([string]$Version, [string]$Hint, [string]$Integrity)
+  if ($Hint -ne '') {
+    if (-not (Test-Path $Hint)) { throw ('指定的 tarball 不存在: ' + $Hint) }
+    $full = (Get-Item $Hint).FullName
+    if ((Get-FileSha512 $full) -ne $Integrity) { throw ('本地 tarball 的 sha512 与 registry 不一致: ' + $full) }
+    Log ('使用本地 tarball: ' + $full + '（sha512 校验通过）')
+    return $full
+  }
+  $out = Join-Path $env:TEMP ('lingshu-' + $Version + '.tgz')
+  if (Test-Path $out) {
+    if ((Get-FileSha512 $out) -eq $Integrity) { Log ('复用已缓存且校验通过的 tarball: ' + $out); return $out }
+    Remove-Item $out -Force
+  }
+  $short = $Pkg.Substring($Pkg.IndexOf('/') + 1)
+  $url = 'https://registry.npmjs.org/' + $Pkg + '/-/' + $short + '-' + $Version + '.tgz'
+  if ($DryRun) {
+    Log ('[dry-run] 将断点续传下载 ' + $url + ' 并校验 sha512')
+    return $out
+  }
+  for ($i = 1; $i -le 15; $i++) {
+    & curl.exe -sS -L -C - -o $out --retry 3 --retry-delay 3 --max-time 900 --connect-timeout 30 $url 2>$null
+    $sz = 0
+    if (Test-Path $out) { $sz = (Get-Item $out).Length }
+    if ((Test-Path $out) -and ((Get-FileSha512 $out) -eq $Integrity)) {
+      Log ('tarball 下载完成并校验通过: ' + [math]::Round($sz / 1MB, 2) + ' MB')
+      return $out
+    }
+    Log ('  第 ' + $i + ' 次下载未完（' + [math]::Round($sz / 1MB, 2) + ' MB），继续断点续传…')
+    Start-Sleep -Seconds 3
+  }
+  throw '下载 tarball 失败（网络过慢）。可手动下载后用 -Tarball 指定本地文件'
+}
+
+function Stop-Holders {
+  param([bool]$IncludeDsh)
+  $n = 0
+  $procs = Get-CimInstance Win32_Process -Filter "name='node.exe' or name='python.exe' or name='pythonw.exe'" -ErrorAction SilentlyContinue
+  foreach ($p in $procs) {
+    $cl = [string]$p.CommandLine
+    if ($cl -eq '') { continue }
+    $kill = $false
+    if ($cl -match 'md_cg') { $kill = $true }
+    if ($IncludeDsh -and ($cl -match '@deepseek-ai[\\/]dsh')) { $kill = $true }
+    if ($kill) {
+      try {
+        Stop-Process -Id $p.ProcessId -Force -ErrorAction Stop
+        Log ('  已结束 pid=' + $p.ProcessId)
+        $n++
+      } catch {
+        Log ('  pid=' + $p.ProcessId + ' 结束失败（可能已退出）')
+      }
+    }
+  }
+  return $n
+}
+
+function Install-Overlay {
+  param([string]$Tgz, [string]$Version)
+  $stage = Join-Path $env:TEMP ('lingshu-stage-' + $Version)
+  if (Test-Path $stage) { Remove-Item $stage -Recurse -Force }
+  New-Item -ItemType Directory -Path $stage -Force | Out-Null
+  Log '  解包发布包…'
+  & tar.exe -xzf $Tgz -C $stage
+  $src = Join-Path $stage 'package'
+  if (-not (Test-Path (Join-Path $src 'package.json'))) { throw '解包结果缺少 package/package.json' }
+  $m = [regex]::Match((Get-Content (Join-Path $src 'package.json') -Raw -Encoding UTF8), '"version"\s*:\s*"([^"]+)"')
+  if (-not $m.Success -or $m.Groups[1].Value -ne $Version) { throw ('发布包内版本不是 ' + $Version) }
+  $suspect = Get-ChildItem $src -Recurse -File -Force | Where-Object { $_.Name -in @('_keys.json', '_audit.jsonl', '_index.json', '_refindex.json') }
+  if ($suspect) { throw ('发布包内出现不应发布的运行时文件: ' + $suspect[0].FullName) }
+  Log '  覆盖写入插件目录（不重命名目录，DSH 开着也能装）…'
+  & robocopy $src $PluginDir /E /NFL /NDL /NJH /NJS /NP /R:2 /W:1 | Out-Null
+  Log '  逐文件哈希核对…'
+  $bad = New-Object System.Collections.ArrayList
+  $all = Get-ChildItem $src -Recurse -File -Force
+  foreach ($f in $all) {
+    $rel = $f.FullName.Substring($src.Length + 1)
+    $dst = Join-Path $PluginDir $rel
+    if (-not (Test-Path $dst)) { [void]$bad.Add('缺失 ' + $rel); continue }
+    if ((Get-Item $dst).Length -ne $f.Length) { [void]$bad.Add('大小不符 ' + $rel); continue }
+    if ((Get-FileHash $dst -Algorithm SHA256).Hash -ne (Get-FileHash $f.FullName -Algorithm SHA256).Hash) { [void]$bad.Add('内容不符 ' + $rel) }
+  }
+  if ($bad.Count -gt 0) { throw ('覆盖后核对失败 ' + $bad.Count + ' 个文件，例如: ' + $bad[0]) }
+  Log ('  核对通过: ' + $all.Count + ' 个文件与发布包逐字节一致')
+}
+
+function Install-WithPnpm {
+  Push-Location $ProfileDir
+  try {
+    for ($i = 1; $i -le 6; $i++) {
+      Log ('  pnpm update（第 ' + $i + ' 次）…')
+      $o = (& pnpm update 2>&1 | Out-String)
+      $v = Get-InstalledVersion
+      if ($v -eq $script:TargetVersion) { return $true }
+      Log ('  本轮结果仍为 ' + $v + '，重试前再清一次占锁子进程…')
+      [void](Stop-Holders -IncludeDsh:$false)
+      Start-Sleep -Seconds 3
+    }
+    return $false
+  } finally { Pop-Location }
+}
+
+function Start-Dsh {
+  $bat = Join-Path $PluginDir 'dsh\dsh-web-start.bat'
+  if (-not (Test-Path $bat)) { Log ('找不到启动脚本: ' + $bat) 'Yellow'; return }
+  Log '启动 DSH…'
+  Start-Process -FilePath $bat -WorkingDirectory (Split-Path $bat) | Out-Null
+  Log 'DSH 已在新窗口启动；浏览器访问 http://127.0.0.1:3080'
+}
+
+# ============================ 主流程 ============================
+Log '===== 灵枢一键更新 ====='
+Log ('profile 目录: ' + $ProfileDir)
+if ($DryRun) { Log '运行模式: DryRun（不落任何修改）' 'Yellow' }
+
+try {
+  if (-not (Test-Path $PluginDir)) { throw ('找不到插件目录: ' + $PluginDir) }
+  $cur = Get-InstalledVersion
+  $script:TargetVersion = Get-LatestVersion
+  Log ('当前版本 ' + $cur + '  →  npm 最新 ' + $script:TargetVersion)
+
+  if ($cur -eq $script:TargetVersion -and -not $Force -and $Tarball -eq '') {
+    Log '已经是最新版本，未做任何修改。' 'Green'
+    exit 0
+  }
+
+  if (-not $DryRun) {
+    Copy-Item $WsFile ($WsFile + '.pre-update-' + $Stamp) -Force
+    Copy-Item $PkgJson ($PkgJson + '.pre-update-' + $Stamp) -Force
+    Log ('已备份 profile 配置（后缀 pre-update-' + $Stamp + '）')
+  }
+
+  Log '--- 1/5 放行发布龄闸门 + 声明目标版本 ---'
+  Set-ReleaseGate -Version $script:TargetVersion
+  Set-ProfileRange -Version $script:TargetVersion
+
+  Log '--- 2/5 同步 lockfile（只写 lockfile，不动目录）---'
+  Sync-Lockfile
+
+  Log '--- 3/5 准备发布包（sha512 校验）---'
+  $integrity = Get-NpmIntegrity $script:TargetVersion
+  $tgz = Get-Tarball -Version $script:TargetVersion -Hint $Tarball -Integrity $integrity
+  if ($DryRun) {
+    Log '--- DryRun 结束：以上动作均未执行 ---' 'Yellow'
+    Log ('完整日志: ' + $LogFile)
+    exit 0
+  }
+
+  Log '--- 4/5 停 DSH 与 md_cg 子进程（释放目录锁）---'
+  $killed = Stop-Holders -IncludeDsh:$true
+  $script:Stopped = $killed -gt 0
+  Log ('共结束 ' + $killed + ' 个进程；等待文件句柄释放…')
+  Start-Sleep -Seconds 3
+
+  Log '--- 5/5 安装 ---'
+  $ok = $false
+  if ($UsePnpm) {
+    $ok = Install-WithPnpm
+    if (-not $ok) { Log 'pnpm 路线未成功，改用发布包覆盖安装…' 'Yellow' }
+  }
+  if (-not $ok) { Install-Overlay -Tgz $tgz -Version $script:TargetVersion }
+  $final = Get-InstalledVersion
+  if ($final -ne $script:TargetVersion) { throw ('安装后版本仍为 ' + $final + '，预期 ' + $script:TargetVersion) }
+  Log ('安装完成: ' + $cur + ' → ' + $final) 'Green'
+
+  if ($NoRestart) {
+    Log '按 -NoRestart 未重启 DSH，请手动运行 dsh\dsh-web-start.bat' 'Yellow'
+  } else {
+    Start-Dsh
+  }
+  Log ('完整日志: ' + $LogFile)
+  exit 0
+} catch {
+  Log ('[失败] ' + $_.Exception.Message) 'Red'
+  Log ('完整日志: ' + $LogFile) 'Red'
+  if ($script:Stopped -and -not $NoRestart) { Log '尝试把 DSH 重新拉起来…' 'Yellow'; Start-Dsh }
+  exit 1
+}

package/lib/hooks.d.ts

@@ -21,6 +21,9 @@
  * 模型请求组装 system prompt 时自动注入灵枢最近记忆
  * （`stg(op=timeline)`，最近记忆节点时间线），让记忆"自动可用"而不只依赖
  * Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
+ * ⚠️ 该注入块的**稳定性**决定宿主是否新追加快照：内容没变时也必须照旧 push
+ * （宿主按渲染后的整段文本去重）；跳过 push 反而会各追加一份「有块/无块」的快照
+ * —— 详见 installMemoryHooks 里的长注释。
  *
  * ⚠️ 注入文本**必经** escapePromptBraces（src/lib/prompt_safety.ts，issue #16）：
  * 宿主对 context 文本做严格 `{{variable}}` 插值，裸 `{{` 会让每轮 assemble 抛错

package/lib/hooks.js

@@ -21,6 +21,9 @@
  * 模型请求组装 system prompt 时自动注入灵枢最近记忆
  * （`stg(op=timeline)`，最近记忆节点时间线），让记忆"自动可用"而不只依赖
  * Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
+ * ⚠️ 该注入块的**稳定性**决定宿主是否新追加快照：内容没变时也必须照旧 push
+ * （宿主按渲染后的整段文本去重）；跳过 push 反而会各追加一份「有块/无块」的快照
+ * —— 详见 installMemoryHooks 里的长注释。
  *
  * ⚠️ 注入文本**必经** escapePromptBraces（src/lib/prompt_safety.ts，issue #16）：
  * 宿主对 context 文本做严格 `{{variable}}` 插值，裸 `{{` 会让每轮 assemble 抛错
@@ -100,8 +103,6 @@ const RECALL_MIN_CHARS = 24;
 const RECALL_MAX_CHARS = 1400;
 /** 永久层不自动注入（按需用 mdcg_recall / lingshu_stg 取）。 */
 const RECALL_SKIP_LAYERS = new Set(['anchor', 'self']);
-/** 连续跳过多少步后强制补一次（内容未变也刷新，防止压缩归档后块消失）。 */
-const RECALL_REPUSH_EVERY = 8;
 /** 分级递减渲染：按距当前的次序逐档收窄，早期条目信息量更大。
  *
  *  动机：注入块总长受限，而"最近 N 条"里越靠前的越可能被用到；线性等宽分配
@@ -131,18 +132,6 @@ function formatTimelineDecayed(payload) {
     }
     return out.join('\n').slice(0, RECALL_MAX_CHARS);
 }
-/** 去重：内容与上次相同就不再 push 新副本。
- *
- *  背景：本钩子挂在 `system-prompt/assemble` 上，每个 step 都会 push 一份，而每份
- *  都会留成独立的 surface 节点 → 同一块累积 N 份（实测 11 份 ≈2700 tok/请求），
- *  随步数线性增长。去重后同一块只占 1 份，外加每 RECALL_REPUSH_EVERY 步一次自愈刷新。 */
-function shouldPushRecall(text, lastText, skippedSincePush) {
-    if (!text)
-        return false;
-    if (text !== lastText)
-        return true;
-    return skippedSincePush >= RECALL_REPUSH_EVERY;
-}
 /** 安装自动记忆钩子（effect 作用域内，随插件卸载自动移除）。
  *
  *  mdcg 为 null（config.mdcg.enabled=false）时自动记忆整体停用：记忆真源是
@@ -170,19 +159,27 @@ export function installMemoryHooks(ctx, mdcg, opts) {
     };
     // P1 完善（自动 recall 注入）：每次模型请求组装 system prompt 时，注入灵枢最近记忆。
     // 用 system-prompt/assemble 事件（waterfall）而非 llm/stream——后者请求 deep-frozen 不可改写。
+    //
+    // ⚠️ 必须**每步都 push**，哪怕内容与上一步逐字节相同。原因在宿主侧（dsh-agent-loop 的
+    // RuntimeContextProjection）：assembly.contexts 会被渲染成一段「运行时上下文快照」，
+    // 每个 step 拿渲染后的**整段文本**与上一份已提交的快照比对，**只有不同才**在会话里
+    // append 一条新的 user/message（append 语义，旧的不会被替换或移除）。于是：
+    //   · 内容不变 + 照旧 push → 渲染文本不变 → 宿主不追加任何东西（零开销、零增长）；
+    //   · 内容不变 + 跳过 push → 渲染文本**变了**（少了本块）→ 宿主追加一份「没有本块」的
+    //     快照；下一步再 push 又把本块加回来 → **再**追加一份。跳过一次反而多花两份快照
+    //     （实测每份 ~250 tok），这正是 v0.4.8「每 8 步强制补一次」的自愈刷新会把长会话的
+    //     inject 推到 30k+ tok 的原因。
+    // 因此本实现把「要不要补」交还给宿主：压缩归档后宿主会把 retained 置空并重新投影快照
+    // （RuntimeContextProjection 的 retained === null 分支），本块自然跟着回来——
+    // 不需要插件自己数步数做自愈。
     if (opts.autoRecall) {
         const recallLimit = Math.max(1, Math.min(10, opts.autoRecallLimit || 4));
-        // 去重状态：同一块内容只保留一份 surface 节点，避免随步数线性增长。
-        let lastRecallText = '';
-        let skippedSincePush = 0;
         ctx.on('system-prompt/assemble', async (assembly, _ctx, next) => {
             try {
                 // 异步取最近记忆节点（失败静默——不阻塞模型请求）
                 if (graph.isReady()) {
                     const text = formatTimelineDecayed(await graph.timeline(recallLimit));
-                    if (shouldPushRecall(text, lastRecallText, skippedSincePush)) {
-                        lastRecallText = text;
-                        skippedSincePush = 0;
+                    if (text) {
                         // 注入边界转义（issue #16）：宿主 system-prompt 对 context 文本做严格
                         // `{{variable}}` 插值，裸 `{{` 会 throw → 该轮请求整体失败。记忆原文
                         // （含用户命令里的 `{{.X}}`）必须保真落库，故只在注入副本上打断 `{{`。
@@ -191,9 +188,6 @@ export function installMemoryHooks(ctx, mdcg, opts) {
                             text: escapePromptBraces(`【灵枢最近记忆】\n${text.slice(0, RECALL_MAX_CHARS)}`),
                         });
                     }
-                    else {
-                        skippedSincePush += 1;
-                    }
                 }
             }
             catch { /* 静默：召回失败不影响请求 */ }

package/lib/index.d.ts

@@ -17,8 +17,10 @@
  *   name: '@furongjun1999/dsh-memory'
  *   config:
  *     mdcg:                              # 记忆真源：认知图（md 文档）
- *       # root = 记忆写入路径（用户可改）。缺省 = 插件仓自身 data/mdcg。
- *       # 覆盖优先级：env MDCG_ROOT > <插件仓>/data/paths.json > 本项 > 默认
+ *       # root = 记忆写入路径（用户可改）。缺省 = 用户级状态根 data/mdcg
+ *       #   （~/.dsh/.dsh-memory/data/mdcg；**不在插件包内**——包内数据会被
+ *       #    pnpm 更新连目录一起删掉，见 src/lib/datapath.ts 头注）
+ *       # 覆盖优先级：env MDCG_ROOT > <用户级状态根>/paths.json > 本项 > 默认
  *       # root: 'D:/somewhere/mdcg'        # 例：把记忆库放到别处
  *       actor: 'dsh-memory'
  *     env:                               # 写入凭据：默认【关闭】，由你决定是否打开

package/lib/index.js

@@ -17,8 +17,10 @@
  *   name: '@furongjun1999/dsh-memory'
  *   config:
  *     mdcg:                              # 记忆真源：认知图（md 文档）
- *       # root = 记忆写入路径（用户可改）。缺省 = 插件仓自身 data/mdcg。
- *       # 覆盖优先级：env MDCG_ROOT > <插件仓>/data/paths.json > 本项 > 默认
+ *       # root = 记忆写入路径（用户可改）。缺省 = 用户级状态根 data/mdcg
+ *       #   （~/.dsh/.dsh-memory/data/mdcg；**不在插件包内**——包内数据会被
+ *       #    pnpm 更新连目录一起删掉，见 src/lib/datapath.ts 头注）
+ *       # 覆盖优先级：env MDCG_ROOT > <用户级状态根>/paths.json > 本项 > 默认
  *       # root: 'D:/somewhere/mdcg'        # 例：把记忆库放到别处
  *       actor: 'dsh-memory'
  *     env:                               # 写入凭据：默认【关闭】，由你决定是否打开
@@ -50,7 +52,7 @@ import { installMemoryHooks } from './hooks.js';
 // LIB 本地库：角色扮演网页 / 互维维护 / 白箱 LLM 适配器统一收在 src/lib/。
 import { installRoleplayWeb } from './lib/roleplay_web.js';
 import { MdcgClient } from './lib/mdcg_client.js';
-import { describeDataPaths, mdcgRoot } from './lib/datapath.js';
+import { describeDataPaths, migrateLegacyData, mdcgRoot, repoRoot } from './lib/datapath.js';
 // 写入凭据密钥环（首启引导）：显式配置 → ~/.mdcg/token → 首启自动签发。
 import { resolveToken } from './lib/token_store.js';
 /**
@@ -118,8 +120,9 @@ export const Config = z.object({
         .default({ enabled: false, heartbeatMs: 10 * 60 * 1000 }),
     /** 认知图（md_cg）：记忆唯一真源。
      *  root 为**记忆写入路径**（用户可改）。缺省空串 = 未指定，按优先级解析：
-     *    ① env MDCG_ROOT ② `<插件仓>/data/paths.json` 的 root
-     *    ③ 本项 ④ 默认 `<插件仓>/data/mdcg`
+     *    ① env MDCG_ROOT ② `<用户级状态根>/paths.json` 的 root
+     *    （旧 `<插件仓>/data/paths.json` 兼容读）
+     *    ③ 本项 ④ 默认 `<用户级状态根>/data/mdcg`
      *  相对路径一律相对**插件仓根**解析——历史教训：相对 cwd 的相对路径随
      *  宿主 cwd 漂移，cwd 落在别仓时记忆真源分裂成互不可见的两处。
      *  tenant/actor 决定私有内容加解密的身份：与 migrate_roleplay 的
@@ -193,13 +196,33 @@ export async function apply(ctx, config) {
             timeoutMs: config.toolCallTimeoutMs,
             maxRetryDelayMs: config.maxRetryDelayMs,
         });
+        // 数据面迁出插件包（issue #18 相邻问题）：旧版把运行时数据与路径配置写在包内
+        // `<pkg>/data`，pnpm 更新会连目录一起替换（实机实证：data/ 54 文件 → 0，
+        // 46 条记忆节点靠人工备份回填）。首启把「旧位置仍有货」的数据**复制**到用户级
+        // 数据根；必须在 mdcg.start() 之前——store 要在 Python 子进程接管前就位。
+        const migrated = migrateLegacyData();
+        if (migrated.ran) {
+            ctx.logger.info(`dsh-memory: 数据面已迁出插件包（旧位置只复制未删除）：`
+                + `${migrated.from} → ${migrated.to}（${migrated.copied} 项`
+                + `${migrated.failed.length ? `，失败 ${migrated.failed.join(',')}` : ''}）`);
+        }
         mdcg.start();
         // 启动留痕：把「记忆真源在哪、由谁决定、路径是否存在」写进可审计日志，
         // 避免再次出现「以为在记忆、其实写到了别仓」的静默分裂（历史事故）。
         const dp = describeDataPaths(config.mdcg.root);
         ctx.logger.info(`dsh-memory: 记忆真源路径 = ${dp.mdcgRoot}（来源 ${dp.source}，`
-            + `dataRoot=${dp.dataRoot}，存在=${dp.mdcgRootExists ? '是' : '否（首次写入将创建）'}，`
+            + `状态根=${dp.stateRoot}，dataRoot=${dp.dataRoot}，`
+            + `存在=${dp.mdcgRootExists ? '是' : '否（首次写入将创建）'}，`
             + `用户可改：${dp.pathsFile}）`);
+        // 包管理器装的插件 + 路径配置还在旧包内位置：pnpm 下次更新会把该文件连目录一起
+        // 删除，用户配置随之丢失（回落默认根 → 表现为「记忆不见了」）。只在真的会被删的
+        // 布局下提醒（开发用的 git clone 不含 node_modules 段 → 不打扰）。
+        const pnpmManaged = repoRoot().split(/[\\/]/).includes('node_modules');
+        if (pnpmManaged && String(dp.pathsFileSource) === 'legacy') {
+            ctx.logger.warn(`dsh-memory: 路径配置仍在插件包内（${dp.pathsFile}）——pnpm 更新该包会连目录`
+                + `一起删除。请复制到 ${String(dp.stateRoot)}/paths.json 后重启`
+                + `（数据面已自动复制到 ${String(dp.dataRoot)}）。`);
+        }
         brainReady = await mdcg.waitReady();
         if (brainReady) {
             ctx.logger.info(`dsh-memory: 认知图已就绪（MDCG_ROOT=${resolvedRoot}）`);

package/lib/lib/datapath.d.ts

@@ -2,9 +2,84 @@ export declare const ENV_DATA_ROOT = "MDCG_DATA_ROOT";
 export declare const ENV_MDCG_ROOT = "MDCG_ROOT";
 /** 插件仓根目录：自本模块所在目录向上找 package.json（对构建层级不敏感）。 */
 export declare function repoRoot(): string;
-/** 用户可编辑的路径配置文件（固定在插件仓 data/，不受 dataRoot 取值影响）。 */
+export declare const ENV_STATE_ROOT = "MDCG_STATE_ROOT";
+/**
+ * 用户级状态根（**插件包目录之外**）：路径配置与默认数据根的落点。
+ * 优先级：`MDCG_STATE_ROOT` → `$DSH_HOME/.dsh-memory` → `~/.dsh/.dsh-memory`。
+ * `DSH_HOME` **未必**由宿主注入（本仓 `dsh/dsh-web-start.bat` 自行 set），
+ * 故家目录兜底；`~/.dsh` 是本插件既有约定（`bridge.ts` 调试日志同址）。
+ */
+export declare function stateRoot(): string;
+/** 旧版落点（插件包内 `data/`）——更新时会被整个替换，只作兼容读与迁移源。 */
+export declare function legacyDataRoot(): string;
+/**
+ * 用户可编辑的路径配置文件：
+ *   `<用户级状态根>/paths.json` → 不存在则回落**旧** `<插件仓>/data/paths.json`
+ *   （兼容读）→ 都不存在返回新位置（首次写入时创建）。
+ * 不做自动复制：配置文件是「谁说了算」的唯一真源，悄悄复制会让旧件的后续编辑
+ * 静默失效——迁移只搬数据面，配置显式交给用户搬（或用 `set_user_root`）。
+ */
 export declare function pathsFile(): string;
+/** 生效中的 paths.json 位置来源：`user`=用户级 / `legacy`=旧包内（兼容读）。 */
+export declare function pathsFileSource(): 'user' | 'legacy';
+/** 默认数据根 = 用户级状态根下 `data/`（**插件包目录之外**，更新不触碰）。 */
 export declare function defaultDataRoot(): string;
+export interface LegacyMigration {
+    /** 是否真的搬了（false 时 `reason` 说明为何没搬）。 */
+    ran: boolean;
+    reason: string;
+    from: string;
+    to: string;
+    /** 复制成功的顶层条目数。 */
+    copied: number;
+    /** 复制失败的顶层条目（权限/占用等，逐项吞掉不抛）。 */
+    failed: string[];
+}
+/**
+ * 一次性迁移：把旧版留在**插件包内** `data/` 的数据面复制到用户级默认数据根。
+ *
+ * 触发条件（三条同时满足，缺一不动）：
+ *   ① 数据根未被显式配置（env `MDCG_DATA_ROOT` / paths.json 的 `data_root` 都未设，
+ *      即 `dataRoot()` 恰为默认值）——显式配置是用户的决定，越权搬运等于改他的真源；
+ *   ② 旧位置存在；
+ *   ③ 目标顶层条目不存在或为空目录（**不覆盖、不合并**已有数据）。
+ *
+ * 只复制不删除（旧目录随后由 pnpm 更新自然移除）；`paths.json` 不复制
+ * （配置走 `pathsFile()` 兼容读，复制会制造「哪个文件说了算」的两说）。
+ * 任何异常逐项吞掉并记入 `failed`——迁移是增益，不该成为启动失败源。
+ *
+ * 边界（如实）：pnpm 更新是**先替换包目录再启动新代码**，故旧数据在升级瞬间
+ * 即已消失，本函数只能接手「旧位置那时仍在」的情形（手工安装、就地覆盖、
+ * 或包目录未被清理）；已在升级中丢掉的数据无法由此恢复——发布说明须提示
+ * 0.4.8 及更早用户升级前备份 `<profile>/node_modules/<pkg>/data/`。
+ */
+export declare function migrateLegacyData(): LegacyMigration;
+export declare const ENV_CHILD_CWD = "MDCG_CHILD_CWD";
+/**
+ * 子进程的工作目录（**必须落在插件包目录之外**）。
+ *
+ * 为什么不能沿用 `repoRoot()`：Windows 不允许删除／改名「正被某进程当作 CWD」
+ * 的目录。DSH 的插件按 hoisted 布局安装在 `<profile>/node_modules/<pkg>`，
+ * 而 `pnpm` 每次更新该包都要先 `rmdir` 包目录 → 子进程一旦把包目录当 CWD，
+ * 更新必然 `ERR_PNPM_EBUSY: resource busy or locked`（含升级回滚一起失败，
+ * 应用内永远升不动这个插件）。注意落点也**不能**是 `<包>/data`——它仍在包内，
+ * 实测同样 `err=32`。
+ *
+ * 落点要求「稳定存在」：进程 cwd 指向已消失的目录会引出新的怪问题，故按稳定度
+ * 排候选目录，取**第一个能建成**的：
+ *   1. `MDCG_CHILD_CWD`（显式覆盖）
+ *   2. `$DSH_HOME/.dsh-memory/run`
+ *   3. `~/.dsh/.dsh-memory/run` —— 家目录兜底：`DSH_HOME` **未必**由宿主注入
+ *      （本仓 `dsh/dsh-web-start.bat` 是自行 `set DSH_HOME=%USERPROFILE%\.dsh`），
+ *      而 `~/.dsh` 是本插件既有约定（`bridge.ts` 调试日志、`token_store` 密钥环同址）
+ *   4. 系统临时目录（可能被清理，故排最后）
+ * 全部建不成时不抛错，交给 spawn 报错——cwd 落点只是防呆，不该成为启动失败源。
+ *
+ * 安全性：`python -m` 的模块解析由 `pythonPathValue()` 的 PYTHONPATH 独立保证，
+ * 不依赖 cwd；已实测 cwd=包目录 与 cwd=包外 时，MCP initialize 握手与
+ * tools/list 工具面（33 个工具）完全一致。
+ */
+export declare function runRoot(): string;
 /** 数据根（记忆/账本/运行态的父目录）。 */
 export declare function dataRoot(): string;
 /**