dsh-ppt-studio 1.1.2 → 1.1.4

package/scripts/verify-preset-scope.mjs

@@ -0,0 +1,593 @@
+#!/usr/bin/env node
+/**
+ * verify-preset-scope.mjs —— **预设隔离矩阵**的真机自证（装配层改动的验收门禁，第一轮）。
+ *
+ * 它回答一个只有真宿主能回答的问题：把本插件的能力面注册到「PPT 工作室」预设的**作用域**里之后，
+ *   ① 工具可见性、② 技能可见性、③ **系统提示段可见性** 是否都只对 ppt 预设的会话生效，
+ *   其它预设（standard）与无预设的全局平面是否**完全看不到**。
+ *
+ * ── 为什么要"真机 + 隔离"─────────────────────────────────────────────────────────
+ * spike（task-1）已经证明：绝对 `file://` 预设行能被挂载、预设不 broken、工具与技能都落预设层、
+ * 会话内切预设也拿得到。**但提示段没验证过**——如果把 `system-prompt/assemble` 监听者搬到预设
+ * 作用域，它的 waterfall 只按 scope 链投递（`scopeTarget`），是否真的"只对该预设的 agent 生效"
+ * 必须实测，不能推断。本脚本用宿主自己的装配入口 `systemPrompt.assemble({agent, scope: agent})`
+ * 取 `sections` 做**双向**判定：standard 里没有 `ppt-workflow`，ppt 里**有**。
+ *
+ * ── 怎么做到"不改仓库、不改产物"──────────────────────────────────────────────────
+ * 本脚本只：① 复制**本仓库当前工作区**到 temp、`npm pack`、装进隔离 profile；② 生成一个**探针
+ * 插件**（temp 里的独立 .mjs）与一份 **--patch overlay**（`- insert:` 一行，绝对 file:// 名），
+ * 由宿主把探针挂到 profile 平面。
+ *   · 探针负责建真会话（`agents.create` + `presets.mount`，与宿主
+ *     `dsh-api-session-controller/lib/types/agent.js` 的 `composeAgent()` 同形，GUI 走同一条路）、
+ *     写会话状态文件（让提示段判据可判）、枚举可见性、把结果写一个 JSON 文件；
+ *   · 脚本负责拉起宿主、等结果、断言、杀进程、清理。
+ *   ⇒ 仓库既有文件（src/lib/docs/smoke）**零改动**；也不依赖任何模型/凭据（不花 token）。
+ *
+ * ── 用法 ─────────────────────────────────────────────────────────────────────
+ *   node scripts/verify-preset-scope.mjs                  # 一键：隔离安装 + 真宿主 + 断言
+ *   node scripts/verify-preset-scope.mjs --keep           # 保留隔离目录（事后翻证据）
+ *   node scripts/verify-preset-scope.mjs --strict         # "未落地"也算失败（改动落地后设为门禁用）
+ *   node scripts/verify-preset-scope.mjs --negative       # 额外跑负面对照（故意写错的 file:// 行）
+ *   node scripts/verify-preset-scope.mjs --work <dir>     # 指定隔离根目录
+ *   node scripts/verify-preset-scope.mjs --dsh <bin.js>   # 指定宿主入口（缺省自动探测）
+ *   node scripts/verify-preset-scope.mjs --timeout 240    # 等探针结果的秒数（缺省 180）
+ *   node scripts/verify-preset-scope.mjs --expect-tools 22 --expect-skills 4
+ *
+ * 退出码：0 = 全部断言通过 **或** 判定为"隔离未生效（改动未落地）"（打印醒目标记，不算 FAIL）；
+ *         1 = 至少一条断言失败（含"预设 broken"这种真失败）；
+ *         2 = 仅 --strict 下的"未生效"。缺 pnpm / 缺 dsh / 缺 node 时打印 ⚠ 跳过并退出 0。
+ *
+ * ── 判定口径（每条断言各自写明"判据来源"）────────────────────────────────────────
+ *  · 工具可见性：`ctx.get('tools').schemas(agent)` —— 即宿主 `systemPrompt.tools(context => wireSchemas(context.scope))`
+ *    用的**同一个** `view(scope)`（dsh-tools/lib/index.js:2707 / :3023 / :2959-2985）；
+ *    agent 本身即 scope key（dsh-agent-loop/lib/index.js:778 `createScope(loopCtx, this)`）。
+ *  · 技能可见性：`ctx.get('skills').list({ scope: agent })`（dsh-skill 按 scope 链合并，:224-240）。
+ *  · 提示段可见性：`ctx.get('systemPrompt').assemble({ agent, scope: agent })` 的 `sections`——
+ *    `assembleContextFor(agent) = { agent, scope: agent }`（dsh-agent/lib/types/dispatch.js:92-94，
+ *    宿主 agent-loop 在 :907 就是这么调的）；waterfall 的投递按 scope（dsh-system-prompt/lib/index.js:355
+ *    `ctx.waterfall(scopeTarget(this, scope), 'system-prompt/assemble', …)`）。
+ *  · 预设健康度：`ctx.get('agentPresets').list()` 行里有无 `broken` 字段
+ *    （dsh-agent-preset-registry/lib/index.js:578-587；前端按 `broken === void 0` 过滤，dsh-client-ui-agent-preset/lib/client.js:1147）。
+ *  · 全局残留：`ctx.get('tools').schemas(undefined)` = 无预设的全局视图。
+ */
+import { spawn, spawnSync } from 'node:child_process'
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { tmpdir, homedir } from 'node:os'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const args = process.argv.slice(2)
+const flag = (name) => args.includes(name)
+const opt = (name, dflt) => {
+  const i = args.indexOf(name)
+  return i >= 0 && args[i + 1] !== undefined && !args[i + 1].startsWith('--') ? args[i + 1] : dflt
+}
+const KEEP = flag('--keep')
+const STRICT = flag('--strict')
+const NEGATIVE = flag('--negative')
+const TIMEOUT_MS = Number(opt('--timeout', '180')) * 1000
+const EXPECT_TOOLS = Number(opt('--expect-tools', '22'))
+const EXPECT_SKILLS = Number(opt('--expect-skills', '4'))
+const PRESET = opt('--preset', 'ppt')
+const OTHER = opt('--other', 'standard')
+const WORK_ARG = opt('--work', '')
+
+let pass = 0
+let fail = 0
+let pending = false
+function check(label, ok, detail = '') {
+  console.log(`${ok ? '✓' : '✗'} ${label}${detail ? ` — ${detail}` : ''}`)
+  ok ? pass++ : fail++
+}
+/** 只打印证据行，**不计入**通过/失败（用于"改动未落地"时的判定依据，避免把它误判成门禁失败）。 */
+function evidence(label, ok, detail = '') {
+  console.log(`${ok ? '✓' : '✗'}（证据）${label}${detail ? ` — ${detail}` : ''}`)
+}
+function info(label, detail = '') { console.log(`· ${label}${detail ? ` — ${detail}` : ''}`) }
+function head(title) { console.log(`\n=== ${title} ===`) }
+
+function run(cmd, cmdArgs, opts = {}) {
+  const r = spawnSync(cmd, cmdArgs, { encoding: 'utf8', shell: process.platform === 'win32', ...opts })
+  return r
+}
+function mergeOut(r) { return `${r.stdout ?? ''}\n${r.stderr ?? ''}`.trim() }
+function tail(s, n = 240) { return String(s).replace(/\s+/g, ' ').trim().slice(-n) }
+
+// ── 前置：node / dsh / pnpm ────────────────────────────────────────────────────
+console.log(`verify-preset-scope：仓库 ${root}`)
+console.log(`  预设 ${PRESET}（期望 ppt_*=${EXPECT_TOOLS}、技能=${EXPECT_SKILLS}）｜对照预设 ${OTHER}`
+  + `｜负面对照 ${NEGATIVE ? '开' : '关'}｜未落地判定 ${STRICT ? 'FAIL(--strict)' : 'PENDING(不算失败)'}`)
+
+const dshBin = findDshBin()
+if (dshBin === null) {
+  console.log('⚠ 跳过：找不到宿主入口 `@deepseek-ai/dsh/lib/bin.js`（用 --dsh <path> 指定，或 npm i -g @deepseek-ai/dsh）')
+  process.exit(0)
+}
+const pnpm = run('pnpm', ['--version'])
+if (pnpm.status !== 0) {
+  console.log('⚠ 跳过：PATH 上没有 pnpm（`dsh plugin` 是 pnpm 转发器）')
+  process.exit(0)
+}
+info('宿主入口', dshBin)
+info('pnpm', mergeOut(pnpm).split(/\r?\n/)[0])
+
+// ── 隔离环境 ───────────────────────────────────────────────────────────────────
+const work = WORK_ARG ? resolve(WORK_ARG) : mkdtempSync(join(tmpdir(), 'dsh-ppt-scope-verify-'))
+const home = join(work, 'home')
+const cwd = join(work, 'cwd')
+const packDir = join(work, 'pack')
+for (const d of [home, cwd, packDir]) mkdirSync(d, { recursive: true })
+info('隔离根目录', work)
+info('隔离 DSH_HOME', home)
+
+let host = null
+let exitCode = 0
+try {
+  // ── 0) 把**本仓库当前工作区**复制到 temp 并在副本里构建（src → lib）───────────────
+  // 为什么必须先复制 + 构建：`lib/` 是**提交的构建产物**，而本轮改动在 `src/`。直接 pack 仓库里的
+  // 旧 `lib/` 会把"改动未落地"误报成结论。复制到 temp 后跑 `scripts/build.mjs`（纯 src→lib 拷贝）
+  // ⇒ 被测对象 = 你此刻的 src，且**仓库零写入**。
+  const scratch = join(work, 'repo')
+  mkdirSync(scratch, { recursive: true })
+  cpSync(root, scratch, {
+    recursive: true,
+    filter: (src) => !/[\\/](\.git|node_modules)([\\/]|$)/.test(src),
+  })
+  const build = run('node', [join(scratch, 'scripts', 'build.mjs')], { cwd: scratch })
+  check('副本里构建成功（src → lib，测的是你此刻的 src）', build.status === 0, tail(mergeOut(build)))
+
+  // ── 1) 打包（npm pack 只写 packDir，不写仓库）─────────────────────────────────
+  const pack = run('npm', ['pack', '--pack-destination', packDir], { cwd: scratch })
+  // 文件名只信 **stdout**（npm 把 notice 写 stderr、文件名写 stdout；合并输出后"最后一行"会是 notice）
+  // 再兜一层：直接扫 packDir 里的 tgz。
+  const fromStdout = (pack.stdout ?? '').split(/\r?\n/).map((s) => s.trim()).filter((s) => s.endsWith('.tgz')).pop()
+  const fromDir = readdirSync(packDir).filter((f) => f.endsWith('.tgz')).sort().pop()
+  const tgzName = fromStdout ?? fromDir ?? ''
+  const tgz = join(packDir, tgzName)
+  check('npm pack 出当前工作区的 tgz', existsSync(tgz), tgzName || tail(mergeOut(pack)))
+
+  // ── 2) 装进隔离 profile ───────────────────────────────────────────────────────
+  const env = { ...process.env, DSH_HOME: home }
+  const add = run('node', [dshBin, 'plugin', '--profile', 'web', 'add', tgz], { env, cwd: work })
+  check('`dsh plugin --profile web add <tgz>` 退出码 0（隔离 profile）', add.status === 0, tail(mergeOut(add)))
+  const installed = join(home, 'profiles', 'web', 'node_modules', 'dsh-ppt-studio')
+  check('插件已物化到隔离 profile', existsSync(join(installed, 'lib', 'index.js')), installed)
+
+  // ── 3) 探针（temp 里的独立模块）+ overlay patch（绝对 file:// 行）──────────────
+  const probeFile = join(work, 'probe.mjs')
+  writeFileSync(probeFile, probeSource(), 'utf8')
+  const patchFile = join(work, 'probe.patch.yml')
+  writeFileSync(patchFile, `# verify-preset-scope：把探针挂到 profile 平面（绝对 file:// 名，不经 baseUrl 解析）\n`
+    + `- insert:\n    - id: ppt-scope-probe\n      name: '${pathToFileURL(probeFile).href}'\n`, 'utf8')
+  const resultFile = join(work, 'result.json')
+  const hostLog = join(work, 'host.log')
+
+  // ── 4) 拉起宿主 ───────────────────────────────────────────────────────────────
+  console.log('\n拉起隔离宿主（不打开浏览器，端口交给 OS）…')
+  host = spawn(process.execPath, [dshBin, '--profile', 'web', '--patch', patchFile, '--no-open', '--port', '0'], {
+    cwd, env: {
+      ...env,
+      PPT_SCOPE_VERIFY: '1',
+      PPT_SCOPE_RESULT: resultFile,
+      PPT_SCOPE_PRESET: PRESET,
+      PPT_SCOPE_OTHER: OTHER,
+      PPT_SCOPE_NEGATIVE: NEGATIVE ? '1' : '0',
+      PPT_SCOPE_CWD: cwd,
+      PPT_STUDIO_DEBUG: '1',
+    },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    windowsHide: true,
+  })
+  let hostOut = ''
+  host.stdout.on('data', (b) => { hostOut += String(b) })
+  host.stderr.on('data', (b) => { hostOut += String(b) })
+  host.on('error', (e) => { hostOut += `\n[spawn error] ${String(e?.message ?? e)}\n` })
+
+  const result = await waitForResult(resultFile, host, TIMEOUT_MS)
+  writeFileSync(hostLog, hostOut, 'utf8')
+  if (result !== null) {
+    const url = (hostOut.match(/https?:\/\/127\.0\.0\.1:\d+\S*/) ?? ['(未见 URL)'])[0]
+    info('宿主已就绪', url)
+  }
+
+  if (result === null) {
+    check(`探针在 ${TIMEOUT_MS / 1000}s 内产出结果（${resultFile}）`, false,
+      host === null || host.exitCode === null ? '宿主仍在跑但探针未落盘' : `宿主已退出 exit=${host.exitCode}`)
+    console.log('  —— 宿主输出尾部 ——')
+    for (const l of hostOut.split(/\r?\n/).slice(-12)) console.log(`  ${l}`)
+  } else {
+    exitCode = report(result)
+  }
+} finally {
+  await killHost(host)
+  if (KEEP) console.log(`\n（--keep）隔离目录保留在：${work}`)
+  else rmSync(work, { recursive: true, force: true })
+}
+
+const verdict = fail > 0 ? 'FAIL' : (pending ? 'PENDING(隔离未生效—核心改动未落地)' : 'PASS')
+console.log(`\n==== verify-preset-scope 结果：${verdict}：${pass} 通过 / ${fail} 失败 ====`)
+process.exit(fail > 0 ? 1 : exitCode)
+
+// ────────────────────────────────────────────────────────────────────────────────
+/** 断言矩阵。返回进程退出码（0 通过 / PENDING；1 失败；STRICT 下 PENDING=2）。 */
+function report(result) {
+  const matrix = result.matrix ?? {}
+  const presets = matrix.presets ?? []
+  const ppt = matrix[PRESET] ?? {}
+  const other = matrix[OTHER] ?? {}
+  const switched = matrix.switched ?? {}
+  const globalView = matrix.global ?? {}
+  const rowOf = (id) => presets.find((p) => p.id === id)
+
+  if (result.fatal) {
+    check('探针跑完（无致命错误）', false, tail(result.fatal, 400))
+    return 1
+  }
+  check('探针跑完（无致命错误）', true, `stages=${(result.stages ?? []).join(' → ')}`)
+
+  // ── A. 预设健康度 ─────────────────────────────────────────────────────────────
+  head('A. 预设健康度（agentPresets.list() 有无 broken 字段）')
+  const pptRow = rowOf(PRESET)
+  check(`presets 列表里存在 ${PRESET} 预设`, pptRow !== undefined,
+    presets.map((p) => p.id).join(', '))
+  const healthy = pptRow !== undefined && pptRow.broken === undefined
+  check(`${PRESET} 预设无 broken 字段（= 选择器可见）`, healthy, pptRow?.broken ?? '(无 broken)')
+
+  // ── "隔离是否生效"的判定（先判，再决定后面是断言还是 PENDING）────────────────────
+  const isolatedTools = (ppt.pptTools ?? []).length === EXPECT_TOOLS && (other.pptTools ?? []).length === 0
+  const isolatedSkills = (ppt.pptSkills ?? []).length === EXPECT_SKILLS && (other.pptSkills ?? []).length === 0
+  const isolatedPrompt = ppt.hasWorkflowSection === true && other.hasWorkflowSection === false
+  const isolated = isolatedTools && isolatedSkills && isolatedPrompt
+
+  head('B. 隔离判定（三条同时成立才算"改动已落地"）')
+  // 已落地 ⇒ 这三条是门禁断言（计入通过/失败）；未落地 ⇒ 它们只是"为什么判未落地"的证据行。
+  const marks = isolated ? check : evidence
+  marks(`工具隔离：${PRESET} ppt_*=${(ppt.pptTools ?? []).length}（期望 ${EXPECT_TOOLS}）且 ${OTHER} ppt_*=0`,
+    isolatedTools, `${PRESET}=${(ppt.pptTools ?? []).length}｜${OTHER}=${(other.pptTools ?? []).length}`)
+  marks(`技能隔离：${PRESET} 本插件技能=${(ppt.pptSkills ?? []).length}（期望 ${EXPECT_SKILLS}）且 ${OTHER}=0`,
+    isolatedSkills, `${PRESET}=${(ppt.pptSkills ?? []).length}｜${OTHER}=${(other.pptSkills ?? []).length}`)
+  marks(`提示段隔离：${PRESET} sections 含 ppt-workflow 且 ${OTHER} 不含`,
+    isolatedPrompt, `${PRESET}=${ppt.hasWorkflowSection}｜${OTHER}=${other.hasWorkflowSection}`)
+
+  if (!isolated) {
+    if (!healthy) {
+      // 预设不健康是**真失败**（不是"未落地"）：插件声明了一条注定挂不上的行。
+      head('结论：FAIL —— 预设不健康（不是"未落地"）')
+      check(`${PRESET} 预设必须健康`, false, String(pptRow?.broken ?? '(缺失)'))
+      return 1
+    }
+    head('结论：隔离未生效（核心改动未落地，或走了全局回落）')
+    console.log(`⚠ PENDING(隔离未生效—核心改动未落地)：${PRESET} 预设健康，但隔离矩阵未成立：`)
+    info(`工具：${OTHER} 可见 ppt_*`, String((other.pptTools ?? []).length))
+    info(`工具：${PRESET} 可见 ppt_*`, String((ppt.pptTools ?? []).length))
+    info('技能', `${OTHER}=${(other.pptSkills ?? []).length}｜${PRESET}=${(ppt.pptSkills ?? []).length}`)
+    info('提示段', `${OTHER}=${other.hasWorkflowSection}｜${PRESET}=${ppt.hasWorkflowSection}`)
+    info('全局视图 ppt_*', String((globalView.pptTools ?? []).length))
+    // 口径要说清是"哪一条没成立"，不要一律归因于"未落地"（避免用推断代替证据）
+    if (isolatedPrompt && !isolatedTools) {
+      info('归因提示', '提示段已隔离而工具未隔离 ⇒ 可能"部分落地"，或 --expect-tools 与插件实际工具数不符（先核对期望值）')
+    } else if (!isolatedPrompt && isolatedTools && isolatedSkills) {
+      info('归因提示', '工具/技能已隔离而提示段未隔离 ⇒ 提示段与语义路由可能仍注册在 profile 平面（本轮最需要补的就是这条）')
+    } else {
+      info('归因提示', '三条均未隔离 ⇒ 更像核心改动未落地；若确信已落地，请查宿主日志里的 [ppt-studio] 回落告警')
+    }
+    console.log('（这不是宿主问题：请确认 src/preset-delivery.js 的自定位行与 src/index.js 的 scope 分档已落地；'
+      + '本脚本测的是 src（副本里现场 build），与仓库提交的 lib/ 是否同步无关）')
+    pending = true
+    return STRICT ? 2 : 0
+  }
+
+  // ── C. 非 PPT 预设：零影响（三条口径分开断言）────────────────────────────────────
+  head(`C. 非 PPT 预设（${OTHER}）零影响`)
+  check('工具：ppt_* = 0', (other.pptTools ?? []).length === 0, `可见工具 ${other.toolCount ?? '?'} 个：${(other.tools ?? []).join(',')}`)
+  check(`技能：本插件 ${EXPECT_SKILLS} 本 = 0`, (other.pptSkills ?? []).length === 0,
+    `可见技能 ${(other.skills ?? []).length} 个${(other.skills ?? []).length ? `：${(other.skills ?? []).join(',')}` : ''}`)
+  check('提示段：sections 里没有 ppt-workflow', other.hasWorkflowSection === false,
+    `sections = [${(other.sections ?? []).join(', ')}]`)
+
+  // ── D. PPT 预设：全能力面（含提示段"有"这一向）────────────────────────────────
+  head(`D. PPT 预设（${PRESET}）全能力面`)
+  check(`工具：ppt_* = ${EXPECT_TOOLS}`, (ppt.pptTools ?? []).length === EXPECT_TOOLS, `ppt_* = [${(ppt.pptTools ?? []).join(',')}]`)
+  check(`技能：= ${EXPECT_SKILLS}`, (ppt.pptSkills ?? []).length === EXPECT_SKILLS, `[${(ppt.pptSkills ?? []).join(',')}]`)
+  check('提示段：sections 里有 ppt-workflow', ppt.hasWorkflowSection === true,
+    `sections = [${(ppt.sections ?? []).join(', ')}]`)
+  check('模型面目录交叉核对：assembly.tools 里 ppt_* 数 = tools.schemas 里 ppt_* 数',
+    (ppt.assemblyPptTools ?? []).length === (ppt.pptTools ?? []).length,
+    `assembly=${(ppt.assemblyPptTools ?? []).length}｜registry=${(ppt.pptTools ?? []).length}`)
+
+  // ── E. 会话内切换 ─────────────────────────────────────────────────────────────
+  head('E. 会话内切换（standard → ppt，同一 agent）')
+  check('切换成功且 composedPreset 变成 ppt', switched.composedPreset === PRESET, String(switched.composedPreset ?? '(未取到)'))
+  check(`切换后拿到 ppt_* = ${EXPECT_TOOLS}`, (switched.pptTools ?? []).length === EXPECT_TOOLS, `= ${(switched.pptTools ?? []).length}`)
+  check(`切换后拿到技能 = ${EXPECT_SKILLS}`, (switched.pptSkills ?? []).length === EXPECT_SKILLS, `= ${(switched.pptSkills ?? []).length}`)
+  check('切换后提示段也出现 ppt-workflow（提示段判据同样跟随 scope 链）', switched.hasWorkflowSection === true,
+    `sections = [${(switched.sections ?? []).join(', ')}]`)
+
+  // ── F. 零全局残留 ─────────────────────────────────────────────────────────────
+  head('F. 零全局残留（无预设的全局视图）')
+  check('全局视图 ppt_* = 0', (globalView.pptTools ?? []).length === 0,
+    `全局工具 ${globalView.toolCount ?? '?'} 个，ppt_* = [${(globalView.pptTools ?? []).join(',')}]`)
+
+  // ── G. 负面对照（可选）────────────────────────────────────────────────────────
+  if (NEGATIVE) {
+    head('G. 负面对照：故意写错的 file:// 行')
+    const neg = matrix.negative ?? {}
+    check('宿主报告 broken（诊断含 "never started"）', typeof neg.brokenRow === 'string' && /never started/.test(neg.brokenRow),
+      tail(String(neg.brokenRow ?? '(未取到)'), 300))
+    check('坏预设不影响好预设（ppt 仍健康）', neg.pptStillHealthy !== false, String(neg.pptStillHealthy))
+  }
+
+  // ── 判据来源（口径标注，避免"用推断代替"）──────────────────────────────────────
+  head('判据来源（每个口径的 API 与宿主代码）')
+  info('工具可见性', "ctx.get('tools').schemas(agent) ← systemPrompt.tools(ctx => wireSchemas(ctx.scope))，dsh-tools/lib/index.js:2707/:3023/:2959-2985")
+  info('技能可见性', "ctx.get('skills').list({ scope: agent })，dsh-skill/lib/index.js:224-240（按 scope 链合并，:111-117）")
+  info('提示段可见性', "ctx.get('systemPrompt').assemble({ agent, scope: agent }) 的 sections ← dsh-agent/lib/types/dispatch.js:92-94 + dsh-agent-loop/lib/index.js:907；waterfall 按 scope 投递 dsh-system-prompt/lib/index.js:355")
+  info('预设健康度', 'ctx.get(\'agentPresets\').list() 的 broken 字段，dsh-agent-preset-registry/lib/index.js:578-587')
+  info('全局残留', "ctx.get('tools').schemas(undefined)（无预设的全局视图）")
+  info('跨平面注记', '工具/技能三条断言读的是"注册表层"（模型目录同一来源）；提示段读的是"装配入口返回的 sections"。三者都不是推断。')
+  return 0
+}
+
+/** 轮询结果文件（探针原子写：先 .tmp 再 rename）。 */
+async function waitForResult(file, child, timeoutMs) {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (existsSync(file)) {
+      try { return JSON.parse(readFileSync(file, 'utf8')) } catch { /* 半成品，继续等 */ }
+    }
+    if (child !== null && child.exitCode !== null) {
+      // 宿主退出前可能刚写完，再给一次机会
+      await sleep(300)
+      if (existsSync(file)) { try { return JSON.parse(readFileSync(file, 'utf8')) } catch { /* 忽略 */ } }
+      return null
+    }
+    await sleep(400)
+  }
+  return null
+}
+
+function sleep(ms) { return new Promise((r) => setTimeout(r, ms)) }
+
+/** 结束宿主（Windows 下要连子进程一起杀）。 */
+async function killHost(child) {
+  if (child === null || child.exitCode !== null) return
+  try {
+    if (process.platform === 'win32') run('taskkill', ['/PID', String(child.pid), '/T', '/F'])
+    else child.kill('SIGKILL')
+  } catch { /* 忽略 */ }
+  await sleep(500)
+}
+
+/** 探测宿主入口：$DSH_BIN → `npm root -g` → APPDATA/LOCALAPPDATA → homedir。 */
+function findDshBin() {
+  const rel = join('@deepseek-ai', 'dsh', 'lib', 'bin.js')
+  const candidates = []
+  if (process.env.DSH_BIN) candidates.push(process.env.DSH_BIN)
+  try {
+    const r = run('npm', ['root', '-g'])
+    if (r.status === 0) candidates.push(join(mergeOut(r), rel))
+  } catch { /* npm 不可用 */ }
+  for (const k of ['APPDATA', 'LOCALAPPDATA']) if (process.env[k]) candidates.push(join(process.env[k], 'npm', 'node_modules', rel))
+  candidates.push(join(homedir(), 'AppData', 'Roaming', 'npm', 'node_modules', rel))
+  candidates.push('/usr/lib/node_modules/@deepseek-ai/dsh/lib/bin.js', '/usr/local/lib/node_modules/@deepseek-ai/dsh/lib/bin.js')
+  for (const c of candidates) if (c && existsSync(c)) return c
+  return null
+}
+
+// ────────────────────────────────────────────────────────────────────────────────
+/**
+ * 探针插件源码（写到 temp 的 probe.mjs，由 --patch overlay 以绝对 file:// 名挂载）。
+ * 它**只读**宿主状态 + 建会话 + 枚举，不改仓库、不改插件。
+ *
+ * 写成**函数声明**而不是模块级 const：下面的顶层代码在模块求值到 `const` 之前就会调用它
+ * （TDZ 会抛 "Cannot access 'PROBE_SOURCE' before initialization"——仓库自己的
+ * scripts/verify-fresh-install.mjs 顶部注释记过同一个坑）。
+ * @returns {string} 探针模块源码
+ */
+function probeSource() {
+  return String.raw`
+import { appendFileSync, existsSync, mkdirSync, renameSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+const OUT = process.env.PPT_SCOPE_RESULT
+const LOG = String(OUT) + '.log'
+const PRESET = process.env.PPT_SCOPE_PRESET || 'ppt'
+const OTHER = process.env.PPT_SCOPE_OTHER || 'standard'
+const NEG = process.env.PPT_SCOPE_NEGATIVE === '1'
+const CWD = process.env.PPT_SCOPE_CWD || process.cwd()
+const HOME = process.env.DSH_HOME
+
+const RESULT = { startedAt: new Date().toISOString(), stages: [], errors: [], matrix: {} }
+const log = (m) => { try { appendFileSync(LOG, new Date().toISOString() + ' ' + m + '\n') } catch {} }
+const flush = () => {
+  try { writeFileSync(OUT + '.tmp', JSON.stringify(RESULT, null, 2)); renameSync(OUT + '.tmp', OUT) } catch {}
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+async function waitFor(ctx, name, ms = 60000) {
+  const end = Date.now() + ms
+  while (Date.now() < end) {
+    try { const s = ctx.get(name); if (s !== undefined) return s } catch { /* 继续等 */ }
+    await sleep(300)
+  }
+  return undefined
+}
+
+export const name = 'ppt-scope-probe'
+
+export function apply(ctx) {
+  if (process.env.PPT_SCOPE_VERIFY !== '1') return
+  main(ctx).catch((e) => { RESULT.fatal = String(e?.stack ?? e); flush(); log('FATAL ' + e) })
+}
+
+async function main(ctx) {
+  const systemPrompt = await waitFor(ctx, 'systemPrompt')
+  const tools = await waitFor(ctx, 'tools')
+  const agents = await waitFor(ctx, 'agents')
+  const presets = await waitFor(ctx, 'agentPresets')
+  const skills = ctx.get('skills')
+  if (!systemPrompt || !tools || !agents || !presets) {
+    RESULT.fatal = '必需服务缺失：' + JSON.stringify({ systemPrompt: !!systemPrompt, tools: !!tools, agents: !!agents, presets: !!presets })
+    flush(); return
+  }
+  RESULT.stages.push('services')
+  log('服务就绪')
+
+  // 等到本插件把预设声明落定（list() 会跑注册表的 diagnostic，broken 判据就在这里）
+  let list = []
+  for (let i = 0; i < 100; i++) {
+    list = await presets.list().catch((e) => [{ id: '(list 抛错)', broken: String(e?.message ?? e) }])
+    if (list.some((p) => p.id === PRESET)) break
+    await sleep(300)
+  }
+  RESULT.matrix.presets = list.map((p) => ({ id: p.id, name: p.name, order: p.order, broken: p.broken }))
+  RESULT.stages.push('preset-declared')
+  log('presets=' + JSON.stringify(list.map((p) => p.id + (p.broken ? ':broken' : ''))))
+
+  const presetBroken = (list.find((p) => p.id === PRESET) || {}).broken
+  if (presetBroken !== undefined) {
+    // 预设不健康：仍然把健康度证据写出来，让脚本判 FAIL（不继续建会话）
+    RESULT.stages.push('preset-broken')
+    flush(); return
+  }
+
+  let agentOptions
+  try {
+    const sel = ctx.get('agentDefaultModel')?.currentSelection()
+    if (sel?.provider && sel?.model) agentOptions = { provider: sel.provider, model: sel.model }
+  } catch { /* 缺默认模型不影响建会话 */ }
+
+  async function makeAgent(presetId, sessionId) {
+    // 先写会话状态（提示段判据需要 workflowActive=true）：字段照 lib/state.js 的 DEFAULT_SESSION
+    mkdirSync(join(HOME, 'ppt-studio'), { recursive: true })
+    writeFileSync(join(HOME, 'ppt-studio', 'session-' + String(sessionId).replace(/[^\w-]+/g, '_') + '.json'),
+      JSON.stringify({
+        routing: 'on', mode: 'auto', fidelity: 'auto', review: 'points', quality: 'standard',
+        engine: 'auto', quick: false, template: null, pauseAfter: [],
+        workflowActive: true, taskType: 'from-scratch', deckDir: null,
+      }, null, 2), 'utf8')
+    const resolved = await presets.resolve(presetId)
+    if (resolved.broken !== undefined) throw new Error('预设 ' + presetId + ' 不健康：' + resolved.broken)
+    const handle = await agents.create({
+      sessionId,
+      ...(agentOptions === undefined ? {} : { agentOptions }),
+      meta: { cwd: CWD, agentPreset: resolved.id },
+      setup: async (agentCtx) => { await presets.mount(agentCtx, resolved.id) },
+    })
+    return handle.agent
+  }
+
+  async function measure(agent) {
+    const out = { sessionId: agent.id, composedPreset: null, tools: [], toolCount: 0, pptTools: [],
+      skills: [], pptSkills: [], sections: [], hasWorkflowSection: false, assemblyPptTools: [], errors: [] }
+    try { out.composedPreset = presets.composedPreset(agent.ctx) ?? null } catch (e) { out.errors.push('composedPreset: ' + e.message) }
+    try {
+      const names = tools.schemas(agent).map((s) => s.name).sort()
+      out.tools = names; out.toolCount = names.length; out.pptTools = names.filter((n) => n.startsWith('ppt_'))
+    } catch (e) { out.errors.push('schemas: ' + String(e?.message ?? e)) }
+    try {
+      if (skills === undefined) out.errors.push('skills 服务缺失')
+      else {
+        const rows = await skills.list({ scope: agent })
+        out.skills = rows.map((s) => s.name).sort()
+        out.pptSkills = out.skills.filter((n) => n.startsWith('ppt-studio-'))
+      }
+    } catch (e) { out.errors.push('skills.list: ' + String(e?.message ?? e)) }
+    try {
+      // 与宿主 agent-loop 同一入口：assembleContextFor(agent) = { agent, scope: agent }
+      const assembly = await systemPrompt.assemble({ agent, scope: agent })
+      out.sections = (assembly.sections ?? []).map((s) => s.name)
+      out.hasWorkflowSection = out.sections.includes('ppt-workflow')
+      out.assemblyPptTools = (assembly.tools ?? []).map((t) => t.name).filter((n) => n.startsWith('ppt_')).sort()
+    } catch (e) { out.errors.push('assemble: ' + String(e?.message ?? e)) }
+    return out
+  }
+
+  // 对照预设（standard）
+  try {
+    const a = await makeAgent(OTHER, 'scope-verify-' + OTHER)
+    RESULT.matrix[OTHER] = await measure(a)
+    RESULT.stages.push('agent:' + OTHER)
+    log(OTHER + ' tools=' + RESULT.matrix[OTHER].toolCount + ' ppt=' + RESULT.matrix[OTHER].pptTools.length
+      + ' skills=' + RESULT.matrix[OTHER].pptSkills.length + ' workflowSection=' + RESULT.matrix[OTHER].hasWorkflowSection)
+  } catch (e) { RESULT.errors.push(OTHER + ': ' + String(e?.message ?? e)); log('ERR ' + OTHER + ' ' + e) }
+
+  // ppt 预设
+  let pptAgent
+  try {
+    pptAgent = await makeAgent(PRESET, 'scope-verify-' + PRESET)
+    RESULT.matrix[PRESET] = await measure(pptAgent)
+    RESULT.stages.push('agent:' + PRESET)
+    log(PRESET + ' tools=' + RESULT.matrix[PRESET].toolCount + ' ppt=' + RESULT.matrix[PRESET].pptTools.length
+      + ' skills=' + RESULT.matrix[PRESET].pptSkills.length + ' workflowSection=' + RESULT.matrix[PRESET].hasWorkflowSection)
+  } catch (e) { RESULT.errors.push(PRESET + ': ' + String(e?.message ?? e)); log('ERR ' + PRESET + ' ' + e) }
+
+  // 会话内切换：在对照预设的 agent 上调注册表自己的 select（= agent-presets.swap 的源头函数）
+  try {
+    if (RESULT.matrix[OTHER] !== undefined) {
+      const again = await makeAgentAfterSwitch(presets, agents, agentOptions)
+      RESULT.matrix.switched = again
+      RESULT.stages.push('switched')
+      log('switched composedPreset=' + again.composedPreset + ' ppt=' + again.pptTools.length
+        + ' skills=' + again.pptSkills.length + ' workflowSection=' + again.hasWorkflowSection)
+    }
+  } catch (e) { RESULT.errors.push('switch: ' + String(e?.message ?? e)); log('ERR switch ' + e) }
+
+  async function makeAgentAfterSwitch(presets2, agents2, agentOptions2) {
+    // 重新走一遍"先 standard 再切"的完整路径，避免复用已被测过的 agent 造成歧义
+    const sid = 'scope-verify-switch'
+    mkdirSync(join(HOME, 'ppt-studio'), { recursive: true })
+    writeFileSync(join(HOME, 'ppt-studio', 'session-' + sid + '.json'),
+      JSON.stringify({
+        routing: 'on', mode: 'auto', fidelity: 'auto', review: 'points', quality: 'standard',
+        engine: 'auto', quick: false, template: null, pauseAfter: [],
+        workflowActive: true, taskType: 'from-scratch', deckDir: null,
+      }, null, 2), 'utf8')
+    const first = await presets2.resolve(OTHER)
+    const handle = await agents2.create({
+      sessionId: sid,
+      ...(agentOptions2 === undefined ? {} : { agentOptions: agentOptions2 }),
+      meta: { cwd: CWD, agentPreset: first.id },
+      setup: async (agentCtx) => { await presets2.mount(agentCtx, first.id) },
+    })
+    const agent = handle.agent
+    await presets2.select(agent, PRESET)
+    await sleep(500)
+    return measure(agent)
+  }
+
+  // 全局视图（无预设）
+  try {
+    const names = tools.schemas(undefined).map((s) => s.name).sort()
+    RESULT.matrix.global = { toolCount: names.length, pptTools: names.filter((n) => n.startsWith('ppt_')) }
+    RESULT.stages.push('global-view')
+    log('global tools=' + names.length + ' ppt=' + RESULT.matrix.global.pptTools.length)
+  } catch (e) { RESULT.errors.push('global: ' + String(e?.message ?? e)) }
+
+  // 负面对照：自己注册一条故意写错的 file:// 行，看宿主的失败形状
+  if (NEG) {
+    try {
+      const bogus = new URL('nope-missing.js', import.meta.url).href
+      const unregister = await presets.register({
+        id: 'scope-verify-broken', name: 'scope verify broken (预期 broken)',
+        plugins: [{ id: 'bogus-row', name: bogus }],
+      })
+      const after = await presets.list()
+      const row = after.find((p) => p.id === 'scope-verify-broken') || {}
+      RESULT.matrix.negative = {
+        bogusName: bogus,
+        brokenRow: row.broken,
+        pptStillHealthy: (after.find((p) => p.id === PRESET) || {}).broken === undefined,
+      }
+      RESULT.stages.push('negative')
+      log('negative broken=' + JSON.stringify(row.broken))
+      await unregister()
+    } catch (e) { RESULT.errors.push('negative: ' + String(e?.message ?? e)) }
+  }
+
+  RESULT.finishedAt = new Date().toISOString()
+  flush()
+  log('DONE')
+}
+`
+}

package/skills/ppt-studio-data/SKILL.md

@@ -22,16 +22,14 @@ whenToUse: 正在给页面安排图表、表格、关键数字；或用户反馈
 | **图表作装饰 / 示意 / 版式衬底**（不承载结论） | **不必** | 让它纯几何即可；**别让它假装承载数据**（要么标注"示意"，要么干脆用形状） |
 | 介于两者之间 | 按"读者是否需要读出值"判 | 拿不准就至少给单位与一句"读图结论"——结论句写在**图外**（§2 路径 A），不是往图里塞标签 |
 
-**成品层（交付物）**：导出的 .pptx 里 `chart` 元素**只画几何**——柱/折线/饼形，
-**没有**分类名、数值、单位、坐标轴、图例（实测：导出包里没有任何 chart 部件，slide XML 里只有你自己写的 text 元素）。
+**成品层（交付物，2026-09-26 第三轮起）**：`chart` 元素**默认产出原生可编辑图表**——包里是 `ppt/charts/chartN.xml` + **内嵌数据工作簿** `ppt/embeddings/*.xlsx`：PowerPoint 里能"**编辑数据**"、能换图表类型，坐标轴/网格线/图例/数据标签**由图表自己算**（分类名与数值都在图表里，不再需要你手写文本框）。
+`chart.render: vector` 才回到旧行为（矢量拼绘：只画柱/折线/饼形，**没有**轴/图例/标签，标签全靠你补）。`chart.legend / labels / axes` 是可选开关：默认多系列或饼图显示图例、饼图显示百分比标签、柱/线显示数值标签。
 
-**预览层（`ppt_render` 的 HTML）也不是"什么都画"**：bar/line 会画分类名（**超过 8 字截断**）+ 5 条网格线与**数值刻度**（那个 y 轴是按最大值归一化的，不代表真实量纲）；
-**pie 不画分类名，却照样画那套 y 轴刻度**（对饼图毫无意义）；**每个数据点的具体值只在悬停提示里**。
-所以"预览里看着能懂"对饼图根本不成立，对 bar/line 也仅是分类名与相对刻度可读。
+**预览层（`ppt_render` 的 HTML）与成品同源**：`svgCharts.js` 与导出共用同一个图表模型，预览里能看到的轴/刻度/网格/图例/数据标签与成品一致（旧版"预览画了刻度、成品却没有"的错位已消除）。分类名超过 8 字截断（预览与成品同一处理）。
 
 → **预览是定版参考，交付物是 pptx**：只按预览确认"图表能看懂"，交付出去可能就是一张没有标注的图形。
 
-→ **承载数据的图表** = 图表元素（几何）+ 你自己补的文本（分类名/数值/单位/图例/结论）。
+→ **承载数据的图表** = 图表元素 + 你补的**单位与一句结论句**（native 默认已带分类名/数值/图例；`render: vector` 才需要自己补标签）。
 → **装饰性图表** 可以不带标签，但交付说明里加一句"该图仅作示意"（本手册的补充建议，不在铁律 7 的必含项里），并且不要用它去支撑页面结论。
 
 ## 1. 选型：先问"读者要读到什么"
@@ -74,7 +72,7 @@ whenToUse: 正在给页面安排图表、表格、关键数字；或用户反馈
 
 | 做法 | 怎么写 | 代价 |
 |---|---|---|
-| **A. 标签放图表框外**（默认，永远可用） | 图表 bounds 缩小，分类名/数值/图例排在图框上/下/左/右的空白区 | 需要预留空间（图表别占满整页） |
+| **A. 图内标签 / 图外标签**（默认） | native（默认）：`chart.labels: true` 把数值画在图上、图例自动生成、轴与网格自带；vector：图表 bounds 缩小，分类名/数值/图例排在图框外空白区 | native 不需预留空间；vector 需要（图表别占满整页） |
 | **B. 图当衬底**（仅衬底类图） | 给 chart 加 `role: background`，再把这组重叠写进该页 `expectedOverlaps` | 声明的是"这张图是承载文字的底"——语义变了，且**文字压在图形上仍然难读**，声明不会替你解决可读性 |
 | **C. 图纯装饰**（仅纯装饰图） | 给 chart 加 `role: decoration`，**完全退出重叠报告**（不用写声明） | `decoration` 的语义是"此元素不承载信息"；只豁免**重叠**，不豁免超页面/超安全区/文本溢出 |
 

package/skills/ppt-studio-manual/SKILL.md

@@ -34,7 +34,7 @@ DSH 上做 PPT 的工作区：说需求 → 四类任务工作流 → 「数字
 | "字号可以 11pt 吗" | **可以**（下限 = 用户指令）：用户给了下限（如"不得小于14号"）→ 写入 theme.minFontSize 并严格遵守；用户没给 → 不设任何强制下限（插件无默认）。 |
 | "为什么导出会缩字" | verify 已报溢出 → 先清零（扩容器/精简文案/显式 `\n`）；verify 通过 ⇒ 导出不缩字 |
 | "预览链接 404" | 路由在 PPT 工作室会话挂载时注册——确认当前是 PPT 工作室会话（不是默认会话） |
-| "图表能画什么" | bar/line/pie（矢量拼绘）；python-pptx 兜底引擎降级表格；复杂图表用图片或 Shape 拼 |
+| "图表能画什么" | bar/line/pie，默认**原生可编辑图表**（自带轴/网格/图例/数据标签，可"编辑数据"，数据在内嵌工作簿）；`chart.render: vector` 回到矢量拼绘（标签自己补） |
 | "用别人的模板做" | `ppt_import`（带参考层：source.pptx + 真渲染整页 + 全量色板）→ 先 read_image 看 `reference/previews/*.png` 真身再动手 |
 | "要 100% 像模板" | `ppt_patch`（手术模式：只换文字/表格内容，XML 原样） |
 | "网页预览对，打开 pptx 线条不对" | 旧引擎三个连线编码 bug（四个症状：斜线镜像 / × 少一笔 / 箭头消失 / 水平线变斜），**均已修复**——看 `ppt_export` 报告的"线方向 N/N"自证；修复前导出的产物重新 `ppt_export` |
@@ -97,7 +97,7 @@ DSH 上做 PPT 的工作区：说需求 → 四类任务工作流 → 「数字
 ## 7. 开发维护（仅改插件时用）
 
 - 改码：`src/` → `node scripts/build.mjs` → **重启 host**（插件经 agent preset 会话装配；`dev_reload_package` 只覆盖注入器装配包，且注入器 junction 已存在时会指向旧安装根）。
-- 回归：`node scripts/smoke.mjs`（276 断言）→ `node scripts/preflight-1.0.mjs`（发布预检）→ `node scripts/regression-real.mjs`。
+- 回归：`node scripts/smoke.mjs`（303 断言）→ `node scripts/preflight-1.0.mjs`（发布预检）→ `node scripts/regression-real.mjs`。
 - 跨层验证纪律：**预览层与成品层必须互相验证**——`ppt_render`+`ppt_verify` 只管 HTML/估算层，OOXML 层靠 `ppt_export` 的 parity 自证（表/图/线方向）+ `ppt_visual` 真渲染抽检；只跑单层会漏掉"预览对、成品错"（2026-09-14 连线方向事故）。
 - 文档链：改需求/决策 → docs/01；改机制 → docs/02；每次 → docs/03；验收 → docs/04；发布前 → docs/06。
 - 装配：**默认装法是 npm 包名**（`dsh plugin --profile <p> add dsh-ppt-studio`，profile 级、随 profile 启动装配；**桌面端**在插件管理里填同一个包名 `dsh-ppt-studio`；GitHub Release 的资产 URL 与 `scripts/install*.mjs` 是离线/归档备选）。装完**必须重启 host**。排查：`dsh plugin --profile web list` → `dsh --profile web --dump-config` 找 `ppt-studio` 行。preset 插件行只在"离线 junction"场景用，与 bundle 装法**互斥**。