@mingfuyun/star-allinone 0.0.2 → 0.0.4

package/README.md

@@ -263,6 +263,23 @@ HocModal会将你的组件包装，并注入以下props：
 
 适用于需要动态控制显示/隐藏，并且需要传递参数的Modal场景。
 
+#### ⚠️ 常见错误
+
+**错误用法**：
+```tsx
+// ❌ 错误：HocModal 是一个高阶组件，不能直接作为组件使用
+<HocModal />
+```
+
+**正确用法**：
+```tsx
+// ✅ 正确：先使用 HocModal 包装你的组件
+const WrappedModal = HocModal(MyContent);
+<WrappedModal ref={modalRef} />
+```
+
+**注意**：`HocModal` 是一个函数，接受一个组件作为参数，返回一个新的包装组件。不能直接作为 React 组件使用。
+
 ### CustomDrawer 自定义抽屉
 
 基于Antd Drawer的增强组件，提供统一的样式和默认配置，支持自定义底部操作栏。
@@ -425,6 +442,13 @@ function Page() {
 - Antd >= 5.27.3
 - cron-validator >= 1.4.0 (用于Cron表达式验证)
 
+**重要提示**：组件库使用 `peerDependencies` 管理 React 和 Antd，确保你的项目中已安装这些依赖。如果遇到 "Invalid hook call" 错误，请检查：
+
+1. 确保项目中只安装了一个 React 版本
+2. 确保 React 和 React-DOM 版本匹配
+3. 如果使用 npm/yarn，可以尝试删除 `node_modules` 和锁文件后重新安装
+4. 如果使用 pnpm，确保在 `.npmrc` 中配置了 `shamefully-hoist=true` 或使用 `public-hoist-pattern[]=*react*`
+
 ## 🔧 开发
 
 ### 本地开发