用途：本技能面向 Hugeicons Pro 付费包的使用，重点是私有 registry 认证与样式包选择，适用于 React、React Native、Vue、Angular、Svelte 等框架。
主要能力：配置 @hugeicons-pro 私有 registry 认证；选择 @hugeicons-pro/core-* 样式包；将 Pro 包与对应框架 wrapper 一起安装；在同一代码库混用免费与 Pro 图标；处理 CI/CD、令牌与安装失败；解决现代 ESM 包的 TypeScript 与模块解析问题。
使用方式：先阅读 references/private-registry-and-style-packages.md。按包管理器在 .npmrc、.yarnrc.yml 或 bunfig.toml 中添加项目级认证，例如： @hugeicons-pro:registry=https://npm.hugeicons.com/ //npm.hugeicons.com/:_authToken=${NPM_TOKEN} 安装框架 wrapper（如 @hugeicons/react、@hugeicons/vue），再安装任务实际需要的 Pro 样式包，从对应样式包具名导入图标并通过 wrapper 组件渲染。涉及 CI 或安装失败时阅读 references/pro-troubleshooting-and-ci.md。
适用场景：Pro 私有 registry 配置、付费样式包安装、免费与付费图标混用、CI 认证与安装排错。
限制：Pro core 包为私有 registry 包，无认证会回退到 npmjs 并失败；Pro core 包只含图标资源，仍需框架 wrapper；Universal License Key 不得进入版本控制；应只安装需要的样式，使用具名导入而非通配导入；同名图标跨样式包需显式别名；免费与 Pro 导入应分开；TypeScript 无法解析时改用 bundler、node16 或 nodenext 模块解析。