用途:向 visual-reference 项目添加一条新的视觉参考,自包含运行,无需 vault 或外部流水线。
主要能力:分析截图并提取颜色(背景、强调色、文字,使用十六进制与语义命名)、字体(display/body/mono)、效果(按给定分类法识别背景处理、悬停交互、入场动画、布局模式、视觉点缀、内容模式、插画系统、3D 空间等;不在分类法内的效果以 kebab-case 新建 slug,默认归入 visual-accent)、模式(dark/light/warm)与一行风格描述。
使用方式:需在项目根目录,用户提供截图(粘贴或文件路径)。先分析截图,再与用户确认名称、来源 URL(可选)、分类(Portfolio、B2B SaaS、Dev Tools、VC / Finance、Creative / 3D、Education、Fintech)、模式、风格与效果。生成 slug 格式为 hunt-{kebab-case-name}。截图保存到 public/references/{slug}/reference-desktop.png(可另存 reference-tablet.png、reference-mobile.png),先执行 mkdir -p public/references/{slug}。随后按给定 schema 生成 src/content/references/{slug}.json,字段含 slug、name、style、sourceUrl、huntDate、categories、engagement(默认 5,1-10)、mode、tokens(colors、typography、spacing、borderRadius、shadows、animation)、effects、whyItWorks、coreAesthetic、techStack、screenshots。再读取并更新 src/content/references/index.json,最后运行 bun run build 验证,构建须零错误,失败则修正 JSON 重试。完成后打印创建的文件与后续 git 命令。
限制:需在项目根目录且用户提供截图;效果分类法之外需新建 slug;techStack 为视觉推测;构建必须通过。