dsh-jev-prune 0.1.0

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "dsh-jev-prune",
+  "version": "0.1.0",
+  "description": "Jev-judged context compaction for DeepSeek Harness. Two layers: prune stale tool results (semantic instead of size-only), and replace spent tool-call ranges with a deterministic receipt instead of a model-written summary.",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./index.js": "./index.js",
+    "./*.js": "./src/*.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "src",
+    "test",
+    "scripts",
+    "cordis.patch.yml",
+    "assets",
+    "examples",
+    "docs",
+    "demo",
+    "README.md",
+    "README_zh.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "scripts": {
+    "check": "node test/check.js",
+    "smoke": "node test/smoke_apply.mjs",
+    "demo": "node demo/run.mjs",
+    "coverage": "node --experimental-test-coverage --test --test-coverage-include=src/jev.js --test-coverage-include=src/prune.js --test-coverage-include=src/receipt.js --test-coverage-include=src/state.js --test-coverage-lines=90 --test-coverage-branches=75 --test-coverage-functions=75 test/check.js test/smoke_apply.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
+    "@deepseek-ai/schemastery": "*"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
+    "@deepseek-ai/schemastery": "3.18.2"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "yangyu666"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yangyu666/dsh-jev-prune.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yangyu666/dsh-jev-prune/issues"
+  },
+  "homepage": "https://github.com/yangyu666/dsh-jev-prune#readme",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "cordis",
+    "compaction",
+    "context",
+    "jev",
+    "typesafe"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "testedAgainst": "@deepseek-ai/dsh@0.1.5-rc.2",
+      "note": "DSH 0.1.x is a pre-release line; plugin-facing surfaces (event shapes, service names) may change between rc versions. After upgrading DSH, run `node test/check.js` and the smoke test, and use the `jev_probe_shapes` tool once in a real session."
+    }
+  }
+}

package/scripts/inspect_session.mjs

@@ -0,0 +1,235 @@
+/**
+ * inspect_session.mjs —— 直接读 DSH 的持久化会话日志做取证（零 LLM 成本）。
+ *
+ * 为什么需要它：
+ *   · `jev_probe_shapes` 打的是**事件级**形状（type / 块类型 / 键名），看不到**块内部**字段；
+ *     而工具名解析要靠 `tool-call` 块的 id/name 与 `tool-result` 的 toolCallId/source.callId 配对。
+ *   · 想验证"回执有没有真的落进会话"，一条命令就能查，不必再跑一轮 LLM 会话去让模型转述。
+ *
+ * ⚠️ DSH 的 `session.v3.jsonl.zstd` 是**多帧拼接**的 zstd（每追加一批就新起一帧），
+ *   而 Node 的 `zstdDecompressSync` / 流式解压**只认第一帧**（实测第二帧报
+ *   "Unknown frame descriptor"）。所以这里自己按 zstd 帧格式切帧后逐帧解压。
+ *
+ * 用法：
+ *   node scripts/inspect_session.mjs <会话目录 | session.v3.jsonl.zstd>
+ */
+
+import { readFileSync, readdirSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+import { zstdDecompressSync } from 'node:zlib'
+
+// ---------------------------------------------------------------- zstd 多帧切分
+
+const MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd])
+
+/**
+ * 把多帧 zstd 缓冲切成单帧数组。
+ * 帧格式：magic(4) + FHD(1) + [Window_Descriptor(1)] + [Dictionary_ID(0/1/2/4)] + [FCS(0/1/2/4/8)] + blocks
+ * 每个 block 头 3 字节小端：bit0=last, bits1-2=type, bits3-23=size；
+ * raw/compressed block 后跟 size 字节，RLE block 后跟 1 字节。
+ * 尾随的 Content_Checksum(4) 在 FHD 的 bit2 置位时存在。
+ */
+export function splitZstdFrames(buffer) {
+  const frames = []
+  let offset = 0
+  while (offset + 4 <= buffer.length) {
+    const start = buffer.indexOf(MAGIC, offset)
+    if (start < 0) break
+    let p = start + 4
+    if (p >= buffer.length) break
+    const fhd = buffer[p]
+    p += 1
+    const fcsFlag = (fhd >> 6) & 0b11
+    const singleSegment = (fhd >> 5) & 1
+    const hasChecksum = (fhd >> 2) & 1
+    const dictIdFlag = fhd & 0b11
+
+    if (singleSegment === 0) p += 1 // Window_Descriptor
+    p += dictIdFlag === 0 ? 0 : dictIdFlag === 1 ? 1 : dictIdFlag === 2 ? 2 : 4
+    p += fcsFlag === 0 ? (singleSegment === 1 ? 1 : 0)
+      : fcsFlag === 1 ? 2
+        : fcsFlag === 2 ? 4 : 8
+
+    if (p > buffer.length) break
+    for (;;) {
+      if (p + 3 > buffer.length) {
+        p = buffer.length
+        break
+      }
+      const header = buffer.readUIntLE(p, 3)
+      p += 3
+      const last = header & 1
+      const blockType = (header >> 1) & 0b11
+      const blockSize = header >> 3
+      if (blockType === 0 || blockType === 2) p += blockSize
+      else if (blockType === 1) p += 1
+      else throw new Error(`未知的 zstd block 类型 ${blockType}`)
+      if (last === 1) break
+      if (p > buffer.length) {
+        p = buffer.length
+        break
+      }
+    }
+    if (hasChecksum) p += 4
+    frames.push(buffer.subarray(start, Math.min(p, buffer.length)))
+    offset = Math.min(p, buffer.length)
+    if (offset <= start) break
+  }
+  return frames
+}
+
+/** 逐帧解压并拼起来。 */
+export function decompressZstdJsonl(buffer) {
+  const frames = splitZstdFrames(buffer)
+  const parts = []
+  for (const frame of frames) {
+    try {
+      parts.push(zstdDecompressSync(frame).toString('utf8'))
+    } catch {
+      // 单帧坏了就跳过，不让取证停摆
+    }
+  }
+  return parts.join('')
+}
+
+// ---------------------------------------------------------------- 会话读解
+
+export function readSessionEvents(pathOrDir) {
+  let file = pathOrDir
+  if (statSync(pathOrDir).isDirectory()) {
+    const entry = readdirSync(pathOrDir).find((f) => f.endsWith('.jsonl.zstd'))
+    if (entry == null) throw new Error(`目录里没有 .jsonl.zstd：${pathOrDir}`)
+    file = join(pathOrDir, entry)
+  }
+  const text = decompressZstdJsonl(readFileSync(file))
+  const events = []
+  let header = null
+  for (const line of text.split('\n')) {
+    if (line.trim().length === 0) continue
+    let parsed
+    try {
+      parsed = JSON.parse(line)
+    } catch {
+      continue
+    }
+    if (parsed?.type === 'session') header = parsed
+    else if (parsed?.type != null && typeof parsed.seq === 'number') events.push(parsed)
+    else if (parsed?.type != null) events.push(parsed)
+  }
+  return { file, header, events }
+}
+
+/** 取事件的内容块（与 state.js 的 contentOf 同口径）。 */
+function blocksOf(event) {
+  const data = event?.data ?? {}
+  if (event?.type === 'user/message') return data.content ?? null
+  if (event?.type === 'assistant/message' || event?.type === 'tool/result') return data.message?.content ?? null
+  return null
+}
+
+// ---------------------------------------------------------------- CLI
+
+const isMain = process.argv[1] != null && import.meta.url.endsWith(process.argv[1].replace(/\\/g, '/').split('/').pop())
+// issue #10：CLI 触发条件此前是 `isMain || process.argv[2] != null`——任何 importer
+// 只要命令行带了第二个参数（例如 verify_real_shapes.mjs 的正常用法），import 求值时
+// 就会替它跑 CLI、把进程带崩。CLI 入口只留给直接执行本文件的场景。
+if (isMain) {
+  const target = process.argv[2]
+  if (target == null) {
+    console.error('用法: node scripts/inspect_session.mjs <会话目录 | session.v3.jsonl.zstd>')
+    process.exit(1)
+  }
+  const { file, header, events } = readSessionEvents(target)
+  console.log(`文件: ${file}`)
+  // issue #11：createdAt 缺失/非法时此前直接 RangeError 整个工具退出——
+  // 而取证工具存在的意义恰恰是查"日志为什么不对"，头部字段缺失是常见病因
+  const createdAt = header?.createdAt != null && Number.isFinite(new Date(header.createdAt).getTime())
+    ? new Date(header.createdAt).toISOString()
+    : 'unknown'
+  if (header != null) console.log(`会话: ${header.id}  cwd=${header.cwd}  ${createdAt}`)
+  console.log(`事件数: ${events.length}\n`)
+
+  const byType = {}
+  for (const e of events) byType[e.type] = (byType[e.type] ?? 0) + 1
+  console.log('事件类型分布:', JSON.stringify(byType))
+  const onSurface = events.filter((e) => e.surfaceOp == null && e.shadowedRange == null)
+  console.log(`（其中 ${onSurface.length} 条不带 surfaceOp/shadowedRange）\n`)
+
+  console.log('=== tool-call 块（原样字段名）===')
+  let n = 0
+  for (const e of events) {
+    const blocks = blocksOf(e)
+    if (!Array.isArray(blocks)) continue
+    for (const b of blocks) {
+      if (b?.type !== 'tool-call') continue
+      console.log(`  seq=${e.seq}  块键=${JSON.stringify(Object.keys(b))}`)
+      console.log(`    id=${JSON.stringify(b.id)}  name=${JSON.stringify(b.name)}  arguments 类型=${typeof b.arguments}`)
+      if (++n >= 2) break
+    }
+    if (n >= 2) break
+  }
+
+  console.log('\n=== tool-result 块 ===')
+  n = 0
+  for (const e of events) {
+    const blocks = blocksOf(e)
+    if (!Array.isArray(blocks)) continue
+    for (const b of blocks) {
+      if (b?.type !== 'tool-result') continue
+      console.log(`  seq=${e.seq}  
+
+source=${JSON.stringify(e.data?.message?.source)}  块键=${JSON.stringify(Object.keys(b))}`)
+      console.log(`    toolCallId=${JSON.stringify(b.toolCallId)}  isError=${JSON.stringify(b.isError)}  正文块数=${Array.isArray(b.content) ? b.content.length : '-'}`)
+      if (++n >= 2) break
+    }
+    if (n >= 2) break
+  }
+
+  // 工具名解析真值：id ↔ source.callId 能不能配上
+  console.log('\n=== 工具名解析（真值）===')
+  const nameById = new Map()
+  for (const e of events) {
+    const blocks = blocksOf(e)
+    if (!Array.isArray(blocks)) continue
+    for (const b of blocks) {
+      if (b?.type !== 'tool-call') continue
+      const id = b.id ?? b.callId ?? b.toolCallId
+      if (id != null && typeof b.name === 'string') nameById.set(id, b.name)
+    }
+  }
+  const names = new Set(nameById.values())
+  console.log(`  索引大小=${nameById.size}  索引到的工具名=${JSON.stringify([...names])}`)
+  let resolved = 0
+  let unresolved = 0
+  for (const e of events) {
+    if (e.type !== 'tool/result') continue
+    const callId = e.data?.message?.source?.callId
+    if (nameById.has(callId)) resolved += 1
+    else unresolved += 1
+  }
+  console.log(`  tool/result 里 source.callId 能配对上的: ${resolved} 条；配对不上的: ${unresolved} 条`)
+  if (unresolved > 0) {
+    const sample = events.find((e) => e.type === 'tool/result' && !nameById.has(e.data?.message?.source?.callId))
+    console.log(`  反例: seq=${sample?.seq} source.callId=${JSON.stringify(sample?.data?.message?.source?.callId)}`)
+    console.log(`  索引里的 id 样例: ${JSON.stringify([...nameById.keys()].slice(0, 5))}`)
+  }
+
+  // checkpoint 与回执
+  const summaries = events.filter((e) => e.type === 'compaction/summary')
+  const checkpoints = events.filter((e) => e.type === 'user/message'
+    && e.data?.source?.kind === 'plugin' && e.data.source.plugin === 'compact')
+  console.log(`\n=== 压缩产物 ===\n  compaction/summary: ${summaries.length} 条；checkpoint user/message: ${checkpoints.length} 条`)
+  for (const s of summaries) {
+    const text = (s.data?.summary ?? []).map((b) => (typeof b === 'string' ? b : b?.text ?? '')).join('')
+    console.log(`  summary seq=${s.seq}  provider=${JSON.stringify(s.data?.provider)}  model=${JSON.stringify(s.data?.model)}`)
+    console.log(`    shadowedRange=${JSON.stringify(s.data?.shadowedRange)}  shadowedSeqs=${JSON.stringify(s.data?.shadowedSeqs)}`)
+    console.log(`    摘要前 160 字: ${text.slice(0, 160).replace(/\n/g, ' ⏎ ')}`)
+  }
+  for (const c of checkpoints) {
+    const text = (c.data?.content ?? []).map((b) => b?.text ?? '').join('')
+    console.log(`  checkpoint seq=${c.seq}  compactionId=${JSON.stringify(c.data?.source?.compactionId)}`)
+    console.log(`    正文前 200 字: ${text.slice(0, 200).replace(/\n/g, ' ⏎ ')}`)
+  }
+  const prunes = events.filter((e) => e.type === 'compaction/prune')
+  console.log(`  compaction/prune（第一层裁剪的影子定价）: ${prunes.length} 条`)
+}

package/scripts/verify_layout.mjs

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict';
+import {existsSync,readdirSync,readFileSync,statSync} from 'node:fs';
+import {dirname,resolve,relative} from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+const root=resolve(dirname(fileURLToPath(import.meta.url)),'..');
+const walk=dir=>readdirSync(dir).flatMap(name=>{
+  const path=resolve(dir,name);
+  if(['.git','node_modules','ci'].includes(name)) return [];
+  return statSync(path).isDirectory()?walk(path):[path];
+});
+for(const file of walk(root).filter(file=>file.endsWith('.md'))){
+  for(const match of readFileSync(file,'utf8').matchAll(/\]\(([^)]+)\)/g)){
+    const target=match[1].split('#')[0];
+    if(!target||/^[a-z]+:/.test(target)||target.includes('<'))continue;
+    assert.ok(existsSync(resolve(dirname(file),target)),relative(root,file)+' links to missing '+target);
+  }
+}
+assert.equal((await import('dsh-jev-prune')).name,'jev-prune');
+assert.equal((await import('dsh-jev-prune/index.js')).name,'jev-prune');
+for(const module of ['jev','prune','receipt','state']){
+  assert.ok(Object.keys(await import('dsh-jev-prune/'+module+'.js')).length>0);
+}
+console.log('Markdown file links, plugin entry and legacy public subpath exports verified.');

package/scripts/verify_real_shapes.mjs

@@ -0,0 +1,99 @@
+/**
+ * verify_real_shapes.mjs —— 用**真实会话日志**离线验工具名解析（零 LLM 成本）。
+ *
+ * 起因：真实 DSH 里的工具名是 `pwsh` / `read`（小写，shell 叫 pwsh），
+ * 而我猜的白名单是 Claude Code 风格的 PascalCase —— 白名单一个都匹配不上，
+ * 第二层因此静默永不触发。字段名这类东西**必须拿真值，不能猜**。
+ *
+ * 这个脚本把会话日志喂给插件自己的 state.js，验证：
+ *   ① buildToolNameIndex 能否从真实事件里建出索引
+ *   ② toolNameOf 能否解析出工具名（而不是 'unknown'）
+ *   ③ selectCandidates 会挑出哪些节点、解析出的名字是什么
+ *
+ * 用法: node scripts/verify_real_shapes.mjs <会话目录 | .jsonl.zstd> [...更多会话]
+ */
+
+import { readSessionEvents } from './inspect_session.mjs'
+import { buildToolNameIndex, selectCandidates, toolNameOf, resultChars } from '../src/state.js'
+
+const targets = process.argv.slice(2)
+if (targets.length === 0) {
+  console.error('用法: node scripts/verify_real_shapes.mjs <会话目录 | .jsonl.zstd> [...]')
+  process.exit(1)
+}
+
+const MARKER = '[' + '… Jev 判定该工具结果已过期' // 只要前缀就够（避免和实现里的常量耦合）
+
+// 真实 DSH 的工具名（从会话日志取证得到，不是猜的）
+const REAL_DSH_TOOLS = ['pwsh', 'read', 'write', 'edit', 'glob', 'grep', 'list', 'fetch', 'web_search']
+// 我原来猜的（Claude Code 风格 PascalCase）——留着做对照，证明这个 bug 有多隐蔽
+const DEFAULT_COMPACT_TOOLS_GUESS = ['Read', 'Grep', 'Glob', 'Bash', 'List', 'Ls', 'Search',
+  'WebFetch', 'WebSearch', 'Fetch', 'Tree', 'Stat']
+
+// 日志里 `surfaceOp` 是**字符串**（"append" / "replace"），不是对象 —— 别按对象判空。
+const SURFACE_TYPES = new Set(['system/message', 'user/message', 'assistant/message', 'tool/result', 'compaction/summary'])
+
+/** 从会话日志重建 surface（replace 事件把它声明的 sourceEventSeqs 移出）。 */
+function reconstructSurface(events) {
+  const present = new Set()
+  for (const e of events) {
+    if (typeof e.seq !== 'number' || !SURFACE_TYPES.has(e.type)) continue
+    if (e.surfaceOp === 'replace') {
+      for (const src of e.sourceEventSeqs ?? []) present.delete(src)
+    } else {
+      present.add(e.seq)
+    }
+  }
+  return [...present].sort((a, b) => a - b)
+}
+
+for (const target of targets) {
+  let loaded
+  try {
+    loaded = readSessionEvents(target)
+  } catch (error) {
+    console.log(`跳过 ${target}：${error.message}`)
+    continue
+  }
+  const { file, events } = loaded
+  const bySeq = new Map(events.filter((e) => typeof e.seq === 'number').map((e) => [e.seq, e]))
+  const surface = reconstructSurface(events)
+
+  console.log(`\n════════ ${file.split(/[\\/]/).pop()} ════════`)
+  console.log(`事件 ${events.length} 条，surface 候选 ${surface.length} 个节点`)
+
+  const nameByCallId = buildToolNameIndex(events)
+  console.log(`buildToolNameIndex → ${nameByCallId.size} 条，名字集合 = ${JSON.stringify([...new Set(nameByCallId.values())])}`)
+
+  const eventAt = (seq) => bySeq.get(seq) ?? null
+  let resolved = 0
+  let unknown = 0
+  for (const seq of surface) {
+    const event = eventAt(seq)
+    if (event?.type !== 'tool/result') continue
+    const name = toolNameOf(event, nameByCallId)
+    if (name === 'unknown') unknown += 1
+    else resolved += 1
+  }
+  console.log(`toolNameOf 解析：成功 ${resolved} 条 / 未解析 ${unknown} 条`)
+
+  const candidates = selectCandidates({
+    surface,
+    eventAt,
+    events,
+    preserveRecent: 2,
+    neverPruneTools: ['edit', 'write', 'multiedit', 'applypatch'],
+    marker: MARKER,
+    nameByCallId,
+  })
+  console.log(`selectCandidates → ${candidates.length} 个：`)
+  for (const c of candidates.slice(0, 12)) {
+    console.log(`  s${String(c.seq).padStart(4)}  ${c.tool.padEnd(18)} ${String(resultChars(eventAt(c.seq))).padStart(7)} 字符`)
+  }
+
+  // 白名单命中检查（这才是第二层能不能触发的实际判据）
+  for (const allowlist of [REAL_DSH_TOOLS, DEFAULT_COMPACT_TOOLS_GUESS]) {
+    const hit = candidates.filter((c) => allowlist.includes(c.tool)).length
+    console.log(`  白名单[${allowlist === REAL_DSH_TOOLS ? '真实 DSH 名' : '我原来猜的 PascalCase'}] 命中 ${hit}/${candidates.length}`)
+  }
+}

package/scripts/wire_profile.mjs

@@ -0,0 +1,173 @@
+/**
+ * wire_profile.mjs —— 绕开 pnpm，把 dsh-jev-prune 手工接进一个 DSH profile。
+ *
+ * 为什么需要它：`dsh plugin add` 会转发给 pnpm，而 pnpm 在本机装了三次都没成功
+ * （第一次被并发 install 冲掉、第二次被 npm 当多余包清掉、第三次 24 分钟无输出被终止）。
+ * 而 DSH 的插件加载契约其实是两件很朴素的事：
+ *   ① 包能在 profile 的解析范围内被 import 到
+ *   ② profile 的 cordis.patch.yml 里有一条把它 insert 进配置树
+ * 这两件事手工做完全等价，只是绕开了 pnpm 那层。
+ *
+ * 代价：偏离官方支持路径（`dsh plugin add`），所以升级 DSH 后要重新跑一次。
+ *
+ * 用法：
+ *   node scripts/wire_profile.mjs <DSH_HOME> <profile名> [--plugin <插件目录>]
+ *   --plugin 省略时默认为**本脚本所在目录**（即插件仓库根）。
+ * 例：
+ *   node scripts/wire_profile.mjs ../../_dshhome jevtest
+ *   node scripts/wire_profile.mjs ~/.dsh web --plugin /path/to/dsh-jev-prune
+ */
+
+import { copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(dirname(fileURLToPath(import.meta.url)))
+const args = process.argv.slice(2)
+
+// 手工解析参数（保持零依赖）：位置参数 <DSH_HOME> [profile名]，可选 --plugin <dir>
+let dshHome
+let profileName
+let pluginDir
+for (let i = 0; i < args.length; i += 1) {
+  const arg = args[i]
+  if (arg === '--plugin' || arg === '-p') {
+    pluginDir = args[i + 1]
+    if (pluginDir == null) {
+      console.error('❌ --plugin 需要一个目录参数')
+      process.exit(2)
+    }
+    i += 1
+  } else if (dshHome == null) {
+    dshHome = arg
+  } else if (profileName == null) {
+    profileName = arg
+  } else {
+    console.error(`❌ 多余的参数：${arg}`)
+    process.exit(2)
+  }
+}
+
+const pluginSrc = resolve(pluginDir ?? here)
+const packageName = JSON.parse(readFileSync(join(pluginSrc, 'package.json'), 'utf8')).name
+
+// issue #12：profile 名此前在用法行写"可选"，实际 join() 会拿到 undefined 抛原始 TypeError——
+// 要么给默认要么明确必填，这里选择明确必填 + 友好报错
+if (!dshHome || !profileName) {
+  console.error('用法: node scripts/wire_profile.mjs <DSH_HOME> <profile名> [--plugin <插件目录>]')
+  if (!dshHome) console.error('  缺少 <DSH_HOME>（DSH 的主目录，含 profiles/ 的那个）')
+  if (!profileName) console.error('  缺少 <profile名>（dsh --profile <名字> 用的那个名字，必填）')
+  process.exit(2)
+}
+
+// issue #12：Node 的 path.resolve 不展开 ~，示例却写着 ~/.dsh —— 先展开
+if (dshHome === '~' || dshHome.startsWith('~/') || dshHome.startsWith('~\\')) {
+  dshHome = join(homedir(), dshHome.slice(1).replace(/^[\\/]/, ''))
+}
+
+const profileDir = join(resolve(dshHome), 'profiles', profileName)
+if (!existsSync(profileDir)) {
+  console.error(`❌ profile 目录不存在：${profileDir}`)
+  console.error('   先用 dsh --profile <name> --from-default-profile headless --dump-config 创建它')
+  process.exit(1)
+}
+
+// ---------------------------------------------------------------- 1. 落包
+// 用复制而不是软链：Node 默认把软链解析成真实路径，那样插件里的
+// `import '@deepseek-ai/...'` 会从插件源目录往上找、找不到 DSH 的 node_modules。
+//
+// 放两个位置（DSH 的 profile 解析规则没有公开文档，而它源码里有个
+// `healProfilesModuleFallback`，说明确实存在回退链）：
+//   ① profile 自己的 node_modules —— pnpm 正常安装时的位置
+//   ② $DSH_HOME/node_modules      —— 回退链上的位置
+// 复制清单**从 package.json 的 files 字段推导**，而不是硬写：
+// 硬写清单会漂移——实测加过 prune.js 之后忘了同步，装进 profile 后启动直接
+// ERR_MODULE_NOT_FOUND。files 字段本来就该是唯一的真相来源。
+const pkg = JSON.parse(readFileSync(join(pluginSrc, 'package.json'), 'utf8'))
+const declared = Array.isArray(pkg.files) ? pkg.files : []
+const files = [...new Set([...declared, 'package.json', 'cordis.patch.yml', 'README.md'])]
+const missing = files.filter((f) => !existsSync(join(pluginSrc, f)))
+if (missing.length > 0) {
+  console.error(`❌ package.json 的 files 里声明了但文件不存在：${missing.join(', ')}`)
+  process.exit(1)
+}
+// 顺带守住另一类漂移：代码里的相对 import 必须都能落到实际文件上
+// （issue #13：此前只扫 .js，4 个 .mjs 的相对 import 全部漏检）
+const srcFiles = files.filter((f) => f.endsWith('.js') || f.endsWith('.mjs'))
+const brokenImports = []
+for (const f of srcFiles) {
+  const text = readFileSync(join(pluginSrc, f), 'utf8')
+  for (const m of text.matchAll(/from\s+'\.\/([^']+)'/g)) {
+    if (!existsSync(join(pluginSrc, m[1]))) brokenImports.push(`${f} → ./${m[1]}`)
+  }
+}
+if (brokenImports.length > 0) {
+  console.error(`❌ 相对 import 指向不存在的文件（复制后会在宿主里启动失败）：\n  ${brokenImports.join('\n  ')}`)
+  process.exit(1)
+}
+
+const targets = [
+  join(profileDir, 'node_modules', packageName),
+  join(resolve(dshHome), 'node_modules', packageName),
+]
+for (const pluginDest of targets) {
+  mkdirSync(pluginDest, { recursive: true })
+  for (const file of files) {
+    // files 里可能有目录条目（如 assets/）——目录用递归拷贝，文件用 copyFileSync
+    if (statSync(join(pluginSrc, file)).isDirectory()) {
+      cpSync(join(pluginSrc, file), join(pluginDest, file), { recursive: true })
+    } else {
+      copyFileSync(join(pluginSrc, file), join(pluginDest, file))
+    }
+  }
+  console.log(`  已落包 ${pluginDest}（${files.length} 个条目）`)
+}
+console.log(`✅ 插件已复制到 ${targets.length} 个候选解析位置`)
+
+// ---------------------------------------------------------------- 2. 改 patch
+const patchPath = join(profileDir, 'cordis.patch.yml')
+const original = readFileSync(patchPath, 'utf8')
+const entry = `- insert:\n    - id: jev-prune\n      name: ${packageName}\n`
+// 模板文件开头是注释，判断"是不是空数组"必须先剥掉注释和空行，
+// 否则会把条目追加在 `[]` 后面 → 顶层两个节点 → YAML 解析失败。
+const comments = original.split('\n').filter((l) => l.trim().startsWith('#')).join('\n')
+const effective = original
+  .split('\n')
+  .filter((l) => !l.trim().startsWith('#'))
+  .join('\n')
+  .trim()
+
+let next
+if (effective.includes(packageName) && !effective.split('\n').some((l) => l.trim() === '[]')) {
+  next = original
+  console.log('✅ cordis.patch.yml 里已有该条目，跳过')
+} else {
+  // 重建：保留注释头，丢掉空数组占位行（`[]` 与条目并存会让顶层出现两个节点 → YAML 解析失败），
+  // 然后把我们的 insert 条目放进去。已经存在的同 id 条目先删掉再重加，保证幂等。
+  const kept = original
+    .split('\n')
+    .filter((l) => l.trim().startsWith('#'))
+    .join('\n')
+    .trimEnd()
+  const rest = original
+    .split('\n')
+    .filter((l) => !l.trim().startsWith('#') && l.trim() !== '[]' && l.trim() !== '')
+    .join('\n')
+    .trim()
+  const withoutOurs = rest
+    .split(/\n(?=- insert:)/) // 按顶层条目切
+    .filter((block) => !block.includes(packageName))
+    .join('\n')
+    .trim()
+  next = `${kept}\n${withoutOurs ? `${withoutOurs}\n` : ''}${entry}`
+  console.log(rest === '' ? '✅ 已写入 cordis.patch.yml（原先是空数组）' : '✅ 已重建 cordis.patch.yml')
+}
+writeFileSync(patchPath, next, 'utf8')
+console.log(`\n--- ${patchPath} ---\n${next}`)
+
+// ---------------------------------------------------------------- 3. 下一步提示
+console.log('下一步：')
+console.log(`  1. 确认进了配置树：`)
+console.log(`     DSH_HOME=${resolve(dshHome)} dsh --profile ${profileName} --dump-config | grep -A1 jev-prune`)
+console.log(`  2. 真实跑一次会话，用 jev_probe_shapes 工具校正事件字段名`)