mb-rrvideo-server 1.0.2

package/.dockerignore

@@ -0,0 +1,48 @@
+# Node modules
+node_modules/
+npm-debug.log
+yarn-error.log
+package-lock.json
+
+# 日志文件
+logs/
+*.log
+
+# 临时文件
+temp/
+__rrvideo__temp__/
+__rrvideos__temp__/
+tasks/
+Video/
+
+# 配置文件（用户自己提供）
+config.json
+
+# 测试文件
+test-*.js
+test-*.sh
+*.test.js
+
+# Git
+.git/
+.gitignore
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# 系统文件
+.DS_Store
+Thumbs.db
+
+# 文档
+*.md
+!README.md
+!CHANGELOG.md
+
+# Docker 文件（避免递归）
+Dockerfile
+docker-compose.yml
+.dockerignore

package/CHANGELOG.md

@@ -0,0 +1,335 @@
+# 更新日志
+
+## [1.0.2] - 2025-02-06
+
+### 新增
+
+#### 配置文件支持注释
+
+现在配置文件支持添加注释，方便理解和维护：
+
+**支持的注释格式：**
+
+1. **单行注释** - 使用 `//`
+```json
+{
+  "server": {
+    "port": 24203,  // 服务端口
+    "host": "0.0.0.0"  // 监听所有网卡
+  }
+}
+```
+
+2. **多行注释** - 使用 `/* */`
+```json
+{
+  /*
+   * 服务器配置
+   * 包括端口和监听地址
+   */
+  "server": {
+    "port": 24203,
+    "host": "0.0.0.0"
+  }
+}
+```
+
+3. **尾随逗号** - 支持 JSON5 风格
+```json
+{
+  "server": {
+    "port": 24203,
+    "host": "0.0.0.0",  // 最后一项可以有逗号
+  },
+}
+```
+
+**实现细节：**
+- 自动移除单行注释（`//`）
+- 自动移除多行注释（`/* */`）
+- 自动移除尾随逗号
+- 智能识别字符串内的 `//`（如 URL）不会被当作注释
+- 完全向后兼容标准 JSON
+
+**使用示例：**
+
+```json
+{
+  // ==================
+  // 服务器配置
+  // ==================
+  "server": {
+    "port": 24203,              // 服务端口
+    "host": "0.0.0.0"           // 监听地址
+  },
+  
+  // ==================
+  // 存储配置
+  // ==================
+  "storage": {
+    "type": "local",            // 存储类型: "local" 或 "minio"
+    
+    /* 本地存储配置 */
+    "local": {
+      "video_dir": "./Video",   // 视频存储目录
+      "temp_dir": "./temp"      // 临时文件目录
+    },
+    
+    /* MinIO 对象存储配置 */
+    "minio": {
+      "endpoint": "172.168.1.2",
+      "port": 9000,
+      "useSSL": false,
+      "accessKey": "your-access-key",
+      "secretKey": "your-secret-key",
+      "bucket": "record-prod",
+      "public_host": "https://oss-bbx.17maibaoxian.com:10008"  // 公开访问地址
+    }
+  },
+  
+  // rrvideo 播放器配置
+  "rrvideo": {
+    "speed": 1,                 // 播放速度
+    "skipInactive": true,       // 跳过不活跃时间
+    "mouseTail": false,         // 鼠标轨迹
+  }
+}
+```
+
+**测试工具：**
+
+```bash
+# 测试配置文件解析
+node test-config.js
+```
+
+### 改进
+
+- 优化了配置文件解析逻辑
+- 增强了错误提示信息
+- 更新了配置文件示例（添加注释）
+
+### 技术细节
+
+#### 注释解析算法
+
+```javascript
+// 1. 移除多行注释
+jsonString = jsonString.replace(/\/\*[\s\S]*?\*\//g, '');
+
+// 2. 移除单行注释（智能识别字符串内的 //）
+const lines = jsonString.split('\n');
+const cleanedLines = lines.map(line => {
+  // 跟踪字符串状态，避免移除字符串内的 //
+  let inString = false;
+  let stringChar = null;
+  
+  for (let i = 0; i < line.length - 1; i++) {
+    // 检测字符串边界
+    if ((char === '"' || char === "'") && line[i - 1] !== '\\') {
+      if (!inString) {
+        inString = true;
+        stringChar = char;
+      } else if (char === stringChar) {
+        inString = false;
+      }
+    }
+    
+    // 在字符串外找到 //
+    if (!inString && char === '/' && nextChar === '/') {
+      return line.substring(0, i).trimEnd();
+    }
+  }
+  return line;
+});
+
+// 3. 移除尾随逗号
+jsonString = jsonString.replace(/,(\s*[}\]])/g, '$1');
+
+// 4. 解析 JSON
+return JSON.parse(jsonString);
+```
+
+### 向后兼容性
+
+✅ **完全向后兼容**
+
+- 标准 JSON 格式继续有效
+- 不影响现有配置文件
+- 可选功能，不强制使用注释
+
+### 已知限制
+
+1. 不支持嵌套的多行注释
+2. 字符串内的 `//` 和 `/* */` 会被正确保留（如 URL）
+3. 注释内容不会被保存（仅用于阅读）
+
+---
+
+## [1.0.1] - 2025-02-06
+
+### 新增
+
+#### 1. 命令行启动支持
+
+现在可以通过 `rrvideo-server` 命令直接启动服务：
+
+```bash
+# 全局安装
+npm link
+
+# 启动服务
+rrvideo-server
+```
+
+**实现细节：**
+- 添加了 `bin/rrvideo-server` 可执行文件
+- 在 `package.json` 中配置了 `bin` 字段
+- 自动设置工作目录为项目根目录
+
+**使用场景：**
+- 开发测试时快速启动
+- 系统服务配置（systemd, supervisor）
+- Docker 容器入口点
+
+#### 2. 智能配置文件处理
+
+解决了 rrvideo 配置文件格式问题，支持两种配置方式：
+
+**方式 1：使用全局配置（推荐）**
+
+在 `config.json` 中配置 rrvideo 参数：
+
+```json
+{
+  "rrvideo": {
+    "speed": 1,
+    "skipInactive": true,
+    "mouseTail": false
+  }
+}
+```
+
+服务会自动生成临时配置文件传递给 rrvideos 命令。
+
+**方式 2：使用独立配置文件**
+
+在请求中指定配置文件路径：
+
+```json
+{
+  "input": "/path/to/input.data",
+  "output": "/path/to/output.mp4",
+  "config": "/path/to/rrvideo.config.json"
+}
+```
+
+**实现细节：**
+- 自动检测配置类型（对象 vs 文件路径）
+- 对象配置自动生成临时文件
+- 进程结束后自动清理临时文件
+- 临时文件存储在系统临时目录（`/tmp/rrvideo-server/`）
+- 使用唯一文件名避免冲突
+
+**优势：**
+- ✅ 无需手动管理配置文件
+- ✅ 配置集中管理
+- ✅ 自动清理，无残留
+- ✅ 多进程安全
+
+### 改进
+
+- 优化了配置文件处理逻辑
+- 增强了日志输出（记录临时配置文件路径）
+- 改进了错误处理
+
+### 技术细节
+
+#### 临时配置文件生成
+
+```javascript
+// 从 config.rrvideo 读取配置
+const rrvideoConfig = config.get('rrvideo');
+
+// 自动生成临时配置文件
+const { command, tempConfigFile } = buildConvertCommand(
+  inputList, 
+  outputList, 
+  rrvideoConfig  // 传递对象，自动生成临时文件
+);
+
+// 进程结束后自动清理
+if (tempConfigFile) {
+  cleanupTempConfigFile(tempConfigFile);
+}
+```
+
+#### 配置文件格式
+
+**原始格式（config.json）：**
+```json
+{
+  "rrvideo": {
+    "speed": 1,
+    "skipInactive": true,
+    "mouseTail": false
+  }
+}
+```
+
+**生成的临时文件（rrvideos 期望的格式）：**
+```json
+{
+  "speed": 1,
+  "skipInactive": true,
+  "mouseTail": false
+}
+```
+
+### 迁移指南
+
+如果你之前使用独立的 rrvideo 配置文件，现在有两个选择：
+
+**选项 1：迁移到全局配置（推荐）**
+
+将配置内容移到 `config.json` 的 `rrvideo` 字段下：
+
+```json
+{
+  "server": { ... },
+  "storage": { ... },
+  "rrvideo": {
+    "speed": 1,
+    "skipInactive": true,
+    "mouseTail": false
+  }
+}
+```
+
+**选项 2：继续使用独立文件**
+
+保持现有配置文件，在请求中指定路径即可。
+
+### 已知问题
+
+无
+
+### 下一步计划
+
+- [ ] 支持配置热重载
+- [ ] 添加配置验证
+- [ ] 支持环境变量覆盖配置
+
+---
+
+## [1.0.0] - 2025-02-06
+
+### 初始版本
+
+- ✅ V1/V2 转码支持
+- ✅ 视频合并功能
+- ✅ MinIO/本地存储
+- ✅ 文件系统任务管理
+- ✅ 缓冲式日志系统
+- ✅ HTTP 回调通知
+- ✅ 完整文档