@gientech/modual 2.0.9 → 2.0.10

package/INSTALL_TROUBLESHOOTING.md

@@ -1,316 +0,0 @@
-# 安装故障排除指南
-
-## Yarn Hoisting 错误
-
-### 错误信息
-
-```
-error Invariant Violation: expected hoisted manifest for "@gientech/modual#@mxmweb/zui-components#@mxmweb/zui-elements"
-```
-
-### 问题原因
-
-`@mxmweb/zui-components` 和 `@mxmweb/zui-elements` 同时出现在 `dependencies` 和 `peerDependencies` 中，导致 Yarn 的 hoisting 算法无法正确解析依赖关系。
-
-### 解决方案
-
-#### ✅ 方案一：使用 `resolutions` 强制版本（推荐，适用于 Yarn 1.x）
-
-在用户项目的 `package.json` 中添加 `resolutions` 字段：
-
-```json
-{
-  "resolutions": {
-    "@mxmweb/zui-components": "1.2.5",
-    "@mxmweb/zui-elements": "1.1.5",
-    "@mxmweb/zui-icons": "1.2.2",
-    "@mxmweb/zui-layouts": "1.3.1",
-    "@mxmweb/zui-theme": "2.1.5"
-  }
-}
-```
-
-然后重新安装：
-
-```bash
-rm -rf node_modules yarn.lock
-yarn install
-```
-
-**优点**：
-- 简单直接
-- 适用于 Yarn 1.x
-- 强制统一版本，避免冲突
-
-**缺点**：
-- 需要手动维护版本号
-- 不适用于 Yarn 2+ / Berry
-
----
-
-#### ✅ 方案二：使用 `.yarnrc.yml` 配置（适用于 Yarn 2+ / Berry）
-
-在项目根目录创建或修改 `.yarnrc.yml` 文件：
-
-```yaml
-nodeLinker: node-modules
-
-packageExtensions:
-  "@gientech/modual@*":
-    peerDependencies:
-      "@mxmweb/zui-components": "*"
-      "@mxmweb/zui-elements": "*"
-```
-
-然后重新安装：
-
-```bash
-rm -rf node_modules .yarn/cache yarn.lock
-yarn install
-```
-
-**优点**：
-- 适用于 Yarn 2+ / Berry
-- 自动处理依赖关系
-
-**缺点**：
-- 仅适用于 Yarn 2+ / Berry
-- 需要了解 Yarn 配置
-
----
-
-#### ✅ 方案三：切换到 npm 或 pnpm（最简单）
-
-如果使用 Yarn 遇到问题，可以切换到 npm 或 pnpm：
-
-```bash
-# 清理 Yarn 相关文件
-rm -rf node_modules yarn.lock
-
-# 使用 npm
-npm install @gientech/modual
-
-# 或使用 pnpm
-pnpm install @gientech/modual
-```
-
-**优点**：
-- 最简单，无需额外配置
-- npm 和 pnpm 对 peerDependencies 的处理更宽松
-- 适用于所有项目
-
-**缺点**：
-- 需要切换包管理器
-- 可能需要更新 CI/CD 配置
-
----
-
-#### ✅ 方案四：手动安装 peerDependencies
-
-先安装 `@gientech/modual` 的 peerDependencies，然后再安装包本身：
-
-```bash
-# 先安装 peerDependencies
-yarn add @mxmweb/zui-components@1.2.5 \
-         @mxmweb/zui-elements@1.1.5 \
-         @mxmweb/zui-icons@1.2.2 \
-         @mxmweb/zui-layouts@1.3.1 \
-         @mxmweb/zui-theme@2.1.5
-
-# 再安装 @gientech/modual
-yarn add @gientech/modual
-```
-
-**优点**：
-- 明确控制依赖版本
-- 适用于所有包管理器
-
-**缺点**：
-- 需要手动维护版本号
-- 步骤较多
-
----
-
-#### ✅ 方案五：使用 `--ignore-scripts` 和手动安装
-
-```bash
-# 先清理
-rm -rf node_modules yarn.lock
-
-# 使用 --ignore-scripts 安装
-yarn install --ignore-scripts
-
-# 手动安装缺失的依赖
-yarn add @mxmweb/zui-components@1.2.5 \
-         @mxmweb/zui-elements@1.1.5 \
-         @mxmweb/zui-icons@1.2.2 \
-         @mxmweb/zui-layouts@1.3.1 \
-         @mxmweb/zui-theme@2.1.5
-```
-
-**优点**：
-- 可以绕过某些安装脚本问题
-
-**缺点**：
-- 步骤复杂
-- 可能影响其他依赖的安装
-
----
-
-### 推荐方案选择
-
-| 包管理器 | 推荐方案 | 说明 |
-|---------|---------|------|
-| Yarn 1.x | 方案一（resolutions） | 最简单直接 |
-| Yarn 2+ / Berry | 方案二（.yarnrc.yml） | 官方推荐方式 |
-| npm | 方案三（直接安装） | 通常不会有问题 |
-| pnpm | 方案三（直接安装） | 通常不会有问题 |
-| 新项目 | 方案三（使用 npm/pnpm） | 避免 Yarn hoisting 问题 |
-
----
-
-### 验证安装
-
-安装完成后，验证依赖是否正确：
-
-```bash
-# Yarn
-yarn list --pattern "@mxmweb/zui-*"
-
-# npm
-npm ls @mxmweb/zui-components @mxmweb/zui-elements
-
-# pnpm
-pnpm list "@mxmweb/zui-*"
-```
-
-应该能看到类似以下输出：
-
-```
-@mxmweb/zui-components@1.2.5
-@mxmweb/zui-elements@1.1.5
-@mxmweb/zui-icons@1.2.2
-@mxmweb/zui-layouts@1.3.1
-@mxmweb/zui-theme@2.1.5
-```
-
----
-
-### 完整示例：使用 resolutions（Yarn 1.x）
-
-1. **修改 `package.json`**：
-
-```json
-{
-  "name": "my-app",
-  "version": "1.0.0",
-  "dependencies": {
-    "@gientech/modual": "^2.0.4"
-  },
-  "resolutions": {
-    "@mxmweb/zui-components": "1.2.5",
-    "@mxmweb/zui-elements": "1.1.5",
-    "@mxmweb/zui-icons": "1.2.2",
-    "@mxmweb/zui-layouts": "1.3.1",
-    "@mxmweb/zui-theme": "2.1.5"
-  }
-}
-```
-
-2. **清理并重新安装**：
-
-```bash
-rm -rf node_modules yarn.lock
-yarn install
-```
-
-3. **验证安装**：
-
-```bash
-yarn list --pattern "@mxmweb/zui-*"
-```
-
----
-
-### 完整示例：使用 .yarnrc.yml（Yarn 2+）
-
-1. **创建 `.yarnrc.yml`**：
-
-```yaml
-nodeLinker: node-modules
-
-packageExtensions:
-  "@gientech/modual@*":
-    peerDependencies:
-      "@mxmweb/zui-components": "*"
-      "@mxmweb/zui-elements": "*"
-```
-
-2. **清理并重新安装**：
-
-```bash
-rm -rf node_modules .yarn/cache yarn.lock
-yarn install
-```
-
-3. **验证安装**：
-
-```bash
-yarn list --pattern "@mxmweb/zui-*"
-```
-
----
-
-### 其他常见问题
-
-#### Q: 安装后运行时提示找不到 `@mxmweb/zui-components`
-
-**A**: 确保已安装所有 peerDependencies：
-
-```bash
-yarn add @mxmweb/zui-components@1.2.5 \
-         @mxmweb/zui-elements@1.1.5 \
-         @mxmweb/zui-icons@1.2.2 \
-         @mxmweb/zui-layouts@1.3.1 \
-         @mxmweb/zui-theme@2.1.5
-```
-
-#### Q: 使用 resolutions 后仍然报错
-
-**A**: 尝试清理缓存并重新安装：
-
-```bash
-# 清理所有缓存
-yarn cache clean
-rm -rf node_modules yarn.lock
-
-# 重新安装
-yarn install
-```
-
-#### Q: 在 CI/CD 环境中遇到问题
-
-**A**: 在 CI/CD 配置中，建议：
-
-1. 使用 npm 或 pnpm（避免 Yarn hoisting 问题）
-2. 如果必须使用 Yarn，确保 `package.json` 中有 `resolutions` 配置
-3. 在安装前清理缓存：
-
-```yaml
-# GitHub Actions 示例
-- name: Install dependencies
-  run: |
-    rm -rf node_modules yarn.lock
-    yarn install --frozen-lockfile
-```
-
----
-
-## 联系支持
-
-如果以上方案都无法解决问题，请：
-
-1. 检查 Node.js 版本（建议 >= 16.0.0）
-2. 检查包管理器版本
-3. 提供完整的错误日志
-4. 提供 `package.json` 和 `yarn.lock`（或 `package-lock.json`）

package/USAGE.md

@@ -1,247 +0,0 @@
-# Gientech 多模块使用指南
-
-## 安装
-
-### 方式一：npm 安装
-```bash
-npm install @gientech/modual
-```
-
-### 方式二：本地安装
-```bash
-npm install /path/to/gientech/dist
-```
-
-## 重要：PDF Worker 注册
-
-**在使用 Chat 模块或其他涉及 PDF 预览的功能之前，必须在应用入口处注册 PDF Worker。**
-
-### 注册方式
-
-```javascript
-// 在应用入口文件（如 main.tsx 或 App.tsx）中
-import { registerPDFWorker } from '@gientech/modual';
-// 或者从 @mxmweb/fviewer 导入
-// import { registerPDFWorker } from '@mxmweb/fviewer';
-
-// 注册 Worker（只注册一次）
-registerPDFWorker('/worker/pdf.worker.min.js');
-```
-
-### Worker 文件部署
-
-1. **获取 Worker 文件**：
-   - 从 `node_modules/pdfjs-dist/build/pdf.worker.min.js` 复制
-   - 或从 `@mxmweb/fviewer` 的 dist 目录获取
-
-2. **部署 Worker 文件**：
-   - 将 `pdf.worker.min.js` 放在项目的 `public/worker/` 目录
-   - 或使用 CDN 提供 Worker 文件
-   - 确保 Worker 文件路径与注册时使用的路径一致
-
-3. **路径配置**：
-   - 开发环境：通常使用 `/worker/pdf.worker.min.js`
-   - 生产环境：根据实际部署路径调整（可能需要使用 CDN 或绝对路径）
-
-### 注意事项
-
-- ⚠️ **Worker 文件不应被打包进 bundle**，应作为静态资源部署
-- ⚠️ **只注册一次**：`registerPDFWorker` 内部有检查机制，多次调用不会重复注册
-- ⚠️ **必须在组件使用前注册**：建议在应用入口处注册，确保所有组件都能使用
-
-### 完整示例
-
-```javascript
-// main.tsx 或 App.tsx
-import React from 'react';
-import ReactDOM from 'react-dom/client';
-import { registerPDFWorker } from '@gientech/modual';
-import App from './App';
-
-// 注册 PDF Worker（必须在组件使用前）
-registerPDFWorker('/worker/pdf.worker.min.js');
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>
-);
-```
-
-## 使用方式
-
-### 1. Chat 聊天模块
-
-```javascript
-// 导入 chat 模块
-import { GientechChat } from '@gientech/modual/chat';
-
-// 在 React 组件中使用
-function App() {
-  return (
-    <div>
-      <GientechChat 
-        config={{
-          apiUrl: 'https://your-api.com',
-          token: 'your-token'
-        }}
-        // 其他配置...
-      />
-    </div>
-  );
-}
-```
-
-### 2. Database 数据库模块
-
-```javascript
-import { GientechDatabase } from '@gientech/modual/database';
-
-function DatabasePage() {
-  return (
-    <GientechDatabase 
-      config={{
-        apiUrl: 'https://your-api.com',
-        token: 'your-token'
-      }}
-    />
-  );
-}
-```
-
-### 3. DatabaseTable 数据库表格模块
-
-```javascript
-import { GientechDatabaseTable } from '@gientech/modual/databaseTable';
-
-function TablePage() {
-  return (
-    <GientechDatabaseTable 
-      config={{
-        apiUrl: 'https://your-api.com',
-        token: 'your-token'
-      }}
-    />
-  );
-}
-```
-
-### 4. HeadlessChat 无头聊天模块
-
-```javascript
-import { GientechHeadlessChat } from '@gientech/modual/headlessChat';
-
-function HeadlessChatPage() {
-  return (
-    <GientechHeadlessChat 
-      config={{
-        apiUrl: 'https://your-api.com',
-        token: 'your-token'
-      }}
-    />
-  );
-}
-```
-
-### 5. Login 登录模块
-
-```javascript
-import { GientechLogin } from '@gientech/modual/login';
-
-function LoginPage() {
-  return (
-    <GientechLogin 
-      config={{
-        apiUrl: 'https://your-api.com',
-        token: 'your-token'
-      }}
-    />
-  );
-}
-```
-
-### 6. Search 搜索模块
-
-```javascript
-import { KnowledgeSearch } from '@gientech/modual/search';
-
-function SearchPage() {
-  return (
-    <KnowledgeSearch 
-      config={{
-        apiUrl: 'https://your-api.com',
-        token: 'your-token'
-      }}
-    />
-  );
-}
-```
-
-## 样式引入
-
-```javascript
-// 引入样式
-import '@gientech/modual/style.css';
-```
-
-## 在 HTML 中直接使用
-
-```html
-<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="UTF-8">
-  <title>Gientech Demo</title>
-  <!-- 引入样式 -->
-  <link rel="stylesheet" href="./node_modules/@gientech/modual/style.css">
-</head>
-<body>
-  <div id="app"></div>
-  
-  <!-- 引入 React 和相关依赖 -->
-  <script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
-  <script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
-  <script src="https://unpkg.com/antd@5/dist/antd.min.js"></script>
-  
-  <!-- 引入模块 -->
-  <script type="module">
-    import { GientechChat } from './node_modules/@gientech/modual/chat.js';
-    
-    // 渲染组件
-    const root = ReactDOM.createRoot(document.getElementById('app'));
-    root.render(React.createElement(GientechChat, {
-      config: {
-        apiUrl: 'https://your-api.com',
-        token: 'your-token'
-      }
-    }));
-  </script>
-</body>
-</html>
-```
-
-## 依赖要求
-
-确保项目中已安装以下依赖：
-
-```json
-{
-  "dependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
-    "antd": "^5.0.0",
-    "@mxmweb/xviewer": "*",
-    "@mxmweb/fviewer": "*",
-    "@mxmweb/rtext": "*",
-    "@mxmweb/zui": "*",
-    "@mxmweb/aichat": "*"
-  }
-}
-```
-
-## 注意事项
-
-1. 每个模块都是独立的，可以按需引入
-2. 所有模块都需要相应的依赖包
-3. 确保 API 配置正确
-4. 样式文件需要单独引入

package/bash.exe.stackdump

@@ -1,40 +0,0 @@
-Stack trace:
-Frame         Function      Args
-0007FFFFCD30  00021006118E (0002102A6010, 000210272B51, 000000000063, 0007FFFFB660) msys-2.0.dll+0x2118E
-0007FFFFCD30  0002100469BA (0007FFFFC710, 000200000000, 000700000000, 000700000001) msys-2.0.dll+0x69BA
-0007FFFFCD30  0002100469F2 (000000000000, 000000000000, 000000000063, 000700000003) msys-2.0.dll+0x69F2
-0007FFFFCD30  000210101D21 (000210177B53, 000800007798, 000000000000, 0002102752E0) msys-2.0.dll+0xC1D21
-0007FFFFCD30  000210101D39 (0002101779A0, 0003000000FF, 000000000006, 0007FFFFC890) msys-2.0.dll+0xC1D39
-0007FFFFCD30  000210104704 (0007FFFFCD30, 000000000000, 0007FFFFC890, 0002102752E0) msys-2.0.dll+0xC4704
-0007FFFFCD30  000210059095 (000000000004, 000000000004, 0007FFFFC9E8, 0000FFFFFFFF) msys-2.0.dll+0x19095
-0007FFFFCD30  000210059865 (000210070B52, 00021024CB20, 000800004540, 000000000030) msys-2.0.dll+0x19865
-0007FFFFCD30  000210059D77 (00021017DB25, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x19D77
-0007FFFFCD30  00021005A0B6 (0002100CB9A0, 000000000000, FFFFFFFFFFFFFF43, 000200000000) msys-2.0.dll+0x1A0B6
-0007FFFFCD30  000210047151 (000000000000, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x7151
-0007FFFFFFF0  000210045C86 (000000000000, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x5C86
-0007FFFFFFF0  000210045D34 (000000000000, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x5D34
-End of stack trace
-Loaded modules:
-000100400000 bash.exe
-7FFD10F50000 ntdll.dll
-7FFD0FA20000 KERNEL32.DLL
-7FFD0E710000 KERNELBASE.dll
-7FFD10800000 USER32.dll
-7FFD0EB80000 win32u.dll
-7FFD10370000 GDI32.dll
-7FFD0E220000 gdi32full.dll
-000210040000 msys-2.0.dll
-7FFD0EBB0000 msvcp_win.dll
-7FFD0E5F0000 ucrtbase.dll
-7FFD0F630000 advapi32.dll
-7FFD10430000 msvcrt.dll
-7FFD0F350000 sechost.dll
-7FFD0EAD0000 bcrypt.dll
-7FFD104E0000 RPCRT4.dll
-7FFD0DA20000 CRYPTBASE.DLL
-7FFD0EB00000 bcryptPrimitives.dll
-7FFD0F5F0000 IMM32.DLL
-7FFD02F20000 netapi32.dll
-7FFCFB7A0000 SAMCLI.DLL
-7FFD05410000 SAMLIB.dll
-7FFD0CD40000 NETUTILS.DLL

package/components.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "new-york",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "tailwind.config.js",
-    "css": "src/style.css",
-    "baseColor": "slate",
-    "cssVariables": false,
-    "prefix": ""
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/components/shadcn/utils",
-    "ui": "@/components/shadcn/ui",
-    "lib": "@/components/shadcn/lib",
-    "hooks": "@/components/shadcn/hooks"
-  },
-  "iconLibrary": "lucide"
-}