cardbuddy 0.14.3 → 0.16.0

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

@@ -1,153 +0,0 @@
-#!/usr/bin/env node
-/**
- * analyze_component_usage.mjs — 组件/范式使用分析，用真实卡片数据反哺 recipes。
- *
- * 回答三个问题：
- *   1. 哪些组件/范式最高频？（className 频率 + recipe 探测命中卡数）
- *   2. 哪些结构组合最常见？（父→子组件共现对，供新 recipe 候选判断）
- *   3. 现有 recipe 片段健康度如何？（recipe_snippets/*.json 各被多少卡使用；
- *      0 使用 = 候选复核，高频无片段 = 候选补充）
- *
- * 数据源：直接扫宿主项目卡片 schema（唯一真源），复用 build_card_index.mjs 的
- * RECIPE_PROBES / collectComponents（同一份探测定义，不复制）。
- *
- * 用法：
- *   node skills/dsl-card-generator/scripts/analyze_component_usage.mjs [--json] [--out <path>]
- *   （在宿主项目根目录跑；卡片目录由 lib/paths.mjs 解析）
- *
- * 退出码：0 = 正常（报告制工具，永不拦截）。
- */
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { cardsDir, skillRoot } from './lib/paths.mjs'
-import { RECIPE_PROBES, collectComponents } from './build_card_index.mjs'
-
-const SNIPPETS_DIR = path.join(skillRoot, 'references', 'recipe_snippets')
-
-/** snippet 文件名 → recipe 探测 key（无对应探测的记 null = unprobed，如实报告不硬凑） */
-const SNIPPET_PROBE = {
-  'alertCard-pair': 'alertCard',
-  'canvas-title-head': 'canvas-head',
-  'list-expand-collapse': 'list-expand',
-  globalSet: 'globalSet',
-  'money-format': 'money-format',
-  tabBillMode: 'tab-billMode',
-  'tab-billMode': 'tab-billMode',
-}
-
-/** 遍历全部节点（双通道），回调 (node, parentClassName) */
-function walk(node, parent, cb) {
-  if (!node || typeof node !== 'object') return
-  const cls = node.className || '?'
-  cb(node, parent)
-  for (const c of node.components || []) walk(c, cls, cb)
-  for (const s of node.slots || []) for (const c of s.components || []) walk(c, cls, cb)
-}
-
-function main() {
-  const argv = process.argv.slice(2)
-  const asJson = argv.includes('--json')
-  const outIdx = argv.indexOf('--out')
-  const outPath = outIdx >= 0 ? argv[outIdx + 1] : null
-
-  const ids = fs.readdirSync(cardsDir).filter((id) => {
-    const d = path.join(cardsDir, id)
-    return fs.statSync(d).isDirectory() && fs.existsSync(path.join(d, 'schema.json'))
-  })
-
-  const compCards = new Map() // className -> Set<cardId>（多少卡用过）
-  const compTotal = new Map() // className -> 实例总数
-  const pairs = new Map() // 'Parent>Child' -> 次数
-  const recipeCards = new Map(RECIPE_PROBES.map((p) => [p.key, new Set()]))
-  let parseFail = 0
-
-  for (const id of ids) {
-    let schema
-    try {
-      schema = JSON.parse(fs.readFileSync(path.join(cardsDir, id, 'schema.json'), 'utf8'))
-    } catch {
-      parseFail++
-      continue
-    }
-    const text = JSON.stringify(schema)
-    for (const p of RECIPE_PROBES) if (p.test(text)) recipeCards.get(p.key).add(id)
-
-    const inCard = new Set()
-    walk(schema.view, null, (node, parent) => {
-      const cls = node.className || '?'
-      inCard.add(cls)
-      compTotal.set(cls, (compTotal.get(cls) || 0) + 1)
-      if (parent) {
-        const key = `${parent}>${cls}`
-        pairs.set(key, (pairs.get(key) || 0) + 1)
-      }
-    })
-    for (const cls of inCard) {
-      if (!compCards.has(cls)) compCards.set(cls, new Set())
-      compCards.get(cls).add(id)
-    }
-  }
-
-  // snippet 健康度：每个片段对应探测的命中卡数；无探测记 null
-  const snippetFiles = fs.existsSync(SNIPPETS_DIR)
-    ? fs.readdirSync(SNIPPETS_DIR).filter((f) => f.endsWith('.json')).sort()
-    : []
-  const snippets = snippetFiles.map((f) => {
-    const key = f.replace(/\.json$/, '')
-    const probe = Object.prototype.hasOwnProperty.call(SNIPPET_PROBE, key) ? SNIPPET_PROBE[key] : null
-    return {
-      snippet: key,
-      probe,
-      usedByCards: probe ? recipeCards.get(probe).size : null,
-    }
-  })
-
-  const sorted = (m, val) => [...m.entries()].sort((a, b) => val(b) - val(a))
-  const report = {
-    generatedAt: new Date().toISOString(),
-    cardCount: ids.length,
-    parseFail,
-    components: sorted(compCards, (e) => e[1].size).map(([className, cards]) => ({
-      className,
-      cards: cards.size,
-      instances: compTotal.get(className) || 0,
-    })),
-    recipes: RECIPE_PROBES.map((p) => ({ recipe: p.key, cards: recipeCards.get(p.key).size })).sort(
-      (a, b) => b.cards - a.cards,
-    ),
-    topPairs: sorted(pairs, (e) => e[1])
-      .slice(0, 20)
-      .map(([pair, count]) => ({ pair, count })),
-    snippetHealth: snippets.sort((a, b) => (b.usedByCards ?? -1) - (a.usedByCards ?? -1)),
-  }
-
-  if (asJson) {
-    console.log(JSON.stringify(report, null, 2))
-  } else {
-    console.log(`\n📊 组件使用分析（${report.cardCount} 张卡${parseFail ? `，${parseFail} 张解析失败` : ''}）`)
-    console.log('\n组件频率（使用卡数 / 实例数）：')
-    for (const c of report.components) console.log(`  ${c.className.padEnd(16)} ${String(c.cards).padStart(3)} 卡 / ${c.instances} 实例`)
-    console.log('\n范式命中（卡数）：')
-    for (const r of report.recipes) console.log(`  ${r.recipe.padEnd(16)} ${r.cards} 卡`)
-    console.log('\nTop 结构组合（父>子 共现）：')
-    for (const p of report.topPairs.slice(0, 10)) console.log(`  ${p.pair.padEnd(28)} ${p.count}`)
-    console.log('\nrecipe 片段健康度：')
-    for (const s of report.snippetHealth) {
-      const usage = s.usedByCards == null ? 'unprobed（无对应探测，需人工判断）' : `${s.usedByCards} 卡使用`
-      const flag = s.usedByCards === 0 ? '  ⚠️ 0 使用，候选复核' : ''
-      console.log(`  ${s.snippet.padEnd(24)} ${usage}${flag}`)
-    }
-  }
-
-  if (outPath) {
-    const abs = path.resolve(outPath)
-    fs.mkdirSync(path.dirname(abs), { recursive: true })
-    fs.writeFileSync(abs, JSON.stringify(report, null, 2) + '\n')
-    console.log(`\n报告已落盘: ${abs}`)
-  }
-}
-
-const _thisScript = fs.realpathSync(fileURLToPath(import.meta.url))
-const _calledAs = process.argv[1] ? fs.realpathSync(path.resolve(process.argv[1])) : ''
-if (_thisScript === _calledAs) main()