技能介绍

图标库接入的常见问题

把 Hugeicons 这类图标库接入项目时，容易卡在几个具体位置：图标数量多，靠浏览目录找合适的语义图标很慢；同一个图标在不同框架下的用法并不完全一致，React、Vue、Angular、Svelte、React Native、Flutter 和 HTML 的接入方式需要分别确认；同时，很多场景真正需要的是某个图标的 Unicode 字形，而不是手动复制展示字符。

这个技能如何工作

@org-rn88lg3j/huge-icons 提供了一个基于 TypeScript 的 MCP server，把图标检索和平台用法收敛到一组可调用工具里。大模型负责理解意图、选择工具和提取参数，代码负责调用 API 并返回结果。

可用能力包括：

scripts.tools.list_icons：获取可用图标列表。
scripts.tools.search_icons：按名称或标签搜索，支持逗号分隔多个查询。
scripts.tools.get_platform_usage：获取指定平台的使用说明。
scripts.tools.get_icon_glyphs：获取某个图标在各样式下的 Unicode 字形。
scripts.tools.get_icon_glyph_by_style：获取某个图标在特定样式下的 Unicode 字形。

执行流程先检查 scripts.config.settings.api_key。如果密钥为空，会通过 AskUserQuestion 向用户询问；拿到密钥后调用 scripts.config.set_api_key(api_key) 保存。随后根据用户意图选择工具，按函数要求传入关键字参数，例如 scripts.tools.search_icons(query='home, notification, settings')，最后整理 result["raw"] 中的原始数据并展示。若必填参数缺失，同样会先询问。

适用边界与注意点

这个技能依赖 Hugeicons API，API 密钥是必需配置。缺少密钥时不能自行搜索或编造图标数据；返回结果应以 result["raw"]、result["success"] 和 result["message"] 为准，避免在工具失败时猜测图标是否存在。搜索适合已知语义或标签的场景，平台用法只覆盖文档列出的框架，样式与字形以实际返回为准。