用途:在项目中从零完成 Font Awesome 配置,包括检测项目类型、下载 Kit 或安装包、写入初始集成代码,并创建 .font-awesome.md,使 /add-icon 可立即使用。
主要能力:先做预检,若项目根目录已存在 .font-awesome.md 则提示已配置并询问是否重配;通过 command -v fa 检测 fa CLI,fa kit 子命令需 0.8.0 及以上;Kit 操作前用 fa whoami 检查登录,或依赖 FA_API_TOKEN。用子代理检测包管理器、框架(React、Vue、Angular、Ember、Svelte、WordPress、静态 HTML)、已有 Font Awesome 痕迹、已用图标及许可证线索。
集成方式:有账号或 Kit 时优先 Kit——JS 框架用 npm 包 @awesome.me/kit-*,静态或服务端渲染用嵌入代码,桌面应用用 Kit 下载;无账号则建议在 fontawesome.com 注册(有免费账号)后走 Kit 路径。不推荐第三方 CDN。
执行与验证:按所选路径读取 references/ 下对应文件(path-a-kit-embed、path-b-kit-npm、path-c-kit-download、path-d-npm-packages),npm 路径再读 path-f-framework-init。拿到 Kit token 后用 fa kit icon、fa kit icons、fa kit family-styles 核对已用图标是否被 Kit 子集覆盖,缺失需明确警告。随后添加测试图标验证渲染,最后按 font-awesome-md-format.md 写入 .font-awesome.md。
限制:禁止凭训练数据生成裸 SVG,需要时用 fa icons --version <version> --name <icon> --svg-format html 从 API 获取,且需登录或设置 FA_API_TOKEN;fa CLI 不可用或无法认证时无法验证 Kit 覆盖,缺失图标将不渲染。具体价格、平台支持等资料暂未提供。