@furongjun1999/dsh-memory 0.4.7 → 0.4.9

package/dsh/cordis.yml.example

@@ -3,13 +3,18 @@
 #
 # 说明：
 # - !!js process.env.X 语法在加载期求值，密钥不入库
-# - 记忆写入路径（下面 mdcg.root）默认锚定**插件仓自身** data/，与进程 cwd
-#   解耦——历史事故：cwd 落在别的仓时，相对路径会把记忆真源写偏。目录不存在
-#   会自动创建。想换位置有三种方式（优先级由高到低）：
+# - 记忆写入路径（下面 mdcg.root）默认落在**用户级状态根**（~/.dsh/.dsh-memory/data），
+#   与进程 cwd、**插件包目录**都解耦——历史事故①：cwd 落在别的仓时相对路径会把
+#   记忆真源写偏；事故②：默认曾锚定插件包内 data/，而 pnpm 更新包会整目录替换，
+#   包内数据每次更新成功即被删掉（详见 src/lib/datapath.ts 头注）。目录不存在会
+#   自动创建。想换位置有三种方式（优先级由高到低）：
 #     ① 环境变量 MDCG_DATA_ROOT（数据根）/ MDCG_ROOT（认知图根）
-#     ② 编辑 <插件仓>/data/paths.json 的 "data_root" / "root"
+#     ② 编辑 <用户级状态根>/paths.json 的 "data_root" / "root"
+#        （旧版包内 data/paths.json 仍兼容读，但会被下次 pnpm 更新删除）
 #     ③ 本文件的 mdcg.root（填绝对路径或相对插件仓的路径）
 #   查当前解析结果：python md_cg/datapath.py
+#   旧版数据迁移：包内 data/ 仍有内容时，插件首启会**复制**（不删除）到用户级根；
+#   也可手动执行 python md_cg/datapath.py --migrate-legacy
 
 - id: lingshu-memory
   name: '@furongjun1999/dsh-memory'
@@ -108,9 +113,10 @@
     mdcg:
       enabled: true
       # root = 记忆写入路径（用户可改）。留空 '' = 走解析优先级，默认落在
-      # **插件仓自身** data/mdcg（与 cwd 解耦）：
-      #   env MDCG_ROOT > data/paths.json 的 "root" > 本项 > 默认 <插件仓>/data/mdcg
-      # 想换位置：填绝对路径（如 'D:/lingshu/mdcg'），或改 data/paths.json。
+      # **用户级状态根** data/mdcg（与 cwd、插件包目录都解耦）：
+      #   env MDCG_ROOT > <用户级状态根>/paths.json 的 "root" > 本项
+      #   > 默认 ~/.dsh/.dsh-memory/data/mdcg
+      # 想换位置：填绝对路径（如 'D:/lingshu/mdcg'），或改 paths.json。
       root: ''
       actor: 'dsh-memory'        # MDCG_ACTOR：私有内容按 (tenant, actor) 派生 DEK
       tenant: 'default'          # MDCG_TENANT：须与迁移脚本 --tenant 一致

package/dsh/hive-mcp-probe.mjs

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * hive-mcp-probe.mjs —— 用 DSH 自带的 @modelcontextprotocol/sdk 直接连一次蜂巢 MCP server。
+ *
+ * 目的：在不动 DSH 进程的前提下，验证「DSH 的 mcp-client 会看到什么」。
+ *   - 用与 dsh-mcp-client 同一个 SDK（版本一致）走 stdio 握手
+ *   - tools/list → 工具名与入参 schema
+ *   - tools/call hive_doctor → serve 存活与任务统计
+ *   - （可选）tools/call hive_spawn → 真提交一个任务，证明写路径通
+ *
+ * 用法：node dsh/hive-mcp-probe.mjs [--spawn]
+ * 依赖环境变量（可覆盖）：DSH_ROOT、HIVE_REPO、HIVE_LIB、MDCG_ROOT
+ *   DSH_ROOT  = DSH 安装目录（其下含 node_modules/@modelcontextprotocol/sdk）
+ *   HIVE_REPO = dsh-memory 仓绝对路径
+ *   HIVE_LIB  = 认知图库仓绝对路径（追加进 PYTHONPATH）
+ *   MDCG_ROOT = 认知图根
+ * 四个值未设置且脚本内仍为占位符时直接报错退出——本仓是公开仓，不硬编码本机路径。
+ */
+const DSH_ROOT = (process.env.DSH_ROOT || '<REPLACE_WITH_DSH_INSTALL_DIR>').replace(/\\/g, '/')
+const REPO = process.env.HIVE_REPO || '<REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory>'
+const LIB = process.env.HIVE_LIB || '<REPLACE_WITH_ABSOLUTE_PATH_TO_mdcg_lib>'
+const MDCG_ROOT = process.env.MDCG_ROOT || '<REPLACE_WITH_ABSOLUTE_PATH_TO_MDCG_ROOT>'
+
+const PH = { DSH_ROOT, HIVE_REPO: REPO, HIVE_LIB: LIB, MDCG_ROOT }
+const missing = Object.entries(PH).filter(([, v]) => v.includes('REPLACE_WITH'))
+if (missing.length) {
+  console.error('[ABORT] 以下参数仍是占位符，请用同名环境变量覆盖后重跑：' + missing.map(([k]) => k).join(', '))
+  process.exit(1)
+}
+
+const SDK = 'file:///' + DSH_ROOT + '/node_modules/@modelcontextprotocol/sdk/dist/esm'
+const { Client } = await import(SDK + '/client/index.js')
+const { StdioClientTransport } = await import(SDK + '/client/stdio.js')
+
+const doSpawn = process.argv.includes('--spawn')
+
+const transport = new StdioClientTransport({
+  command: 'python',
+  args: ['-m', 'hive.hive_mcp.mcp_server'],
+  cwd: REPO,
+  env: {
+    ...process.env,
+    PYTHONPATH: REPO + ';' + LIB,
+    PYTHONUTF8: '1',
+    PYTHONIOENCODING: 'utf-8',
+    MDCG_ROOT,
+  },
+})
+
+const client = new Client({ name: 'dsh-hive-probe', version: '1.0.0' })
+await client.connect(transport)
+console.log('[OK] MCP 握手成功（stdio）')
+console.log('serverInfo =', JSON.stringify(client.getServerVersion?.() ?? {}))
+
+const listed = await client.listTools()
+console.log('[OK] tools/list 返回 ' + listed.tools.length + ' 个工具：')
+for (const t of listed.tools) {
+  console.log('  - ' + t.name + '  参数：' + Object.keys(t.inputSchema?.properties ?? {}).join(', '))
+}
+
+const doc = await client.callTool({ name: 'hive_doctor', arguments: {} })
+const docText = (doc.content ?? []).map((c) => c.text ?? '').join('')
+console.log('[OK] hive_doctor →')
+console.log('  ' + docText.slice(0, 900).replace(/\n/g, '\n  '))
+
+if (doSpawn) {
+  const tag = 'HIVE_MCP_OK_' + Date.now()
+  const sp = await client.callTool({ name: 'hive_spawn', arguments: {
+    model: 'deepseek-flash',
+    user_prompt: 'Reply with exactly this token and nothing else: ' + tag,
+    max_tokens: 2000,
+  } })
+  const spText = (sp.content ?? []).map((c) => c.text ?? '').join('')
+  console.log('[OK] hive_spawn → ' + spText.slice(0, 400))
+  const jobId = (spText.match(/h\d+_[0-9a-f]+/) || [])[0]
+  if (jobId) {
+    let last = ''
+    for (let i = 0; i < 60; i++) {
+      await new Promise((r) => setTimeout(r, 3000))
+      const pl = await client.callTool({ name: 'hive_poll', arguments: { job_id: jobId } })
+      const txt = (pl.content ?? []).map((c) => c.text ?? '').join('')
+      const st = (txt.match(/"state"\s*:\s*"([a-z]+)"/) || [])[1]
+      if (st !== last) { console.log('  poll ' + jobId + ' state=' + st); last = st }
+      if (['done', 'error', 'timeout', 'killed'].includes(st)) {
+        console.log('[RESULT] ' + txt.slice(0, 1200))
+        console.log('[CHECK] 令牌往返 ' + (txt.includes(tag) ? '通过（content 含 ' + tag + '）' : '未在片段中看到令牌，读全文确认'))
+        break
+      }
+    }
+  }
+}
+
+await client.close()
+console.log('[DONE] 探针结束')

package/dsh/hive-mcp.example.yml

@@ -0,0 +1,62 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# 蜂巢（hive）MCP 接入 · DSH 端配置样例（本机实测通过 2026-09-17）
+#
+#   作用：把 hive 的 4 个工具变成 DSH 原生工具，交给模型直接调用：
+#     mcp__hive__hive_spawn   提交 LLM 任务（毫秒返回 job_id，蜂巢后台并发执行）
+#     mcp__hive__hive_poll    查状态 / 读结果（含 handoff_ready 交回信号）
+#     mcp__hive__hive_kill    写 kill 标志强杀（worker ≤1s 生效）
+#     mcp__hive__hive_doctor  体检：serve 存活 / 任务统计 / env 资格列
+#
+#   放置位置：$DSH_HOME/profiles/<profile>/cordis.patch.yml（用户 patch 层，追加即可）
+#
+#   ⚠️ 必须包在 `- insert:` 里。用户 patch 层的裸条目 `- id: xxx` 语义是「覆盖已
+#      有行的 config」；对不存在的 id **不生效，而且不报错**。实测：裸写 mcp-hive
+#      后 `dsh --profile web --dump-config` 里查无此行、stderr 也为空；改成
+#      `- insert: [...]` 后立刻出现在 dump 里。
+#
+#   前置依赖（一次性）：
+#     1) profile 需能解析 @deepseek-ai/dsh-mcp-client（DSH 自带此包，用 link: 指过去）：
+#        {"@deepseek-ai/dsh-mcp-client": "link:<你的 DSH 安装目录>/node_modules/@deepseek-ai/dsh-mcp-client"}
+#        再用 pnpm install --lockfile-only 同步 lockfile（只写 lockfile，不动 node_modules）。
+#        node_modules 下的目录实体与其它 link: 依赖同形（Windows Junction），可手工补齐：
+#          New-Item -ItemType Junction -Path <profile>\\node_modules\\@deepseek-ai\\dsh-mcp-client -Target <上面的路径>
+#        （DSH 运行中跑 pnpm install 会被 <profile>\\node_modules\\@furongjun1999\\dsh-memory
+#          的目录锁挡住报 EPERM；用 Junction 可绕开，因为不重命名任何目录。）
+#     2) 生效时机：profile 的 patchReload 默认 "startup" → 改完要**重启 DSH**才加载。
+#
+#   实测要点（2026-09-17 本机，全部有回显证据）：
+#     · mcp-client 会清洗宿主环境变量：只继承 APPDATA / HOMEDRIVE / HOMEPATH /
+#       LOCALAPPDATA / PATH / PROCESSOR_ARCHITECTURE / SYSTEMDRIVE / SYSTEMROOT /
+#       TEMP / USERNAME / USERPROFILE / PROGRAMFILES 这 12 个
+#       （@modelcontextprotocol/sdk 的 stdio.js::DEFAULT_INHERITED_ENV_VARS）。
+#       → PYTHONPATH / PYTHONUTF8 必须在这里显式声明，否则
+#         `python -m hive.hive_mcp.mcp_server` 直接 ModuleNotFoundError。
+#     · hive/ 是 python 包；`-m hive.hive_mcp.mcp_server` 要求 PYTHONPATH 指向仓根。
+#     · serve 未存活时 hive_spawn 会自动拉起（复用 serve_start.start()）。该路径的
+#       env = MCP 进程 env + hive/config.local.json；而 config.local.json 里
+#       HIVE_API_KEY 的来源写作 {"env": "DEEPSEEK_API_KEY"} → 必须把
+#       DEEPSEEK_API_KEY 传下来，否则自动拉起的是「没钥匙的 serve」，任务必失败。
+#     · 验收（端到端）：mcp__hive__hive_spawn 提交 → mcp__hive__hive_poll 轮询到
+#       done。实测 job h1789598763792_32c0aa：claimed→running→done 5.77s，
+#       content 与提示词约定的令牌逐字相同，且 serve 由本次 spawn 自动拉起。
+#     · 可用 `node dsh/hive-mcp-probe.mjs` 在不动 DSH 的前提下单独验证 server 侧。
+#     · 本文件是公开仓模板：下面 4 个 <REPLACE_WITH_...> 占位符须换成你自己的
+#       绝对路径（正斜杠写法），否则客户端会以错误 cwd/PYTHONPATH 启动 server。
+# ─────────────────────────────────────────────────────────────────────────────
+- insert:
+    - id: mcp-hive
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: hive
+        transport: stdio
+        command: python
+        args: ['-m', 'hive.hive_mcp.mcp_server']
+        cwd: '<REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory>'
+        env:
+          PYTHONPATH: '<REPLACE_WITH_ABSOLUTE_PATH_TO_dsh-memory>;<REPLACE_WITH_ABSOLUTE_PATH_TO_mdcg_lib>'
+          PYTHONUTF8: '1'
+          PYTHONIOENCODING: 'utf-8'
+          MDCG_ROOT: '<REPLACE_WITH_ABSOLUTE_PATH_TO_MDCG_ROOT>'
+          DEEPSEEK_API_KEY: !!js process.env.DEEPSEEK_API_KEY
+        toolCallTimeoutMs: 60000
+        failOnStartupError: false

package/dsh/update-lingshu.bat

@@ -0,0 +1,11 @@
+@echo off
+rem ============================================================
+rem update-lingshu.bat - 灵枢插件一键更新（占位：逻辑在 update-lingshu.ps1）
+rem ============================================================
+setlocal
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0update-lingshu.ps1" %*
+set RC=%ERRORLEVEL%
+echo.
+if "%RC%"=="0" (echo [OK] update finished.) else (echo [FAILED] exit %RC% - see %TEMP%\update-lingshu.log)
+pause
+endlocal

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,14 @@
  * 模型请求组装 system prompt 时自动注入灵枢最近记忆
  * （`stg(op=timeline)`，最近记忆节点时间线），让记忆"自动可用"而不只依赖
  * Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
+ * ⚠️ 该注入块的**稳定性**决定宿主是否新追加快照：内容没变时也必须照旧 push
+ * （宿主按渲染后的整段文本去重）；跳过 push 反而会各追加一份「有块/无块」的快照
+ * —— 详见 installMemoryHooks 里的长注释。
+ *
+ * ⚠️ 注入文本**必经** escapePromptBraces（src/lib/prompt_safety.ts，issue #16）：
+ * 宿主对 context 文本做严格 `{{variable}}` 插值，裸 `{{` 会让每轮 assemble 抛错
+ * → 会话永久不可用（记忆永久在库，非偶发）。记忆真源不动，只在**注入副本**上
+ * 打断 `{{`——新增任何 push context/section 的代码，同样必须过这道转义。
  */
 import '@deepseek-ai/dsh-session';
 import '@deepseek-ai/dsh-system-prompt';

package/lib/hooks.js

@@ -21,9 +21,18 @@
  * 模型请求组装 system prompt 时自动注入灵枢最近记忆
  * （`stg(op=timeline)`，最近记忆节点时间线），让记忆"自动可用"而不只依赖
  * Agent 主动调用 recall/think 工具。失败静默（不影响请求）。
+ * ⚠️ 该注入块的**稳定性**决定宿主是否新追加快照：内容没变时也必须照旧 push
+ * （宿主按渲染后的整段文本去重）；跳过 push 反而会各追加一份「有块/无块」的快照
+ * —— 详见 installMemoryHooks 里的长注释。
+ *
+ * ⚠️ 注入文本**必经** escapePromptBraces（src/lib/prompt_safety.ts，issue #16）：
+ * 宿主对 context 文本做严格 `{{variable}}` 插值，裸 `{{` 会让每轮 assemble 抛错
+ * → 会话永久不可用（记忆永久在库，非偶发）。记忆真源不动，只在**注入副本**上
+ * 打断 `{{`——新增任何 push context/section 的代码，同样必须过这道转义。
  */
 import '@deepseek-ai/dsh-session';
 import '@deepseek-ai/dsh-system-prompt';
+import { escapePromptBraces } from './lib/prompt_safety.js';
 /** 从 ContentBlock[] 提取纯文本。 */
 function extractText(blocks) {
     const parts = [];
@@ -94,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 条"里越靠前的越可能被用到；线性等宽分配
@@ -125,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）时自动记忆整体停用：记忆真源是
@@ -164,27 +159,35 @@ 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}}`）必须保真落库，故只在注入副本上打断 `{{`。
                         assembly.contexts.push({
                             name: 'lingshu:auto-recall',
-                            text: `【灵枢最近记忆】\n${text.slice(0, RECALL_MAX_CHARS)}`,
+                            text: escapePromptBraces(`【灵枢最近记忆】\n${text.slice(0, RECALL_MAX_CHARS)}`),
                         });
                     }
-                    else {
-                        skippedSincePush += 1;
-                    }
                 }
             }
             catch { /* 静默：召回失败不影响请求 */ }