howone 0.2.0 → 0.2.1

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

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-import crypto from "node:crypto";
-
-function usage() {
-  console.log(`Usage:
-  node scripts/asset-harvest.mjs --recon original-recon.json --out assets/original [--manifest asset-manifest.json] [--all-external]
-
-Reads recon JSON, downloads discovered images/scripts/stylesheets, and writes a manifest.
-`);
-}
-
-function parseArgs(argv) {
-  const out = { recon: "", outDir: "assets/original", manifest: "", allExternal: false };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--help" || arg === "-h") out.help = true;
-    else if (arg === "--recon") out.recon = argv[++i] || "";
-    else if (arg === "--out") out.outDir = argv[++i] || "assets/original";
-    else if (arg === "--manifest") out.manifest = argv[++i] || "";
-    else if (arg === "--all-external") out.allExternal = true;
-    else throw new Error(`Unexpected argument: ${arg}`);
-  }
-  return out;
-}
-
-function safeName(url) {
-  const parsed = new URL(url);
-  const ext = path.extname(parsed.pathname).slice(0, 12);
-  const base = path.basename(parsed.pathname, ext).replace(/[^a-z0-9._-]+/gi, "-").slice(0, 80) || "asset";
-  const hash = crypto.createHash("sha1").update(url).digest("hex").slice(0, 10);
-  return `${base}-${hash}${ext || ".bin"}`;
-}
-
-function collectAssets(recon) {
-  const assets = new Map();
-  for (const capture of recon.captures || []) {
-    const signals = capture.signals || {};
-    for (const src of signals.scripts || []) assets.set(src, { type: "script", url: src });
-    for (const href of signals.stylesheets || []) assets.set(href, { type: "stylesheet", url: href });
-    for (const image of signals.images || []) {
-      if (image.src) assets.set(image.src, { type: "image", url: image.src, alt: image.alt, width: image.width, height: image.height });
-    }
-  }
-  return Array.from(assets.values()).filter((asset) => /^https?:\/\//i.test(asset.url));
-}
-
-async function download(asset, outDir) {
-  const response = await fetch(asset.url, {
-    headers: {
-      "user-agent": "web-clone-skill/1.0 asset-harvest",
-      "accept": "*/*",
-    },
-  });
-  if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
-  const buffer = Buffer.from(await response.arrayBuffer());
-  const hostDir = path.join(outDir, new URL(asset.url).hostname);
-  fs.mkdirSync(hostDir, { recursive: true });
-  const file = path.join(hostDir, safeName(asset.url));
-  fs.writeFileSync(file, buffer);
-  return { ...asset, status: "ok", bytes: buffer.length, file };
-}
-
-try {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.help || !args.recon) {
-    usage();
-    process.exit(args.help ? 0 : 1);
-  }
-
-  const recon = JSON.parse(fs.readFileSync(args.recon, "utf8"));
-  const outDir = path.resolve(args.outDir);
-  const manifestFile = path.resolve(args.manifest || path.join(outDir, "asset-manifest.json"));
-  const originHost = recon.url ? new URL(recon.url).hostname : "";
-  const assets = collectAssets(recon).filter((asset) => args.allExternal || new URL(asset.url).hostname === originHost);
-  const results = [];
-
-  for (const asset of assets) {
-    try {
-      results.push(await download(asset, outDir));
-    } catch (error) {
-      results.push({ ...asset, status: "error", error: error.message });
-    }
-  }
-
-  fs.mkdirSync(path.dirname(manifestFile), { recursive: true });
-  fs.writeFileSync(manifestFile, `${JSON.stringify({
-    source: args.recon,
-    url: recon.url,
-    allExternal: args.allExternal,
-    total: results.length,
-    ok: results.filter((item) => item.status === "ok").length,
-    error: results.filter((item) => item.status === "error").length,
-    assets: results,
-  }, null, 2)}\n`);
-  console.log(manifestFile);
-} catch (error) {
-  console.error(`asset-harvest failed: ${error.message}`);
-  process.exit(1);
-}

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);
-}