用途：为 React Native 或 Expo 项目添加 Reacticx 组件。该库提供 163 个动画与手势驱动组件，组件以源码复制进项目，安装后即为普通项目代码，可自由编辑，无运行时包依赖，也不需要从 node_modules 导入。
两种入口：CLI（npx reacticx <command>）适合在终端手动或一次性添加；MCP 服务器（@reacticx/mcp）适合由智能体完成并获得结构化结果。两者读取同一注册表、写入同一 outDir，并以相同方式重写导入。同一任务中不要混用，除非先用 reacticx diff 或 diff_components 重新检查状态。
添加前：用 npx reacticx config 或 get_config 查看解析后的配置；若项目没有 component.config.json，会采用默认值（src/shared/components、分类结构、@/shared/components 别名），通常不符合现有项目需求，应先运行 reacticx init / init_config。用 reacticx list、list_installed_components 或查看 outDir 确认组件是否已存在；带 --overwrite 重新添加会丢弃本地修改。添加前可用 reacticx info <name>、get_component_types、get_component_example 了解属性与示例，避免猜测。
添加命令示例：npx reacticx add accordion；npx reacticx add accordion --dir src/components/ui；npx reacticx add accordion --types --examples；npx reacticx add accordion --dry；npx reacticx add accordion --overwrite。按项目包管理器使用 bunx、npx 或 pnpm dlx。add 会重写注册表源码中的 @/components、@/utils、@/helpers 等导入为项目别名或相对路径；自动拉取依赖组件与共享 helper（--no-deps 可关闭，但关闭后需自行补齐模块）；除非 --overwrite 否则不覆盖已有文件；每次下载校验 checksum；报告缺失 npm 包并询问是否安装，MCP 服务器仅报告不会自动安装。
添加后：安装缺失包时优先用 npx expo install <package> 以匹配 Expo SDK；若有原生依赖，需重建原生目标（npx expo run:ios、npx expo run:android），仅重启 Metro 不够，这是新加组件启动崩溃的常见原因；从配置的别名导入；类型检查与 lint。
依赖：多数组件用 react-native-reanimated 动画，40 个还需 react-native-worklets（Reanimated 4 起独立安装）；45 个使用 @shopify/react-native-skia；模糊使用 @sbaiahmed1/react-native-blur（勿装未加作用域的 react-native-blur）；图标来自 @expo/vector-icons、expo-symbols 或 @hugeicons/react-native。references/components.md 列出每个组件的确切依赖。
常见错误：未 init 就添加导致落入错误目录与别名；原生依赖添加后未重建；覆盖本地已编辑组件（先 reacticx diff <name>）；使用 --no-deps 导致导入无法解析；装错 blur 包；凭相似名称假设组件存在（可用 reacticx list -s <term> 搜索）。参考文件包括 components.md、cli.md、mcp.md、configuration.md。