@gientech/modual 2.2.3-fix.5 → 2.2.3-fix.6

package/release-it.json

@@ -0,0 +1,21 @@
+{
+  "git": {
+    "commitMessage": "chore: release v${version}"
+  },
+  "github": {
+    "release": true
+  },
+  "npm": {
+    "publish": true
+  },
+  "hooks": {
+    "before:init": ["npm run build"]
+  },
+  "plugins": {
+    "@release-it/conventional-changelog": {
+      "preset": {
+        "name": "conventionalcommits"
+      }
+    }
+  }
+}

package/scripts/README.md

@@ -0,0 +1,133 @@
+# XViewer 演示脚本使用说明
+
+## 概述
+
+这套脚本用于运行 XViewer 组件的演示示例，支持跨平台运行（Windows、macOS、Linux）。
+
+## 脚本文件
+
+- `demo-selector.js` - 示例选择器，扫描并选择要运行的示例
+- `dev-demo.js` - 开发模式演示
+- `build-demo.js` - 打包模式演示  
+- `preview-demo.js` - 预览模式演示
+- `run-demo.bat` - Windows 批处理文件（备用方案）
+
+## 使用方法
+
+### 方法一：使用 npm 脚本（推荐）
+
+```bash
+# 开发模式
+pnpm run dev:demo
+
+# 打包模式
+pnpm run build:demo
+
+# 预览模式
+pnpm run preview:demo
+```
+
+### 方法二：直接运行 Node.js 脚本
+
+```bash
+# 开发模式
+node scripts/dev-demo.js
+
+# 打包模式
+node scripts/build-demo.js
+
+# 预览模式
+node scripts/preview-demo.js
+```
+
+### 方法三：Windows 批处理文件
+
+```cmd
+# 开发模式
+scripts\run-demo.bat dev-demo
+
+# 打包模式
+scripts\run-demo.bat build-demo
+
+# 预览模式
+scripts\run-demo.bat preview-demo
+```
+
+## 示例文件格式
+
+脚本支持两种示例文件格式：
+
+1. **单文件模式**: `src/Example_XXXX.tsx`
+2. **文件夹模式**: 
+   - `src/examples/XXXX/index.tsx`
+   - `src/examples/XXXX/XXXX.tsx`
+
+## Windows 兼容性
+
+### 已解决的问题
+
+1. ✅ **依赖包缺失** - 已添加 `inquirer` 和 `fs-extra` 依赖
+2. ✅ **Shell 执行** - Windows 下使用 `shell: true` 选项
+3. ✅ **环境变量** - 自动设置 `NODE_OPTIONS` 环境变量
+4. ✅ **路径处理** - 使用 `path.join()` 确保跨平台兼容
+5. ✅ **调试信息** - 添加详细的调试输出
+
+### 调试信息
+
+脚本运行时会显示以下调试信息：
+- Node.js 版本
+- 操作系统类型
+- 当前工作目录
+- 脚本目录
+- Windows 模式标识
+
+## 故障排除
+
+### 问题 1：脚本执行没有反应
+
+**解决方案**：
+1. 确保已安装依赖：`pnpm install`
+2. 检查 Node.js 版本：`node --version`（需要 >= 22）
+3. 使用调试模式查看详细信息
+
+### 问题 2：Windows 下 pnpm 命令无法识别
+
+**解决方案**：
+1. 确保 pnpm 已全局安装：`npm install -g pnpm`
+2. 检查 PATH 环境变量
+3. 使用批处理文件：`scripts\run-demo.bat`
+
+### 问题 3：内存不足错误
+
+**解决方案**：
+1. 脚本已自动设置 `NODE_OPTIONS=--max-old-space-size=16384`
+2. 如需调整，修改脚本中的环境变量设置
+
+### 问题 4：示例文件扫描失败
+
+**解决方案**：
+1. 确保示例文件格式正确
+2. 检查文件路径和权限
+3. 查看调试信息中的路径信息
+
+## 开发说明
+
+### 添加新示例
+
+1. 在 `src/examples/` 下创建新文件夹
+2. 添加 `index.tsx` 或 `[文件夹名].tsx` 文件
+3. 脚本会自动扫描并显示
+
+### 修改脚本
+
+1. 所有脚本都支持跨平台运行
+2. 使用 `process.platform === 'win32'` 检测 Windows
+3. 使用 `path.join()` 处理路径
+4. 使用 `shell: isWindows` 设置 spawn 选项
+
+## 技术细节
+
+- **Node.js 版本要求**: >= 22
+- **依赖包**: inquirer, fs-extra
+- **支持平台**: Windows, macOS, Linux
+- **脚本类型**: ES Modules

package/scripts/build-demo.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { main, restoreMainFile } from './demo-selector.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 检测操作系统
+const isWindows = process.platform === 'win32';
+
+/**
+ * 执行打包
+ */
+function runBuild() {
+  console.log('\n🔨 正在执行打包...\n');
+  console.log('🔧 调试信息:');
+  console.log('  操作系统:', process.platform);
+  console.log('  Windows 模式:', isWindows);
+  console.log('  工作目录:', path.resolve(__dirname, '..'));
+  console.log('');
+
+  const buildProcess = spawn('pnpm', ['run', 'build:app'], {
+    stdio: 'inherit',
+    shell: isWindows, // Windows 下需要 shell: true
+    cwd: path.resolve(__dirname, '..'),
+    env: {
+      ...process.env,
+      NODE_OPTIONS: '--max-old-space-size=16384',
+    },
+  });
+
+  buildProcess.on('close', code => {
+    if (code === 0) {
+      console.log('\n✅ 打包完成！');
+      console.log('📁 输出目录: dist-app/');
+    } else {
+      console.error(`\n❌ 打包失败 (退出码: ${code})`);
+    }
+
+    // 恢复原始 main.tsx 文件
+    restoreMainFile();
+    process.exit(code);
+  });
+
+  buildProcess.on('error', error => {
+    console.error('❌ 执行打包失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  });
+
+  // 处理进程退出信号
+  process.on('SIGINT', () => {
+    console.log('\n🔄 正在取消打包...');
+    buildProcess.kill('SIGINT');
+  });
+
+  process.on('SIGTERM', () => {
+    console.log('\n🔄 正在取消打包...');
+    buildProcess.kill('SIGTERM');
+  });
+}
+
+/**
+ * 主函数
+ */
+async function runBuildDemo() {
+  try {
+    // 先选择示例
+    await main();
+
+    // 执行打包
+    runBuild();
+  } catch (error) {
+    console.error('❌ 打包模式启动失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  }
+}
+
+// 如果直接运行此脚本
+//if (import.meta.url === `file://${process.argv[1]}`) {
+runBuildDemo();
+//}
+
+export { runBuildDemo };

package/scripts/check-changelog.cjs

@@ -0,0 +1,124 @@
+const fs = require('fs');
+const { execSync } = require('child_process');
+const path = require('path');
+const pkg = require('../package.json');
+
+const pkgPath = path.resolve(__dirname, '../package.json');
+
+let originalVersion;
+let originalPkgContent; // 备份完整package.json内容（避免格式丢失）
+
+function execCmd(cmd) {
+  try {
+    return execSync(cmd, { stdio: 'pipe', encoding: 'utf8' });
+  } catch (err) {
+    console.error(`命令执行失败: ${cmd}`);
+    console.error(err.stdout || err.message);
+    throw err;
+  }
+}
+
+function backupOriginalVersion() {
+  console.log('📌 备份原始版本信息...');
+  // 备份package.json
+  originalPkgContent = fs.readFileSync(pkgPath, 'utf8');
+  originalVersion = JSON.parse(originalPkgContent).version;
+  console.log(`✅ 原始版本号: ${originalVersion}`);
+}
+
+function rollbackVersion() {
+  console.log('\n🔄 开始回退版本...');
+  try {
+    // 恢复package.json
+    fs.writeFileSync(pkgPath, originalPkgContent);
+    console.log(`✅ 恢复package.json至版本: ${originalVersion}`);
+  } catch (err) {
+    console.error('\n❌ 版本回退失败，请手动处理：', err.message);
+    process.exit(1);
+  }
+}
+
+// 核心：校验新版本的changelog是否存在
+function checkNewVersionChangelog(newVersion) {
+  console.log(`\n🔍 校验新版本 ${newVersion} 的changelog记录...`);
+  try {
+    // CHANGELOG 路径
+    const changelogPath = path.resolve(__dirname, '../CHANGELOG.md');
+
+    // 读取 CHANGELOG 内容
+    const changelog = fs.readFileSync(changelogPath, 'utf8');
+
+    if (!changelog.includes(`## [${newVersion}]`)) {
+      throw new Error(`❌ 错误：CHANGELOG.md 中未找到版本 ${newVersion} 的记录，请先手写补充！`);
+    } else {
+      console.log(`✅ 校验通过：CHANGELOG.md 已包含版本 ${newVersion} 的记录`);
+      return true;
+    }
+  } catch (err) {
+    throw err;
+  }
+}
+// 主流程
+function main() {
+  try {
+    // 1. 前置检查：git工作区必须干净（避免未提交文件影响）
+    // const gitStatus = execCmd('git status --porcelain', true).trim();
+    // if (gitStatus) {
+    //   throw new Error('git工作区存在未提交的变更，请先提交或暂存');
+    // }
+
+    // 2. 备份原始版本信息
+    backupOriginalVersion();
+
+    // 3. 执行standard-version升级版本（生成changelog+提升版本+提交+打tag）
+    console.log('\n🚀 执行standard-version升级版本...');
+    execCmd('npx standard-version --release-as patch');
+
+    // 4. 获取升级后的新版本号
+    const newPkgContent = fs.readFileSync(pkgPath, 'utf8');
+    const newVersion = JSON.parse(newPkgContent).version;
+    console.log(`\n📌 版本升级完成，新版本号：${newVersion}`);
+
+    // 5. 校验新版本的changelog记录
+    checkNewVersionChangelog(newVersion);
+
+    // 6. 发布成功
+    console.log(`\n🎉 版本发布流程全部完成！最终版本：${newVersion}`);
+    execCmd('pnpm install');
+    process.exit(0);
+  } catch (err) {
+    // 任何步骤失败，都回退版本
+    console.error('\n❌ 版本发布流程失败：', err.message);
+    if (originalVersion) {
+      // 只有备份了原始版本才回退
+      rollbackVersion();
+    }
+    process.exit(1);
+  }
+}
+
+// 启动主流程
+main();
+// // 原始版本（如 1.0.1）
+
+// originalPkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+// originalVersion = originalPkg.version;
+// console.log(`📌 原始版本号: ${originalVersion}`);
+
+// execCmd('npx standard-version --release-as patch');
+
+// const newVersion = pkg.version;
+// // CHANGELOG 路径
+// const changelogPath = path.resolve(__dirname, '../CHANGELOG.md');
+
+// // 读取 CHANGELOG 内容
+// const changelog = fs.readFileSync(changelogPath, 'utf8');
+
+// // 校验：是否包含「## [x.y.z]」格式的当前版本
+// if (!changelog.includes(`## [${newVersion}]`)) {
+//   console.error(`❌ 错误：CHANGELOG.md 中未找到版本 ${newVersion} 的记录，请先手写补充！`);
+//   fs.writeFileSync(pkgPath, JSON.stringify(originalPkg, null, 2) + '\n');
+//   console.log(`✅ 恢复package.json版本至: ${originalVersion}`);
+
+//   process.exit(1); // 终止发布流程
+// }

package/scripts/check-version.cjs

@@ -0,0 +1,49 @@
+const axios = require('axios');
+const fs = require('fs');
+const path = require('path');
+
+// 读取package.json获取包名和新版本号
+const packageJsonPath = path.resolve(__dirname, '../package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+const packageName = packageJson.name;
+const newVersion = packageJson.version;
+
+/**
+ * 检查npm仓库中是否已存在指定版本
+ * @param {string} name 包名
+ * @param {string} version 版本号
+ * @returns {Promise<boolean>} 是否存在
+ */
+async function checkNpmVersionExists(name, version) {
+  try {
+    // 优先检查npm官方仓库，私有仓库可修改此URL
+    const response = await axios.get(`https://registry.npmjs.org/${name}/${version}`);
+    // 如果能获取到版本信息，说明已存在
+    return !!response.data;
+  } catch (error) {
+    // 404表示版本不存在，其他错误需要提示
+    if (error.response && error.response.status === 404) {
+      return false;
+    }
+    console.error('检查npm版本时发生错误:', error.message);
+    process.exit(1);
+  }
+}
+
+// 执行校验逻辑
+async function run() {
+  console.log(`开始检查 npm 仓库中 ${packageName}@${newVersion} 是否存在...`);
+
+  const exists = await checkNpmVersionExists(packageName, newVersion);
+
+  if (exists) {
+    console.error(`❌ 错误: ${packageName}@${newVersion} 已存在于npm仓库！`);
+    // 退出并返回错误码，阻止后续发布
+    process.exit(1);
+  } else {
+    console.log(`✅ 成功: ${packageName}@${newVersion} 未在npm仓库中找到，可以发布`);
+    process.exit(0);
+  }
+}
+
+run();

package/scripts/decrypt-api-key.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+/**
+ * API Key 解密工具
+ * 使用方法: node scripts/decrypt-api-key.js <encrypted-key>
+ */
+
+import CryptoJS from 'crypto-js';
+
+// 默认的 KEY 与 IV（与代码库中的一致）
+const DEFAULT_KEY = CryptoJS.enc.Utf8.parse("1234567890123456");
+const DEFAULT_IV = CryptoJS.enc.Utf8.parse("1234567890123456");
+
+/**
+ * AES 解密函数
+ */
+function decrypt(encryptedText, keyStr, ivStr) {
+  let key = DEFAULT_KEY;
+  let iv = DEFAULT_IV;
+
+  if (keyStr) {
+    key = CryptoJS.enc.Utf8.parse(keyStr);
+    iv = CryptoJS.enc.Utf8.parse(ivStr || keyStr);
+  }
+
+  try {
+    const base64 = CryptoJS.enc.Base64.parse(encryptedText);
+    const src = CryptoJS.enc.Base64.stringify(base64);
+
+    const decrypted = CryptoJS.AES.decrypt(src, key, {
+      iv: iv,
+      mode: CryptoJS.mode.CBC,
+      padding: CryptoJS.pad.ZeroPadding,
+    });
+
+    const decryptedStr = decrypted.toString(CryptoJS.enc.Utf8);
+    return decryptedStr.toString().replace(/\0/g, ''); // 移除填充的 null 字符
+  } catch (error) {
+    return null;
+  }
+}
+
+// 主函数
+function main() {
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0) {
+    console.log('使用方法: node scripts/decrypt-api-key.js <encrypted-key> [key] [iv]');
+    console.log('');
+    console.log('示例:');
+    console.log('  node scripts/decrypt-api-key.js "apiKey_r6HozveeuFu31Ix8MSW6BYODRzUNGmxAG6bC58dvYOSzzCaqVJ56nKGybQy2aCfQfGXru0/BWC2ozy232FCf0w=="');
+    console.log('  node scripts/decrypt-api-key.js "encrypted-text" "custom-key" "custom-iv"');
+    process.exit(1);
+  }
+
+  let encryptedKey = args[0];
+  const customKey = args[1];
+  const customIV = args[2];
+
+  // 如果 key 以 apiKey_ 开头，去掉前缀
+  if (encryptedKey.startsWith('apiKey_')) {
+    encryptedKey = encryptedKey.replace('apiKey_', '');
+  }
+
+  console.log('🔐 尝试解密 API Key...');
+  console.log('加密文本:', encryptedKey);
+  console.log('');
+
+  // 尝试使用默认密钥解密
+  console.log('📝 使用默认密钥 (1234567890123456) 解密:');
+  const result1 = decrypt(encryptedKey);
+  if (result1) {
+    console.log('✅ 解密结果:', result1);
+  } else {
+    console.log('❌ 解密失败（可能使用了不同的密钥）');
+  }
+  console.log('');
+
+  // 如果提供了自定义密钥，尝试使用自定义密钥解密
+  if (customKey) {
+    console.log(`📝 使用自定义密钥 (${customKey}) 解密:`);
+    const result2 = decrypt(encryptedKey, customKey, customIV);
+    if (result2) {
+      console.log('✅ 解密结果:', result2);
+    } else {
+      console.log('❌ 解密失败');
+    }
+    console.log('');
+  }
+
+  console.log('⚠️  注意: 如果解密失败，可能需要使用不同的密钥或加密算法');
+}
+
+main();
+