@mingfuyun/star-allinone 0.0.3 → 0.0.5

package/README.md

@@ -442,6 +442,56 @@ function Page() {
 - Antd >= 5.27.3
 - cron-validator >= 1.4.0 (用于Cron表达式验证)
 
+**重要提示**：组件库使用 `peerDependencies` 管理 React 和 Antd，确保你的项目中已安装这些依赖。
+
+### 常见问题排查
+
+#### 1. "Invalid hook call" 错误
+
+如果遇到此错误，请检查：
+
+1. 确保项目中只安装了一个 React 版本
+2. 确保 React 和 React-DOM 版本匹配
+3. 如果使用 npm/yarn，可以尝试删除 `node_modules` 和锁文件后重新安装
+4. 如果使用 pnpm，确保在 `.npmrc` 中配置了：
+   ```ini
+   shamefully-hoist=true
+   ```
+   或
+   ```ini
+   public-hoist-pattern[]=*react*
+   ```
+
+#### 2. "Cannot read properties of undefined (reading 'recentlyCreatedOwnerStacks')" 错误
+
+这是 React 19 的一个已知问题，可能的原因和解决方案：
+
+1. **React 版本问题**：确保使用 React 19.0.0 或更高版本（推荐 19.1.1+）
+2. **多个 React 实例**：确保项目中只有一个 React 实例
+   ```bash
+   # 检查是否有多个 React 实例
+   npm ls react
+   # 或
+   pnpm list react
+   ```
+3. **pnpm 配置**：如果使用 pnpm，在 `.npmrc` 中添加：
+   ```ini
+   shamefully-hoist=true
+   public-hoist-pattern[]=*react*
+   public-hoist-pattern[]=*react-dom*
+   ```
+4. **清除缓存**：尝试清除构建缓存和 node_modules
+   ```bash
+   rm -rf node_modules .next dist build
+   npm install
+   # 或
+   pnpm install
+   ```
+5. **降级到 React 18**：如果问题持续，可以考虑暂时使用 React 18：
+   ```bash
+   npm install react@^18.0.0 react-dom@^18.0.0
+   ```
+
 ## 🔧 开发
 
 ### 本地开发