@gientech/modual 2.0.7 → 2.0.9

package/.editorconfig

@@ -0,0 +1,38 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+trim_trailing_whitespace = true
+
+# TypeScript and JavaScript files
+[*.{ts,tsx,js,jsx}]
+indent_style = space
+indent_size = 2
+quote_type = single
+max_line_length = 100
+
+# CSS files
+[*.css]
+indent_style = space
+indent_size = 2
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+max_line_length = off
+
+# JSON files
+[*.json]
+indent_style = space
+indent_size = 2
+
+# YAML files
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2

package/.prettierignore

@@ -0,0 +1,16 @@
+# 构建输出
+dist
+build
+
+# 依赖
+node_modules
+
+# 测试覆盖率
+coverage
+
+# 其他
+.git
+.husky
+.vscode
+*.log
+*.lock 

package/.prettierrc

@@ -0,0 +1,17 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "jsxSingleQuote": false,
+  "quoteProps": "as-needed",
+  "useTabs": false,
+  "htmlWhitespaceSensitivity": "css",
+  "embeddedLanguageFormatting": "auto",
+  "singleAttributePerLine": false,
+  "bracketSameLine": false
+} 

package/INSTALL_TROUBLESHOOTING.md

@@ -0,0 +1,316 @@
+# 安装故障排除指南
+
+## 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

@@ -0,0 +1,247 @@
+# 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

@@ -0,0 +1,40 @@
+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

@@ -0,0 +1,21 @@
+{
+  "$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"
+}