用途：向用户项目添加 Font Awesome 图标，自动完成图标名解析、项目集成方式检测与代码生成。
主要能力：先用 command -v fa 检查 fa CLI 是否可用；可用时用其做图标查询与 Kit 获取（返回结构化 JSON），Kit 操作需先 fa whoami 登录或设置 FA_API_TOKEN，否则提示运行 fa login，或回退到 fetch-kit.py。不可用时回退到 Python 脚本，如 latest-version.py、icon-exists.py。
流程：读取项目根目录 .font-awesome.md 判断是否使用 Kit；无该文件则用子代理探测 package.json、HTML 模板、源码导入、SVG 精灵、Web Components 等，确定集成方式、Kit ID/CDN、许可证、默认样式与家族、导入模式、版本及项目约定，并写入 .font-awesome.md。随后按优先级确定样式与家族，校验图标在所选家族样式中是否可用；Kit 项目用 fa kit icon --kit-token <TOKEN> <icon> 校验，不在子集内则停止并建议加入 Kit 或改用替代图标。
生成代码：按集成方式输出 React、Vue、Angular、Web Components、SVG+JS Kit、Web Fonts+CSS、SVG 精灵等对应写法；有位置参数则插入代码并补导入，否则以代码块展示。若图标仅限 Pro 而项目为免费版，会给出提示。
限制：Kit 子集校验依赖 fa CLI 与登录；不得凭记忆生成裸 SVG，需用 fa icons --version <version> --name <icon> --svg-format html 从 API 获取。资料未提供具体收费与价格信息。