sfsymbol-generator

SF Symbol Generator 是一款专为 iOS/macOS 开发者设计的轻量级命令行工具，旨在简化自定义 SF Symbol 资产目录的生成流程。该工具通过解析标准 SVG 文件，自动创建符合 Xcode 规范的 .symbolset 目录结构，包括完整的 Contents.json 配置和多版本模板注入，使开发者能够快速将自定义矢量图标集成到苹果生态应用中。

核心用法上，该技能提供两种工作模式：原始模式（Raw）直接复制 SVG 文件创建基础 symbolset；推荐模式（Template-based）则将 SVG 路径智能注入到 SF Symbols 标准模板中，自动生成 Ultralight、Regular、Black 三种权重变体，确保与系统图标风格一致。使用时只需指定符号名称、SVG 路径及可选的资产目录位置，脚本会自动完成路径验证、viewBox 计算、边界框对齐和文件写入等操作。

显著优点体现在其极高的安全性和轻量性。代码仅依赖 Node.js 标准库（fs、path），无第三方 npm 包引入，从根本上杜绝了供应链攻击风险。Bash 脚本采用 set -euo pipefail 严格模式，Node 脚本具备完善的参数校验、文件存在性检查和正则匹配验证，错误处理机制完善且不暴露敏感路径信息。全程本地离线运行，无网络通信、无数据收集，权限申请与文件操作功能严格匹配。

潜在局限性包括来源可信度为 T3 级（个人开发者），虽代码质量优良但建议首次使用前进行审计。功能上对输入 SVG 有严格要求：必须包含 viewBox、使用 path-based 形状（矩形虽支持转换但可能产生意外），且推荐使用填充而非描边以避免渲染伪影。此外，作为命令行工具缺乏图形界面，对非技术设计师不够友好。

适合的目标群体主要是 iOS/macOS 原生应用开发者、UI/UX 设计师以及需要维护自定义图标资产库的团队。特别适用于需要将品牌图标统一为 SF Symbols 风格、或在 SwiftUI/UIKit 项目中使用可变颜色符号的场景。

使用风险主要集中于文件系统操作：脚本会写入指定的 Xcode 资产目录，若环境变量 SFSYMBOL_ASSETS_DIR 或参数指向错误路径，可能导致现有资源被覆盖。虽然工具本身不执行破坏性命令（如 rm -rf），但处理来源不明的 SVG 文件仍存在理论上的 XML 解析风险（尽管实际使用正则而非 XML 解析器）。建议在使用前备份现有 Assets.xcassets，并确保输入 SVG 来自可信来源。