SuperAPI AI 工具集

icon-export

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:在图标母版通过评审后,把 icon-design/icon.svg 导出为各平台所需资产,避免“半透明圆角”这类常见上线缺陷。平台自带遮罩的目标(iOS、Play、apple-touch-icon、PWA maskable)使用全幅方形变体;自渲染表面保留圆角矩形,防止二次遮罩产生透明角碎片。

主要能力:脚本确定性地完成全部导出,自动检测渲染器(rsvg-convert → resvg → cairosvg → inkscape → ImageMagick → macOS qlmanage+sips),无可用渲染器时退出码 2 并给出安装提示;内部生成方形变体与 1280×640 社交横幅;校验每个 PNG 的真实尺寸和 ICO 结构,失败退出码 1;默认拒绝覆盖已有文件(退出码 3),除非加 --force;导出文件不写元数据,会剥离 eXIf/tEXt/iTXt/zTXt/tIME/caBX/dSIG 并保留色彩块。输出默认放在 icon-design/export/,按 web、apple、android、github 分组,并附带 snippet.html 与 manifest.webmanifest 片段。

使用方式:python3 "${CLAUDE_SKILL_DIR}/scripts/export_icons.py" icon-design/icon.svg [--out DIR] [--targets web,apple,android,github] [--name icon] [--force]。退出码 0 表示完成。可接入仓库:--out public/ 并加入 head 标签与 manifest 的 icons 数组;README 场景直接引用 SVG 母版。

适用场景:已有批准母版时的多平台图标打包与对接。不适用:尚无母版、概念、绘制、评审、任意 SVG 转 PNG、照片缩放、文章 og:image。限制:只渲染内部约定子集的母版,会先做安全扫描,遇到脚本、外部引用或内嵌位图失败关闭;maskable 字形需位于居中 40% 半径安全圆内,裁切时应改母版而非导出;App Store 需不透明平面化的 1024 PNG,存在 alpha 时若装有 ImageMagick 会自动平面化,否则打印 magick -alpha remove 命令;qlmanage 回退仅适合预览/开发;iOS 26+ 分层图标需在 Apple Icon Composer 中基于平面 1024 母版制作;Android 自适应图标需在应用项目中做前后景图层。更多尺寸细节见 references/platform-targets.md。