howone 0.1.50 → 0.1.52

package/templates/vite/.howone/skills/web-clone/scripts/audit-clone.mjs

@@ -1,151 +0,0 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-
-function usage() {
-  console.log(`Usage:
-  node scripts/audit-clone.mjs --project <clone-dir> [--brand "KOKUYO,Original Brand"] [--out CLONE_AUDIT.md]
-
-Scans clone source files for tracking scripts, original-brand residue, Japanese residue, TODOs, and risky external dependencies.
-`);
-}
-
-function parseArgs(argv) {
-  const out = { project: process.cwd(), brand: [], out: "CLONE_AUDIT.md" };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--help" || arg === "-h") out.help = true;
-    else if (arg === "--project") out.project = argv[++i] || process.cwd();
-    else if (arg === "--brand") out.brand = (argv[++i] || "").split(",").map((s) => s.trim()).filter(Boolean);
-    else if (arg === "--out") out.out = argv[++i] || "CLONE_AUDIT.md";
-    else throw new Error(`Unexpected argument: ${arg}`);
-  }
-  return out;
-}
-
-const includeExt = new Set([".html", ".css", ".js", ".jsx", ".ts", ".tsx", ".json", ".md", ".txt", ".svg"]);
-const skipDirs = new Set([".git", "node_modules", "dist", "build", ".next", ".nuxt", "coverage", "RECON"]);
-const skipFiles = new Set(["NOTES.md", "TEARDOWN.md", "CLONE_REPORT.md", "CLONE_AUDIT.md", "REPLACE_GUIDE.md"]);
-
-function walk(dir, files = []) {
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    if (skipDirs.has(entry.name)) continue;
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (entry.name === "screenshots") continue;
-      walk(full, files);
-    } else if (!skipFiles.has(entry.name) && includeExt.has(path.extname(entry.name).toLowerCase())) {
-      files.push(full);
-    }
-  }
-  return files;
-}
-
-function lineNumber(text, index) {
-  return text.slice(0, index).split("\n").length;
-}
-
-function collectMatches(file, text, checks) {
-  const findings = [];
-  for (const check of checks) {
-    const regex = new RegExp(check.pattern, check.flags || "gi");
-    for (const match of text.matchAll(regex)) {
-      const matchedText = String(match[0]);
-      if (check.type === "external" && /^https?:\/\/(www\.)?w3\.org\//i.test(matchedText)) continue;
-      findings.push({
-        type: check.type,
-        label: check.label,
-        file,
-        line: lineNumber(text, match.index || 0),
-        match: matchedText.slice(0, 160),
-      });
-    }
-  }
-  return findings;
-}
-
-function markdown(findings, project, scannedFiles) {
-  const byType = new Map();
-  for (const finding of findings) {
-    if (!byType.has(finding.type)) byType.set(finding.type, []);
-    byType.get(finding.type).push(finding);
-  }
-  const types = [
-    ["tracking", "追踪脚本 / 统计像素"],
-    ["brand", "原站品牌残留"],
-    ["japanese", "日文残留"],
-    ["todo", "TODO / 占位内容"],
-    ["external", "外部依赖 / 外链风险"],
-  ];
-  const lines = [
-    `# Clone Audit`,
-    "",
-    `- Project: ${project}`,
-    `- Scanned files: ${scannedFiles}`,
-    `- Findings: ${findings.length}`,
-    "",
-  ];
-
-  for (const [type, title] of types) {
-    const items = byType.get(type) || [];
-    lines.push(`## ${title}`);
-    if (!items.length) {
-      lines.push("- 未发现");
-      lines.push("");
-      continue;
-    }
-    for (const item of items.slice(0, 200)) {
-      lines.push(`- ${path.relative(project, item.file)}:${item.line} · ${item.label} · \`${item.match.replaceAll("`", "'")}\``);
-    }
-    if (items.length > 200) lines.push(`- 还有 ${items.length - 200} 条未展开`);
-    lines.push("");
-  }
-
-  lines.push("## 结论");
-  lines.push(findings.length ? "- 需要处理上面的残留项后再声明可部署。" : "- 未发现明显残留项；仍需人工核查素材授权和视觉截图。");
-  return `${lines.join("\n")}\n`;
-}
-
-try {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.help) {
-    usage();
-    process.exit(0);
-  }
-
-  const project = path.resolve(args.project);
-  if (!fs.existsSync(project)) throw new Error(`Project not found: ${project}`);
-
-  const brandPatterns = args.brand.map((brand) => ({
-    type: "brand",
-    label: `brand residue: ${brand}`,
-    pattern: brand.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"),
-    flags: "gi",
-  }));
-
-  const checks = [
-    { type: "tracking", label: "Google Tag Manager", pattern: "googletagmanager|GTM-[A-Z0-9]+", flags: "gi" },
-    { type: "tracking", label: "Google Analytics / gtag", pattern: "google-analytics|gtag\\s*\\(|ga\\s*\\(", flags: "gi" },
-    { type: "tracking", label: "Meta Pixel / fbq", pattern: "connect\\.facebook\\.net|fbq\\s*\\(", flags: "gi" },
-    { type: "tracking", label: "Hotjar / Clarity", pattern: "hotjar|clarity\\.ms|hj\\s*\\(", flags: "gi" },
-    { type: "japanese", label: "Japanese kana residue", pattern: "[\\u3040-\\u30ff]{2,}", flags: "g" },
-    { type: "todo", label: "TODO / placeholder content", pattern: "TODO|FIXME|lorem ipsum|待补|这里填写", flags: "gi" },
-    { type: "external", label: "external URL", pattern: "https?://[^\\s\"')<>]+", flags: "gi" },
-    ...brandPatterns,
-  ];
-
-  const files = walk(project);
-  const findings = [];
-  for (const file of files) {
-    const text = fs.readFileSync(file, "utf8");
-    findings.push(...collectMatches(file, text, checks));
-  }
-
-  const output = path.resolve(args.out);
-  fs.mkdirSync(path.dirname(output), { recursive: true });
-  fs.writeFileSync(output, markdown(findings, project, files.length));
-  console.log(output);
-} catch (error) {
-  console.error(`audit-clone failed: ${error.message}`);
-  process.exit(1);
-}

package/templates/vite/.howone/skills/web-clone/scripts/compare-recon.mjs

@@ -1,265 +0,0 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-
-function usage() {
-  console.log(`Usage:
-  node scripts/compare-recon.mjs --original <original-recon.json> --clone <clone-recon.json> [--visual-diff visual-diff.json] [--original-routes route-map.json] [--clone-routes route-map.json] [--original-interactions interactions.json] [--clone-interactions interactions.json] [--out CLONE_REPORT.md]
-`);
-}
-
-function parseArgs(argv) {
-  const out = {
-    original: "",
-    clone: "",
-    visualDiff: "",
-    originalRoutes: "",
-    cloneRoutes: "",
-    originalInteractions: "",
-    cloneInteractions: "",
-    out: "CLONE_REPORT.md",
-  };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--help" || arg === "-h") out.help = true;
-    else if (arg === "--original") out.original = argv[++i] || "";
-    else if (arg === "--clone") out.clone = argv[++i] || "";
-    else if (arg === "--visual-diff") out.visualDiff = argv[++i] || "";
-    else if (arg === "--original-routes") out.originalRoutes = argv[++i] || "";
-    else if (arg === "--clone-routes") out.cloneRoutes = argv[++i] || "";
-    else if (arg === "--original-interactions") out.originalInteractions = argv[++i] || "";
-    else if (arg === "--clone-interactions") out.cloneInteractions = argv[++i] || "";
-    else if (arg === "--out") out.out = argv[++i] || "CLONE_REPORT.md";
-    else throw new Error(`Unexpected argument: ${arg}`);
-  }
-  return out;
-}
-
-function readJson(file) {
-  return JSON.parse(fs.readFileSync(file, "utf8"));
-}
-
-function firstSignals(recon) {
-  return recon.captures?.[0]?.signals || {};
-}
-
-function boolList(flags = {}) {
-  return Object.entries(flags).filter(([, value]) => value).map(([key]) => key);
-}
-
-function ratioScore(a, b) {
-  if (a === 0 && b === 0) return 5;
-  if (a === 0 || b === 0) return 1;
-  const ratio = Math.min(a, b) / Math.max(a, b);
-  if (ratio > 0.9) return 5;
-  if (ratio > 0.75) return 4;
-  if (ratio > 0.55) return 3;
-  if (ratio > 0.3) return 2;
-  return 1;
-}
-
-function sequenceSimilarity(a, b) {
-  const left = a.map((item) => `${item.tag}:${item.text}`).filter(Boolean);
-  const right = b.map((item) => `${item.tag}:${item.text}`).filter(Boolean);
-  if (!left.length && !right.length) return 1;
-  if (!left.length || !right.length) return 0;
-  const rightSet = new Set(right);
-  const hits = left.filter((item) => rightSet.has(item)).length;
-  return hits / Math.max(left.length, right.length);
-}
-
-function inferComplexity(signals) {
-  const frameworks = boolList(signals.frameworks);
-  const counts = signals.counts || {};
-  if ((counts.forms || 0) > 2 && (counts.inputs || 0) > 10) return "L6";
-  if ((counts.canvas || 0) > 0 || signals.frameworks?.three) return "L5";
-  if (signals.frameworks?.gsap || signals.frameworks?.lenis || (counts.video || 0) > 2) return "L4";
-  if (frameworks.some((name) => ["react", "next", "vue", "nuxt", "svelte", "astro"].includes(name))) return "L3";
-  if ((counts.links || 0) > 80 || (counts.images || 0) > 40) return "L2";
-  return "L1";
-}
-
-function score(original, clone, visualDiff) {
-  const o = firstSignals(original);
-  const c = firstSignals(clone);
-  const structureSimilarity = sequenceSimilarity(o.headings || [], c.headings || []);
-  const structure = Math.max(1, Math.round(structureSimilarity * 5));
-  const responsive = original.captures?.length === clone.captures?.length ? 4 : 2;
-  const functionCounts = ["links", "forms", "buttons", "inputs"].map((key) => ratioScore(o.counts?.[key] || 0, c.counts?.[key] || 0));
-  const functional = Math.round(functionCounts.reduce((sum, value) => sum + value, 0) / functionCounts.length);
-  const motionCounts = ["canvas", "video"].map((key) => ratioScore(o.counts?.[key] || 0, c.counts?.[key] || 0));
-  const interaction = Math.round(motionCounts.reduce((sum, value) => sum + value, 0) / motionCounts.length);
-  return {
-    sourceEvidence: 3,
-    structure,
-    visual: visualDiff ? `${visualDiff.visualScore}/5` : "需人工看截图或传 --visual-diff",
-    interaction,
-    responsive,
-    functional,
-    contentReplacement: "需人工看文案残留",
-    legalRisk: "需人工核查 license / 素材",
-  };
-}
-
-function line(value) {
-  if (Array.isArray(value)) return value.join(", ") || "none";
-  return value ?? "";
-}
-
-function routePath(url) {
-  try {
-    const parsed = new URL(url);
-    return `${parsed.pathname}${parsed.search}` || "/";
-  } catch {
-    return url;
-  }
-}
-
-function routesSection(files, evidence) {
-  if (!evidence.originalRoutes || !evidence.cloneRoutes) {
-    return `## 路由覆盖
-- 未提供 route-crawl 结果。多页面站需要传 --original-routes / --clone-routes。
-`;
-  }
-  const originalSet = new Set((evidence.originalRoutes.routes || []).map((route) => routePath(route.url)));
-  const cloneSet = new Set((evidence.cloneRoutes.routes || []).map((route) => routePath(route.url)));
-  const matched = Array.from(originalSet).filter((item) => cloneSet.has(item));
-  const missing = Array.from(originalSet).filter((item) => !cloneSet.has(item));
-  const extra = Array.from(cloneSet).filter((item) => !originalSet.has(item));
-  const coverage = originalSet.size ? Math.round((matched.length / originalSet.size) * 100) : 100;
-  return `## 路由覆盖
-- 原站路由: ${originalSet.size}
-- 克隆路由: ${cloneSet.size}
-- 覆盖率: ${coverage}%
-- 原站 route map: ${files.originalRoutes}
-- 克隆 route map: ${files.cloneRoutes}
-- 缺失路由: ${missing.join(", ") || "无"}
-- 额外路由: ${extra.join(", ") || "无"}
-`;
-}
-
-function changedActionCount(interactions) {
-  return (interactions?.actions || []).filter((action) => action.changed).length;
-}
-
-function interactionSection(files, evidence) {
-  if (!evidence.originalInteractions || !evidence.cloneInteractions) {
-    return `## 交互覆盖
-- 未提供 interaction-probe 结果。交互站需要传 --original-interactions / --clone-interactions。
-`;
-  }
-  const originalActions = evidence.originalInteractions.actions || [];
-  const cloneActions = evidence.cloneInteractions.actions || [];
-  const originalChanged = changedActionCount(evidence.originalInteractions);
-  const cloneChanged = changedActionCount(evidence.cloneInteractions);
-  const originalCanvas = evidence.originalInteractions.discovered?.canvases?.length || 0;
-  const cloneCanvas = evidence.cloneInteractions.discovered?.canvases?.length || 0;
-  const originalInteractive = evidence.originalInteractions.discovered?.interactive?.length || 0;
-  const cloneInteractive = evidence.cloneInteractions.discovered?.interactive?.length || 0;
-  return `## 交互覆盖
-- 原站可见交互目标: ${originalInteractive}
-- 克隆可见交互目标: ${cloneInteractive}
-- 原站 canvas 目标: ${originalCanvas}
-- 克隆 canvas 目标: ${cloneCanvas}
-- 原站 changed actions: ${originalChanged}/${originalActions.length}
-- 克隆 changed actions: ${cloneChanged}/${cloneActions.length}
-- 原站 interaction probe: ${files.originalInteractions}
-- 克隆 interaction probe: ${files.cloneInteractions}
-- 判断: ${originalChanged === cloneChanged && originalCanvas === cloneCanvas ? "交互数量信号接近，仍需看截图确认状态质量。" : "交互数量信号不一致，需要检查缺失状态或过度实现。"}
-`;
-}
-
-function report(files, original, clone, evidence) {
-  const o = firstSignals(original);
-  const c = firstSignals(clone);
-  const scores = score(original, clone, evidence.visualDiff);
-  const complexity = inferComplexity(o);
-  const originalFlags = boolList(o.frameworks);
-  const cloneFlags = boolList(c.frameworks);
-  const counts = ["sections", "links", "images", "video", "canvas", "forms", "buttons", "inputs", "interactive", "scripts"];
-
-  return `# ${original.label || "original"} vs ${clone.label || "clone"} · 克隆评估报告
-
-## 结论
-- 原站 URL: ${original.url}
-- 克隆 URL: ${clone.url}
-- 自动推断复杂度: ${complexity}
-- 复刻模式建议: ${complexity === "L5" ? "技术拆解 / 忠实复刻优先" : complexity === "L6" ? "展示层视觉复刻" : "视觉复刻 / 内容爆改"}
-- 自动报告边界: 结构、数量、框架、console 可自动比；传入 visual-diff 后可纳入像素差异分。内容残留和法务仍需审计。
-
-## 技术信号
-| 项目 | 原站 | 克隆站 |
-|---|---|---|
-| title | ${o.title || ""} | ${c.title || ""} |
-| lang | ${o.lang || ""} | ${c.lang || ""} |
-| frameworks | ${line(originalFlags)} | ${line(cloneFlags)} |
-| scrollHeight | ${o.scrollHeight || 0} | ${c.scrollHeight || 0} |
-| h1 | ${line(o.h1)} | ${line(c.h1)} |
-
-## 数量对比
-| 指标 | 原站 | 克隆站 | 自动评分 |
-|---|---:|---:|---:|
-${counts.map((key) => `| ${key} | ${o.counts?.[key] || 0} | ${c.counts?.[key] || 0} | ${ratioScore(o.counts?.[key] || 0, c.counts?.[key] || 0)}/5 |`).join("\n")}
-
-## 复刻评分
-- 源证据: ${scores.sourceEvidence}/5
-- 结构保真: ${scores.structure}/5
-- 视觉保真: ${scores.visual}
-- 动效/交互: ${scores.interaction}/5
-- 响应式: ${scores.responsive}/5
-- 功能完整: ${scores.functional}/5
-- 内容替换: ${scores.contentReplacement}
-- 法务/部署风险: ${scores.legalRisk}
-
-## Console
-- 原站 console errors: ${original.console?.errors?.length || 0}
-- 克隆 console errors: ${clone.console?.errors?.length || 0}
-- 原站 page errors: ${original.console?.pageErrors?.length || 0}
-- 克隆 page errors: ${clone.console?.pageErrors?.length || 0}
-
-${routesSection(files, evidence)}
-
-${interactionSection(files, evidence)}
-
-## 截图证据
-- 原站侦察: ${files.original}
-- 克隆侦察: ${files.clone}
-- 像素差异: ${files.visualDiff || "未提供"}
-- 像素差异率: ${evidence.visualDiff ? evidence.visualDiff.diffPixelRatio : "未提供"}
-- 原站截图: ${(original.captures || []).map((capture) => capture.screenshot).join(", ")}
-- 克隆截图: ${(clone.captures || []).map((capture) => capture.screenshot).join(", ")}
-
-## 已知缺口
-- 未传入 visual-diff 时，视觉保真需要打开截图人工确认。
-- 法务、素材授权、品牌替换完整度需要人工核查。
-`;
-}
-
-try {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.help || !args.original || !args.clone) {
-    usage();
-    process.exit(args.help ? 0 : 1);
-  }
-
-  const original = readJson(args.original);
-  const clone = readJson(args.clone);
-  const visualDiff = args.visualDiff ? readJson(args.visualDiff) : null;
-  const originalRoutes = args.originalRoutes ? readJson(args.originalRoutes) : null;
-  const cloneRoutes = args.cloneRoutes ? readJson(args.cloneRoutes) : null;
-  const originalInteractions = args.originalInteractions ? readJson(args.originalInteractions) : null;
-  const cloneInteractions = args.cloneInteractions ? readJson(args.cloneInteractions) : null;
-  const output = path.resolve(args.out);
-  fs.mkdirSync(path.dirname(output), { recursive: true });
-  fs.writeFileSync(output, report(args, original, clone, {
-    visualDiff,
-    originalRoutes,
-    cloneRoutes,
-    originalInteractions,
-    cloneInteractions,
-  }));
-  console.log(output);
-} catch (error) {
-  console.error(`compare-recon failed: ${error.message}`);
-  process.exit(1);
-}

package/templates/vite/.howone/skills/web-clone/scripts/dna-scaffold.mjs

@@ -1,214 +0,0 @@
-#!/usr/bin/env node
-// dna-scaffold.mjs — 生成 design-dna.json 骨架，best-effort 从 recon-site.mjs 的输出预填。
-// 用法:
-//   node scripts/dna-scaffold.mjs --out <design-dna.json> [--recon <label-recon.json>] [--name <站名>]
-// 产物:
-//   <out>  完整 DNA 骨架；有 --recon 时预填字体/色候选/框架特效信号，其余留 "" 待人工 Analyze。
-// 纪律: 只搬侦察里"真实抓到"的信号，绝不编造。拿不准角色(primary/accent)的色值统一丢进 _recon_signals 供人工指派。
-
-import fs from "node:fs";
-import path from "node:path";
-
-function parseArgs(argv) {
-  const out = { recon: "", out: "", name: "", help: false };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--help" || a === "-h") out.help = true;
-    else if (a === "--recon") out.recon = argv[++i] || "";
-    else if (a === "--out") out.out = argv[++i] || "";
-    else if (a === "--name") out.name = argv[++i] || "";
-  }
-  return out;
-}
-
-function usage() {
-  console.log(`dna-scaffold.mjs — 生成 design-dna.json 骨架并 best-effort 预填
-
-  node scripts/dna-scaffold.mjs --out <design-dna.json> [--recon <label-recon.json>] [--name <站名>]
-
-只用在「视觉复刻 / 内容爆改」模式。忠实复刻分支不需要 DNA（真源码即真相）。
-schema 与字段含义见 references/design-dna.md。`);
-}
-
-// 完整 DNA 骨架（与 references/design-dna.md 对齐）
-function skeleton(name) {
-  const ts = () => ({ size: "", weight: "", line_height: "", tracking: "" });
-  return {
-    meta: { name: name || "", description: "", source_references: "", created_at: "" },
-    design_system: {
-      color: {
-        palette_type: "",
-        primary: { hex: "", role: "" },
-        secondary: { hex: "", role: "" },
-        accent: { hex: "", role: "" },
-        neutral: { scale: "", usage: "" },
-        semantic: { success: "", warning: "", error: "", info: "" },
-        surface: { background: "", card: "", elevated: "" },
-        contrast_strategy: "",
-      },
-      typography: {
-        type_scale: {
-          display: ts(), heading_1: ts(), heading_2: ts(), heading_3: ts(),
-          body: ts(), body_small: ts(), caption: ts(), overline: ts(),
-        },
-        font_families: { heading: "", body: "", mono: "" },
-        font_style_notes: "",
-      },
-      spacing: { base_unit: "", scale: "", content_density: "", section_rhythm: "" },
-      layout: { grid_system: "", max_content_width: "", columns: "", gutter: "", breakpoints: "", alignment_tendency: "" },
-      shape: { border_radius: { small: "", medium: "", large: "", pill: "" }, border_usage: "", divider_style: "" },
-      elevation: { shadow_style: "", levels: { low: "", medium: "", high: "" }, depth_cues: "" },
-      iconography: { style: "", stroke_weight: "", size_scale: "", preferred_set: "" },
-      motion: { easing: "", duration_scale: { micro: "", normal: "", macro: "" }, entrance_pattern: "", exit_pattern: "", philosophy: "" },
-      components: { button_style: "", input_style: "", card_style: "", navigation_pattern: "", modal_style: "", list_style: "", component_notes: "" },
-    },
-    design_style: {
-      aesthetic: { mood: [], visual_metaphor: "", era_influence: "", genre: "", personality_traits: [], adjectives: [] },
-      visual_language: { complexity: "", ornamentation: "", whitespace_usage: "", visual_weight_distribution: "", focal_strategy: "", contrast_level: "", texture_usage: "" },
-      composition: { hierarchy_method: "", balance_type: "", flow_direction: "", grouping_strategy: "", negative_space_role: "" },
-      imagery: { photo_treatment: "", illustration_style: "", graphic_elements: "", pattern_usage: "", image_shape: "" },
-      interaction_feel: { feedback_style: "", hover_behavior: "", transition_personality: "", loading_style: "", microinteraction_density: "" },
-      brand_voice_in_ui: { tone: "", formality: "", cta_style: "", empty_state_approach: "", error_tone: "" },
-    },
-    visual_effects: {
-      overview: { effect_intensity: "", performance_tier: "", fallback_strategy: "", primary_technology: "" },
-      background_effects: { type: "", description: "", technology: "", params: { color_palette: "", speed: "", density: "", opacity: "", blend_mode: "" } },
-      particle_systems: { enabled: false, type: "", description: "", technology: "", params: { count: "", shape: "", size_range: "", movement_pattern: "", color_behavior: "", interaction: "", spawn_area: "" } },
-      "3d_elements": { enabled: false, type: "", description: "", technology: "", params: { renderer: "", lighting: "", camera: "", materials: "", geometry: "", post_processing: [], interaction_model: "" } },
-      shader_effects: { enabled: false, type: "", description: "", technology: "", params: { uniforms: "", vertex_manipulation: "", fragment_output: "", noise_type: "", distortion: "" } },
-      scroll_effects: { parallax: { enabled: false, layers: "", depth_range: "", speed_curve: "" }, scroll_triggered_animations: { enabled: false, trigger_points: "", animation_type: "", scrub_behavior: "" }, scroll_morphing: { enabled: false, description: "" } },
-      text_effects: { type: "", description: "", technology: "", params: { split_strategy: "", animation_per_unit: "", stagger: "", effect_style: "" } },
-      cursor_effects: { enabled: false, type: "", description: "", params: { shape: "", size: "", blend_mode: "", trail: "", interaction_zone: "" } },
-      image_effects: { type: "", description: "", technology: "", params: { filter_pipeline: "", hover_transform: "", reveal_animation: "", distortion_type: "" } },
-      glassmorphism_neumorphism: { enabled: false, style: "", params: { blur_radius: "", transparency: "", border_treatment: "", shadow_type: "", light_source_angle: "" } },
-      canvas_drawings: { enabled: false, type: "", description: "", technology: "", params: { draw_method: "", animation_loop: "", color_scheme: "", responsiveness: "", interaction: "" } },
-      svg_animations: { enabled: false, type: "", description: "", params: { animation_method: "", path_morphing: "", stroke_animation: "", filter_effects: "" } },
-      composite_notes: "",
-    },
-  };
-}
-
-const COLOR_RE = /(#[0-9a-fA-F]{3,8}\b|\brgba?\([^)]*\)|\bhsla?\([^)]*\))/;
-
-// recon-site.mjs 把信号按视口嵌在 captures[].signals 下；取最宽视口的 signals 摊平，
-// 兼容已是扁平结构的 recon 输入。摊平失败则原样返回(enrich 对缺字段已容错)。
-function flattenRecon(recon) {
-  if (recon && Array.isArray(recon.captures) && recon.captures.length) {
-    const widest = recon.captures
-      .filter((c) => c && c.signals)
-      .sort((a, b) => (b?.viewport?.width || 0) - (a?.viewport?.width || 0))[0];
-    if (widest && widest.signals) {
-      // 顶层 url 兜底进 href，便于 meta.source_references 预填
-      return { href: recon.url, ...widest.signals };
-    }
-  }
-  return recon;
-}
-
-function uniq(arr) {
-  return Array.from(new Set(arr.filter(Boolean)));
-}
-
-// 从 recon JSON best-effort 抽信号，并预填 skeleton 的明确字段
-function enrich(dna, recon) {
-  const signals = { fonts: [], color_candidates: [], frameworks: {}, canvas_count: 0, css_color_vars: [] };
-
-  // 字体: fonts[] + sections[].style.fontFamily
-  const fontList = uniq([
-    ...(Array.isArray(recon.fonts) ? recon.fonts : []),
-    ...((recon.sections || []).map((s) => s?.style?.fontFamily).filter(Boolean)),
-  ]).map((f) => String(f).replace(/^["']|["']$/g, "").split(",")[0].trim()).filter(Boolean);
-  signals.fonts = uniq(fontList);
-  if (signals.fonts.length) {
-    const mono = signals.fonts.find((f) => /mono|code|consol|courier/i.test(f)) || "";
-    const nonMono = signals.fonts.filter((f) => f !== mono);
-    dna.design_system.typography.font_families.heading = nonMono[0] || "";
-    dna.design_system.typography.font_families.body = nonMono[1] || nonMono[0] || "";
-    dna.design_system.typography.font_families.mono = mono;
-  }
-
-  // 颜色: CSS 变量里像颜色的 + sections 的 bg/color
-  const cssVars = Array.isArray(recon.cssVariables) ? recon.cssVariables : [];
-  for (const pair of cssVars) {
-    const [name, val] = Array.isArray(pair) ? pair : [pair?.name, pair?.value];
-    if (val && COLOR_RE.test(String(val))) signals.css_color_vars.push(`${name}: ${String(val).trim()}`);
-  }
-  const sectionColors = [];
-  for (const s of recon.sections || []) {
-    const bg = s?.style?.backgroundColor;
-    const fg = s?.style?.color;
-    if (bg && !/rgba?\(0, 0, 0, 0\)|transparent/i.test(bg)) sectionColors.push(bg);
-    if (fg) sectionColors.push(fg);
-  }
-  signals.color_candidates = uniq([
-    ...signals.css_color_vars.map((v) => v.split(":").slice(1).join(":").trim()),
-    ...sectionColors,
-  ]).slice(0, 24);
-  // body/header 背景作为 surface.background 候选(第一个非透明的 section bg)
-  const firstBg = (recon.sections || []).map((s) => s?.style?.backgroundColor)
-    .find((c) => c && !/rgba?\(0, 0, 0, 0\)|transparent/i.test(c));
-  if (firstBg) dna.design_system.color.surface.background = firstBg;
-
-  // 框架/特效信号
-  const fw = recon.frameworks || {};
-  signals.frameworks = fw;
-  signals.canvas_count = (recon.canvases && recon.canvases.length) || recon?.counts?.canvas || 0;
-
-  if (fw.three) {
-    dna.visual_effects.overview.primary_technology = "WebGL/Three.js";
-    dna.visual_effects.overview.performance_tier = "heavy";
-    dna.visual_effects["3d_elements"].enabled = true;
-    dna.visual_effects["3d_elements"].technology = "Three.js";
-  } else if (signals.canvas_count > 0) {
-    dna.visual_effects.overview.primary_technology = "Canvas 2D";
-    dna.visual_effects.canvas_drawings.enabled = true;
-  } else if (fw.gsap) {
-    dna.visual_effects.overview.primary_technology = "GSAP";
-  }
-  if (fw.gsap || fw.lenis) {
-    dna.visual_effects.scroll_effects.scroll_triggered_animations.enabled = true;
-    dna.visual_effects.scroll_effects.scroll_triggered_animations.scrub_behavior =
-      fw.lenis ? "lenis smooth-scroll detected" : "gsap detected";
-  }
-
-  // meta 预填
-  if (recon.href) dna.meta.source_references = recon.href;
-  if (!dna.meta.name && recon.title) dna.meta.name = recon.title;
-
-  // 把原始信号留在顶层供人工指派角色(不编造 primary/accent)
-  dna._recon_signals = signals;
-  dna._scaffold_note =
-    "best-effort 预填来自 recon。font_families/surface.background/visual_effects 已据真实信号填写；" +
-    "color 的 primary/secondary/accent 角色需人工从 _recon_signals.color_candidates 指派；" +
-    "所有 \"\" 字段需人工 Analyze 补全(见 references/design-dna.md)。确认无误后可删除 _recon_signals 与本说明。";
-  return dna;
-}
-
-try {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.help || !args.out) {
-    usage();
-    process.exit(args.help ? 0 : 1);
-  }
-  let dna = skeleton(args.name);
-  if (args.recon) {
-    try {
-      const recon = JSON.parse(fs.readFileSync(path.resolve(args.recon), "utf8"));
-      dna = enrich(dna, flattenRecon(recon));
-    } catch (e) {
-      console.warn(`⚠️ 读 recon 失败(${e.message})，只输出空骨架。`);
-    }
-  }
-  const outPath = path.resolve(args.out);
-  fs.mkdirSync(path.dirname(outPath), { recursive: true });
-  fs.writeFileSync(outPath, `${JSON.stringify(dna, null, 2)}\n`);
-  console.log(`✅ design-dna 骨架已写入: ${outPath}`);
-  if (dna._recon_signals) {
-    const s = dna._recon_signals;
-    console.log(`   预填: 字体 ${s.fonts.length} 个 / 色候选 ${s.color_candidates.length} 个 / canvas ${s.canvas_count} / three=${!!s.frameworks.three} gsap=${!!s.frameworks.gsap} lenis=${!!s.frameworks.lenis}`);
-  }
-  console.log(`   下一步: 人工 Analyze 补全 ""，并从 _recon_signals 指派颜色角色。schema → references/design-dna.md`);
-} catch (e) {
-  console.error(`dna-scaffold 失败: ${e.message}`);
-  process.exit(1);
-}