用途:从指定源图片生成一整套 favicon,并自动把对应的 link 标签写入项目 HTML/布局文件。需先确认已安装 ImageMagick v7+(检查命令 which magick;macOS 用 brew install imagemagick,Linux 用 sudo apt install imagemagick)。支持的源格式:PNG、JPG、JPEG、SVG、WEBP、GIF。
主要能力:生成 favicon.ico(16/32/48 多分辨率)、favicon-96x96.png、apple-touch-icon.png(180x180)、web-app-manifest-192x192.png、web-app-manifest-512x512.png;源为 SVG 时另复制 favicon.svg。创建或更新 site.webmanifest(保留已有的 theme_color、background_color、display),并更新布局文件中的图标链接。
使用方式:传入源图片路径 $1。技能会检测框架与静态资源目录(如 Rails/Next.js/Vite 用 public/,Gatsby/SvelteKit/Hugo 用 static/,Angular 用 src/assets/ 等),优先级为已有 favicon 文件所在位置;若不确定会用 AskUserQuestionTool 询问。应用名依次取 site.webmanifest 的 name、package.json 的 name、Rails 模块名或目录名。之后按项目类型更新 Rails 的 application.html.erb、Next.js 的 metadata 导出或静态 index.html。
限制:需 ImageMagick v7+;源图不存在或格式无效会报错停止;未识别项目类型时跳过 HTML 更新并提示手动添加标签;渲染 SVG 时 -background none 必须放在输入文件之前以保留透明;命令失败会报告具体错误。