crabatool 1.0.857 → 1.0.860

package/ev-recording-implementation.md

@@ -162,4 +162,132 @@ crabatool -runEv -evSavePath "ev保存音频的路径，如c:\\Users\\grasp\\ev
 
 - 所有日志都包含时间戳
 - 详细记录文件监控、大小变化等信息
-- 错误信息清晰明了
+- 错误信息清晰明了
+
+
+
+## 方案二：windows【命令版ev服务工具】使用步骤
+
+1. **Node.js 环境**【仅首次安装】
+
+   若电脑尚未安装 Node.js，请先下载并安装：[Node.js 下载地址](https://nodejs.cn/download/)
+
+2. [下载工具包](setup/evtool.zip) 然后解压到本地
+
+3. 双击安装软件.bat【仅首次安装】
+
+后期通知软件有更新的情况，就需要双击更新软件.bat，平时不用【仅有更新的时候】
+
+4. 右键启动软件.bat---编辑---根据你当前的情况修改ev的存储路径【仅首次】
+
+如果不清楚怎么修改ev存储路径，继续看下面的介绍
+
+5. 双击启动软件.bat【**每次**】
+
+平时需要采集音视频的时候
+
+-----如果只是使用步骤，到此结束即可------
+
+还需更多了解，可以继续往下看
+
+
+
+# crabatool + EV录屏 集成服务介绍
+
+## 功能说明
+
+`crabatool` 提供 EV 录屏自动化集成功能。启动服务后，工具将自动监听 EV 录屏生成的文件（视频/音频），检测录制完成并自动上传至七牛云存储，最终将生成的 URL 回填至教学录制页面中，实现教学音视频的自动化采集与上传。
+
+## 适用场景
+
+- 录制教学视频或音频，自动上传至七牛云
+- 无需手动操作，自动获取录制文件的访问链接
+- 支持 EV 录屏路径自动检测，简化配置流程
+
+## 依赖环境
+
+1. **Node.js 环境**（仅首次安装）  
+   若电脑尚未安装 Node.js，请先下载并安装：[Node.js 下载地址](https://nodejs.cn/download/)
+
+2. **全局安装 crabatool**（仅首次安装）  
+   打开命令行工具，执行以下命令：
+   ```bash
+   npm install crabatool -g
+   ```
+
+## 启动服务
+
+### 命令格式
+
+```bash
+crabatool -runEv -evSavePath "<EV录屏保存路径>"
+```
+
+### 参数说明
+
+| 参数 | 说明 |
+|------|------|
+| `-runEv` | 启动 EV 录屏集成服务 |
+| `-evSavePath` | EV 录屏保存视频和音频的目录路径，需与 EV 录屏软件中的“保存路径”设置一致 |
+
+> 💡 **如何查看或修改 EV 录屏的保存路径？**  
+> 参考官方帮助文档：[EV录屏 - 如何查看/修改保存路径](https://www.ieway.cn/help/desc-evcapture-pc-2141.html)
+
+### 示例
+
+```bash
+crabatool -runEv -evSavePath "C:\Users\用户名\Documents\EV录屏"
+```
+
+### 快捷启动（推荐）
+
+建议将启动命令保存为 **批处理文件（.bat）**，便于后续快速启动服务，无需重复输入命令。
+
+**创建方法：**
+1. 新建文本文件，输入上述命令
+2. 将文件扩展名改为 `.bat`
+3. 双击即可启动服务
+
+## 详细操作流程
+
+1. **启动集成服务**  
+   执行启动命令（或双击已保存的 `.bat` 文件），服务开始监听 EV 录屏的保存目录。
+
+2. **触发录制**  
+   在教学录制页面中，点击 **“采集这一步的音/视频”** 图标。
+
+3. **启动 EV 录屏**  
+   系统将自动打开 EV 录屏工具，请手动点击 EV 录屏的 **“开始录制”** 按钮或使用预设的快捷键开始录制。
+
+4. **自动上传与回填**  
+   录制完成后，文件将自动上传至七牛云，上传成功后生成的音频/视频 URL 将自动填入当前教学步骤，图标变为红色，表示处理完成。
+
+## 注意事项
+
+- 请确保 EV 录屏的保存路径与 `-evSavePath` 参数填写路径**完全一致**
+- 录制过程中请勿手动删除或移动正在写入的文件，否则可能导致上传失败
+- 若录制完成后长时间未触发上传，请检查网络连接及七牛云配置是否正常
+- 服务启动后请保持命令行窗口运行状态，关闭窗口将停止监听
+
+
+## 使用 crabatool 与原生 EV 录屏的对比
+
+| 对比项 | 原生 EV 录屏 | crabatool 集成方案 |
+|--------|--------------|--------------------|
+| **启动方式** | 手动打开 EV 录屏，点击录制 | 双击 `.bat` 文件启动服务，教学页面一键触发录制 |
+| **录制触发** | 手动点击 EV 录屏界面按钮 | 在教学页面点击“采集音/视频”，工具自动唤起 EV 录屏并开始监听 |
+| **文件处理** | 录制完成后，需手动找到文件、重命名、上传至云存储 | 工具自动检测录制结束，自动上传至七牛云 |
+| **URL 回填** | 手动复制云存储链接，粘贴到教学步骤中 | 上传成功后 URL 自动回填，图标状态自动更新 |
+| **多步骤支持** | 需手动记录每次录制的文件对应关系 | 自动关联当前步骤，无需人工核对 |
+| **出错处理** | 依赖人工检查是否遗漏 | 工具实时监控，有错误日志可追溯 |
+| **适用场景** | 适合临时、少量录制 | 适合批量、流程化的教学音视频采集 |
+
+通过集成 `crabatool`，可将原本需要 5~8 步的手动操作简化为 **一键触发 → 自动完成**，大幅提升录制上传效率，避免人工失误。
+
+## 常见问题
+
+**Q：为什么服务启动后没有反应？**  
+A：请检查 EV 录屏保存路径是否正确，以及该目录是否存在。
+
+**Q：录制完成后未自动上传？**  
+A：可检查网络连接，或查看命令行窗口是否有错误日志输出。

package/lib/utils.js

@@ -9,6 +9,7 @@ var compressing = require('compressing');
 var axios = require('axios');
 var os = require('os');
 const { execSync } = require('child_process');
+const { execFileSync } = require('child_process');
 /*
 const util = require('util');
 const execPromise = util.promisify(execSync);
@@ -984,7 +985,9 @@ class Utils {
     execSync('git add --all', { cwd: webPath }); // 暂存
 
     console.log('git commit -m "' + msg + '"'); // 提交日志
-    execSync('git commit -m "' + msg + '"', { cwd: webPath }); // 提交日志
+    //execSync('git commit -m "' + msg + '"', { cwd: webPath }); // 提交日志
+    execFileSync('git', ['commit', '-m', msg]);
+
 
     //console.log('git pull --rebase origin ' + branchName); // 拉取分支
     //execSync('git pull --rebase origin ' + branchName, { cwd: webPath }); // 拉取分支

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crabatool",
-  "version": "1.0.857",
+  "version": "1.0.860",
   "description": "crabatool",
   "main": "index.js",
   "bin": {

package/tool/checkjs.js

@@ -10,6 +10,7 @@ var gspx = require('./checkgspx.js');
 var iconfont = require('./checkiconfont.js');
 var eslint = require('eslint');
 const upgrade = require('./upgrade.js');
+const javaEnum = require('./javaEnum.js');
 
 
 // js超过多少kb给与提示
@@ -46,6 +47,9 @@ module.exports.start = async function() {
 
   iconfont.start(); // 检查收集各项目组iconfont使用情况
 
+  //javaEnum.start(); // 执行代码检测时，搜集当前webPath路径下面所有java枚举类（1. 普通枚举，2. 含@EnumDbMapping注解的枚举)
+
+
   //utils.copyFile(jsonPath, path.join(process.cwd(), '.eslintrc.json'));
   var jsFiles = utils.getFiles({ source: config.webPath, exts: '.js', ignores: config.ignoreCheck });
 

package/tool/javaEnum.js

@@ -0,0 +1,141 @@
+var fs = require('fs');
+var path = require('path');
+var utils = require('../lib/utils.js');
+var config = require('../lib/config.js');
+
+
+function processJavaFile(filePath, enumInfos) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+
+    const hasEnumDbMapping = content.includes('@EnumDbMapping');
+    const isEnum = content.includes('public enum');
+
+    if (!hasEnumDbMapping || !isEnum) {
+      return;
+    }
+
+    const packageMatch = content.match(/package\s+([\w\.]+);/);
+    const packageName = packageMatch ? packageMatch[1] : '';
+
+    const classNameMatch = content.match(/public\s+(?:enum|class)\s+(\w+)\s+(?:implements|extends)/);
+    let className = '';
+    if (!classNameMatch) {
+      const enumNameMatch = content.match(/public\s+enum\s+(\w+)/);
+      if (!enumNameMatch) {
+        return;
+      }
+      className = enumNameMatch[1];
+    } else {
+      className = classNameMatch[1];
+    }
+
+    let dbMap = '';
+    if (hasEnumDbMapping) {
+      let annotationMatch = content.match(/@EnumDbMapping\s*\(\s*"([^"]+)"\s*\)/);
+      if (!annotationMatch) {
+        annotationMatch = content.match(/@EnumDbMapping\s*\(\s*value\s*=\s*"([^"]+)"\s*\)/);
+      }
+      if (!annotationMatch) {
+        annotationMatch = content.match(/@EnumDbMapping\s*\(\s*value\s*=\s*\{\s*"([^"]+)"/);
+      }
+      if (!annotationMatch) {
+        annotationMatch = content.match(/@EnumDbMapping\s*\(\s*\{\s*"([^"]+)"/);
+      }
+      if (annotationMatch) {
+        dbMap = annotationMatch[1];
+      }
+    }
+
+    const values = [];
+
+    // 提取枚举体内容（在enum声明和第一个private字段之间）
+    // 支持有implements和没有implements两种情况
+    let enumBodyMatch = content.match(/public\s+enum\s+\w+\s+implements[^{]*\{([\s\S]*?)\n\s+private/);
+    if (!enumBodyMatch) {
+      enumBodyMatch = content.match(/public\s+enum\s+\w+\s*\{([\s\S]*?)\n\s+private/);
+    }
+    if (enumBodyMatch) {
+      const enumBody = enumBodyMatch[1];
+      // 使用更宽松的正则匹配枚举值：枚举名(参数1, 参数2, ...)
+      const valuePattern = /([A-Za-z_]\w*)\(([^)]+)\)/g;
+      let match;
+      while ((match = valuePattern.exec(enumBody)) !== null) {
+        const valueStr = match[2];
+        // 分割参数
+        const parts = valueStr.split(',');
+        if (parts.length >= 2) {
+          let part1 = parts[0].trim();
+          let part2 = parts[1].trim();
+          // 去除引号
+          part1 = part1.replace(/^"|"$/g, '');
+          part2 = part2.replace(/^"|"$/g, '');
+
+          // 判断哪个是code，哪个是name
+          // 如果第一个是数字，第二个是中文 -> (数字, "中文名")
+          // 如果第一个是中文，第二个是数字 -> ("中文名", 数字)
+          let code, name;
+          if (/^\d+$/.test(part1)) {
+            code = part1;
+            name = part2;
+          } else if (/^\d+$/.test(part2)) {
+            code = part2;
+            name = part1;
+          } else {
+            // 无法判断，使用第一个作为name，第二个作为code
+            name = part1;
+            code = part2;
+          }
+
+          if (code && name) {
+            values.push(code + '=' + name);
+          }
+        }
+      }
+    }
+
+    const valueStr = values.join(',');
+
+    const enumInfo = {
+      name: packageName + "." + className,
+      dbMap: dbMap,
+      value: valueStr
+    };
+
+    enumInfos.push(enumInfo);
+  } catch (error) {
+    console.error(`Error processing file ${filePath}:`, error.message);
+  }
+}
+
+function generateEnumsJson(enumInfos) {
+  try {
+    var jsonContent = JSON.stringify(enumInfos, null, 2);
+    fs.writeFileSync(path.join(__dirname, '../enums.json'), jsonContent, 'utf8');
+    console.log('Successfully generated enums.json with ' + enumInfos.length + ' entries');
+  } catch (error) {
+    console.error('Error generating enums.json:', error.message);
+  }
+}
+
+module.exports.start = function() {
+  var enumInfos = [];
+
+  console.log('Scanning Java files...');
+  var webPath = config.webPath;
+  if (!webPath) {
+    console.error('config.webPath is not defined');
+    return;
+  }
+
+  var javaFiles = utils.getFiles({ source: webPath, exts: '.java', ignores: config.ignoreCheck });
+  console.log('Found ' + javaFiles.length + ' Java files');
+
+  console.log('Processing files...');
+  for (var i = 0; i < javaFiles.length; i++) {
+    processJavaFile(javaFiles[i], enumInfos);
+  }
+
+  console.log('Generating enums.json...');
+  generateEnumsJson(enumInfos);
+};

package/tool/ngpSkinUtils.js

@@ -136,7 +136,7 @@ function _copyFiles() {
 
 // 更新完成后推送平台并提交日志
 function pushGitLog() {
-  var msg = "ngp皮肤和图标库更新完成";
+  var msg = "ngp皮肤和图标库更新完成【无需测试】";
   console.log(msg);
   utils.gitpush(msg);
 }