用途:本技能面向使用 @ariestools/sdk-react 及其子包的 React 项目,帮助选择伞包或聚焦包、正确导入模块、配置依赖并完成迁移。
主要能力:覆盖 12.0.1 版本的 11 个 @ariestools/sdk-react* 包,提供导入与上下文身份、包与子路径、组件与 Hook 模式、迁移指南等参考。
必要用法:不要导入聚焦包的根(如 @ariestools/sdk-react-foundation),应导入 @ariestools/sdk-react/<module> 或所属 @ariestools/sdk-react-<pkg>/<module>;用户事件位于 @ariestools/sdk-react-foundation/user-events。应用需自行添加 @ariestools/sdk ~9.0、zod ^4.6、@opentelemetry/api ^1.9,MUI 还需 @emotion/react 与 @emotion/styled。使用 react-router ^8.4(非 react-router-dom),保持 @mui/material 9.4.x 与 react-router 8.4.x。移除所有 @xylabs/sdk-react 与 @xylabs/react-* 垫片,不要添加 @ariestools/sdk-react-core。运行时使用 Node 26,不支持 React 18。
安装:npx skills add ariestools/ariestools-skills --skill ariestools-sdk-react,或在 xy 仓库中 pnpm xy skills pick --skill ariestools-sdk-react。
适用场景:在 React 应用中集成 Aries Tools UI、分析、加密等模块,或从旧包迁移。
限制:不覆盖 @ariestools/sdk 工具、构建测试工具链、actor/host 套件、XYO/XL1 包及通用 React 设计、MUI 主题与 Storybook 设置;12.0.0 存在错误边界与 Gtag 问题,需 12.0.1 或更高。