SuperAPI AI 工具集

favicon

通用与其它

查看项目

更新于 10-16 01:27

技能介绍

用途:输入一张源图片路径($1),生成完整 favicon 资源并写入项目静态目录,同时更新页面 head 中的相关 link 标签,适合需要一次性补齐站点图标与 PWA manifest 的前端项目。

主要能力:依赖 ImageMagick v7+(先执行 which magick 校验,缺失时提示用 brew install imagemagick 或 sudo apt install imagemagick 安装后停止)。校验源文件存在且扩展名为 PNG、JPG、JPEG、SVG、WEBP、GIF;识别 Rails、Next.js、Gatsby、SvelteKit、Astro、Hugo、Jekyll、Vite、CRA、Vue CLI、Angular、Eleventy、静态 HTML 等框架并确定静态资源目录;若已存在图标文件则以其位置为准。自动推断应用名(site.webmanifest → package.json → Rails 模块名 → 目录名,转标题式)。

生成内容:favicon.ico(16/32/48 多分辨率)、favicon-96x96.png、apple-touch-icon.png(180)、web-app-manifest-192x192.png、web-app-manifest-512x512.png;源为 SVG 时另复制 favicon.svg。创建或更新 site.webmanifest(保留已有的 theme_color、background_color、display,更新名称与 icons)。按框架更新相应文件:Rails 改 application.html.erb,Next.js 改 metadata 的 icons/manifest/appleWebApp,静态 HTML 改 index.html;未识别项目则跳过 HTML 改动并给出需手动添加的标签。

限制与注意:命令中 -background none 必须放在输入文件之前,否则 SVG 透明背景会变白;无法 100% 确认静态目录时应先询问用户;图标路径需依静态目录相对站点根的位置调整;命令失败、源文件缺失或布局文件找不到时会报告具体错误或转为手动指引;本技能不替代针对具体环境的验证、测试与人工审查。