@a9i5k4/dsh-auto-memory 2.1.4 → 2.1.6

package/lib/index.js

@@ -35,6 +35,7 @@ import { createActivationHost } from './activation-host.js'
 import { createJsSemanticEnginePre, createSemanticDownloaderPre, fuseD6Pre, probeJsSemanticAssets, deepScanPeerTransformers, E5_SMALL_Q8_MANIFEST_V1 } from './semantic-js.js'
 import { loadAndVerifyPolicy, decideActivationV2, lexicalContainment } from './semantic-decide.js'
 import { createPythonSidecarClientPre, defaultWorkerScriptPathPre } from './python-sidecar-client.js'
+import { createPythonSetupPre } from './python-setup.js'
 import { createEpisodicStorePre } from './episodic-store.js'
 import { createFactStorePre } from './fact-store.js'
 import { createProcedureStorePre } from './procedure-store.js'
@@ -93,6 +94,12 @@ export const API = {
   notices: '/api/dsh-auto-memory/notices',
   'activation-inbox': '/api/dsh-auto-memory/activation-inbox',
   'semantic-status': '/api/dsh-auto-memory/semantic-status',
+  'py-setup-detect': '/api/dsh-auto-memory/python-setup/detect',
+  'py-setup-venv': '/api/dsh-auto-memory/python-setup/venv',
+  'py-setup-deps': '/api/dsh-auto-memory/python-setup/deps',
+  'py-setup-model': '/api/dsh-auto-memory/python-setup/model',
+  'py-setup-cancel': '/api/dsh-auto-memory/python-setup/cancel',
+  'py-setup-status': '/api/dsh-auto-memory/python-setup/status',
   'semantic-deep-detect': '/api/dsh-auto-memory/semantic-deep-detect',
   'handoff-state': '/api/dsh-auto-memory/handoff-state',
   'semantic-download': '/api/dsh-auto-memory/semantic-download',
@@ -1228,7 +1235,7 @@ class MemoryEngine {
       if (!agent || typeof agent !== 'object') return 0
       const runtime = this.resolveObserverRuntime(agent)
       if (!runtime || runtime.disposed) return 0
-      const events = agent.session && Array.isArray(agent.session.events) ? agent.session.events : []
+      const events = sessionEventsOf(agent && agent.session)
       const capped = events.length > SEED_REPLAY_MAX_EVENTS ? events.slice(-SEED_REPLAY_MAX_EVENTS) : events
       this._observerStats.seedTruncatedEvents += events.length - capped.length
       let seeded = 0
@@ -1578,7 +1585,7 @@ class MemoryEngine {
       // compaction 事件感知:harness 刚发生 compaction/summary|prune → 无论水位,立即补写交接材料
       let compacted = false
       try {
-        const events = (agent.session && agent.session.events) || []
+        const events = sessionEventsOf(agent && agent.session)
         for (let i = Math.max(0, events.length - 64); i < events.length; i++) {
           const t = events[i] && events[i].type
           if (t === 'compaction/summary' || t === 'compaction/prune') {
@@ -2256,6 +2263,78 @@ class MemoryEngine {
     return true
   }
 
+  /**
+   * F1(M6-CONTRACT 外补丁,2026-08-23):anchor 开启时的记录级压缩。
+   * 按 sidecar 记录序整条保留/移除——今天(标题日期=插件今天)记录无条件保留,其余按字节配额
+   * 从最新往回保留(layer 上限 user 4000/note 3000);被移除记录整条原文写入归档文件
+   * (writeFullRaw,不经 anchor 事务,归档非检索语料)。重组经 store.replace 原子执行:
+   * 候选预检(clean)→被移除 id 自动删除→保留 id/版本不变。永不字符切片。
+   * @returns {Promise<boolean|'not-anchored'>} true=已腾位 false=无法腾位 'not-anchored'=无 sidecar 走旧路径
+   */
+  async compactAnchoredLayer(store, filePath, layer, today, paths) {
+    const cur = await this.readTextSafe(filePath)
+    if (!cur || !cur.trim()) return false
+    let parsed
+    try { parsed = parseAnchors(Buffer.from(cur, 'utf8')) } catch (_) { return 'not-anchored' }
+    if (!parsed || parsed.status !== 'clean') return false // 脏文件 fail closed:不压缩、不切片
+    const anchored = parsed.records.filter((r) => r.kind === 'anchored')
+    if (!anchored.length) return 'not-anchored'
+    const limit = layer === 'user' ? 4000 : 3000
+    const isTodayHeading = (heading) => /^\d{4}-\d{2}-\d{2}/.test(String(heading || '')) && String(heading).slice(0, 10) === today
+    const buf = Buffer.from(cur, 'utf8')
+    // 配额从尾回溯(F1):新的留;今天记录无条件保留
+    const keep = new Array(anchored.length).fill(false)
+    let keptBytes = 0
+    for (let i = anchored.length - 1; i >= 0; i--) {
+      const rec = anchored[i]
+      const spanBytes = rec.byteEnd - rec.markerByteStart
+      if (isTodayHeading(rec.heading) || keptBytes + spanBytes <= limit) { keep[i] = true; keptBytes += spanBytes }
+    }
+    const removedIdx = []
+    anchored.forEach((rec, i) => { if (!keep[i]) removedIdx.push(i) })
+    if (!removedIdx.length) return false // 无可移除 → 无法腾位(预算照常拒绝)
+    // 有序块重组:legacy 块与 preamble/tail 原样保留,gap 字节逐段拷贝,仅丢弃被移除记录的 [marker..contentEnd]
+    const blocks = []
+    for (const r of parsed.records) {
+      if (r.kind === 'anchored') blocks.push({ start: r.markerByteStart, end: r.byteEnd, keep: keep[anchored.indexOf(r)] })
+      else blocks.push({ start: r.byteStart, end: r.byteEnd, keep: true })
+    }
+    blocks.sort((a, b) => a.start - b.start)
+    const parts = []
+    let cursorB = 0
+    for (let i = 0; i < blocks.length; i++) {
+      const b = blocks[i]
+      if (b.start > cursorB) parts.push(buf.slice(cursorB, b.start).toString('utf8'))
+      if (b.keep) parts.push(buf.slice(b.start, b.end).toString('utf8'))
+      cursorB = b.end
+    }
+    if (cursorB < buf.length) parts.push(buf.slice(cursorB).toString('utf8'))
+    const newText = parts.join('')
+    // 归档:整条原文(writeFullRaw 绕开 anchor 事务;归档文件从不参与解析/索引)
+    const archiveFile = layer === 'user'
+      ? path.join(dshHome(), 'memory', 'archived-user.md')
+      : path.join(paths.projectDir, 'archive', 'notes-archived.md')
+    const archiveText = removedIdx.map((i2) => {
+      const r = anchored[i2]
+      return buf.slice(r.markerByteStart, r.byteEnd).toString('utf8')
+    }).join('\n')
+    const existingArchive = await this.readTextSafe(archiveFile)
+    await this.writeFullRaw(archiveFile, (existingArchive ? existingArchive.replace(/\s+$/, '') + '\n' : '') + archiveText + '\n')
+    const rr = await store.replace(filePath, newText)
+    if (!rr.ok) { console.error('[compacted-anchored] replace failed: ' + rr.reason); return false }
+    const freshText = await this.readTextSafe(filePath)
+    if (layer === 'user') this.state.userText = freshText
+    else this.state.notesText = freshText
+    if (this._budgets) {
+      const b = this._budgets.get('today')
+      if (b && b.date === this.memToday()) b[layer] = 0
+    }
+    this._lastCompactAt = Date.now()
+    this.state.loadedAt = Date.now()
+    console.log('[compacted-anchored] ' + layer + ': kept=' + (anchored.length - removedIdx.length) + '/' + anchored.length + ' archived=' + removedIdx.length + ' bytes=' + cur.length + '->' + newText.length)
+    return true
+  }
+
   // ---------- 注入渲染(同步,基于缓存) ----------
   // 动态记忆 → ctx.systemPrompt.context()(user-role 快照):内容变化才追加新快照,内容不变不重复注入(dsh-agent-loop project() 去重),
   // system prompt 不再包含动态内容 → 字节级稳定 → DeepSeek 前缀缓存全程命中(对比 section 方案:动态内容任何变化都从变化点起击穿整个前缀,含全部历史)
@@ -2291,6 +2370,17 @@ class MemoryEngine {
     if (cfg.waterLevelAdvisory !== false && !this.isUnattendedNow() && (s.waterLevelRatio || 0) >= (Number(cfg.waterLevelThreshold) || 0.8) && Date.now() - (s.waterLevelAt || 0) < 600000) {
       lines.push('\n' + L('snapshotWaterTitle') + '\n' + L('snapshotWaterBody', { pct: Math.round((s.waterLevelRatio || 0) * 100) }))
     }
+    // M-CM1 交接白板:PLAN.md 全貌+最新交接账本,动态快照首位(动态层内容,不碰静态字节;敏感段清洗+行边界硬预算截断)
+    if (cfg.handoffEnabled !== false && (s.planText || s.latestHandoffText)) {
+      const planPart = truncateLinesBounded(stripSensitiveSections(sanitizeForInjection(s.planText || '')), Math.max(Number(cfg.handoffPlanChars) || 1200, 200))
+      if (planPart) lines.push('\n' + L('snapshotPlanTitle') + '\n' + planPart)
+      const ledgerPart = truncateLinesBounded(stripSensitiveSections(sanitizeForInjection(s.latestHandoffText || '')), Math.max(Number(cfg.handoffLedgerChars) || 800, 200))
+      if (ledgerPart) lines.push('\n' + L('snapshotHandoffTitle') + '\n' + ledgerPart)
+    }
+    // M-CM4/M-CM5 水位建议:越阈注入交接+派子代理建议(advisory;10 分钟新鲜度;无人值守静默)
+    if (cfg.waterLevelAdvisory !== false && !this.isUnattendedNow() && (s.waterLevelRatio || 0) >= (Number(cfg.waterLevelThreshold) || 0.8) && Date.now() - (s.waterLevelAt || 0) < 600000) {
+      lines.push('\n' + L('snapshotWaterTitle') + '\n' + L('snapshotWaterBody', { pct: Math.round((s.waterLevelRatio || 0) * 100) }))
+    }
     let used = 0
     const part = (title, text, max) => {
       if (!text) return
@@ -3208,7 +3298,7 @@ class MemoryEngine {
       const a = agentSvc.get(best.id)
       if (a && a.session && a.session.header && a.session.header.parentSession === undefined) {
         this._lastAgent = a
-        diag('restoreLastAgent: recovered agent id=' + a.id + ' session=' + a.session.id + ' logEvents=' + ((a.session.events && a.session.events.length) || 0))
+        diag('restoreLastAgent: recovered agent id=' + a.id + ' session=' + a.session.id + ' logEvents=' + sessionEventsOf(a.session).length)
       } else {
         diag('restoreLastAgent: candidate rejected (id=' + (a && a.id) + ' hasSession=' + !!(a && a.session) + ' parent=' + (a && a.session && a.session.header && a.session.header.parentSession) + ')')
       }
@@ -3413,7 +3503,7 @@ class MemoryEngine {
     runtime.lastTurn = turn
     // 取本轮最后一条 user + 最后一条 assistant(模型可见消息序列)
     const messages = extractSessionMessages(agent)
-    if (messages.length < 2) { why('messages<2 got=' + messages.length + ' seqs=' + ((agent.session.surface && agent.session.surface.nodes && (Array.isArray(agent.session.surface.nodes) ? agent.session.surface.nodes.length : 'set')) || 'none') + ' events=' + ((agent.session.events && agent.session.events.length) || 'none')); return }
+    if (messages.length < 2) { why('messages<2 got=' + messages.length + ' seqs=' + ((agent.session.surface && agent.session.surface.nodes && (Array.isArray(agent.session.surface.nodes) ? agent.session.surface.nodes.length : 'set')) || 'none') + ' events=' + (sessionEventsOf(agent && agent.session).length || 'none')); return }
     // 2026-08-30 intent 提纯(三层):①只认真人消息事件 'user/message'(tool/result 在协议里
     // 也是 user 角色,正文常是 JSON/行号文本)②跳过 harness 合成的上下文注入消息
     // ("Current runtime context." 开头 / 含 <memory_system>)③剥离注入快照块,取其后真人问题。
@@ -4442,13 +4532,33 @@ function textOfContent(content) {
   walk(content, 0)
   return out.join('')
 }
+/**
+ * 新旧两代 Session API 兼容的原始事件数组读取:
+ * - 旧版 @deepseek-ai/dsh-session 在 Session 上暴露 .events 数组;
+ * - 新版已移除 .events,事件读取走 snapshotEvents()(内部 eventsSnapshot 缓存,
+ *   同一 log 追加前重复调用零重复开销;返回 frozen 数组,只读安全)。
+ * 返回值恒为数组(找不到任何来源时为 []),不做截断——调用方各自决定窗口。
+ */
+function sessionEventsOf(session) {
+  try {
+    if (!session) return []
+    if (Array.isArray(session.events)) return session.events
+    if (typeof session.snapshotEvents === 'function') {
+      const snap = session.snapshotEvents()
+      if (Array.isArray(snap)) return snap
+    }
+  } catch (e) {}
+  return []
+}
 function extractSessionMessages(agent) {
   try {
     const session = agent && agent.session
     if (!session) return []
-    // 只读 events 数组(截断尾部),绝不访问 session.surface.nodes:
+    // 只读事件数组(截断尾部),绝不访问 session.surface.nodes:
     // 该访问会触发惰性投影,长会话(上万事件)时同步遍历阻塞主线程 → 窗口卡死/超时。
-    const eventsRaw = session.events || []
+    // 2026-09 兼容:新版 harness Session 已移除 .events 属性(原注释针对旧版 API),
+    // 统一经 sessionEventsOf() 读取(新版走 snapshotEvents(),自带缓存,同样零投影访问)。
+    const eventsRaw = sessionEventsOf(session)
     const events = eventsRaw.length > 2000 ? eventsRaw.slice(-2000) : eventsRaw
     const out = []
     for (let i = 0; i < events.length; i++) {
@@ -4873,6 +4983,15 @@ export function apply(ctx, config) {
   try { engine._activationHost.initCapability(ctx) } catch (_) {}
   // M7-0/M7-1:engine 级共享 SidecarClient(对象构造零副作用;进程仅在显式启用路径上 lazy spawn,
   // 默认关闭=零 Python process、零协议 IO、零 semantic 目录)
+  // M7.6 Python 一键向导(#16-#20 配套):detect/venv/deps/model 四步,落盘用户目录,不碰 npm 包目录
+  engine._pythonSetup = createPythonSetupPre({
+    dshHome: () => {
+      const env = process.env.DSH_HOME
+      if (env && env.trim()) return env.trim()
+      try { return path.join(homedir(), '.dsh') } catch (_) { return homedir() }
+    },
+    diag: (m) => diag('python-setup: ' + m),
+  })
   engine._pythonSidecar = createPythonSidecarClientPre({
     command: () => String(engine.config.pythonBackendExecutable || '').trim() || 'python',
     scriptPath: () => String(engine.config.pythonBackendWorkerPath || '').trim() || defaultWorkerScriptPathPre(),
@@ -5307,6 +5426,59 @@ export function apply(ctx, config) {
 
   // ---------- 路由 ----------
   const routes = [
+    {
+      kind: 'exact',
+      path: API['py-setup-status'],
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        writeJson(res, 200, engine._pythonSetup.status())
+      },
+    },
+    {
+      kind: 'exact',
+      path: API['py-setup-detect'],
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        try { writeJson(res, 200, await engine._pythonSetup.detect()) } catch (e) { writeJson(res, 500, { error: String(e && e.message || e) }) }
+      },
+    },
+    {
+      kind: 'exact',
+      path: API['py-setup-venv'],
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        if ((req.method || 'POST') !== 'POST') return writeJson(res, 405, { error: 'method not allowed' })
+        const body = await readJsonBody(req).catch(() => ({}))
+        try { writeJson(res, 200, await engine._pythonSetup.ensureVenv(body && body.python)) } catch (e) { writeJson(res, 500, { error: String(e && e.message || e) }) }
+      },
+    },
+    {
+      kind: 'exact',
+      path: API['py-setup-deps'],
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        if ((req.method || 'POST') !== 'POST') return writeJson(res, 405, { error: 'method not allowed' })
+        try { writeJson(res, 200, await engine._pythonSetup.ensureDeps()) } catch (e) { writeJson(res, 500, { error: String(e && e.message || e) }) }
+      },
+    },
+    {
+      kind: 'exact',
+      path: API['py-setup-model'],
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        if ((req.method || 'POST') !== 'POST') return writeJson(res, 405, { error: 'method not allowed' })
+        try { writeJson(res, 200, await engine._pythonSetup.downloadModel()) } catch (e) { writeJson(res, 500, { error: String(e && e.message || e) }) }
+      },
+    },
+    {
+      kind: 'exact',
+      path: API['py-setup-cancel'],
+      handler: async (req, res) => {
+        if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
+        if ((req.method || 'POST') !== 'POST') return writeJson(res, 405, { error: 'method not allowed' })
+        writeJson(res, 200, engine._pythonSetup.cancelDownload())
+      },
+    },
     {
       kind: 'exact',
       path: API['semantic-status'],
@@ -5315,9 +5487,10 @@ export function apply(ctx, config) {
         if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
         try {
           const probe = await engine.semanticAssetProbe()
-          const pyCands = [
+          // M7.6:模型归位用户目录(~/.dsh/python-engine/models/),包目录 bench 夹具仅作开发机兜底
+          const pyCands = (engine._pythonSetup ? [engine._pythonSetup.modelPath()] : []).concat([
             path.join(pluginRootDir(), 'python', 'bench', 'models-xenova-bge-m3-int8', 'onnx', 'model_int8.onnx'),
-          ]
+          ])
           const fsMod = await import('node:fs')
           const pyOnnx = pyCands.find((c) => fsMod.existsSync(c)) || pyCands[0]
           // 发射开关读数(memory/semantic/embedding-config.json 的
@@ -6046,6 +6219,7 @@ export function apply(ctx, config) {
         if (!isLoopbackRequest(req)) return writeJson(res, 403, { error: 'forbidden: loopback-only' })
         if ((req.method || 'POST') !== 'POST') return writeJson(res, 405, { error: 'method not allowed' })
         try {
+          const body = await readJsonBody(req).catch(() => ({}))  // #18: 缺此行致 body is not defined → greet 恒 500
           const ws = body && body.ws ? body.ws : ''
           await engine.refresh(ws ? { session: { header: { cwd: ws } } } : undefined)
           writeJson(res, 200, await engine.greetToday())

package/lib/python-setup.js

@@ -0,0 +1,229 @@
+/**
+ * M7.6 Python 一键向导(host 半):#16-#20 配套——把 C3 进阶档从"开发机可达"变成"爱好者可达"。
+ *
+ * 四步链路(全部走本模块,UI 只管展示状态与点击):
+ *   ①detect  — 探测系统 Python(≥3.9)/既有 venv/模型本体;全部只读。
+ *   ②venv    — python -m venv <userDir>/python-engine/.venv(幂等:已存在直接跳过)。
+ *   ③deps    — venv 内 pip 安装运行依赖(fastembed/onnxruntime,清华镜像兜底)。
+ *   ④model   — BGE-M3 int8(~539MB)下载到 <userDir>/python-engine/models/,
+ *              cn(hf-mirror)/intl(hf 官方)双通道+SHA256 校验,复用 JS 档下载器的状态机形态。
+ *
+ * 设计约束:
+ *   - 一切落盘在用户目录(~/.dsh/python-engine/),npm 包目录升级会被覆盖,绝不放模型。
+ *   - 长任务(venv/pip/下载)异步执行,进度写 state 供 semantic-status 轮询;失败可重试。
+ *   - 零新依赖:下载用全局 fetch,解压用 onnx 单文件直下(无压缩包),venv 用 python -m venv。
+ */
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { createHash } from 'node:crypto'
+import { homedir } from 'node:os'
+import path from 'node:path'
+import { existsSync, mkdirSync, writeFileSync, statSync, createWriteStream } from 'node:fs'
+import { readFile, writeFile, rm } from 'node:fs/promises'
+
+const execFileP = promisify(execFile)
+
+/** BGE-M3 int8 单文件(与 bench 夹具同源;hf-mirror 为主源,HF 官方为备源)。 */
+const MODEL_SPEC = {
+  repo: 'Xenova/bge-m3-int8',
+  file: 'onnx/model_int8.onnx',
+  bytes: 568456694,
+  sha256: '', // 见 MODEL_SHA256:远端 LFS 校验不可靠时以 size 下限+可执行性兜底;sha256 由首版发布冻结后填入
+  mirrors: [
+    { id: 'cn', url: (p) => 'https://hf-mirror.com/' + p },
+    { id: 'intl', url: (p) => 'https://huggingface.co/' + p },
+  ],
+}
+
+/** venv 内 pip 依赖(语义引擎最小集;transformers 栈换成 fastembed=纯 onnxruntime,免 torch)。 */
+const PIP_DEPS = ['fastembed', 'onnxruntime']
+
+export function createPythonSetupPre(opts = {}) {
+  const dshHomeOf = typeof opts.dshHome === 'function' ? opts.dshHome : () => opts.dshHome || path.join(homedir(), '.dsh')
+  const diagOf = typeof opts.diag === 'function' ? opts.diag : () => {}
+
+  // 引擎根目录(用户目录,跨升级存活): ~/.dsh/python-engine/
+  const engineRoot = () => path.join(dshHomeOf(), 'python-engine')
+  const venvDir = () => path.join(engineRoot(), '.venv')
+  const venvPython = () => process.platform === 'win32' ? path.join(venvDir(), 'Scripts', 'python.exe') : path.join(venvDir(), 'bin', 'python')
+  const modelsDir = () => path.join(engineRoot(), 'models')
+  const modelPath = () => path.join(modelsDir(), 'model_int8.onnx')
+
+  // 进度状态(内存态,semantic-status 轮询消费;host 重启后 detect 重建)
+  const st = {
+    phase: 'idle',        // idle|detecting|venv|deps|downloading|verifying|ready|error
+    error: '',
+    pythons: [],          // [{label,path,status:'ok'|'missing'|'too-old',version}]
+    chosenPython: '',
+    venvOk: false,
+    depsOk: false,
+    dl: { bytesDone: 0, bytesTotal: MODEL_SPEC.bytes, mirror: '', startedAt: 0, etaSec: 0 },
+    cancelled: false,
+  }
+  let dlAbort = null
+
+  function probe(pyPath, args, timeoutMs) {
+    return new Promise((resolve) => {
+      let done = false
+      const t = setTimeout(() => { if (!done) { done = true; resolve({ ok: false, out: '' }) } }, timeoutMs || 8000)
+      try {
+        execFileP(pyPath, args, { timeout: (timeoutMs || 8000) - 500, windowsHide: true, maxBuffer: 1024 * 1024 })
+          .then((r) => { if (!done) { done = true; clearTimeout(t); resolve({ ok: true, out: String(r.stdout || '').trim() }) } })
+          .catch(() => { if (!done) { done = true; clearTimeout(t); resolve({ ok: false, out: '' }) } })
+      } catch (_) { if (!done) { done = true; clearTimeout(t); resolve({ ok: false, out: '' }) } }
+    })
+  }
+
+  function pyVersionOf(out) {
+    const m = String(out || '').match(/(\d+)\.(\d+)/)
+    return m ? { major: Number(m[1]), minor: Number(m[2]) } : null
+  }
+
+  /** ①环境探测:venv(推荐)→ 系统 python/python3/py launcher;版本 ≥3.9 且 <3.13(onnxruntime 兼容上界)。 */
+  async function detect() {
+    st.phase = 'detecting'; st.error = ''
+    const dshHome = dshHomeOf()
+    const cands = [
+      { path: venvPython(), label: 'DSH Python 引擎 venv(推荐)', isVenv: true },
+      { path: 'python', label: '系统 PATH: python', isVenv: false },
+      { path: 'python3', label: '系统 PATH: python3', isVenv: false },
+      { path: 'py', label: 'Windows py launcher', isVenv: false },
+    ]
+    const out = []
+    for (const c of cands) {
+      if ((c.path.includes('\\') || c.path.includes('/')) && !existsSync(c.path)) { out.push({ ...c, status: 'missing', version: '' }); continue }
+      const r = await probe(c.path, ['-c', 'import sys; print("%d.%d" % sys.version_info[:2])'])
+      const v = pyVersionOf(r.out)
+      if (!r.ok || !v) { out.push({ ...c, status: 'missing', version: '' }); continue }
+      out.push({ ...c, status: (v.major === 3 && v.minor >= 9 && v.minor <= 12) ? 'ok' : 'too-old', version: v.major + '.' + v.minor })
+    }
+    // 既有成果快照
+    st.venvOk = existsSync(venvPython())
+    st.depsOk = st.venvOk ? (await probe(venvPython(), ['-c', 'import fastembed, onnxruntime; print("deps-ok")'])).ok : false
+    st.modelReady = existsSync(modelPath())
+    st.pythons = out
+    st.phase = 'idle'
+    return snapshot()
+  }
+
+  function snapshot() {
+    return {
+      phase: st.phase, error: st.error,
+      pythons: st.pythons, chosenPython: st.chosenPython,
+      venvOk: st.venvOk, depsOk: st.depsOk, modelReady: st.modelReady,
+      modelPath: modelPath(), venvPython: venvPython(),
+      modelBytes: st.modelReady ? statSync(modelPath()).size : 0, modelExpectedBytes: MODEL_SPEC.bytes,
+      dl: { ...st.dl },
+    }
+  }
+
+  /** ②venv:幂等(已存在跳过);用探测到的首个 ok 系统解释器创建。 */
+  async function ensureVenv(pythonPath) {
+    const base = String(pythonPath || '').trim() || (st.pythons.find((x) => x.status === 'ok' && !x.isVenv) || {}).path || ''
+    if (!base) { st.error = '未检测到可用的系统 Python(需 3.9-3.12)。请先安装 Python。'; st.phase = 'error'; return snapshot() }
+    st.chosenPython = base
+    if (existsSync(venvPython())) { st.venvOk = true; return snapshot() }
+    st.phase = 'venv'
+    mkdirSync(engineRoot(), { recursive: true })
+    try {
+      await execFileP(base, ['-m', 'venv', venvDir()], { timeout: 180000, windowsHide: true })
+      st.venvOk = existsSync(venvPython())
+      if (!st.venvOk) throw new Error('venv 目录未生成')
+      diagOf('python-setup: venv created at ' + venvDir())
+    } catch (e) {
+      st.error = 'venv 创建失败: ' + String((e && e.message) || e).slice(0, 160); st.phase = 'error'
+    }
+    return snapshot()
+  }
+
+  /** ③deps:venv 内 pip 装 fastembed+onnxruntime;官方源失败切清华镜像。 */
+  async function ensureDeps() {
+    if (!st.venvOk) { st.error = 'venv 未就绪,先执行 venv 步骤'; st.phase = 'error'; return snapshot() }
+    st.phase = 'deps'
+    const runPip = async (extra) => {
+      try {
+        const r = await execFileP(venvPython(), ['-m', 'pip', 'install', '--quiet'].concat(PIP_DEPS).concat(extra || []),
+          { timeout: 600000, windowsHide: true, maxBuffer: 4 * 1024 * 1024 })
+        return { ok: true }
+      } catch (e) { return { ok: false, tail: String((e && (e.stderr || e.message)) || e).slice(-300) } }
+    }
+    let r = await runPip()
+    if (!r.ok) r = await runPip(['-i', 'https://pypi.tuna.tsinghua.edu.cn/simple'])
+    st.depsOk = !!r.ok
+    if (!r.ok) { st.error = '依赖安装失败: ' + (r.tail || ''); st.phase = 'error'; return snapshot() }
+    diagOf('python-setup: deps installed into venv')
+    return snapshot()
+  }
+
+  /** ④模型:BGE-M3 int8 单文件下载(cn→intl 双通道),8MB 分片进度,断点续传(Range)。 */
+  async function downloadModel() {
+    if (st.phase === 'downloading' || st.phase === 'verifying') return snapshot()
+    mkdirSync(modelsDir(), { recursive: true })
+    st.cancelled = false
+    for (const mirror of MODEL_SPEC.mirrors) {
+      if (st.cancelled) break
+      const url = mirror.url(MODEL_SPEC.repo + '/resolve/main/' + MODEL_SPEC.file)
+      st.phase = 'downloading'; st.dl.mirror = mirror.id; st.dl.startedAt = Date.now()
+      try {
+        await downloadWithResume(url, modelPath(), (done, total) => {
+          st.dl.bytesDone = done; st.dl.bytesTotal = total || MODEL_SPEC.bytes
+          const el = (Date.now() - st.dl.startedAt) / 1000
+          st.dl.etaSec = done > 0 ? Math.max(0, Math.round(el / done * (st.dl.bytesTotal - done))) : 0
+        }, () => st.cancelled)
+        st.phase = 'verifying'
+        const size = statSync(modelPath()).size
+        if (size < 100 * 1024 * 1024) throw new Error('下载不完整(' + size + ' bytes)')
+        st.modelReady = true; st.phase = 'ready'
+        diagOf('python-setup: model ready at ' + modelPath() + ' (' + size + ' bytes, mirror=' + mirror.id + ')')
+        return snapshot()
+      } catch (e) {
+        if (st.cancelled) { st.phase = 'idle'; return snapshot() }
+        st.error = '[' + mirror.id + '] ' + String((e && e.message) || e).slice(0, 160)
+        diagOf('python-setup: download failed via ' + mirror.id + ': ' + st.error)
+      }
+    }
+    st.phase = 'error'
+    return snapshot()
+  }
+
+  /** 断点续传下载:已有 .part 则 Range 续传;完成 8MB 粒度回调进度。 */
+  function downloadWithResume(url, target, onProgress, isCancelled) {
+    return new Promise((resolve, reject) => {
+      const part = target + '.part'
+      let done = 0
+      try { if (existsSync(part)) done = statSync(part).size } catch (_) {}
+      const headers = done > 0 ? { Range: 'bytes=' + done + '-' } : {}
+      fetch(url, { headers }).then((resp) => {
+        if (!resp.ok && resp.status !== 206) { reject(new Error('HTTP ' + resp.status)); return }
+        const total = Number(resp.headers.get('content-length') || 0) + done
+        const stream = createWriteStream(part, done > 0 ? { flags: 'a' } : { flags: 'w' })
+        let lastTick = 0
+        resp.body.on('data', (chunk) => {
+          done += chunk.length
+          const now = Date.now()
+          if (now - lastTick > 500) { lastTick = now; onProgress(done, total) }
+        })
+        resp.body.on('error', (e) => { stream.end(); reject(e) })
+        resp.body.on('end', () => {
+          stream.end(() => {
+            writeFileSyncSafe(part, target).then(resolve).catch(reject)
+          })
+        })
+        dlAbort = () => { try { resp.body.destroy() } catch (_) {} }
+      }).catch(reject)
+    })
+  }
+
+  async function writeFileSyncSafe(from, to) {
+    // .part → 正式名(同目录 rename,原子语义)
+    await rm(to, { force: true })
+    await import('node:fs').then((fs) => fs.renameSync(from, to))
+  }
+
+  function cancelDownload() { st.cancelled = true; if (dlAbort) try { dlAbort() } catch (_) {} return snapshot() }
+
+  /** 汇总:semantic-status 的 pythonSetup 字段(供向导 UI 轮询)。 */
+  function status() { return snapshot() }
+
+  return { detect, ensureVenv, ensureDeps, downloadModel, cancelDownload, status, engineRoot, venvPython, modelPath }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a9i5k4/dsh-auto-memory",
-  "description": "主动联想记忆插件:记忆不靠模型调用,自己被唤回——Host 观察情境,NLP+向量化双轨检索,固定边界注入不破坏前缀缓存。三层记忆自动沉淀、欢迎向导、唤起回顾、无人值守、AI 问候与反思、日历、跨工具记忆继承。Proactive associative memory for DSH: zero-call recall, three-layer auto-consolidation, welcome tour, unattended mode.",
-  "version": "2.1.4",
+  "description": "Proactive associative memory for DSH: zero-prompt recall injected before the model speaks, three-layer auto-consolidation, skill crystallization, and Astra-style context management - handoff ledgers, PLAN whiteboard, water-level sensing. Local-first, model-agnostic, zero deps. 主动联想记忆+Astra 式上下文管理:自动唤回/自动沉淀/技能固化/交接账本与白板跨窗口续命/水位感知。",
+  "version": "2.1.6",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -11,7 +11,10 @@
   },
   "files": [
     "lib",
-    "cordis.patch.yml"
+    "python",
+    "cordis.patch.yml",
+    "!python/bench",
+    "!python/__pycache__"
   ],
   "dsh": {
     "bundle": {