dsh-ppt-studio 1.1.5 → 1.2.1

package/scripts/check-unknown-keys.mjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * `unknown-key` 检查：页面级/元素级**未知键** ⇒ 报 warning（**不阻断** ✓）。
+ *
+ * 为什么需要：写错/残留的键过去会被静默忽略 ⇒ 表面"出图了"，其实是空页或漏项。
+ *
+ * 白名单来源（**不手写猜测** ✓）：
+ *   · 页面级：从 `src/pptd/schema.js` 的 `validatePage` 里**真正被访问的 `page.<键>`** 推导；
+ *   · 元素级：`ELEMENT_KEYS`（类型专属）+ 通用键（`elementId/elementType/bounds/...`）+ `path`（custGeom 路径）。
+ * 防漂移：默认模式扫**本仓自带示例**，一旦发现未知键就**判失败** ⇒ 白名单漏项会立刻在 `npm test` 暴露 ✓
+ *         （宁可在 CI 里发现自己漏了键，也不能对用户误报）。
+ *
+ * 用法：
+ *   node scripts/check-unknown-keys.mjs                  # 扫 examples/hand-drawn + examples/smoke（必须 0 命中）
+ *   node scripts/check-unknown-keys.mjs --fixture <dir>   # 扫指定夹具（至少 1 命中才算红样本通过）
+ */
+import { readdirSync, readFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+
+const ROOT = new URL('..', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')
+
+// ── 白名单（来源见文件头注释；改 schema 消费点时同步这里）──
+const PAGE_KEYS = new Set([
+  'version', 'pageType', 'title', 'elements', 'notes', 'groups', 'expectedOverlaps',
+  'background', 'blocks', 'contrastExempt', 'expectedOutOfSafeArea', 'overlapMode',
+  'rowBounds', 'safeArea', 'source',
+])
+const EL_COMMON = new Set([
+  'elementId', 'elementType', 'bounds', 'role', 'roleReason', 'contains', 'badgeOf',
+  'expectedOverlaps', 'rotation',
+])
+const EL_BY_TYPE = {
+  text: ['content'],
+  shape: ['kind', 'fill', 'line', 'path'],
+  line: ['points', 'arrow', 'line', 'attach', 'dash'],
+  image: ['src', 'fit'],
+  table: ['cols', 'rows', 'header'],
+  chart: ['chart'],
+}
+const elAllowed = (type) => new Set([...EL_COMMON, ...(EL_BY_TYPE[type] ?? [])])
+
+// ── 收集待检 YAML ──
+const collect = (dir) => {
+  const out = []
+  const rec = (d) => {
+    for (const e of readdirSync(d, { withFileTypes: true })) {
+      const p = join(d, e.name)
+      if (/preview$|\.tmp/.test(p)) continue
+      if (e.isDirectory()) rec(p)
+      else if (/^pages?\/.*\.ya?ml$|pages\/.*\.ya?ml$/.test(p.replace(/\\/g, '/')) || /\.ya?ml$/.test(e.name)) out.push(p)
+    }
+  }
+  rec(dir)
+  return out.filter((p) => !/deck\.ya?ml$/.test(p)) // deck.yaml 是 deck 级（另有 schema 校验）
+}
+
+// ── 极简 YAML 顶层/元素键扫描（只认结构，不做完整解析）──
+const scanPage = (file) => {
+  const text = readFileSync(file, 'utf8')
+  const lines = text.split('\n')
+  const found = []
+  let inElements = false
+  let curEl = null
+  const flushEl = () => {
+    if (!curEl) return
+    const allowed = elAllowed(curEl.type)
+    for (const k of Object.keys(curEl.keys)) if (!allowed.has(k)) found.push({ scope: '元素 ' + (curEl.id ?? '?'), key: k })
+    curEl = null
+  }
+  for (let i = 0; i < lines.length; i++) {
+    const raw = lines[i]
+    const line = raw.replace(/\s+#.*$/, '')
+    if (!line.trim() || /^\s*#/.test(line)) continue
+    const top = line.match(/^([A-Za-z_][\w]*):/)
+    if (top) {
+      if (top[1] === 'elements') { inElements = true; continue }
+      if (!PAGE_KEYS.has(top[1])) found.push({ scope: '页面', key: top[1] })
+      continue
+    }
+    if (!inElements) continue
+    const elStart = line.match(/^ {2}- elementId:\s*(\S+)/)
+    if (elStart) { flushEl(); curEl = { id: elStart[1].replace(/['"]/g, ''), type: null, keys: {} }; continue }
+    if (!curEl) continue
+    const kv = line.match(/^ {4}([A-Za-z_][\w]*):\s*(.*)$/)
+    if (!kv) continue
+    const [, k, v] = kv
+    if (k === 'elementType') curEl.type = v.trim().replace(/['"]/g, '')
+    else curEl.keys[k] = true
+  }
+  flushEl()
+  return found
+}
+
+// ── 主流程 ──
+const args = process.argv.slice(2)
+const fixtureIdx = args.indexOf('--fixture')
+const targets = fixtureIdx >= 0 ? [join(ROOT, args[fixtureIdx + 1])] : [join(ROOT, 'examples', 'hand-drawn'), join(ROOT, 'examples', 'smoke')]
+const hits = []
+for (const t of targets) {
+  if (!existsSync(t)) continue
+  for (const f of collect(t)) for (const h of scanPage(f)) hits.push({ file: f.replace(ROOT + '/', ''), ...h })
+}
+if (fixtureIdx >= 0) {
+  console.log('unknown-key 红样本：[fixture] 命中 ' + hits.length + ' 处' + (hits.length > 0 ? ' ✓' : ' ✗'))
+  for (const h of hits) console.log('   [警告][unknown-key] ' + h.file + ' — ' + h.scope + ' 出现未知键 "' + h.key + '"')
+  process.exit(hits.length > 0 ? 0 : 1)
+}
+console.log('unknown-key 零误报自证：扫 ' + targets.length + ' 个目录｜未知键 ' + hits.length + ' 处')
+for (const h of hits.slice(0, 12)) console.log('   · ' + h.file + ' ' + h.scope + ' → ' + h.key)
+if (hits.length) {
+  console.log('✗ 本仓示例出现未知键 ⇒ 要么页面写错（应修页面），要么白名单漏了合法键（应补白名单）——两者都必须处理')
+  process.exit(1)
+}
+console.log('✓ 本仓示例 0 未知键（白名单与真实用法一致）')

package/scripts/fixtures/handdrawn-baseline.json

@@ -0,0 +1,177 @@
+{
+  "savedAt": "2026-09-30T04:24:38.618Z",
+  "head": "55f17ad08101da726b73a9001134a6746ae86299",
+  "digest": "f675371b5e56d694d80e4915cc443ccd0aa3e88b7c97d367aceaf5539ae35fbd",
+  "perPage": [
+    {
+      "page": "01",
+      "els": 23,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 3,
+      "warnCodes": [
+        "hotspot"
+      ],
+      "digest": "cc0400aa6eb74da595cc69ee555418d2123c408eaebc739b389ba4ee142c1d17"
+    },
+    {
+      "page": "02",
+      "els": 19,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 1,
+      "warnCodes": [
+        "density"
+      ],
+      "digest": "fb901a860b2812aa8dc00b34e8d0f48b87b25fecc0eec6471cea92fa637d272c"
+    },
+    {
+      "page": "03",
+      "els": 27,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 5,
+      "warnCodes": [
+        "density",
+        "hotspot",
+        "line-end-off-edge"
+      ],
+      "digest": "82603d08ddeed43514ceca9dca6a26a72cff87bdd5009651c3444d6bd3d5b700"
+    },
+    {
+      "page": "04",
+      "els": 31,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 7,
+      "warnCodes": [
+        "arrow-tip-inside-shape",
+        "density",
+        "hotspot"
+      ],
+      "digest": "4ba29ae26b06e837e647c6c9ffe88139c8e853c637b78b1808c8a2c60512aad1"
+    },
+    {
+      "page": "05",
+      "els": 23,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 3,
+      "warnCodes": [
+        "density",
+        "hotspot"
+      ],
+      "digest": "08c7d4dc3efce9f743a96cd25489b94dbfd0d8ea03efb8650432769860fa5dd3"
+    },
+    {
+      "page": "06",
+      "els": 17,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 4,
+      "warnCodes": [
+        "line-diagonal-segment"
+      ],
+      "digest": "dc9bafef54b12d21bed5e158541f1338189ece093592d89b3534a024bb60956a"
+    },
+    {
+      "page": "07",
+      "els": 10,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 0,
+      "warnCodes": [],
+      "digest": "7dd49bca1f4d720972e5540ab00c08d11f1e543d0b50151126c0fee5944d22c8"
+    },
+    {
+      "page": "08",
+      "els": 23,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 6,
+      "warnCodes": [
+        "line-diagonal-segment"
+      ],
+      "digest": "e6955cc6d03591df46be9312201f2a5088c1c26a64248304ed1d00d1a48030d4"
+    },
+    {
+      "page": "09",
+      "els": 29,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 1,
+      "warnCodes": [
+        "line-crossing"
+      ],
+      "digest": "3bd30c8dc70278153553e829575e05818449883b8a1a101f5f4025c4660a5711"
+    },
+    {
+      "page": "10",
+      "els": 27,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 2,
+      "warnCodes": [
+        "density",
+        "hotspot"
+      ],
+      "digest": "475fbd6aaa18735c00a211387a89a5eabc45e90294dbc36e480611c1554a8dc7"
+    },
+    {
+      "page": "11",
+      "els": 18,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 0,
+      "warnCodes": [],
+      "digest": "45e04425fe4a65830f3850c66f166efc492befee277862c3d62837f9d764a55a"
+    },
+    {
+      "page": "12",
+      "els": 29,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 1,
+      "warnCodes": [
+        "density"
+      ],
+      "digest": "6c29eaebbde6714ad9b54e10cfa078070aab86a7c581f2f985424f873a8e16a6"
+    },
+    {
+      "page": "13",
+      "els": 25,
+      "errors": 0,
+      "errorCodes": [],
+      "warns": 7,
+      "warnCodes": [
+        "attach-override",
+        "density",
+        "hotspot"
+      ],
+      "digest": "e4d6fc9e7aa69febc5af53cb659a3553f70655a0e2bafb85e2476ecb98ec6ee4"
+    }
+  ],
+  "pngs": {
+    "01-层级树（手画）.png": "e58fadc991edb4b57b6832cad9830ed28aa62f34fb8097e7ef56352fee915855",
+    "02-矩阵（手画）.png": "f72c62f4215b4f09643c90221adbd97ee8d725b3d55e8b7ca7f88ee25dee1a66",
+    "03-时间轴（手画）.png": "df7bd35389ab379c6cabdfac2ae82ebec29aebb2bdfd5b5ce82f895fd897adb5",
+    "04-泳道（手画）.png": "ee642e5989c1c4f09a079e26e82b1b720449910f3a92d8d6fdbebf5a23b888af",
+    "05-左右对比（手画）.png": "afa2caf3a16bcebc8cb1d3ead09a5dc5b3eaed6ca682281d8268402d50d0bd71",
+    "06-闭环（手画）.png": "f5b8cf822c503fbe1669fea5fc109fb84d946a87ddb35b6bd6a12ed90acf8bbd",
+    "07-漏斗（手画）.png": "f00e0251aef97510aec6336fe2a32fcd8f5acb0c5b2c1e361be95598909d72b1",
+    "08-步骤环（手画）.png": "50e1c1f175fea024c0c5b956cfb919dc44fa7e8329646199343097c538943d31",
+    "09-时序（手画）.png": "1cc278d9a41f5f3e2217f0913af954b264a2e01a6326723fcce4584fdbe20331",
+    "10-状态机（手画）.png": "9a84e28cabacf631118633e0c50ca4ef4a402fb659da0c8310b80c421a9ff36e",
+    "11-流程图（手画）.png": "dcf2887e1824496448bfaf2be3757fb7087a989e63a8f2eb55e3be150c5727ab",
+    "12-分层架构（手画）.png": "69989c267bf13a89279f4d192e752f8aff918d49b0583c1e0888a60ea22e37a0",
+    "13-平台架构（手画）.png": "05a454b19ffd2aac351e2e343d4a545aeeb630f1bd5eda0183fe3fe2fb09c100"
+  },
+  "history": [
+    {
+      "at": "2026-09-30T04:24:38.616Z",
+      "from": "f675371b5e56d694d80e4915cc443ccd0aa3e88b7c97d367aceaf5539ae35fbd",
+      "to": "f675371b5e56d694d80e4915cc443ccd0aa3e88b7c97d367aceaf5539ae35fbd",
+      "reason": "摘要未变（重采）: P2-3 补采：为基线补写变更沿革（history 断言上线前的一次留痕）"
+    }
+  ]
+}

package/scripts/fixtures/prompt-cost-baseline.json

@@ -0,0 +1,178 @@
+{
+  "measuredAt": "2026-09-27",
+  "estimator": "CJK=1 token/字；其余=4 字节/token",
+  "toolCount": 22,
+  "tools": [
+    {
+      "name": "ppt_verify",
+      "chars": 860,
+      "bytes": 1467,
+      "tokens": 436
+    },
+    {
+      "name": "ppt_patch",
+      "chars": 767,
+      "bytes": 1283,
+      "tokens": 380
+    },
+    {
+      "name": "ppt_visual",
+      "chars": 733,
+      "bytes": 1208,
+      "tokens": 355
+    },
+    {
+      "name": "ppt_template_add",
+      "chars": 795,
+      "bytes": 1211,
+      "tokens": 353
+    },
+    {
+      "name": "ppt_splice",
+      "chars": 677,
+      "bytes": 1071,
+      "tokens": 310
+    },
+    {
+      "name": "ppt_export",
+      "chars": 637,
+      "bytes": 955,
+      "tokens": 279
+    },
+    {
+      "name": "ppt_template_styleaudit",
+      "chars": 573,
+      "bytes": 853,
+      "tokens": 244
+    },
+    {
+      "name": "ppt_crosscheck",
+      "chars": 425,
+      "bytes": 761,
+      "tokens": 233
+    },
+    {
+      "name": "ppt_new",
+      "chars": 524,
+      "bytes": 712,
+      "tokens": 202
+    },
+    {
+      "name": "ppt_shot",
+      "chars": 533,
+      "bytes": 711,
+      "tokens": 199
+    },
+    {
+      "name": "ppt_slice",
+      "chars": 459,
+      "bytes": 657,
+      "tokens": 188
+    },
+    {
+      "name": "ppt_measure",
+      "chars": 407,
+      "bytes": 629,
+      "tokens": 182
+    },
+    {
+      "name": "ppt_templates",
+      "chars": 354,
+      "bytes": 580,
+      "tokens": 172
+    },
+    {
+      "name": "ppt_template_remove",
+      "chars": 352,
+      "bytes": 534,
+      "tokens": 157
+    },
+    {
+      "name": "ppt_preview",
+      "chars": 287,
+      "bytes": 443,
+      "tokens": 129
+    },
+    {
+      "name": "ppt_import",
+      "chars": 318,
+      "bytes": 410,
+      "tokens": 114
+    },
+    {
+      "name": "ppt_render",
+      "chars": 315,
+      "bytes": 399,
+      "tokens": 110
+    },
+    {
+      "name": "ppt_check",
+      "chars": 284,
+      "bytes": 380,
+      "tokens": 107
+    },
+    {
+      "name": "ppt_media",
+      "chars": 254,
+      "bytes": 340,
+      "tokens": 96
+    },
+    {
+      "name": "ppt_schema",
+      "chars": 214,
+      "bytes": 292,
+      "tokens": 83
+    },
+    {
+      "name": "ppt_state",
+      "chars": 249,
+      "bytes": 303,
+      "tokens": 83
+    },
+    {
+      "name": "ppt_status",
+      "chars": 213,
+      "bytes": 283,
+      "tokens": 80
+    }
+  ],
+  "skills": [
+    {
+      "name": "ppt-studio-manual",
+      "chars": 201,
+      "bytes": 403,
+      "tokens": 125
+    },
+    {
+      "name": "ppt-studio-data",
+      "chars": 127,
+      "bytes": 331,
+      "tokens": 107
+    },
+    {
+      "name": "ppt-studio-copy",
+      "chars": 131,
+      "bytes": 319,
+      "tokens": 102
+    },
+    {
+      "name": "ppt-studio-craft",
+      "chars": 121,
+      "bytes": 307,
+      "tokens": 99
+    }
+  ],
+  "workflow": {
+    "tokens": 4409,
+    "chars": 6941,
+    "quickTokens": 575,
+    "quickChars": 836,
+    "note": ""
+  },
+  "totals": {
+    "tools": 4492,
+    "skills": 433,
+    "workflow": 4409,
+    "all": 9334
+  }
+}

package/scripts/handdrawn-option-probe.mjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ *
+ *   · `pyramid: true` ⇒ 反向（逐段**放宽**的金字塔，而不是收窄的漏斗）
+ *   · `minRatio`      ⇒ 末段宽度相对首段的比例（末段宽 = 首段宽 × ratio）
+ * 本探针用**显式 custGeom 元素**把两种变体画出来并过门禁（不需要族代码）。
+ *
+ * 用法：node scripts/handdrawn-option-probe.mjs
+ */
+import { mkdirSync, writeFileSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { resolveDeck } from '../src/pptd/schema.js'
+import { renderDeck } from '../src/pptd/render-html.js'
+import { verifyDeck } from '../src/verify.js'
+
+const ROOT = new URL('..', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')
+const dir = join(ROOT, 'examples', 'option-probe')
+mkdirSync(join(dir, 'pages'), { recursive: true })
+writeFileSync(join(dir, 'deck.yaml'), [
+  'version: 1', 'title: 选项探针', 'size: [960, 540]', 'theme:', '  colors:',
+  '    primary: "#7C3AED"', '    accent: "#E11D48"', '    soft: "#EDE9FE"',
+  '    text: "#2E1065"', '    bg: "#FAF5FF"', 'pages:',
+  '  - pages/pyramid.yaml', '  - pages/narrow.yaml', '',
+].join('\n'))
+
+// 画一条"逐段变宽/变窄"的 custGeom 梯形带（手画等价物）
+function bands(rows, title, sub, label) {
+  const bw = 800, bx = 80, bandH = 70, topY = 148
+  const L = ['pageType: content', 'elements:']
+  L.push('  - elementId: title', '    elementType: text', '    bounds: [60, 34, 760, 38]',
+    `    content: { text: '${title}', fontSize: 25, color: '#2E1065', bold: true }`)
+  L.push('  - elementId: sub', '    elementType: text', '    bounds: [60, 76, 820, 22]',
+    `    content: { text: '${sub}', fontSize: 12, color: '#64748B' }`)
+  rows.forEach(([name, topW], i) => {
+    const y = topY + i * bandH
+    const botW = i + 1 < rows.length ? rows[i + 1][1] : Math.round(topW * (label === 'pyramid' ? 1.5 : 0.5))
+    const lw = Math.max(120, Math.min(topW, botW) - 60)
+    L.push(`  - elementId: b${i}`, '    elementType: shape', '    kind: custGeom',
+      `    bounds: [${bx}, ${y}, ${bw}, ${bandH}]`,
+      `    fill: '${i === rows.length - 1 ? '#E11D48' : '#7C3AED'}'`,
+      "    line: { color: '#FFFFFF', width: 1.5 }", `    contains: [bt${i}]`,
+      '    path:', `      w: ${bw}`, `      h: ${bandH}`, '      commands:',
+      `        - { cmd: moveTo, pts: [[${Math.round((bw - topW) / 2)}, 0]] }`,
+      `        - { cmd: lnTo, pts: [[${Math.round((bw + topW) / 2)}, 0]] }`,
+      `        - { cmd: lnTo, pts: [[${Math.round((bw + botW) / 2)}, ${bandH}]] }`,
+      `        - { cmd: lnTo, pts: [[${Math.round((bw - botW) / 2)}, ${bandH}]] }`,
+      '        - { cmd: close }')
+    L.push(`  - elementId: bt${i}`, '    elementType: text',
+      `    bounds: [${Math.round(480 - lw / 2)}, ${y + 24}, ${lw}, 26]`,
+      `    content: { text: '${name}', fontSize: 15, color: '#FFFFFF', bold: true, align: center }`)
+  })
+  return L.join('\n') + '\n'
+}
+
+// 变体 A：pyramid（逐段放宽 = 金字塔，族里 pyramid: true 的等价物）
+writeFileSync(join(dir, 'pages', 'pyramid.yaml'), bands(
+  [['苗种', 240], ['育肥', 400], ['成鱼', 560], ['直供', 720]],
+  '金字塔变体（pyramid 等价）', '逐段放宽：苗种 240 → 育肥 400 → 成鱼 560 → 直供 720', 'pyramid'))
+
+// 变体 B：minRatio（末段宽 ≈ 首段宽 × 比例；这里用 0.25 的收窄漏斗）
+writeFileSync(join(dir, 'pages', 'narrow.yaml'), bands(
+  [['存栏', 760], ['达规格', 560], ['抽检', 360], ['直供', 190]],
+  '窄口漏斗变体（minRatio 等价）', '末段宽 ≈ 首段 × 0.25：760 → 560 → 360 → 190', 'narrow'))
+
+const ctx = await resolveDeck(dir)
+await renderDeck(ctx, { out: 'preview' })
+const layout = JSON.parse(readFileSync(join(dir, 'preview', 'layout.json'), 'utf8'))
+const pages = Array.isArray(layout.pages) ? layout.pages : Object.values(layout.pages)
+let bad = 0
+pages.forEach((p, i) => {
+  const v = verifyDeck({ pages: [p] })
+  const kind = i === 0 ? 'pyramid' : 'minRatio'
+  console.log('  ' + (v.errors.length ? '✗' : '✓') + ' ' + kind + '：元素 ' + p.elements.length + '｜门禁 错' + v.errors.length + '/警' + v.warns.length)
+  v.errors.slice(0, 3).forEach((e) => console.log('      [错][' + e.code + '] ' + String(e.message).slice(0, 88)))
+  if (v.errors.length) bad++
+})
+console.log('==== 选项等价探针：' + (bad === 0 ? '两个变体均 0 错（族的 pyramid / minRatio 在手画下等价可复现）' : bad + ' 页未通过') + ' ====')
+process.exit(bad === 0 ? 0 : 1)

package/scripts/probe-prompt-cost.mjs

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * 常驻 prompt 成本探针（阶段 A 硬门槛之一："无图任务 prompt 增幅 ≤5%"）。
+ *
+ * 用法：
+ *   node scripts/probe-prompt-cost.mjs            # 测量并**写入**基线 scripts/fixtures/prompt-cost-baseline.json
+ *   node scripts/probe-prompt-cost.mjs --check     # 与基线对比；总成本增幅 > 5% ⇒ 退出码 1（阶段 B 引入 ppt_diagram 时用）
+ *
+ * 度量口径（**只看模型真正要读的部分**，不看执行结果文本）：
+ *   ① 工具面：每个工具的 name + description + parameters schema（JSON 形态）——output 渲染器不进模型
+ *   ② 技能目录：skills/<name>/SKILL.md 的 front-matter（name + description）——正文只在加载时进上下文
+ *   ③ 工作流提示段：router.workflowSection(...)（仅在 workflowActive 时注入）
+ *
+ * token 估计采用 CJK 感知的保守口径：CJK 字符按 1 token/字，其余按 4 字节/token。
+ * 这是**估算**，用途是"同一口径下的相对增幅"（正是 ≤5% 这条门槛要判的东西），不是绝对 token 数。
+ */
+import { readFileSync, readdirSync, writeFileSync, existsSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { registerTools } from '../lib/tools.js'
+import { workflowSection } from '../lib/router.js'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const BASELINE = join(ROOT, 'scripts', 'fixtures', 'prompt-cost-baseline.json')
+const GROWTH_LIMIT = 1.05
+
+/** CJK 感知的 token 估算（保守：CJK 每字 1 token）。 */
+export function estTokens(s) {
+  let cjk = 0
+  for (const ch of s) if (/[\u3000-\u9fff\uff00-\uffef]/.test(ch)) cjk++
+  const rest = s.length - cjk
+  return Math.ceil(cjk + rest / 4)
+}
+const bytes = (s) => Buffer.byteLength(s, 'utf8')
+
+// ① 工具面：用桩 ctx 捕获全部注册定义（registerTools 只用 effect/tools.register/get）
+const captured = new Map()
+const stub = {
+  effect: (cb) => { cb(); return () => {} },
+  tools: { register: (def) => captured.set(def.name, def) },
+  get: () => undefined,
+}
+registerTools(stub)
+// ppt_state 由 statusToolFor 单独注册（也是模型可见的常驻工具）⇒ 一并计入
+try {
+  const { statusToolFor } = await import('../lib/index.js')
+  statusToolFor(stub, 'profile')
+} catch (e) {
+  console.log(`（提示：ppt_state 未能计入——${e.message}）`)
+}
+const tools = [...captured.values()].map((d) => {
+  const text = JSON.stringify({ name: d.name, description: d.description ?? '', parameters: d.parameters ?? {} })
+  return { name: d.name, chars: text.length, bytes: bytes(text), tokens: estTokens(text) }
+}).sort((a, b) => b.tokens - a.tokens)
+
+// ② 技能目录：front-matter 的 name + description
+const skills = []
+const skillsDir = join(ROOT, 'skills')
+for (const name of readdirSync(skillsDir).sort()) {
+  const f = join(skillsDir, name, 'SKILL.md')
+  if (!existsSync(f)) continue
+  const head = readFileSync(f, 'utf8').split(/^---\s*$/m)[1] ?? ''
+  const desc = (head.match(/^description:\s*(.*)$/m)?.[1] ?? '').trim()
+  const nm = (head.match(/^name:\s*(.*)$/m)?.[1] ?? name).trim()
+  const text = `${nm}\n${desc}`
+  skills.push({ name: nm, chars: text.length, bytes: bytes(text), tokens: estTokens(text) })
+}
+skills.sort((a, b) => b.tokens - a.tokens)
+
+// ③ 工作流提示段（仅有 workflowActive 时注入；两种档都要测——quick 档另有字节不变守卫）
+//    注意：workflowSection 返回 **{name, text}** 而不是字符串；cfg 需要 engine/mode/fidelity/quality/review/pauseAfter 等字段。
+const WF_CFG = { mode: 'normal', engine: 'auto', fidelity: 'balanced', quality: 'standard', review: 'full', pauseAfter: [] }
+function measureWorkflow(cfg) {
+  try {
+    const r = workflowSection('make', cfg)
+    const text = typeof r === 'string' ? r : (r?.text ?? '')
+    return text ? { tokens: estTokens(text), chars: text.length } : { tokens: 0, chars: 0 }
+  } catch (e) {
+    return { tokens: 0, chars: 0, error: e.message }
+  }
+}
+const wfStd = measureWorkflow(WF_CFG)
+const wfQuick = measureWorkflow({ ...WF_CFG, quick: true })
+let wf = { tokens: wfStd.tokens, chars: wfStd.chars, quickTokens: wfQuick.tokens, quickChars: wfQuick.chars, note: wfStd.error ?? '' }
+
+const sum = (list) => list.reduce((n, x) => n + x.tokens, 0)
+const totals = {
+  tools: sum(tools),
+  skills: sum(skills),
+  workflow: wf.tokens,
+  all: sum(tools) + sum(skills) + wf.tokens,
+}
+const report = {
+  measuredAt: new Date().toISOString().slice(0, 10),
+  estimator: 'CJK=1 token/字；其余=4 字节/token',
+  toolCount: tools.length,
+  tools,
+  skills,
+  workflow: wf,
+  totals,
+}
+
+const check = process.argv.includes('--check')
+let fail = 0
+console.log('==== 常驻 prompt 成本（模型要读的部分）====')
+console.log(`工具面：${tools.length} 个工具 = ${totals.tools} tokens（前 5：${tools.slice(0, 5).map((t) => `${t.name} ${t.tokens}`).join('｜')}）`)
+console.log(`技能目录：${skills.length} 个 = ${totals.skills} tokens（${skills.map((s) => `${s.name.replace('ppt-studio-', '')} ${s.tokens}`).join('｜')}）`)
+console.log(`工作流段：${totals.workflow} tokens${wf.note ? `（${wf.note}）` : ''}`)
+console.log(`合计（不含工作流段，即"无图任务"的常驻面）：${totals.tools + totals.skills} tokens；含工作流段 ${totals.all} tokens`)
+
+if (check) {
+  if (!existsSync(BASELINE)) { console.log(`\n✗ 基线不存在（${BASELINE}）——先不带 --check 跑一次生成基线`); process.exit(1) }
+  const base = JSON.parse(readFileSync(BASELINE, 'utf8'))
+  const baseResident = base.totals.tools + base.totals.skills
+  const nowResident = totals.tools + totals.skills
+  const growth = nowResident / baseResident
+  const okAll = totals.all <= base.totals.all * GROWTH_LIMIT
+  const okResident = nowResident <= baseResident * GROWTH_LIMIT
+  console.log(`\n基线（${base.measuredAt}）：常驻 ${baseResident} / 含工作流 ${base.totals.all}`)
+  console.log(`${okResident ? '✓' : '✗'} 常驻面增幅 ${((growth - 1) * 100).toFixed(2)}%（上限 +5%）`)
+  console.log(`${okAll ? '✓' : '✗'} 含工作流段增幅 ${(((totals.all / base.totals.all) - 1) * 100).toFixed(2)}%（上限 +5%）`)
+  if (!okResident || !okAll) fail = 1
+} else {
+  writeFileSync(BASELINE, JSON.stringify(report, null, 2) + '\n')
+  console.log(`\n✓ 基线已写入 ${BASELINE.replace(ROOT + '\\', '')}`)
+}
+if (fail) { console.log('\n✗ 常驻 prompt 成本超出门槛'); process.exit(1) }