cardbuddy 0.14.3 → 0.16.0

package/dist/vendored/skills/card-skill-trainer/scripts/lib/scoring.mjs

@@ -137,7 +137,7 @@ export function rectMask(normalizedRects, width, height) {
   return mask
 }
 
-export function imageFidelity(designBuffer, renderBuffer, exclusionRects = [], pixelOnlyRects = []) {
+export function imageFidelity(designBuffer, renderBuffer, exclusionRects = [], pixelOnlyRects = [], opts = {}) {
   try {
     const designPng = PNG.sync.read(designBuffer)
     const renderPng = PNG.sync.read(renderBuffer)
@@ -166,27 +166,31 @@ export function imageFidelity(designBuffer, renderBuffer, exclusionRects = [], p
     // 诊断：最佳纵向对齐偏移（仅记录，不参与评分）。
     // 用于区分「截图裁切/节奏误差」与「真实布局错误」——
     // 禁止用对齐搜索后的差异替代零偏移差异评分，避免放宽阈值掩盖还原缺陷。
+    // 该扫描 13× 全图（dy -12..+12 step2），属纯诊断、不进任何门禁；默认关闭以省 CPU，
+    // 仅最终报告像素（run_round 显式 includeAlignDy:true）保留，供 score_round / diagnose 消费。
     let bestAlignDy = 0
-    let bestAlignedRatio = ratio
-    for (let dy = -12; dy <= 12; dy += 2) {
-      let alignDiff = 0
-      let alignCompared = 0
-      for (let y = Math.max(0, dy); y < Math.min(height, height + dy); y += 1) {
-        for (let x = 0; x < width; x += 1) {
-          const leftIndex = (y * width + x) * 4
-          const rightIndex = ((y - dy) * width + x) * 4
-          if (rightIndex < 0 || rightIndex >= right.length) continue
-          if (mask[leftIndex / 4]) continue
-          alignCompared += 1
-          if (Math.abs(left[leftIndex] - right[rightIndex]) > 15 ||
-              Math.abs(left[leftIndex + 1] - right[rightIndex + 1]) > 15 ||
-              Math.abs(left[leftIndex + 2] - right[rightIndex + 2]) > 15) alignDiff += 1
+    if (opts.includeAlignDy) {
+      let bestAlignedRatio = ratio
+      for (let dy = -12; dy <= 12; dy += 2) {
+        let alignDiff = 0
+        let alignCompared = 0
+        for (let y = Math.max(0, dy); y < Math.min(height, height + dy); y += 1) {
+          for (let x = 0; x < width; x += 1) {
+            const leftIndex = (y * width + x) * 4
+            const rightIndex = ((y - dy) * width + x) * 4
+            if (rightIndex < 0 || rightIndex >= right.length) continue
+            if (mask[leftIndex / 4]) continue
+            alignCompared += 1
+            if (Math.abs(left[leftIndex] - right[rightIndex]) > 15 ||
+                Math.abs(left[leftIndex + 1] - right[rightIndex + 1]) > 15 ||
+                Math.abs(left[leftIndex + 2] - right[rightIndex + 2]) > 15) alignDiff += 1
+          }
+        }
+        const alignedRatio = alignDiff / Math.max(1, alignCompared)
+        if (alignedRatio < bestAlignedRatio - 0.005) {
+          bestAlignedRatio = alignedRatio
+          bestAlignDy = dy
         }
-      }
-      const alignedRatio = alignDiff / Math.max(1, alignCompared)
-      if (alignedRatio < bestAlignedRatio - 0.005) {
-        bestAlignedRatio = alignedRatio
-        bestAlignDy = dy
       }
     }
 

package/dist/vendored/skills/card-skill-trainer/scripts/lib/telemetry.mjs

@@ -0,0 +1,46 @@
+/**
+ * 训练 telemetry 纯函数集（2026-09-25）：PNG 尺寸嗅探、视觉 token 估算、阶段计时器。
+ * run_round.mjs 消费；tools/tests/trainer-telemetry.test.mjs 直测本模块
+ * （run_round.mjs 底部 main() 无条件执行，不可被测试 import）。
+ */
+
+// PNG 尺寸只读 IHDR 头（前 24 字节），不做全图解压；非 PNG / 截断 buffer 返回 null。
+export function pngSize(buffer) {
+  if (!buffer || buffer.length < 24 || buffer.readUInt32BE(0) !== 0x89504e47) return null
+  try { return { width: buffer.readUInt32BE(16), height: buffer.readUInt32BE(20) } } catch { return null }
+}
+
+// 视觉模型图像 token 口径：面积 / 750（Claude 视觉近似）。用于估算 Agent 在环归因的
+// 证据包成本——训练闭环中真实发生的 token 消耗在「失败案例的多模态归因」，不在 v3 生成
+// （v3 是纯规则引擎，0 LLM 调用）。口径只作预算参考，不参与任何门禁。
+export function estimateImageTokens(width, height) {
+  return Math.ceil(((width || 0) * (height || 0)) / 750)
+}
+
+export function estimateReviewTokens({ designBuffer, renderBuffer, specChars }) {
+  const d = pngSize(designBuffer)
+  const r = pngSize(renderBuffer)
+  const imageTokens = estimateImageTokens(d?.width, d?.height) + estimateImageTokens(r?.width, r?.height)
+  const textTokens = Math.ceil((specChars || 0) / 4)
+  return { imageTokens, textTokens, total: imageTokens + textTokens }
+}
+
+// P1-2：在环归因改以结构化「diagnosis」证据包为主、双 PNG 为 fallback，故新增纯文本 token
+// 估算（结构化包已是 JSON 文本，无图像 token）。返回形状与 estimateReviewTokens 一致，便于
+// telemetry 直接累加。口径只作预算参考，不参与任何门禁。
+export function estimateStructuredReviewTokens(diagnosis) {
+  const len = diagnosis ? JSON.stringify(diagnosis).length : 0
+  const textTokens = Math.ceil(len / 4)
+  return { imageTokens: 0, textTokens, total: textTokens }
+}
+
+// 阶段计时器：timings 阶段名 → 累计 ms；同步/异步两种包裹（finally 保证异常也计时）。
+export function createStageTimer() {
+  const timings = {}
+  const record = (name, ms) => { timings[name] = (timings[name] || 0) + ms }
+  return {
+    timings,
+    time(name, fn) { const t0 = Date.now(); try { return fn() } finally { record(name, Date.now() - t0) } },
+    async timeAsync(name, fn) { const t0 = Date.now(); try { return await fn() } finally { record(name, Date.now() - t0) } },
+  }
+}

package/dist/vendored/skills/card-skill-trainer/scripts/plan_next_round.mjs

@@ -26,6 +26,7 @@ import {
   MASK_REVIEW_THRESHOLD,
 } from './lib/scoring.mjs'
 import { compareRounds, listRounds, loadRunReports, loadRunSummary, roundMetrics } from './lib/runs.mjs'
+import { enrichSameSignatureDetail } from './lib/paradigm-router.mjs'
 
 const repoRoot = path.resolve(import.meta.dirname, '../../..')
 
@@ -320,9 +321,11 @@ function main() {
 
   const signals = []
   for (const item of history.repeatedSignatures) {
+    const enriched = enrichSameSignatureDetail(item)
     signals.push({
       signal: 'same-signature-3-rounds',
-      detail: `签名 ${item.signature} 在 ${item.occurrences} 轮重复出现（${item.rounds.join(' → ')}）：脚本补丁无效，需升级 Skill 级范式`,
+      detail: enriched.detail,
+      paradigm: enriched.pattern,
     })
   }
   const series = history.marginal?.series || []