用途:从指定源图片生成一整套网站图标(favicon),并更新项目 HTML 中的相应 link 标签。适用于为 Web 项目配置图标。
主要能力:校验源图片格式(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;按项目类型更新布局文件。
使用方式:先确认已安装 ImageMagick v7+,运行 which magick 检查,未安装则按平台安装(macOS: brew install imagemagick;Linux: sudo apt install imagemagick)。然后提供源图片路径,工具按项目类型选择静态目录(如 Rails/Next.js/Astro/Vite 用 public/,Gatsby/SvelteKit/Hugo 用 static/,Jekyll 用根目录,Angular 用 src/assets/),生成文件并更新 HTML。Next.js 更新 metadata 的 icons 配置,Rails 和静态 HTML 更新 head 标签。
限制:需 ImageMagick v7+,否则停止并提示安装;源图片不存在或格式不受支持时报错停止;无法确定静态目录时需询问确认;未检测到项目时跳过 HTML 更新,仅提示手动添加标签;app 名称来自已有 site.webmanifest、package.json、Rails 配置或目录名。