SF符号生成器

技能简介

该技能将SVG矢量图转换为Xcode可用的SF Symbol资源目录（.symbolset），支持直接注入官方模板或生成原始符号集，便于在Apple生态应用中使用自定义图标。

能做什么

• 从SVG自动生成完整的.symbolset文件夹结构
• 创建配套的Contents.json配置文件
• 将自定义路径注入SF Symbols标准模板（Ultralight/Regular/Black三档）
• 自动计算路径边界并居中适配模板边距
• 支持通过环境变量指定资源目录位置

使用说明

安装步骤

1. 克隆技能仓库到本地工作区
2. 确保系统已安装Node.js运行环境
3. 进入技能目录：cd skills/svkozak/sfsymbol-generator
4. 赋予脚本执行权限：chmod +x scripts/*.sh scripts/*.js

基础用法

方式一：原始符号集（无模板注入）

./scripts/generate.sh <symbol-name> <svg-path> [assets-dir]

方式二：模板注入（推荐）

./scripts/generate-from-template.js <symbol-name> <svg-path> [template-svg] [assets-dir]

可通过环境变量覆盖默认路径：export SFSYMBOL_ASSETS_DIR=/path/to/your/Assets.xcassets/Symbols

输入与输出

见下方输入与输出表格。

风险提示

• SVG必须包含viewBox属性，否则无法处理
• 仅支持path路径形状，矩形会被转换，其他形状需提前转为路径
• 建议使用填充图形而非描边，以避免细线伪影
• 生成的符号集需手动添加到Xcode项目才能生效

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/svkozak/sfsymbol-generator/SKILL.md
来源类型：GitHub开源技能