NexRender项目中的文件重命名与视频编码问题解析

问题背景

在NexRender最新版本中，用户反馈了两个关键问题：

1. 工作路径中的文件被自动添加随机前缀名，导致预设的action-encode操作无法正常执行
2. 视频预处理（如裁剪）功能需要更灵活的配置方式

核心问题分析

文件命名机制变更

新版本在nexrender-core/src/tasks/download.js中引入了随机文件名生成逻辑：

// 当非序列文件时自动添加随机前缀
if (!asset.sequence) {
    destName = Math.random().toString(36).substring(2) + '-' + destName;
}

这一改动虽然解决了并行下载时的文件名冲突问题，但导致了：

• 预设的action-encode操作中input参数无法匹配实际文件名
• 工作流中文件引用关系被破坏

视频预处理需求

当前版本缺乏：

1. 智能文件名匹配机制
2. 直接在assets中定义预处理参数的能力
3. 自动化的视频裁剪/编码流程

解决方案建议

临时解决方案

1. 注释掉随机文件名生成代码（不推荐生产环境使用）
2. 在action-encode中使用完整随机化文件名

架构改进建议

建议在项目层面实现以下功能：

1. 智能文件名解析

// 在action-encode模块中增加文件名解析逻辑
function resolveInputFilename(originalName, workpath) {
    const files = fs.readdirSync(workpath);
    return files.find(file => file.endsWith(originalName));
}

2. Asset级预处理配置

{
    "type": "video",
    "layerName": "media.mp4",
    "src": "example.mp4",
    "preprocess": {
        "start": "00:00:02",
        "duration": "00:00:05",
        "codec": "libx264"
    }
}

3. 预处理执行器

建议实现一个统一的预处理管道，自动处理：

• 视频裁剪
• 转码
• 分辨率调整
• 音频处理

技术实现要点

1. 文件名追踪系统

   • 建立下载文件名映射表
   • 提供API查询实际文件路径

2. 预处理流水线

   • 在下载完成后自动执行预处理
   • 支持FFmpeg参数透传

3. 配置验证机制

   • 预处理参数合法性检查
   • 资源存在性验证

版本兼容性考虑

建议通过配置项控制新特性：

{
    "naming": {
        "randomPrefix": false // 禁用随机前缀
    },
    "preprocessing": {
        "autoExecute": true // 启用自动预处理
    }
}

总结

NexRender作为专业的渲染自动化工具，文件管理和视频预处理是核心需求。通过改进文件名管理机制和增强预处理功能，可以显著提升工作流的可靠性和灵活性。建议开发者权衡文件名唯一性需求与工作流稳定性，同时考虑为高级用户提供更细粒度的视频处理控制选项。