cardbuddy 0.14.3 → 0.16.0

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

@@ -83,8 +83,51 @@ summary.correctorRejected = correctorRejected
 summary.correctorCoverage = reports.length ? correctorAttempts / reports.length : null
 summary.correctorAcceptRate = correctorAttempts ? correctorAccepted / correctorAttempts : null
 
-// --- 失败签名 / 未达标维度直方图 / 失败类分布 ---
-// 签名口径 v2（lib/scoring.mjs）：取归一化缺口最大的维度，而非固定优先级顺序。
+// --- Telemetry 聚合：速度 / 错误 / token（2026-09-25）---
+// 旧报告缺 durationMs / telemetry.json 时对应段自动跳过，跨轮兼容；口径不进任何门禁。
+const durations = reports.map((item) => item.durationMs).filter((v) => typeof v === 'number')
+if (durations.length) {
+  const sorted = [...durations].sort((a, b) => a - b)
+  // nearest-rank 百分位：ceil(p*n)-1（P95 of [1.5s,3.5s] 应取 3.5s，floor 秩会错误取到 1.5s）
+  const pct = (p) => sorted[Math.min(sorted.length - 1, Math.max(0, Math.ceil(p * sorted.length) - 1))]
+  summary.avgCaseMs = Math.round(average(durations))
+  summary.p50CaseMs = pct(0.5)
+  summary.p95CaseMs = pct(0.95)
+}
+const telemetryPath = path.join(reportDir, 'telemetry.json')
+if (fs.existsSync(telemetryPath)) {
+  try {
+    const t = JSON.parse(fs.readFileSync(telemetryPath, 'utf8'))
+    // 旧 telemetry.json 可能缺派生字段：从原始累计字段现算兜底
+    const derivedCpm = (t.wallMs > 0 && t.scoredCases)
+      ? Number((t.scoredCases / (t.wallMs / 60000)).toFixed(2)) : null
+    const derivedStageAverages = !t.stageAverages && t.stageMs && t.scoredCases
+      ? Object.fromEntries(Object.entries(t.stageMs)
+        .map(([stage, ms]) => [stage, Math.round(ms / t.scoredCases)]))
+      : null
+    summary.telemetry = {
+      wallMs: t.wallMs ?? null,
+      concurrency: t.concurrency ?? null,
+      casesPerMinute: t.casesPerMinute ?? derivedCpm,
+      stageAverages: t.stageAverages ?? derivedStageAverages,
+      renderCalls: t.renderCalls ?? null,
+      renderRetries: t.renderRetries ?? null,
+      sessionRebuilds: t.sessionRebuilds ?? null,
+      stageErrors: t.stageErrors ?? null,
+      caseErrors: t.caseErrors ?? null,
+      usage: t.usage ?? null,
+      reviewTokensEst: t.reviewTokensEst?.total != null
+        ? {
+            ...t.reviewTokensEst,
+            avgPerFailedCase: t.reviewTokensEst.cases
+              ? Math.round(t.reviewTokensEst.total / t.reviewTokensEst.cases) : 0,
+          }
+        : null,
+    }
+  } catch { /* telemetry.json 损坏不阻塞汇总 */ }
+}
+
+// --- 失败签名 / 未达标维度直方图 / 失败类分布 ---// 签名口径 v2（lib/scoring.mjs）：取归一化缺口最大的维度，而非固定优先级顺序。
 // 旧口径会把 comp=0.42 / pos=0.42 的缺组件卡报成 duplicate-content-detected（重影只超 1 处），
 // 把下一轮修复方向带偏；跨轮签名趋势对比请以口径 v2 之后的轮次为界。
 const signatures = {}
@@ -175,6 +218,35 @@ if (summary.highMaskCases.length) {
   }
 } else lines.push('- （无）')
 
+// —— 速度与消耗（telemetry，2026-09-25）——
+lines.push('', '## 速度与消耗', '')
+if (summary.avgCaseMs != null) {
+  lines.push(`- 单例耗时: 均值 ${(summary.avgCaseMs / 1000).toFixed(1)}s · P50 ${(summary.p50CaseMs / 1000).toFixed(1)}s · P95 ${(summary.p95CaseMs / 1000).toFixed(1)}s`)
+}
+if (summary.telemetry) {
+  const t = summary.telemetry
+  lines.push(
+    `- 墙钟: ${t.wallMs != null ? `${(t.wallMs / 1000).toFixed(1)}s` : 'N/A'}${t.concurrency != null ? `（${t.concurrency} 并发渲染）` : ''}`,
+    `- 吞吐: ${t.casesPerMinute != null ? `${t.casesPerMinute} 例/分钟` : 'N/A'}${t.renderCalls != null ? ` · 渲染 ${t.renderCalls} 次` : ''}${t.renderRetries ? ` · 重试 ${t.renderRetries}` : ''}${t.sessionRebuilds ? ` · 会话重建 ${t.sessionRebuilds}` : ''}`,
+  )
+  if (t.stageAverages && Object.keys(t.stageAverages).length) {
+    const stageStr = Object.entries(t.stageAverages)
+      .sort((a, b) => b[1] - a[1])
+      .map(([stage, ms]) => `${stage} ${(ms / 1000).toFixed(2)}s`)
+      .join(' · ')
+    lines.push(`- 阶段均值（按案例）: ${stageStr}`)
+  }
+  if (t.stageErrors && Object.keys(t.stageErrors).length) {
+    lines.push(`- 阶段错误: ${Object.entries(t.stageErrors).map(([stage, n]) => `${stage}×${n}`).join(' · ')}`)
+  }
+  if (t.usage) lines.push(`- LLM usage（生成链路）: ${t.usage.calls} 次 / in ${t.usage.inputTokens} / out ${t.usage.outputTokens} tok`)
+  if (t.reviewTokensEst) {
+    lines.push(`- 归因证据包估算: ${t.reviewTokensEst.total} tok（${t.reviewTokensEst.cases} 个失败例 · 均 ${t.reviewTokensEst.avgPerFailedCase} tok）— Agent 在环归因预算参考`)
+  }
+} else if (summary.avgCaseMs == null) {
+  lines.push('- （无 telemetry 数据：旧轮次报告或未启用计时）')
+}
+
 // —— 逐案截图对比图廊 ——
 lines.push('', '## 截图对比', '')
 const sortedReports = [...reports].sort((a, b) =>

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

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * sink_rules.mjs — 把 lessons.jsonl 的已推广规则回灌到目标 skill 文档。
+ *
+ * 训练闭环的最后一环：lesson 标了 status=promoted + targetFiles 指向
+ * dsl-card-generator / sketch-spec-to-card / card-skill-trainer 的规则文档
+ * （generation_pitfalls.md / SKILL.md / recipes.md 等），但规则文本从未真正
+ * 写进这些文件——本脚本补上这一步。
+ *
+ * 规则：
+ *   1. 读 lessons.jsonl，筛 status=promoted（或 candidate 且有 rule 文本）
+ *   2. targetFiles 含 .md 的 lesson，检查 rule 文本是否已在目标文件中
+ *   3. 不在 → 按目标文件的节号约定追加新节（generation_pitfalls 用 ## N.，
+ *      SKILL.md / recipes.md 用 ### 训练规则 N）
+ *   4. 已在 → 跳过（幂等）
+ *
+ * 用法：
+ *   node skills/card-skill-trainer/scripts/sink_rules.mjs [--dry-run]
+ *
+ * 退出码：0 = 正常（即使无新规则也 0）；1 = 写入失败。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..')
+const LESSONS = path.join(ROOT, 'training', 'lessons', 'lessons.jsonl')
+
+const dryRun = process.argv.includes('--dry-run')
+
+function loadLessons() {
+  if (!fs.existsSync(LESSONS)) return []
+  return fs.readFileSync(LESSONS, 'utf8')
+    .split('\n').filter((l) => l.trim())
+    .map((l) => { try { return JSON.parse(l) } catch { return null } })
+    .filter(Boolean)
+}
+
+/** 规则文本是否已存在于目标文件（归一化后前 40 字符片段匹配） */
+function ruleAlreadyInFile(filePath, rule) {
+  if (!fs.existsSync(filePath)) return false
+  const content = fs.readFileSync(filePath, 'utf8').replace(/\s+/g, '')
+  const snippet = (rule || '').replace(/\s+/g, '').slice(0, 40)
+  return snippet.length >= 10 && content.includes(snippet)
+}
+
+/** 按目标文件分组待回灌的 lessons */
+function groupByTargetFile(lessons) {
+  const groups = new Map()
+  for (const d of lessons) {
+    if (!d.targetFiles || !d.rule) continue
+    // 只回灌 status=promoted 或有实质 rule 的 candidate
+    if (d.status && d.status !== 'promoted' && d.status !== 'candidate') continue
+    // candidate 但 rule 还是 TODO 占位 → 跳过
+    if (d.rule.includes('TODO')) continue
+    for (const tf of d.targetFiles) {
+      if (!tf.endsWith('.md')) continue
+      const fullPath = path.resolve(ROOT, tf)
+      if (ruleAlreadyInFile(fullPath, d.rule)) continue
+      if (!groups.has(tf)) groups.set(tf, [])
+      groups.get(tf).push(d)
+    }
+  }
+  return groups
+}
+
+/** 生成回灌的 markdown 片段 */
+function buildSection(lessons, filePath) {
+  const isPitfalls = filePath.includes('generation_pitfalls')
+  const lines = []
+  let n = 0
+  for (const d of lessons) {
+    const date = d.round || d.lessonId || ''
+    const sig = d.signature || ''
+    const id = d.lessonId || d.id || ''
+    n++
+    if (isPitfalls) {
+      lines.push(`\n## auto. ${sig.slice(0, 60) || '训练规则'}${date ? `（${date} 训练回灌）` : ''}`)
+    } else {
+      lines.push(`\n---\n### ${sig.slice(0, 60) || '训练规则'}${date ? `（${date} 训练回灌）` : ''}`)
+    }
+    if (id) lines.push(`> lesson: \`${id}\`  status: \`${d.status || 'promoted'}\``)
+    lines.push('')
+    lines.push(d.rule.trim())
+    lines.push('')
+  }
+  return { text: lines.join('\n'), count: n }
+}
+
+function main() {
+  const lessons = loadLessons()
+  if (!lessons.length) {
+    console.log('[sink_rules] 无 lessons.jsonl 或为空，跳过')
+    return
+  }
+
+  const groups = groupByTargetFile(lessons)
+  if (!groups.size) {
+    console.log('[sink_rules] 所有规则已回灌或无 .md 目标，无需操作')
+    return
+  }
+
+  let totalSunk = 0
+  for (const [tf, fileLessons] of groups) {
+    const fullPath = path.resolve(ROOT, tf)
+    if (!fs.existsSync(fullPath)) {
+      console.warn(`[sink_rules] 目标文件不存在: ${tf}，跳过`)
+      continue
+    }
+    const content = fs.readFileSync(fullPath, 'utf8')
+    const isPitfalls = tf.includes('generation_pitfalls')
+    const { text, count } = buildSection(fileLessons, tf)
+
+    if (dryRun) {
+      console.log(`[sink_rules] DRY-RUN: 将向 ${tf} 追加 ${count} 条规则`)
+    } else {
+      const append = content.endsWith('\n') ? text : '\n' + text
+      fs.appendFileSync(fullPath, append + '\n')
+      console.log(`[sink_rules] ${tf}: 回灌 ${count} 条规则`)
+    }
+    totalSunk += count
+  }
+
+  console.log(`[sink_rules] 共回灌 ${totalSunk} 条规则到 ${groups.size} 个文件${dryRun ? '（dry-run，未实际写入）' : ''}`)
+}
+
+main()

package/dist/vendored/skills/dsl-card-ai/SKILL.md

@@ -218,7 +218,7 @@ node skills/dsl-card-generator/scripts/describe_card.mjs --id <cardId> --json
 | `card-dir` | 已存在卡片目录（含 `schema.json`） | 不是建卡是改卡 → 转本技能 Workflow A（修绑定）/ Workflow B（批量改） |
 | `unknown` | 判不出形态（`ok:false`） | **不要猜**：向用户确认输入形态，或让其显式给出 `UI/<画板>/spec.json` 与 `card-N.png` |
 
-> **多画板选择门禁（铁律 §十三）**：`meaxure-export` / `ui-bundle` 判定为多画板输入时，**UI 产物可全量生成**（上游前处理一次跑完整份导出），但**产卡必须以单个画板 / 单个 cardKey 为单位**。用户未指定目标画板时：先机械取全量画板（未前处理 → `parse_meaxure.py --src <导出目录> --list`，展示 1 起；已前处理 → `manifest.json` 的 `canvases[]` + `clusters.json` 的 `cards[]`），按 **`1..n` 编号列出 + 末尾追加 `全部`**；**没有弹选项工具**（不存在 `request_user_input`，**不要去调用或寻找**），一律在正文列出清单 + 一句纯文本提问后**停止输出、等用户回序号**再继续。**UI 产物可回 `全部` 全量生成**；**产卡默认单画板 / 单 cardKey**，用户回 `全部` 才视为显式批量授权——**禁止**自行挑画板、禁止未经同意批量 `card_write`。系统级选择弹窗不可实现，「正文列清单 / 停下等序号」即等价物；清单**逐行配图**（每画板行下紧跟它自己的预览图绝对路径，缺图显式标缺失，禁止把图堆在清单末尾），转给用户时逐条内联 Markdown 图片看图选。
+> **多画板选择门禁（铁律 §十三）**：`meaxure-export` / `ui-bundle` 判定为多画板输入时，**UI 产物可全量生成**（上游前处理一次跑完整份导出），但**产卡必须以单个画板 / 单个 cardKey 为单位**。用户未指定目标画板时：先机械取全量画板（未前处理 → `parse_meaxure.py --src <导出目录> --list`，展示 1 起；已前处理 → `manifest.json` 的 `canvases[]` + `clusters.json` 的 `cards[]`），按 **`1..n` 编号列出 + 末尾追加 `全部`**；**没有弹选项工具**（不存在 `request_user_input`，**不要去调用或寻找**），一律在正文列出清单 + 一句纯文本提问后**停止输出、等用户回序号**再继续。**UI 产物可回 `全部` 全量生成**；**产卡默认单画板 / 单 cardKey**，用户回 `全部` 才视为显式批量授权——**禁止**自行挑画板、禁止未经同意批量 `card_write`。系统级选择弹窗不可实现，「正文列清单 / 停下等序号」即等价物；清单**逐行配图**（每画板行下紧跟它自己的预览图绝对路径，缺图显式标缺失，禁止把图堆在清单末尾）——**路径照抄完整绝对路径：禁止用 `…` / `...` 省略前缀、禁止包进反引号或代码块**（缩写的路径渲染端取不到图），转给用户时逐条内联 Markdown 图片看图选。
 
 ### 6.3 交接生成与收口