cardbuddy 0.14.3 → 0.16.0

package/dist/vendored/skills/dsl-card-generator/scripts/render_card.mjs

@@ -463,6 +463,75 @@ function describeRuntimeEvents(events) {
   }).filter(Boolean).slice(-20).join(' | ')
 }
 
+/**
+ * 抓取 `.phone__screen` 内全部 `[data-cid]` 元素的几何与文本度量。
+ *
+ * 返回 `{ elements, degenerate }`：
+ *  - `elements`：正常尺寸节点（≥1px），供评分 / 归因 / 设计稿配对使用；
+ *  - `degenerate`：**被压成零尺寸但仍参与布局**的节点（display:none / visibility:hidden 的
+ *    v-show 变体已剔除）。旧实现把它们直接丢掉，于是「被兄弟挤成 0 宽 → 文本每字一行 →
+ *    高度爆炸」这类最致命的缺陷在度量里根本不存在，模型只能靠猜。
+ *
+ * 冷路径与热路径（keep-alive 复用页面）都必须调用，否则 keep-alive 模式下 elementBoxes 恒为空。
+ */
+async function extractElementBoxes(cdp) {
+  const elRes = await cdp.send('Runtime.evaluate', {
+    expression: `(function(){
+      var scr = document.querySelector('.phone__screen');
+      if (!scr) return JSON.stringify({ elements: [], degenerate: [] });
+      var sr = scr.getBoundingClientRect();
+      var els = scr.querySelectorAll('[data-cid]');
+      var out = [];
+      var degenerate = [];
+      els.forEach(function(el) {
+        var r = el.getBoundingClientRect();
+        var cs = window.getComputedStyle(el);
+        var fs = parseFloat(cs.fontSize) || 0;
+        var lhRaw = cs.lineHeight;
+        // lineHeight 供几何审计判「文本被折了几行」（h / lh > 2 即 3 行以上）；
+        // 'normal' 时拿不到像素值，取 0 表示未知（调用方据此跳过该判定，不猜）。
+        var lh = (lhRaw && lhRaw !== 'normal') ? (parseFloat(lhRaw) || 0) : 0;
+        var text = (el.textContent || '').trim();
+        // Input 类组件的占位文本在内部 <input placeholder> 属性上，textContent 为空；
+        // 评分/位置配对需要把它当作可见文本捕获（否则占位行被误判为文本缺失）。
+        if (!text) {
+          var innerInput = (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') ? el : el.querySelector('input,textarea');
+          if (innerInput) text = (innerInput.getAttribute('placeholder') || innerInput.value || '').trim();
+        }
+        var rec = {
+          cid: el.getAttribute('data-cid') || '',
+          cls: el.getAttribute('data-class') || '',
+          text: text.slice(0, 60),
+          x: Math.round((r.left - sr.left) * 100) / 100,
+          y: Math.round((r.top - sr.top) * 100) / 100,
+          w: Math.round(r.width * 100) / 100,
+          h: Math.round(r.height * 100) / 100,
+          fs: Math.round(fs * 100) / 100,
+          lh: Math.round(lh * 100) / 100,
+          color: cs.color || '',
+          scrollH: el.scrollHeight || 0,
+          clientH: el.clientHeight || 0,
+        };
+        if (r.width < 1 || r.height < 1) {
+          // display:none / visibility:hidden 是**有意隐藏**（v-show 变体），不算缺陷
+          if (cs.display === 'none' || cs.visibility === 'hidden') return;
+          degenerate.push(rec);
+          return;
+        }
+        out.push(rec);
+      });
+      return JSON.stringify({ elements: out, degenerate: degenerate });
+    })()`,
+    returnByValue: true,
+  })
+  const raw = elRes?.result?.value
+  if (!raw) return null
+  const parsed = JSON.parse(raw)
+  // 兼容旧形态（纯数组，无 degenerate）
+  if (Array.isArray(parsed)) return { elements: parsed, degenerate: [] }
+  return { elements: Array.isArray(parsed.elements) ? parsed.elements : [], degenerate: Array.isArray(parsed.degenerate) ? parsed.degenerate : [] }
+}
+
 /* ------------------------------------------------------------------ */
 /* 可复用渲染会话                                                       */
 /* ------------------------------------------------------------------ */
@@ -507,6 +576,11 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
   } catch {}
   let closed = false
   let pageReady = false
+  // 热路径只允许「同一张卡」复用：热更新靠 history.replaceState 改 URL 再调 window.__bootCard()，
+  // 而 __bootCard 取卡片 id 的时机/来源不由本脚本控制。实测（2026-09-21）：一个会话里连续
+  // 渲染 8 张不同的卡，全部返回**第一张**的度量（8 张高度全 = 341px）——静默错卡。
+  // 一旦接上几何门禁，错卡等于给出错误结论，故用 id 白名单把热路径钉死在同卡重渲染上。
+  let lastRenderedId = null
 
   async function render({
     id,
@@ -537,8 +611,8 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
         deviceScaleFactor: 1,
         mobile: false,
       })
-      // 热更新路径：同会话内已渲染过该页时，通过 fetch 刷新卡片数据 + 重新触发 boot，跳过整页导航
-      if (hotReload && pageReady) {
+      // 热更新路径：同会话内**同一张卡**已渲染过时，通过 history.replaceState + 重新 boot 跳过整页导航
+      if (hotReload && pageReady && id === lastRenderedId) {
         await cdp.send('Emulation.setDeviceMetricsOverride', {
           width: Math.ceil(Number(width)) + 40,
           height: Math.max(2000, Math.ceil(Number(captureHeight || 2000)) + 40),
@@ -571,10 +645,19 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
               captureBeyondViewport: true,
             })
             const buffer2 = Buffer.from(shot2.data, 'base64')
+            // 热路径同样要抓元素度量：keep-alive 模式下每轮 iterate 都走这里，
+            // 漏掉就等于「除了第一轮，模型永远拿不到几何归因」。
+            let hotBoxes = null
+            if (captureElements) {
+              try { hotBoxes = await extractElementBoxes(cdp) } catch { /* best-effort */ }
+            }
+            lastRenderedId = id
             return {
               ok: true, source: 'standalone-hot', id,
               width: Math.round(box2.width), height: Math.round(box2.height),
               base64: buffer2.toString('base64'),
+              elementBoxes: hotBoxes?.elements || undefined,
+              elementBoxesDegenerate: hotBoxes?.degenerate || undefined,
               outFile: outFile ? path.resolve(outFile) : null,
               ms: Math.round(performance.now() - startedAt),
             }
@@ -594,6 +677,7 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
       }).catch(() => {})
       await renderDone
       pageReady = true
+      lastRenderedId = id
       // 截图前等网络静默：冷帧根因（背景图/字体在途时截图）在此闭环
       await waitNetworkIdle(inflight)
       const boxRes = await cdp.send('Runtime.evaluate', {
@@ -618,49 +702,12 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
       })
       const buffer = Buffer.from(shot.data, 'base64')
       let elementBoxes = null
+      let elementBoxesDegenerate = null
       if (captureElements) {
         try {
-          const elRes = await cdp.send('Runtime.evaluate', {
-            expression: `(function(){
-              var scr = document.querySelector('.phone__screen');
-              if (!scr) return JSON.stringify([]);
-              var sr = scr.getBoundingClientRect();
-              var els = scr.querySelectorAll('[data-cid]');
-              var out = [];
-              els.forEach(function(el) {
-                var r = el.getBoundingClientRect();
-                if (r.width < 1 || r.height < 1) return;
-                var cls = el.getAttribute('data-class') || '';
-                var text = (el.textContent || '').trim();
-                // Input 类组件的占位文本在内部 <input placeholder> 属性上，textContent 为空；
-                // 评分/位置配对需要把它当作可见文本捕获（否则占位行被误判为文本缺失）。
-                if (!text) {
-                  // Input.vue 根元素即 <input>：自身优先，其次向后兼容包裹式实现
-                  var innerInput = (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') ? el : el.querySelector('input,textarea');
-                  if (innerInput) text = (innerInput.getAttribute('placeholder') || innerInput.value || '').trim();
-                }
-                var cs = window.getComputedStyle(el);
-                var fs = parseFloat(cs.fontSize) || 0;
-                var color = cs.color || '';
-                out.push({
-                  cid: el.getAttribute('data-cid') || '',
-                  cls: cls,
-                  text: text.slice(0, 60),
-                  x: Math.round((r.left - sr.left) * 100) / 100,
-                  y: Math.round((r.top - sr.top) * 100) / 100,
-                  w: Math.round(r.width * 100) / 100,
-                  h: Math.round(r.height * 100) / 100,
-                  fs: Math.round(fs * 100) / 100,
-                  color: color,
-                  scrollH: el.scrollHeight || 0,
-                  clientH: el.clientHeight || 0,
-                });
-              });
-              return JSON.stringify(out);
-            })()`,
-            returnByValue: true,
-          })
-          if (elRes?.result?.value) elementBoxes = JSON.parse(elRes.result.value)
+          const boxes = await extractElementBoxes(cdp)
+          elementBoxes = boxes?.elements || null
+          elementBoxesDegenerate = boxes?.degenerate || null
         } catch (e) { /* element extraction is best-effort */ }
       }
       const json = {
@@ -670,6 +717,7 @@ export async function createRenderSession({ cardsRoot = cardsDir } = {}) {
         height: Math.round(captureHeight ? Math.min(box.height, Number(captureHeight)) : box.height),
         base64: buffer.toString('base64'),
         elementBoxes: elementBoxes,
+        elementBoxesDegenerate: elementBoxesDegenerate,
       }
 
       if (format === 'json') return { ok: true, source: 'standalone', ...json }

package/dist/vendored/skills/dsl-card-generator/scripts/route_input.mjs

@@ -20,9 +20,9 @@
  */
 import fs from 'node:fs'
 import path from 'node:path'
-import { spawnSync } from 'node:child_process'
 import { fileURLToPath } from 'node:url'
 import { hostSkillsDir, projectRoot } from './lib/paths.mjs'
+import { resolvePython } from './lib/python.mjs'
 
 const IMAGE_EXT = new Set(['.png', '.jpg', '.jpeg', '.webp'])
 /** 已知入口文件：判定交给它所在目录（index.html=MeaXure 导出；manifest/clusters/spec/prompt=要素包；schema=卡片目录）。 */
@@ -34,7 +34,7 @@ const SKETCH_SKILL = path.join(hostSkillsDir, 'sketch-spec-to-card')
  * 作为提示文本随 next/note 下发，让判定器输出即带门禁，不依赖模型记住文档。
  */
 const SELECTION_GATE =
-  '# 多画板门禁（rules.md §十三 + §13.4）：用 spec_tree.mjs --list-cards 把全量画板按「画板序号.卡片序号」列出（一个画板含 N 张卡则展开为 K.1 ~ K.N）+ 末尾加「全部」；让用户选的方式 = 正文逐条写清单 + 一句提问后停止输出、等用户回序号再继续（**没有** request_user_input 这个工具，不要去找弹窗，也不要替用户挑）；序号格式「画板序号.卡片序号」（如 1.2），单独回画板序号默认取该画板第 1 张卡；UI 产物可回「全部」全量生成，产卡默认单卡片（回「全部」才算显式批量授权）；禁止自行挑画板或挑卡、禁止擅自批量产卡；清单逐行配图：每个卡片行下紧跟它自己的 card-N.png 绝对路径，同一画板的卡共享画板预览图（artboard.png）但各有聚焦图；与序号一一对应，缺图显式标缺失，禁止把图堆在清单末尾。'
+  '# 多画板门禁（rules.md §十三 + §13.4）：用 spec_tree.mjs --list-cards 把全量画板按「画板序号.卡片序号」列出（一个画板含 N 张卡则展开为 K.1 ~ K.N）+ 末尾加「全部」；让用户选的方式 = 正文逐条写清单 + 一句提问后停止输出、等用户回序号再继续（**没有** request_user_input 这个工具，不要去找弹窗，也不要替用户挑）；序号格式「画板序号.卡片序号」（如 1.2），单独回画板序号默认取该画板第 1 张卡；UI 产物可回「全部」全量生成，产卡默认单卡片（回「全部」才算显式批量授权）；禁止自行挑画板或挑卡、禁止擅自批量产卡；清单逐行配图：每个卡片行下紧跟它自己的 card-N.png 绝对路径，同一画板的卡共享画板预览图（artboard.png）但各有聚焦图；与序号一一对应，缺图显式标缺失，禁止把图堆在清单末尾；路径照抄完整绝对路径——禁止用 … / ... 省略前缀、禁止包进反引号或代码块（缩写的路径渲染端取不到图，用户那几行只剩一串文字）。'
 /**
  * 要素包根目录 UI/ —— **锚在宿主工程根，不锚在脚本自身位置**。
  *
@@ -88,19 +88,15 @@ function readTextCapped(file, cap = 64 * 1024 * 1024) {
   return head.toString('utf8') + tail.toString('utf8')
 }
 
-/** 命令里输出相对 cwd 的短路径，跨盘/越界时退回绝对路径。 */
+/** 命令里输出相对 cwd 的短路径，跨盘/越界时退回绝对路径（分隔符按平台原生形态）。 */
 function shortPath(abs) {
   const rel = path.relative(process.cwd(), abs)
   return rel && !rel.startsWith('..') && !path.isAbsolute(rel) ? rel : abs
 }
 
+/** Python 解释器：解析集中在 lib/python.mjs（单一来源，含 Windows Store 假别名识别）。 */
 function pythonBin() {
-  if (process.env.DSL_CARD_PYTHON) return process.env.DSL_CARD_PYTHON
-  for (const bin of ['python3', 'python']) {
-    const probe = spawnSync(bin, ['--version'], { stdio: 'ignore' })
-    if (probe.status === 0) return bin
-  }
-  return 'python3'
+  return resolvePython()
 }
 
 /** Sketch MeaXure 标注导出判定：index.html 的 data 签名是硬证据，preview/ assets/ links/ 是佐证。 */
@@ -340,7 +336,7 @@ function route(inputAbs) {
             `node ${shortPath(path.join(hostSkillsDir, 'dsl-card-generator', 'scripts', 'spec_tree.mjs'))} --list-cards ${shortPath(inputAbs)}`,
             SELECTION_GATE,
           ]),
-          `# 再按 SKILL.md §8 Workflow A 六步闭环生成 schema（scaffold_card → add_component/expand_ir → validate+lint → render_diff）`,
+          `# 再按 SKILL.md §8 Workflow A 生成 schema（整树 IR 一次下发 → expand_ir → readiness → gate → iterate 视觉闭环）；add_component 仅改卡用`,
         ],
         note: bundle.artboardBundle
           ? '输入已是单画板要素包，无需前处理，直接走 Workflow A 生成本卡。'
@@ -377,7 +373,7 @@ function route(inputAbs) {
       evidence: [`单张图片 ${path.basename(inputAbs)}（同目录无 spec.json）`],
       skillChain: ['dsl-card-generator'],
       workflow: 'Workflow 0 入口③ → Workflow A（无标注，视觉推断）',
-      next: [`# 直接多模态读图 → scaffold_card 出骨架 → validate+lint → render_diff 视觉闭环`],
+      next: [`# 直接多模态读图 → 整树 IR（AI 判定布局）→ expand_ir → readiness → gate → iterate 视觉闭环`],
       note: '无 MeaXure 标注时全靠 AI 视觉推断，间距/圆角从图上目视估算；若这张图其实来自某份标注导出，请改传导出目录以走入口①。',
     }
   }